Timetable

Description

School timetable plugin for Vulcan (ZIP) and Dobry Plan (HTML), with standard/test modes and teacher duties support.

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.
• 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.
• 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.

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”.
• “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.

Settings

After activating the plugin, go to the settings section in the admin panel:
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.

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).
4. Upload timetable file for standard plan:
   • Vulcan: ZIP
   • Dobry Plan: HTML
5. Upload duties file (.xlsx) for standard plan (required if duties system is enabled).
6. Repeat upload for test plan (timetable + duties).
7. Optionally publish test plan as standard (this also publishes test duties as standard duties).
8. On frontend, place shortcode [planle_plan] on target page.

License

This plugin is distributed under the GPLv2 or later license. More information can be found on the GPL license page.