JEM embed

JEM Embed

JEM Embed

Das Plugin gibt JEM Events als JSON aus, was auf verschiedene Arten verwendet werden kann; z.B. zur Anzeige von JEM Events auf beliebigen externen Webseiten (siehe folgende Anleitungen).

Standard Ausgabe Parameter sind definiert in der Plugin Konfiguration hier. Die Parameter können ergänzt und angepasst werden durch Parameter in der Ausgabe URL.

Beispiel:
https://domain.com/index.php?option=com_ajax&plugin=jemembed&group=content&format=json&token=YOUR_SECURITY_TOKEN&max=10&venueids=1,2&category=2,3,5

Die Parameter
type=today|unfinished|upcoming|archived|newest
featured=on|off|only
title=on|link|off
date=on|link|off
time=on|off
enddatetime=on|off
catids=[durch Komma getrennte Kategorie ids]
category=on|link|off
venueids=[durch Komma getrennte Lokalitäts ids]
venue=on|link|off
max=n
cuttitle=n
noeventsmsg=[Mitteilungstext]

Verwendest Du mehr als einen Parameter, sind sie mit einem logischen AND kombiniert. Das bedeutet, dass nur Events angezeigt werden, die ALLE Bedingungen erfüllen.

Token: Sicherheits-tokens, um vor unerlaubten Abfragen zu schützen. Sie müssen in den Plugin-Einstellungen definiert werden.

Erklärungen:

n: eine positive Zahl
|: trennt wählbare Optionen
type=today: Heutige Events
type=unfinished: Kommende und laufende Events
type=upcoming: Kommende noch nicht begonnene Events
type=archived: Archivierte Events
type=newest: Zuletzt erstellte Events (Events mit den höchsten IDs)
max: max. Zahl angezeigter Events
cuttitle: max. Titel-Länge
noeventsmsg: Anzuzeigende Mitteilung, wenn keine solchen Events vorhanden

Wie JEM Events in eine externe Webseite einbinden:

  1. Downloaden und Dateien extrahieren
    Downloade die zip Datei jemevents.zip und extrahiere sei. Du erhältst die folgenden vier Dateien:
    • jemevents.php
    • jemevents.js
    • jemevents-example.html (Beispielseite, die zeigt wie einbinden funktioniert)
    • readme.txt (Instruktionen, wie man die Dateien verwendet)
  2. Dateien hochladen auf deinen Webserver
    Lade die Dateien jemevents.php und jemevents.js hoch in den Webspace der externen Webseite.
    Beachte: Die jemevents-example.html Datei ist optional und nur als Referenz.
  3. Konfiguriere Einstellungen
    Öffne die Datei jemevents.php und fülle im Konfigurationsbereich deine Bedürfnisse ein.
  4. Füge die JavaScript Datei hinzu
    Auf der Webseite, auf der die Events erscheinten sollen, füge die folgende Linie direkt vor dem schliessenden </body> Tag ein:
    <script src='/jemevents.js'></script>
  5. Füge den Kontainer für die Events hinzu
    Füge das folgende HTML Element an der Stelle in die Seite, wo die Events erscheinen sollten:
    <div id='jemevents-container'></div>