Microtango integrates the Microtango REST API into WordPress.
Features include:
- Provides four shortcodes: mt_courses, mt_reservation, mt_video and mt_form.
Usage:
[mt_courses]
or
[mt_courses webcategory="WTP2"]
or
[mt_courses webcategory="WTP2" orderby="StartWeekday, Name"]
or
[mt_courses webcategory="WTP1"]Kursname|{{Subject}} ({{Name}})#Tag / Zeit|{{StartWeekdayText}} {{Timespan}}#Startdatum|{{StartDateText}}#|{{AttendButton}}[/mt_courses]
or
[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]
or
[mt_video videogroup="GK"]
mt_courses parameters:
- mtattendform (optional): Use the built-in Microtango attend form. Values:
popup (default) or standalone.
- webcategory (optional): Web category filter.
- orderby (optional): Sort order.
- template (optional):
1-9, selects one of the additional templates.
- templateid (optional): ID of the HTML template.
- category (optional): Category filter.
- attendurl (optional): URL for the attend form.
Content
[mt_courses] ... [/mt_courses]:
Defines the table columns in the format:
Column title | {{FieldName}}#Column title | {{FieldName}}
Default:
Kurs|{{Subject}}#Start|{{StartDateText}}#Von|{{Timespan}}#Stunden|{{RepeatCount}}#Verfügbarkeit|{{AvailabilityText}}#|{{AttendButton}}
FieldName:
Values from the Microtango REST API (
https://api.microtango.de/swagger -> RESTCourseModel). Possible values:
- Id: adea471d-d109-416f-9638-5362b490b37a
- Season: 21-1
- Name: 3TK-06
- Subject: Paare Tanzkreis Fr
- StartDate: 2021-01-01T00:00:00
- StartDateText: 01.01.2021
- StartTime: 20:30:00
- StartTimeText: 20:30
- StartWeekday: 5
- StartWeekdayText: Freitag
- StartMonthText: Januar
- EndDate: 2021-12-24T00:00:00
- EndDateText: 24.12.2021
- EndTime: 21:30:00
- EndTimeText: 21:30
- EndWeekday: 5
- EndWeekdayText: Freitag
- EndMonthText: Dezember
- Timespan: 20:30 - 21:30
- Length: 1 Stunde
- TimeCondition: wöchentlich 1 Stunde
- Price: 0
- PriceClub: 35
- PriceText: 35,00
- PriceTextFull: 35,00 € monatlich
- HallName: Großer Saal
- HallAddress: Testweg 1, 12345 Musterhausen
- TeacherName: Dr. Sch. Nitzel
- AssistantName: Ein Name
- ProgramName: Grundkurs 1
- Category: GK
- WebCategory: Grundkurs1
- Availability: G, Y or R
- AvailabilityText: Plätze verfügbar, Wenig Plätze verfügbar, Ausgebucht
- RepeatCount: 12
- SkipDays: 7
- WebNotes: Sonstige Informationen
- AttendFormShowPartner: true
- AttendFormShowLegalGuardian: false
- FreeText1, FreeText2, FreeText3, FreeText4, FreeText5, FreeText6, FreeText7, FreeText8, FreeText9
- DatesText.[x]: 04.05.2023 (x= 0 - RepeatCount)
-
Dates.[x]: 2023-05-04T18:00:00 (x= 0 - RepeatCount)
Special fields:
-
Attend: Generates the attend link.
- AttendButton: Generates an attend button (includes booked information).
- ScheduleInfo: Shows a popup with the timetable.
Example:
[mt_courses]
or
[mt_courses webcategory="WTP2"]
or
[mt_courses webcategory="WTP2" orderby="StartWeekday, Name"]
or
[mt_courses webcategory="WTP1"]Kursname|{{Subject}}{{Name}}#Tag / Zeit|{{StartWeekdayText}} {{Timespan}}#Startdatum|{{StartDateText}}#|{{Attend}}[/mt_courses]
mt_reservation:
Shows the online reservation form for customers.
mt_video:
Shows the available videos for customers.
Example:
[mt_video videogroup="GK"]
[mt_video videogroup="GK", videoPublic=true]
mt_form parameters:
- restkey: Microtango REST Key.
- formid (optional): ID of the form to use (default: the form directly before
[mt_form]).
- redirecturl (optional): URL to redirect to after the form post.
- testmode (optional): If
true, no registration is performed. Instead the mapped values are returned as an HTML page.
Content
[mt_form] ... [/mt_form]:
The field mapping in the format:
RESTApi field=Form field name#RESTApi field=Form field name
Form field name:
Use browser developer tools (F12).
RESTApi field:
Values from the Microtango REST API (
https://api.microtango.de/swagger -> OnlineRegistrationModel). Possible values:
Season, SeasonID, Course, CourseID: Will be set by the API in hidden fields.
FirstName, MiddleName, LastName, Gender, Street, Street2, ZIPCode, City, Birthday, Phone, Cell, EMail, AccountOwner, IBAN, BIC, Notes, PartnerFirstname, PartnerMiddlename, PartnerLastname, PartnerGender, PartnerStreet, PartnerStreet2, PartnerZIPCode, PartnerCity, PartnerBirthday, PartnerPhone, PartnerCell, PartnerEMail, PartnerAccountOwner, PartnerIBAN, PartnerBIC, PartnerNotes
Example:
[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]
Use the standard WordPress plugin search and installer.
Activate the plugin.
Open the Microtango settings page under the
Tools menu in the WordPress admin.
Manual Installation
- Upload the
microtango folder to the /wp-content/plugins/ directory
- Activate the plugin through the 'Plugins' menu in WordPress
0.9.31
- Fix: Load bundled JavaScript in the head.
0.9.30
- Security: Hardening against stored XSS via shortcode attributes (CVE-2026-1821).
- Compatibility: Bundle the JavaScript library with the plugin (no external CDN script loading).
0.9.29
0.9.28
- Bugfix for missing settings
0.9.27
- Bugfix for missing settings
0.9.26
- Optimization for preview of changes
0.9.25
- Add StartWeekday and EndWeekday as Number (1=Monday, 7=Sunday)
- Add orderby Parameter to mt_courses. E.g.[mt_courses orderby="StartWeekday, Name"] to sort by Weekday and then by Name.
0.9.24
- Add missing Dates.[x] (x= 0 - RepeatCount) to documentation
- Add missing DatesText.[x] (x= 0 - RepeatCount) to documentation
0.9.23
- Fix missing templates 2-9
0.9.22
- Add "Disabled" to the settings. Will disable the plugin, but still show the plugin in preview.
- Add additional 9 course templates to settings. The templates can used with the template parameter for mt_courses shortcut. E.g [mt_courses template=1].
0.9.21
0.9.20
- Add videoPublic parameter to video shortcode
0.9.19
- Fix missing RestKey for video
0.9.18
Small fixes
0.9.17
Small fixes
0.9.16
0.9.15
- Fallback to popup, if mtattendform is missing
0.9.14
- Reintroduce old attend link and add new attend button
0.9.13
0.9.12
- Bugfix for multi inline templates
0.9.11
0.9.10
0.9.9
- Add possible field to readme
0.9.8
- Translate setting defaults to german
0.9.7
- Translate setting defaults to german
0.9.6
0.9.5
- Fix for missing default value (load css, load template)
0.9.4
- Documentation update. Support for PartnerMandatory parameter
0.9.3
- Change cdn resource names
0.9.2
0.9.1
- Fix for Safari blocking 3rd party cookies
0.9.0
- Add online-reservation handling
0.8.3
0.8.2
0.8.1
- Missing course not found fix
0.8.0
0.7.0
0.6.0
0.6.0
- Include js and css
- JS handling for wp
0.4.0
- Add settings page
- Setting for API rest Key
- Setting for default list row settings
0.3.0
0.2.0
0.1.0