Event API Addon

Das Event API Addon ist ein leistungsstarkes Hilfsprogramm, das für Modern Events Calendar Dies ermöglicht die nahtlose Anzeige Ihrer Ereignisse auf externen Webanwendungen und Plattformen. Durch die Generierung von Skripten oder JSON-Dateien können Sie Ereignisdaten über mehrere Domänen hinweg synchronisieren, ohne sie manuell erneut eingeben zu müssen.

Ersteinrichtung & Anforderungen

Installation

Bevor Sie beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

Aktivierung: Navigieren Sie zum Menü Ihrer WordPress-Plugins und stellen Sie sicher, dass beides MEC und der Event API Addon sind aktiv.

MEC Lite oder Pro: Im Gegensatz zu manchen Add-ons, Event API Funktioniert mit beiden Versionen von Modern Events Calendar.

Verwendung der Event API

Sie können eine API entweder für eine bestimmte Gruppe von Veranstaltungen (über Shortcodes) oder für eine einzelne Veranstaltungsseite generieren.

Event API für Kurzcodes

So zeigen Sie eine bestimmte Kalenderansicht auf einer anderen Website an:

1. Navigieren MEC > Kurzwahlnummern.
2. Suchen Sie den gewünschten Shortcode und klicken Sie auf API erstellen.

Event API für einzelne Ereignisse

So zeigen Sie die Details einer einzelnen Veranstaltung auf einer anderen Website an:

1. Navigieren MEC > Alle Veranstaltungen.
2. Suchen Sie sich die gewünschte Veranstaltung aus und klicken Sie API erstellen.

Verwaltung des API-Hubs

Sobald Sie auf „API erstellen“ klicken, werden Sie zur Verwaltungsoberfläche weitergeleitet. Diese Seite ist in zwei Hauptabschnitte unterteilt:

Domänenverwaltung (linke Seite)

• Domänenautorisierung: Geben Sie die spezifische(n) Domäne(n) an, auf der/denen das Ereignis angezeigt werden soll. Sie können die API auch so konfigurieren, dass sie auf folgenden Domänen funktioniert: Alle Domänen.
• Zugriff entfernen: Um den Zugriff zu widerrufen, wählen Sie die Domäne(n) aus und klicken Sie auf die entsprechende Schaltfläche. Papierkorb-SymbolDadurch wird die API für diese spezifischen Standorte sofort deaktiviert.
• Abschließen: Klicken Sie immer auf Schaltfläche „Generieren“ sobald Ihre Domäneneinstellungen konfiguriert sind.

Datenextraktion (rechte Seite)

Auf der rechten Seite finden Sie die Werkzeuge, die Sie für Ihre Zielwebsite benötigen:

• Skriptfeld: Enthält ein Skript, das Sie in die Zwischenablage kopieren können. Verwenden Sie dieses, um den Inhalt direkt in den HTML-Code einer anderen Website einzubetten.
• JSON-Feld: Liefert Ereignisdaten im JSON-Format, ideal für Entwickler, die Rohdaten in eine benutzerdefinierte Webanwendung einbinden möchten.

Nachfolgend sehen Sie Beispiele der verwendeten API:

---

Profi-Tipp: Stellen Sie sicher, dass Ihr Hosting-Anbieter iFrames auf Ihrer Website aktiviert hat, da das Skript diese Funktionalität benötigt, um Inhalte korrekt anzuzeigen.

Globale Einstellungen & Anpassung

Globale Konfigurationsoptionen finden Sie unter MEC-Einstellungen > Einstellungen > Event API.

• Quellintegration: Sie können die Daten Ihrer Quellwebsite einbeziehen. Kopf-und Fußzeile in der Ausgabe der Zielwebsite.
• Ereignislimits: Um die Layoutkonsistenz zu gewährleisten, kann die Anzahl der im Shortcode angezeigten Ereignisse gesteuert werden.

Anwendungsfälle (Wann dieses Add-on nützlich ist)

• Plattformübergreifende Syndizierung: Ideal für Organisationen, die einen zentralen Veranstaltungskalender verwalten, aber auf Partner-Websites oder Subdomains spezifische Termine anzeigen müssen.
• Mobile App-Integration: Ideal für Entwickler, die die JSON-Format um Echtzeit-Ereignisdaten in eine native mobile Anwendung einzuspeisen.
• Zentrales Management: Nützlich für Agenturen, die mehrere Kundenseiten verwalten und eine Veranstaltung einmal zentral aktualisieren möchten, sodass die Aktualisierung überall sofort sichtbar wird.

Situationen, in denen dieses Add-on möglicherweise nicht ideal ist

• Host-Beschränkungen: Wenn Ihr Hosting-Anbieter dies strikt blockiert iframesDie Standard-Skriptmethode wird nicht funktionieren.
• Websites mit hoher Optimierung: Wenn die Zielseite aggressive Geschwindigkeitsoptimierungs-Plugins verwendet, können diese die externen Skriptlinks blockieren, die zum Laden der API erforderlich sind.
• Strikte Einhaltung der DSGVO: Drittanbieter-Cookie-Einwilligungs-Plugins auf der Quellseite können manchmal auch auf die Zielseite übertragen werden, was unter Umständen zusätzlichen technischen Anpassungsaufwand erfordert.

Fehlerbehebung für Anfänger

• Ereignisse werden nicht geladen? Wenn Sie Optimierungs-Plugins (wie WP Rocket oder Autoptimize) verwenden, müssen Sie „Externe Links“ ausschließen innerhalb dieser Plugins, damit das API-Skript nicht ignoriert wird.
• Skript funktioniert nicht? Überprüfen Sie noch einmal, ob Sie geklickt haben. Schaltfläche „Generieren“ nach dem Hinzufügen Ihrer Domains; andernfalls bleibt die API inaktiv.
• Formatierungsprobleme? Falls die Anzeige auf der neuen Website fehlerhaft aussieht, versuchen Sie, die … ein- und auszuschalten. Kopf-und Fußzeile Optionen in der Event API Einstellungen, um zu sehen, welche besser zum CSS des Ziels passt.

FAQ