Skip to content

jan-erbert/je-kalender-plugin

Repository files navigation

JE Kalender

Autor: Jan Erbert
Lizenz: MIT
Requires at least: WordPress 5.8
Tested up to: 6.5
Tags: kalender, google calendar, leaflet, veranstaltungen, events, karte


📋 Beschreibung

JE Kalender ist ein WordPress-Plugin zur einfachen Einbindung eines öffentlichen Google Kalenders auf deiner Webseite – ergänzt um eine optisch ansprechende Eventliste mit Filter- und Kartendarstellung via OpenStreetMap (Leaflet) oder optional Google Geocoding.

Ideal für Vereine, Organisationen oder Gruppen, die Veranstaltungen auf einfache Weise veröffentlichen möchten.


🚀 Features

  • ✅ Anzeige kommender Events aus einem Google Kalender
  • 🔍 Suchfunktion & Kategoriefilter
  • 🗂 Unterstützung von Event-Kategorien via [Kategorie1, Kategorie2]
  • 🗺 Leaflet-Integration für Kartenanzeige (OpenStreetMap)
  • 🗺 Alternativ: Google Geocoding API für präzisere Standortauflösung
  • 🔐 Datenschutzkonforme Karteneinbindung mit Nutzer-Zustimmung
  • 📱 Responsives Design
  • 🛠 Admin-Seite mit Einstellung für:
    • Google Kalender-ID
    • Google API Key (für Kalenderdaten)
    • Wahl zwischen OpenCage oder Google Geocoding
    • Je nach Auswahl: API Key für OpenCage oder Google Geocoding
  • 🔧 Fallback über wp-config.php für API Keys

🧩 Shortcodes

🔹 Standard-Kalender

[google_calendar]

→ Zeigt alle kommenden Events, durchsuch- und filterbar

🔹 Gefilterter Kalender (z. B. Leichtathletik)

[google_calendar_filtered category="leichtathletik" max="3"]

→ Zeigt nur Events mit passender Kategorie, maximal 3 Einträge


🗺 Kartenanzeige

Die Standort-Karten werden nur geladen, wenn ein Event geöffnet wird und der Nutzer aktiv zustimmt.
Je nach Auswahl im Backend erfolgt das Geocoding über OpenCage (kostenlos) oder Google Maps Geocoding API (deutlich präziser, ggf. kostenpflichtig -> Anfragen Limit beachten!).


🧪 ToDos für nächste Versionen

  • ⏳ Fallback bei fehlgeschlagenem Geocoding (Google Maps-Link?)
  • ⏳ Gutenberg Block für Kalender
  • ⏳ Caching von Geokoordinaten zur Performance-Optimierung

📝 Lizenz

MIT License – frei für private und kommerzielle Nutzung.


🤝 Mitwirken

Du hast eine Idee, einen Bug gefunden oder möchtest helfen?
Issue erstellen