=== Microtango ===

Microtango WordPress-Integration.

Dieses Plugin erfordert ein Microtango-Abonnement. Es lädt Daten über die Microtango REST API und stellt sie über Shortcodes auf deiner Website dar.

Mindestanforderungen: WordPress 4.1+ und PHP 7.0+.

Hinweis: Die JavaScript-Bibliothek wird zusammen mit dem Plugin ausgeliefert (kein Laden von externen CDN-Skripten).

== Beschreibung ==

Microtango integriert die Microtango REST API in WordPress.

== Funktionen ==

* Stellt vier Shortcodes bereit: **mt_courses**, **mt_reservation**, **mt_video** und **mt_form**.

== Verwendung ==

[mt_courses]
oder
[mt_courses webcategory="WTP2"]
oder
[mt_courses webcategory="WTP2" orderby="StartWeekday, Name"]
oder
[mt_courses webcategory="WTP1"]Kursname|{{Subject}} ({{Name}})#Tag / Zeit|{{StartWeekdayText}} {{Timespan}}#Startdatum|{{StartDateText}}#|{{AttendButton}}[/mt_courses]
oder
[mt_courses webcategory="WTP1"]Kursname|{{Subject}} ({{Name}})#1. Termin|{{DatesText.[0]}}#2. Termin|{{DatesText.[1]}}#3. Termin|{{DatesText.[2]}}#|{{AttendButton}}[/mt_courses]

[mt_reservation]

[mt_video]
oder
[mt_video videogroup="GK"]

== mt_courses Parameter ==

* mtattendform (optional): Verwendet das integrierte Microtango-Anmeldeformular. Werte: `popup` (Standard) oder `standalone`.
* webcategory (optional): Webkategorie-Filter.
* orderby (optional): Sortierreihenfolge.
* template (optional): `1-9`, wählt eines der zusätzlichen Templates.
* templateid (optional): ID des HTML-Templates.
* category (optional): Kategorie-Filter.
* attendurl (optional): URL für das Anmeldeformular.

Inhalt `[mt_courses] ... [/mt_courses]`:
Definiert die Tabellenspalten im Format:
`Spaltentitel | {{FieldName}}#Spaltentitel | {{FieldName}}`

Standard:
Kurs|{{Subject}}#Start|{{StartDateText}}#Von|{{Timespan}}#Stunden|{{RepeatCount}}#Verfügbarkeit|{{AvailabilityText}}#|{{AttendButton}}

FieldName:
Werte aus der Microtango REST API (https://api.microtango.de/swagger -> RESTCourseModel).

Spezialfelder:
* Attend: Erzeugt den Anmeldelink.
* AttendButton: Erzeugt einen Anmeldebutton (inkl. Buchungsinfo).
* ScheduleInfo: Zeigt ein Popup mit dem Stundenplan.

== mt_reservation ==

Zeigt das Online-Reservierungsformular für Kunden.

== mt_video ==

Zeigt die verfügbaren Videos für Kunden.

Beispiel:
[mt_video videogroup="GK"]
[mt_video videogroup="GK", videoPublic=true]

== mt_form Parameter ==

* restkey: Microtango REST Key.
* formid (optional): ID des zu verwendenden Formulars (Standard: das Formular direkt vor `[mt_form]`).
* redirecturl (optional): URL, zu der nach dem Absenden weitergeleitet wird.
* testmode (optional): Wenn `true`, wird keine Registrierung durchgeführt. Stattdessen werden die gemappten Werte als HTML-Seite zurückgegeben.

Inhalt `[mt_form] ... [/mt_form]`:
Feldmapping im Format:
`RESTApi-Feld=Formularfeldname#RESTApi-Feld=Formularfeldname`

Formularfeldname:
Siehe Browser-Entwicklertools (F12).

RESTApi-Feld:
Werte aus der Microtango REST API (https://api.microtango.de/swagger -> OnlineRegistrationModel).

Beispiel:
[mt_form restkey="ABCDEFGH" redirecturl="/" testmode="true"]subject=wpforms[fields][3]#course=wpforms[fields][4]#firstname=wpforms[fields][0][first]#lastname=wpforms[fields][0][last]#email=wpforms[fields][1][/mt_form]

== Installation ==

* Plugin über die WordPress Plugin-Suche installieren und aktivieren.
* Einstellungen im WordPress-Admin unter **Tools** -> **Microtango** öffnen.

Manuelle Installation:

1. Den Ordner `microtango` nach `/wp-content/plugins/` hochladen.
2. Plugin über das Menü **Plugins** aktivieren.