內容簡介
Timetable 外掛專為 Vulcan/Dobry Plan 設計，提供課程表管理、職責支援及列印功能。使用者可輕鬆上傳和管理標準及測試課程表，並可選擇性地處理職責檔案，提升學校的課程安排效率。
【主要功能】
• 支援從 Vulcan (ZIP) 或 Dobry Plan (HTML) 上傳課程表
• 獨立上傳職責檔案 (.xlsx) 而不影響課程計劃
• 自動插入教師休息職責行於課程表
• 提供教師職責面板及列印按鈕
• 設定選項可控制課程表的啟用與顯示權限
• 支援錯誤日誌及快照恢復功能
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
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 a duties file (.xlsx) is required when uploading a standard or test timetable together with the plan.
Updating duties without changing the lesson plan is done only in the separate Duties tab.
The plan upload flow is intentionally strict: standard/test plan upload + duties together; duties-only update is handled separately.
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.
Plan uploads and duties uploads are deliberately separated: a timetable upload requires its duties file together, while duties-only updates are done via the dedicated Duties tab.
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.
