Nachfolger: Kölner Schulneulinge – Kartenanwendung (ksn-kartenanwendung) ab Version 2.0.0.
Versionierte Datenstände, Upload über Gravity Forms, Kartenansicht per Shortcode
[ksn_kartenanwendung], Herkunftsdarstellung und Selbstaktualisierung aus GitHub-Releases. Ab 2.1.0 zusätzlich die Simulation als Prototyp (per Einstellung freischaltbar) mit Excel-Sicherung und Druckansicht, ab 2.3.0 als geführter Wizard neben der Karte, dazu Links auf die Einrichtungsseiten von MiA-NET.
Kartenanwendung herunterladen Installation & Einrichtung
Das unten beschriebene Plugin ABC-Schulklassen v1.0.0 ist eingefroren. Bekanntes Problem: Seine Update-Prüfung bricht mit einem Fehler ab, sobald das Release einen Beschreibungstext hat – v1.0.0 bitte deaktivieren und durch die Kartenanwendung ersetzen (Details in der README des Vorgängers).
Vorgänger: ABC-Schulklassen v1.0.0 (eingefroren)
Das Plugin bringt Karte, Bezirks-Dashboard und Koordinationspanel direkt in die WordPress-Verwaltung. Es löst die frühere Einbettung per iFrame ab: die Anwendung läuft als Teil der Website, die Zugangskontrolle übernimmt WordPress.
Technische Angaben
| Plugin-Ordner | wp-content/plugins/abc-schulklassen |
|---|---|
| WordPress | 6.4 oder neuer |
| PHP | 8.0 oder neuer |
| Abhängigkeiten | keine – weder Composer noch npm, kein Build-Schritt |
| Bezugsquelle | GitHub-Releases von daimpad/mia-net |
| Archivname | abc-schulklassen-v<version>.zip |
| Lizenz | GPL-2.0-or-later |
Installation
- Archiv aus dem Release v1.0.0 laden.
- In WordPress unter Plugins → Installieren → Plugin hochladen einspielen.
- Aktivieren. Dabei werden die Rechte vergeben, der Datenordner angelegt und die mitgelieferten Ausgangsdaten hineinkopiert.
- Das Werkzeug erscheint als Menüpunkt ABC-Schulklassen.
Aktualisierung
Das Plugin prüft selbst auf neue Versionen und meldet sie wie jedes andere Plugin unter Plugins. Ein zusätzliches Updater-Plugin ist nicht nötig.
Warum nicht Git Updater?
Git Updater kann Plugins, die in einem Unterordner eines Repositories
liegen, grundsätzlich nicht aktualisieren: es sucht die Plugin-Hauptdatei ausschließlich
im Wurzelverzeichnis. Der Header Release Asset: true ändert daran nichts –
er greift erst beim Herunterladen, die Versionserkennung läuft vorher.
Der Fehlschlag wäre lautlos: es erschiene schlicht nie ein Update-Hinweis, und man hielte das Plugin für aktuell.
Dieses Plugin bringt deshalb eine eigene Aktualisierungsprüfung mit, die die Version aus dem Release-Tag liest und damit auch aus einem Unterordner heraus funktioniert.
Privates Repository
Wird daimpad/mia-net später privat geschaltet, gehört ein Zugriffstoken
in die wp-config.php – nicht in den Plugincode:
define( 'ABC_SCHULKLASSEN_GITHUB_TOKEN', '…' );Zugriffsrechte
Damit niemand Vollzugriff auf die Website braucht, nur um Schuldaten zu pflegen, legt das Plugin eigene Rechte an:
| Recht | Erlaubt | Standardmäßig bei |
|---|---|---|
abc_schulklassen_view | Ansehen: Karte, Dashboard, Panel, Steckbrief | Administrator, Redakteur |
abc_schulklassen_manage | Import, Plätze speichern, Geocoding | Administrator |
Zusätzlich gibt es die Rolle ABC-Koordination für Personen, die sonst nichts in WordPress tun sollen.
Datenablage
Die Daten liegen in wp-content/uploads/abc-schulklassen/, nicht
im Plugin-Ordner. Zwei Gründe:
- Ein Plugin-Update ersetzt den gesamten Plugin-Ordner – gepflegte Daten wären danach weg.
- Der Ordner ist gegen direkten Abruf gesperrt. Die Auslieferung läuft über eine REST-Schnittstelle, die vorher die Berechtigung prüft.
Webserver ohne .htaccess
Auf Apache – dem Standard bei Plesk – sperrt eine mitgelieferte .htaccess
den Datenordner. Auf nginx greift das nicht; dort gehört in die Serverkonfiguration:
location ~* /wp-content/uploads/abc-schulklassen/ { deny all; }Umstieg von der iFrame-Einbettung
- Plugin installieren und aktivieren.
- Daten prüfen: ABC-Schulklassen im Menü öffnen.
- Den bisherigen
<iframe>-Block aus der WordPress-Seite entfernen.
Die eigenständige Fassung unter /abc-schulklassen/ bleibt vorerst als öffentliche Demonstration bestehen.