Startseite Anleitung

Installationsanleitung

WordPress-Plugin einrichten, iCal-Feed verbinden, Termine online stellen — in 7 Schritten.

WordPress 6.0 oder höher
PHP 8.0 oder höher
IServ iCal-Feed (HTTPS)
WordPress-Admin-Zugang

Schritt für Schritt

Folge den Schritten der Reihe nach. Der erste Einsatz dauert ca. 30 Minuten.

  1. Plugin herunterladen

    Öffne die Download-Seite und stimme dem Haftungsausschluss zu. Der Download startet als ZIP-Datei.

    Zum Download

  2. Plugin in WordPress hochladen

    Im WordPress-Adminbereich: Plugins → Installieren → Plugin hochladen. Die heruntergeladene ZIP-Datei auswählen und auf "Jetzt installieren" klicken.

    Alternativ: Den Ordner gsh-terminplan aus der ZIP manuell nach wp-content/plugins/ kopieren (z. B. per SFTP).

  3. Plugin aktivieren

    Nach dem Upload: Plugins → Installierte Plugins. Das Plugin "Schul-Terminplan" in der Liste suchen und auf "Aktivieren" klicken. Danach erscheint unter Einstellungen ein neuer Menüpunkt "Schul-Terminplan".

  4. iCal-URL aus IServ eintragen

    In IServ: Kalender → Einstellungen → Externen Zugriff einrichten. Die HTTPS-URL des iCal-Feeds kopieren (endet auf .ics).

    Im WordPress-Admin unter Einstellungen → Schul-Terminplan → Profil-Tab: URL einfügen, Cache-Dauer festlegen, speichern. Das Plugin lädt den Feed beim ersten Speichern automatisch.

    Beispiel-URL:
    https://iserv.deine-schule.de/iserv/calendar/pub/xyz123.ics

  5. Schuljahres-Vorlage erstellen (optional)

    Falls Termine noch nicht in IServ eingetragen sind: Den ICS-Konverter öffnen, im Schritt 2 die Schuljahres-Daten und Ferien eintragen, Vorlage herunterladen. Die Excel-Datei dann in Excel befüllen.

    Konverter auf der Startseite

  6. Excel-Termine in ICS umwandeln (optional)

    Im ICS-Konverter: Excel-Vorlage importieren (Schritt 3), Kategorien prüfen, ICS-Datei exportieren (Schritt 4). Die erzeugte .ics-Datei in IServ oder direkt in WordPress importieren.

    Dieser Schritt ist nur nötig, wenn Termine über die Excel-Vorlage erfasst wurden. Bei reiner IServ-Nutzung entfällt er.

  7. Shortcode auf einer WordPress-Seite einfügen

    Eine neue Seite in WordPress erstellen (z. B. "Terminplan") und folgenden Shortcode einfügen:

    [gsh_terminplan]

    Seite veröffentlichen. Der Kalender erscheint sofort mit Quartalansicht, Kategorie-Filter und Volltextsuche. Für IServ-Einbettung (Kiosk-Modus) die Token-URL in den Plugin-Einstellungen konfigurieren.

Gesamtablauf

So hängen die Komponenten zusammen.

Häufige Fragen

Funktioniert das Plugin auch ohne IServ?
Ja, mit Einschränkungen. Das Plugin liest jeden gültigen iCal-Feed (HTTPS). Der Konverter erzeugt eine .ics-Datei, die als statische Datei auf einem Webserver gehostet werden kann. Ohne IServ entfällt der automatische Sync — die ICS-Datei muss manuell erneuert und neu verlinkt werden.
Wie oft wird der iCal-Feed aktualisiert?
Die Cache-Dauer ist in den Plugin-Einstellungen konfigurierbar (Standard: 60 Minuten). Das Plugin nutzt WordPress-Cron für Hintergrundaktualisierungen. Änderungen in IServ sind spätestens nach Ablauf des Cache-Intervalls sichtbar.
Kann ich eigene Kategorien anlegen?
Ja. Unter Einstellungen → Schul-Terminplan → Kategorien können Kategorien hinzugefügt, umbenannt, eingefärbt und mit Stichwörtern für automatisches Matching ausgestattet werden. Bis zu 20 Kategorien, die Farben frei wählbar.
Was passiert bei WordPress-Updates?
Das Plugin wird nicht automatisch mit WordPress aktualisiert (kein WordPress.org-Verzeichnis). Nach einem WordPress-Major-Update empfiehlt sich ein Test in einer Staging-Umgebung. Bei Kompatibilitätsproblemen bitte ein GitHub Issue öffnen.
Wo melde ich Fehler oder Verbesserungsvorschläge?
Über GitHub Issues. Kein Support garantiert — das ist ein Hobbyprojekt. Fehlermeldungen mit WordPress-Version, PHP-Version und konkreter Fehlerbeschreibung werden bevorzugt bearbeitet.