Timetable

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

1. In the admin panel, go to the "Timetable" plugin settings.
2. Select the timetable generator.
3. Configure timetable settings (effective date, disabled mode, normal/test mode, roles) in the "Options" tab.
4. 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)
5. 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
6. View plan statistics in the "Statistics" tab.
7. 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.