Installation

• Paket installieren
• Was wird angelegt?
• Update
• Deinstallation
• Checkliste für den Produktivbetrieb
• Installation aus dem Quellcode (Entwicklung)

Paket installieren

1. Du erhältst die Datei pkg_seminarplan-<version>.zip (oder baust sie selbst, siehe Entwicklung).
2. Melde dich im Joomla-Administrator an und öffne System → Installieren → Erweiterungen.
3. Lade die Zip-Datei hoch. Das Paket installiert die Komponente, sechs Module und vier Plugins.
4. Nach der Installation erscheint ein Hinweis mit den nächsten Schritten; die Plugins Smart Search - SeminarPlan, Aufgabe - SeminarPlan, Konsole - SeminarPlan und Inhalt - SeminarPlan sind bereits aktiviert.

Das Installationsskript prüft vorher die PHP- und Joomla-Version und bricht mit einer Meldung ab, wenn die Voraussetzungen nicht erfüllt sind.

TIP

Nach der Installation findest du die Komponente unter Komponenten → SeminarPlan. Das Dashboard dort zeigt eine Einrichtungs-Checkliste, die du Schritt für Schritt abarbeiten kannst.

Was wird angelegt?

• Komponentenverzeichnisse administrator/components/com_seminarplan und components/com_seminarplan, Medien unter media/com_seminarplan (CSS, JavaScript).
• Module unter modules/mod_seminarplan_*, Plugins unter plugins/{finder,task,console,content}/seminarplan.
• Keine eigenen Datenbanktabellen. Die Katalogdaten liegen im Cache-Verzeichnis (Standard cache/com_seminarplan), das beim ersten Abgleich erstellt wird.

Update

Ein Update installierst du genauso wie die Erstinstallation: neues Paket hochladen, Joomla erkennt die vorhandene Installation und aktualisiert alle Teile. Optionen, Menüeinträge, Modulzuweisungen und der Cache bleiben erhalten. Falls sich das Cache-Format ändert, läuft nach dem Update einmal eine vollständige Synchronisierung (Dashboard → Synchronisieren).

Deinstallation

Unter System → Erweiterungen verwalten das Paket SeminarPlan auswählen und deinstallieren. Das Paket entfernt Komponente, Module und Plugins gemeinsam (einzelne Teile lassen sich nicht separat deinstallieren, solange das Paket installiert ist). Menüeinträge, die auf die Komponente zeigen, löschst du anschließend im Menü-Manager; das Cache-Verzeichnis cache/com_seminarplan kannst du löschen.

Checkliste für den Produktivbetrieb

• HTTPS für die Webseite; SeminarPlan pusht nur an erreichbare HTTPS-Endpunkte sinnvoll.
• Sprachpaket: Die Erweiterung liefert Deutsch und Englisch. Damit generierte Texte (Überschriften, Meta-Beschreibungen, Formulare) deutsch erscheinen, muss Deutsch als Standard-Site-Sprache in Joomla installiert und aktiv sein.
• Scheduler: System → Geplante Aufgaben mit Lazy Scheduler, Webcron oder CLI-Cron betreiben, damit die Synchronisierung läuft.
• OPcache: Bei opcache.validate_timestamps=0 Syncs nicht per CLI ausführen (siehe Einstellungen → Cache).
• Sitemap: Die Erweiterung liefert eine XML-Sitemap unter index.php?option=com_seminarplan&view=sitemap&format=xml. Trage sie in die robots.txt (Sitemap: https://www.beispiel.de/index.php?option=com_seminarplan&view=sitemap&format=xml) oder in die Search Console ein.
• Datenschutz: Formulare übertragen die eingegebenen Daten sowie IP-Adresse, User-Agent und Einstiegsseite an SeminarPlan. Nimm die Verarbeitung durch SeminarPlan in deine Datenschutzerklärung auf und hinterlege die Links zu AGB, Datenschutz und Widerruf (Optionen → Formulare oder SeminarPlan-Systemeinstellungen).
• Captcha: Für öffentlich erreichbare Formulare ein Joomla-Captcha-Plugin aktivieren (Optionen → Formulare); Honeypot und Rate-Limit sind immer aktiv.
• Protokolle: Synchronisierungs-, Push- und Formularfehler stehen in administrator/logs/com_seminarplan.php.
• Backup: Die Komponentenoptionen (inklusive API-Schlüssel und Push-Token) liegen in der Joomla-Datenbank; der Cache ist jederzeit neu erzeugbar.
• Updates: Neue Paketversionen über System → Installieren einspielen; anschließend Dashboard prüfen und bei Bedarf einmal synchronisieren.

Installation aus dem Quellcode (Entwicklung)

Für Entwicklungsumgebungen lässt sich der Quellcode per Symlink in eine Joomla-Instanz einhängen und über Erweiterungen entdecken installieren. Das Skript dev/link.sh im Repository erledigt beides. Details im Kapitel Entwicklung.