Zuerst: Connector-Token anlegen
Einmalig in app.kommunal.es, gilt für alle CMS-Systeme
app.kommunal.es öffnen & anmelden
Mit Ihren Administrator-Zugangsdaten einloggen.
Einstellungen → Integrationen → CMS-Connectors
Klicken Sie auf „Neuen Connector anlegen" und wählen Sie Ihr CMS.
Token erzeugen & sicher speichern
Der Token (z. B.
kc_live_a3f9b2e1…) wird nur einmal angezeigt. Er kann jederzeit widerrufen werden.
- Website öffentlich erreichbar (kein Passwortschutz, keine IP-Sperre)
- HTTPS (TLS) auf Ihrer Website aktiv
- RSS-Feed oder REST-API nicht durch Sicherheits-Plugin deaktiviert
Anleitung nach CMS-System
Rufen Sie diese URL im Browser auf: Sie sollten JSON-Daten Ihrer Beiträge sehen:
https://www.ihre-gemeinde.de/wp-json/wp/v2/posts?per_page=3Tragen Sie in app.kommunal.es → Integrationen → WordPress ein:
Endpoint-URL: https://www.ihre-gemeinde.de/wp-json/wp/v2/posts Connector-Token: kc_live_XXXXX (aus Schritt oben) Abrufintervall: 15 Minuten Authentifizierung:Keine (öffentliche API)
Sollen nur Beiträge einer bestimmten Kategorie importiert werden, ermitteln Sie zuerst die ID:
# Alle Kategorien abrufen: https://www.ihre-gemeinde.de/wp-json/wp/v2/categories # Endpoint mit Filter (Beispiel: ID 5): https://www.ihre-gemeinde.de/wp-json/wp/v2/posts?categories=5
Klicken Sie in app.kommunal.es auf „Verbindung testen". Ein grünes Häkchen bestätigt den erfolgreichen Abruf.
Prüfliste WordPress
- /wp-json/wp/v2/posts gibt JSON-Antwort zurück
- Permalink-Struktur ist auf „Beitragsname" gesetzt
- Endpoint-URL in kommunal.es eingetragen & getestet
- Kategorie-Mapping bei Bedarf konfiguriert
Im Joomla-Backend: System → Globale Konfiguration → Site-Tab → Feed-Einstellungen. Stellen Sie sicher: „Feed aktivieren" steht auf Ja.
https://www.ihre-gemeinde.de/index.php?format=feed&type=rss # Für eine bestimmte Kategorie (ID aus dem Backend): https://www.ihre-gemeinde.de/index.php?option=com_content &view=category&id=12&format=feed&type=rss
Connector-Typ: Joomla RSS Feed-URL: https://www.ihre-gemeinde.de/index.php?format=feed&type=rss Connector-Token: kc_live_XXXXX Abrufintervall: 15 Minuten
Klicken Sie in app.kommunal.es auf „Verbindung testen". Ein grünes Häkchen bestätigt den erfolgreichen Abruf.
Prüfliste Joomla
- RSS-Feed in globaler Konfiguration aktiviert
- Feed-URL öffnet gültiges XML im Browser
- Kein Sicherheits-Plugin blockiert externe Zugriffe
- Feed-URL korrekt in kommunal.es eingetragen
EXT:news erzeugt automatisch einen RSS-Feed sobald ein Listenansicht-Plugin auf einer Seite eingebunden ist:
https://www.ihre-gemeinde.de/?type=9818 # Mit Storage-PID (bei mehreren News-Bereichen): https://www.ihre-gemeinde.de/?type=9818&tx_news_pi1[storagePage]=42
# Web → Template → Setup (nur für Feed-Condition!): plugin.tx_news.settings { format = json } # Zugriffs-URL: https://www.ihre-gemeinde.de/?type=9818&format=json
TYPO3-Installationen mit strengem Caching können den Feed beim ersten Abruf leer ausliefern.
# Web → Seiten → Feed-Seite → Reiter „Verhalten" # Cache → „Kein Seiten-Cache" aktivieren # Alternativ per TypoScript (nur für Feed-Seite!): [traverse(request.getQueryParams(), 'type') == 9818] config.no_cache = 1 [end]
Connector-Typ: TYPO3 / RSS Feed-URL: https://www.ihre-gemeinde.de/?type=9818 Connector-Token: kc_live_XXXXX Abrufintervall: 15 Minuten
Prüfliste TYPO3
- EXT:news installiert & Listenansicht-Plugin vorhanden
- ?type=9818 öffnet gültiges XML im Browser
- Cache der Feed-Seite deaktiviert
- Storage-PID korrekt (bei mehreren News-Bereichen)
- Feed-URL in kommunal.es eingetragen & Test erfolgreich
Kategorien zuordnen
Ihre CMS-Kategorien → kommunal.es-Kategorien
| Ihre CMS-Kategorie | kommunal.es | Verwendung |
|---|---|---|
| Bekanntmachungen | announcements | Ausschreibungen, Satzungen |
| Veranstaltungen | events | Termine, Feste, Bürgerversammlungen |
| Rathaus Aktuell | news | Allgemeine Infos |
| Warnung / Störung | alerts | Wasser, Straßensperrungen |
| (nicht zugeordnet) | news | Standard-Fallback |