內容簡介
**總結：**
這個 WordPress 外掛允許管理課程計劃，讓您上傳 ZIP 檔案並啟用測試課程計劃。
**問題與答案：**
1. 這個 WordPress 外掛的主要功能是什麼？
- 可以上傳包含課程計劃的 ZIP 檔案。
- 在伺服器上解壓縮 ZIP 檔案。
- 提供控制課程計劃是否啟用以及關閉的設定。
- 提供測試選項，可以在正常和測試課程計劃之間切換。
- 可以僅讓已登入的使用者啟用課程計劃。
2. 如何安裝這個外掛？
- 將外掛資料夾上傳至您的伺服器的 wp-content/plugins/ 目錄中。
- 在 WordPress 管理員面板中啟用外掛。
- 透過進入「課程計劃」的 WordPress 設定部分來設定外掛。
3. 如何設定這個外掛？
- 在啟用外掛後，進入管理員面板的設定部分。
- 設定課程計劃的生效日期（格式：d-m-Y）。
- 選擇是否關閉課程計劃的選項。
- 選擇僅讓已登入的使用者看到課程計劃的選項。
- 選擇啟用正常和測試課程計劃的選項。
- 選擇僅啟用測試課程計劃的選項。
4. 如何使用這個外掛？
- 在管理員面板中，進入「課程計劃」外掛設定。
- 更新課程計劃設定，包括生效日期，並選擇啟用或關閉計劃。
- 上傳包含課程計劃的 ZIP 檔案。
- 可以選擇與測試計劃相關的選項，以及僅讓已登入的使用者看到課程計劃的選項。
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
School timetable plugin for Vulcan/Dobry Plan with duties support, management, and print features.
Usage
To use, place the shortcode [planle_plan] on a page.
Required menu type selected in Vulcan Optivum – bulleted list on the left side.
Generator-dependent uploads:
Vulcan Optivum: timetable file must be ZIP.
Dobry Plan: timetable file must be HTML.
If duties are enabled in settings, uploading duties file (.xlsx) is required for both standard and test uploads.
Features
Upload a timetable from Vulcan (ZIP) or Dobry Plan (HTML), for standard and test plans.
Upload and process duties files (.xlsx) for standard and test plans.
Upload duties files separately without modifying the lesson plan.
Optional duties system toggle in settings.
Automatic insertion of teacher break-duty rows in timetable tables (including pre-lesson duties).
Teacher duty panel plus optional “All duties” view on teacher pages with print button.
Publish test plan as standard together with its duties file.
Extract ZIP files on the server (Vulcan mode).
Settings to control whether the timetable is active and the option to disable it.
Test options to switch between normal and test timetables.
Option to display the timetable only to logged-in users.
Tabbed admin panel interface with separate “Duties” and “Statistics” tabs.
Duties data transcoding: XLSX uploads are converted to editable JSON datasets.
Zone-based duties editor (xlsx-like): edit by zone/time/day with live code validation.
Admin error logs tab section for diagnostics and support.
Snapshot restore (undo last duties save) for standard/test duties datasets.
Duties Files
Duties upload is normalized to fixed filenames:
Standard upload: standard_duties.xlsx
Test upload: test_duties.xlsx
Original uploaded filename does not matter (the plugin renames it automatically).
Backward compatibility: if fixed names do not exist, legacy dyzury.xlsx is still supported.
During “Publish Test Plan”, test duties are also moved to standard duties.
Teacher Duties View
On teacher pages, timetable rows can include inserted duty breaks based on XLSX.
If a duty exists before the first lesson (for example 07:40-07:45 before 07:45-08:30), it is also inserted.
On teacher pages only, a subtle toggle button is available to open/close “All duties”.
When “All duties” panel is expanded, a “Print duties” button appears next to the toggle button for printing all duties.
“All duties” opens below:
“Submit feedback on the timetable”
“Last update: …”
“All duties” is rendered as a table grouped by zone, with numbering reset per zone.
Print functionality includes title, all duties table, and current date/time.
Settings
The plugin settings page is organized into tabs:
Lesson Plans Tab
Upload and manage timetable files and duties files for both standard and test plans.
Duties Tab
Manage duties separately:
– Upload duties files (.xlsx) without changing the lesson plan.
– Update standard plan duties only.
– Update test plan duties only.
– View current duties file status and last modification date.
Options Tab
Configure global plugin options:
1. Timetable effective date (format: d-m-Y).
2. Option to disable the timetable.
3. Option to show the timetable only to logged-in users.
4. Option to enable both normal and test timetables.
5. Option to enable only the test timetable.
6. Generator selection (Vulcan Optivum or Dobry Plan).
7. Duties system switch (Require and display duties/breaks for teachers).
8. Roles allowed to access the test timetable.
9. Optional feedback/contact page for timetable issues.
Statistics Tab
View and manage plan view statistics:
– Display view count for each timetable plan.
– Reset statistics with password verification.
How to Use
In the admin panel, go to the “Timetable” plugin settings.
Select the timetable generator.
Configure timetable settings (effective date, disabled mode, normal/test mode, roles) in the “Options” tab.
Navigate to the “Lesson Plans” tab:
Upload timetable file for standard plan (Vulcan: ZIP, Dobry Plan: HTML)
Upload duties file (.xlsx) for standard plan (required if duties system is enabled)
Repeat upload for test plan (timetable + duties)
Optionally publish test plan as standard (also publishes test duties as standard duties)
To update duties without changing the lesson plan, use the “Duties” tab:
Upload a new duties file for standard or test plan separately
Current duties file status and last update date are displayed
View plan statistics in the “Statistics” tab.
On frontend, place shortcode [planle_plan] on target page.
Duties Management
Use the “Duties” tab to update duties (.xlsx) separately from lesson plans.
Upload duties for standard plan without affecting the standard lesson plan.
Upload duties for test plan without affecting the test lesson plan.
Current duties file status is shown (file existence and last modification date).
License
This plugin is distributed under the GPLv2 or later license. More information can be found on the GPL license page.
