Wordpress-API

Einführung in die MGVO-Integration mit Wordpress

Vereine, die ihre Verwaltung mit MGVO durchführen haben die Möglichkeit, die Daten aus MGVO auch einfach auf ihrer Webseite zu integrieren. Welche Daten hierbei angezeigt werden, kann individuell festgelegt werden. Für kritische Daten (z.b. die Mitgliederliste) ist ein besonderer Zugriffsschlüssel notwendig.

Typische Anwendungsfälle sind die Auflistung der angebotenen Gruppen oder die Liste der Veranstaltungen. Es können jedoch auch viele weitere Daten angezeigt werden, so das sich der Pflegeaufwand der Webseite deutlich reduziert und Redundanzen komplett vermieden werden.

Wir haben eine Wordpress-Seite zur Demonstration vieler der vorhanden Möglichkeiten aufgebaut.

Dokumentation der Wordpress-API

Unter wp.demoverein.de finden Sie eine ausführliche Beschreibung, Dokumentation zur Integration und Beispiele für die konkrete Anwendung der Wordpress-API.

Grundsätzliche Möglichkeiten für eine Integration sind:

• Verwendung des fertigen Wordpress-Plugins
  
• Nutzung der Sniplets (Funktionen, die HTML-Schnipsel erzeugen, die leicht in andere CMS oder direkt in PHP erstellte Seiten eingebunden werden können.
  
• Verwendung der API (PHP), die Daten als PHP-Arrray liefert.

Das Gute daran ist, das diese Funktionen aufeinander aufbauen, d.h. es ist möglich alles gemeinsam zu nutzen oder in den Sniplets kleine Anpassungen vorzunehmen und diese dann in Wordpress zur Verfügung zu haben (ohne Kentnisse über die Wordpress-Plugin-Programmierung zu haben).

Basis für alle Funktionen sind die JSON/XML-Schnittstellen von MGVO. Die MGVO-API ist separat zu installieren.

Installation

Die Installation des Wordpress-Plugins gestaltet sich, so wie bei allen Wordpress-Plugins sehr einfach. Das hier verlinkte ZIP-File in Wordpress unter "Plugins" - "Add new" - "Upload" (in der englischen Version) bzw. "Plugins" - "Installieren" - "Plugin hochladen" (in der deutschen Version) hochladen und dann aktivieren.

Als nächstes ist die MGVO Call-ID für ihren Verein zu hinterlegen. Diese ist eine 32-Stellige Zeichenfolge, die im System unter "System -> Basiseinstellungen -> Allg. Parameter", Verein angezeigt wird.
Zum Testen ist es durchaus zweckmäßig erstmal die Daten des Demovereins zu verwenden, diese lauten:

Call-ID: 9a052167eb8a71f51b686e35c18a665a
Secret: f4jd8Nzhfr4f8tbhkHGZ765VGVuj

Die Cache-Time (die Zeit die die Daten aus MGVO zwischengespeichert werden) wird typischerweise auf 5 min gesetzt. Bei geringeren Zeiten kann es passieren, dass MGVO bei einer zu hohen Abfragefrequenz aus Sicherheitsgründen die Schnittstelle abschaltet.

Shortcodes

Alles erstes kann nun eine neue Seite (Seiten - neu) erstellt werden, die Daten aus MGVO anzeigt. In Wordpress gibt es das die sogenannten Shortcodes. Diese werden immer in eckigen Klammern geschrieben.
Beispiel: [shortcode]

Es können dabei auch Parameter mit angegeben werden: [shortcode parameter1='wert' parameter2='wert']