Plan lekcji

Opis

Wtyczka planu lekcji dla Vulcan/Dobry Plan z obsługą dyżurów, zarządzaniem i funkcją drukowania.

Użycie

• Aby użyć umieść na stronie shortcode [planle_plan]
• Wymagany typ menu wybrany w programie Vulcan Optivum – lista wypunktowana z lewej strony
• Przesyłanie zależne od generatora:
  • Vulcan Optivum: plik planu musi być w formacie ZIP.
  • Dobry Plan: plik planu musi być w formacie HTML.
• Jeśli system dyżurów jest włączony w ustawieniach, przesłanie pliku dyżurów (.xlsx) jest wymagane zarówno dla planu standardowego, jak i testowego.

Funkcje

• Przesyłaj plan lekcji z Vulcan (ZIP) lub Dobry Plan (HTML) dla planów standardowych i testowych.
• Przesyłaj i przetwarzaj pliki dyżurów (.xlsx) dla planów standardowych i testowych.
• Przesyłanie plików dyżurów oddzielnie, bez modyfikowania planu lekcji.
• Opcjonalny przełącznik systemu dyżurów w ustawieniach.
• Automatyczne wstawianie wierszy dyżurów/przerw nauczycieli w tabelach planu (w tym przed pierwszą lekcją).
• Panel dyżurów nauczyciela oraz opcjonalny widok „Wszystkie dyżury” na stronach nauczycieli z przyciskiem drukowania.
• Opublikuj plan testowy jako standardowy wraz z jego plikiem dyżurów.
• Rozpakuj pliki ZIP na serwerze (tryb Vulcan).
• Ustawienia, które umożliwiają kontrolowanie, czy plan lekcji jest aktywny, a także opcję wyłączenia go.
• Opcje testowe, które umożliwiają przełączanie między planem normalnym i testowym.
• Możliwość włączenia planu lekcji tylko dla zalogowanych użytkowników.
• Panel administracyjny z interfejsem zakładek, w tym osobne zakładki „Dyżury” i „Statystyki”
• Transkodowanie danych dyżurów: przesłane pliki XLSX są konwertowane do edytowalnych zbiorów danych JSON.
• Edytor dyżurów oparty na strefach (jak w Excelu): edycja według strefy/czasu/dnia z walidacją kodów w czasie rzeczywistym.
• Sekcja logów błędów administratora do diagnostyki i wsparcia.
• Przywracanie kopii (cofnięcie ostatniego zapisu dyżurów) dla danych dyżurów planu standardowego i testowego.

Pliki dyżurów

• Przesyłanie dyżurów jest ujednolicane do stałych nazw plików:
  • Przesyłanie standardowe: standard_duties.xlsx
  • Przesyłanie testowe: test_duties.xlsx
• Oryginalna nazwa przesłanego pliku nie ma znaczenia (wtyczka zmienia ją automatycznie).
• Zgodność wsteczna: jeśli stałe nazwy nie istnieją, obsługiwany jest również starszy plik dyzury.xlsx.
• Podczas „Publikacji planu testowego” dyżury testowe są również przenoszone do standardowych.

Widok dyżurów nauczyciela

• Na stronach nauczycieli wiersze planu mogą zawierać wstawione dyżury/przerwy na podstawie pliku XLSX.
• Jeśli dyżur występuje przed pierwszą lekcją (np. 07:40–07:45 przed 07:45–08:30), zostaje również dodany.
• Tylko na stronach nauczycieli dostępny jest dyskretny przycisk do rozwijania/zwijania „Wszystkich dyżurów”.
• Po rozwinięciu panelu „Wszystkie dyżury” pojawia się przycisk „Drukuj dyżury” obok przycisku przełączania, umożliwiający wydruk wszystkich dyżurów.
• „Wszystkie dyżury” rozwijają się poniżej:
  • „Zgłoś uwagi do planu lekcji”
  • „Ostatnia aktualizacja: …”
• „Wszystkie dyżury” są wyświetlane jako tabela pogrupowana według stref, z numeracją resetowaną dla każdej strefy.
• Funkcja drukowania zawiera tytuł, tabelę wszystkich dyżurów oraz aktualną datę i godzinę.

Ustawienia

Strona ustawień wtyczki jest podzielona na zakładki:

Zakładka „Plany lekcji”

Przesyłanie i zarządzanie plikami planu lekcji oraz plikami dyżurów dla planów standardowego i testowego.

Zakładka „Dyżury”

Zarządzanie dyżurami niezależnie:
– Przesyłanie plików dyżurów (.xlsx) bez zmiany planu lekcji.
– Aktualizacja dyżurów tylko dla planu standardowego.
– Aktualizacja dyżurów tylko dla planu testowego.
– Podgląd statusu aktualnego pliku dyżurów i daty ostatniej modyfikacji.

Zakładka „Opcje”

Po aktywacji wtyczki przejdź do sekcji ustawień w panelu administratora:
1. Data obowiązywania planu (format: d-m-Y).
2. Opcja wyłączenia planu lekcji.
3. Opcja wyświetlania planu tylko dla zalogowanych użytkowników.
4. Opcja włączenia planu standardowego i testowego.
5. Opcja włączenia tylko planu testowego.
6. Wybór generatora (Vulcan Optivum lub Dobry Plan).
7. Przełącznik systemu dyżurów (wymagaj i wyświetlaj dyżury/przerwy dla nauczycieli).
8. Role mające dostęp do planu testowego.
9. Opcjonalna strona zgłoszeń/kontaktu dotycząca problemów z planem lekcji.

Zakładka „Statystyki”

Wyświetlanie i zarządzanie statystykami wyświetleń planu:
– Wyświetlanie liczby odsłon dla każdego planu lekcji.
– Resetowanie statystyk z weryfikacją hasła.

Jak używać

1. W panelu administracyjnym, przejdź do ustawień wtyczki „Plan Lekcji”.
2. Wybierz generator planu lekcji.
3. Skonfiguruj ustawienia planu (data obowiązywania, tryb wyłączony, tryb standardowy/testowy, role) w zakładce „Opcje”.
4. Przejdź do zakładki „Plany lekcji”:
   • Prześlij plik planu lekcji dla planu standardowego (Vulcan: ZIP, Dobry Plan: HTML).
   • Prześlij plik dyżurów (.xlsx) dla planu standardowego (wymagane, jeśli system dyżurów jest włączony)
   • Powtórz przesyłanie dla planu testowego (plan + dyżury)
   • Opcjonalnie opublikuj plan testowy jako standardowy (spowoduje to również publikację dyżurów testowych jako standardowych)
5. Aby zaktualizować dyżury bez zmiany planu lekcji, użyj zakładki „Dyżury”:
   • Prześlij nowy plik dyżurów osobno dla planu standardowego lub testowego.
   • Wyświetlany jest aktualny status pliku dyżurów oraz data ostatniej aktualizacji.
6. Wyświetl statystyki planu w zakładce „Statystyki”.
7. Na stronie frontowej umieść shortcode [planle_plan] na wybranej stronie.

Zarządzanie dyżurami

• Użyj zakładki „Dyżury”, aby aktualizować dyżury (.xlsx) niezależnie od planów lekcji.
• Prześlij dyżury dla planu standardowego bez wpływu na plan lekcji standardowy.
• Prześlij dyżury dla planu testowego bez wpływu na plan lekcji testowy.
• Wyświetlany jest aktualny status pliku dyżurów (istnienie pliku oraz data ostatniej modyfikacji).

Licencja

Ta wtyczka jest rozpowszechniana na licencji GPLv2 lub późniejszej. Więcej informacji możesz znaleźć na GPL license page.