Integration mit dem WordPress-Modul

Wenn Ihre Website das Open-Source-CMS WordPress verwendet, stellen wir Ihnen ein Plugin zur Verfügung, das Ihnen Folgendes ermöglichtüber eine starke Integration verfügen, ohne unsere API implementieren zu müssen was Ihnen wertvolle Zeit spart. Sie werden auch die Möglichkeit haben, die Veranstaltungsblätter direkt in WordPress zu importieren, was zusätzlich Folgendes ermöglichtdie vom CMS bereitgestellten Suchfunktionen zu nutzen und das erneute Implementieren eines Importeurs zu vermeiden aus Ihrer Programmierungsdatenbank oder geben Sie Ihre Ereigniskarten erneut ein.

Installation

Sie können unser Plugin ¹ direkt über den Plugin-Manager von WordPress installieren, indem Sie nach „Ticketack“ suchen; nach der Installation müssen Sie es noch über den Plugin-Manager aktivieren.

Gehen Sie dann in die Verwaltung der Permalinks und klicken Sie einfach auf „Speichern“, um die neuen, vom Plugin bereitgestellten Permalinks zu speichern.

Aktualisierungen

Bevor Sie ein Update des Plugins oder Themas durchführen, überprüfen Sie Folgendes dass Sie richtig gehandelt haben eine Sicherung Ihrer Installation vollständig von WordPress durch das Lesen des changelog zur Verfügung gestellt, damit jeder Regression, inkompatible Änderung oder Installation von Funktionen nicht gewollt vermieden wird.

Nehmen Sie besondershüte dich vor Themenaktualisierungen die Ihre Layoutanpassungen löschen können.

Konfiguration

Das Ticketack-Plugin muss so konfiguriert sein, dass es mit Ihrem Ticketbüro kommunizieren kann.

Gehen Sie dazu in denEinstellungen > Ticketack (Registerkarte API)des Administrationsbereichs Ihres WordPress und füllen Sie die folgenden Felder mit den von Net Oxygen bereitgestellten Informationen aus:

• URL der Engine
• API-Schlüssel

Zahlungsarten aktivieren

Das Ticketack-Plugin bietet Ihnen in den Einstellungen zwei Buchungsmodi an -> ticketack -> checkout:

1. Reservierungen zulassen (Reservierung ohne Online-Zahlung).
2. Käufe zulassen (Kauf mit Online-Zahlung).

Erstellung von Musterseiten

Um die Inhalte des Online-Shops direkt auf Ihrer WordPress-Website anzuzeigen, müssen Sie Musterseiten (aus der Basisfunktionalität „Seiten“ von WordPress) erstellen, die einen bestimmten Shortcode aufnehmen werden.

Je nach Ihrem Anwendungsfall sollten Sie folgende Seiten erstellen :

• Programm (verwenden Sie den Shortcode [tkt_program][/tkt_program])
• Warenkorb (verwenden Sie den Shortcode [tkt_cart][/tkt_cart])
• Verkauf von Abonnements (verwenden Sie den Shortcode [tkt_buy_pass][/tkt_buy_pass])
• Artikel verkaufen (verwenden Sie den Shortcode [tkt_shop][/tkt_shop])
• Bestätigung des Kaufs eines Artikels (verwenden Sie den Shortcode [tkt_checkout][/tkt_checkout])
• Danke-Seite (verwenden Sie den Shortcode [tkt_thank_you][/tkt_thank_you])
• Anmelden mit einem Konto und/oder einem Ticket (verwenden Sie den Shortcode [tkt_user_login][/tkt_user_login] und/oder [tkt_ticket_connect][/tkt_ticket_connect])
• Ansicht eines Tickets und seiner Buchungen (verwenden Sie den Shortcode [tkt_ticket_view][/tkt_ticket_view])

Allgemeine Seiten ausfüllen

Sobald Sie die Musterseiten erstellt haben, können Sie sie dem Plugin aus dem BereichEinstellungen > Ticketack> Seiten.

Import von Veranstaltungen aus Ticketack

Um Inhalte anzuzeigen, müssen Sie zuerst die Events „aus Ticketack importieren“:

 

Artikel aus Ticketack importieren

Um zu haben der Artikel anzuzeigen in den Teil, in dem Artikel verkauft werden, müssen Sie zunächst „Aus Ticketack importieren“ die Artikel :

ACF-Felder für Page Builder (Divi, Elementor, Bricks…)

Bei aktivem Advanced Custom Fields registriert Ticketack lokale Feldgruppen und befüllt / überschreibt sie bei jedem Import. Ticketack bleibt die Quelle der Wahrheit.

CPTs : tkt-event, tkt-article, tkt-person.

Sichtbarkeit der ACF-Gruppen. Die Gruppen « Ticketack-Veranstaltung », « Ticketack-Artikel » und « Ticketack-Person » werden in PHP registriert (acf_add_local_field_group). Sie erscheinen in der Regel nicht (oder nicht editierbar) unter ACF → Field Groups — das ist Absicht. Sie sehen sie auf dem CPT-Bearbeitungsbildschirm (tkt-event usw.) und in Divi / Elementor über Dynamic Content → ACF. Legen Sie dieselbe Gruppe nicht manuell in der ACF-UI an (Duplikate / Konflikte).

Sprache der Labels. Admin-Labels folgen der WordPress-Oberflächensprache (gettext / tkt_t), nicht einem nativen ACF-Mehrsprachensystem. Die Werte (Titel, Beschreibung, Freitexte…) bleiben in der Sprache des Beitrags (WPML).

ACF Free vs ACF Pro

• ACF free covers most flat fields (text, URL, textarea, wysiwyg) — ideal with Divi / Elementor / Bricks Dynamic Content.
• ACF Pro schaltet Repeater frei (Bildlisten, Trailer, strukturierter Cast, Länder / Audio / Untertitel als Zeilen) — praktischer zum Schleifen in Buildern.

After enabling ACF, or after changing the image proxy (weserv) / images_dimensions (big_width / big_height), run an import again so URLs are recomputed and existing posts are backfilled.

When the image proxy is configured in the plugin, ACF image URLs go through tkt_img_proxy_url (“big” dimensions). Otherwise the raw URL is stored.

Internal ACF keys (field_tkt_…) are stable — do not rename them. Always use the field names below with get_field() or Dynamic Content.

Events — “Ticketack Event” (tkt-event)

Metadaten

Name	Type	Meaning
tkt_event_id	text	Ticketack id
tkt_event_title	text	Title in the WordPress / WPML post language
tkt_event_title_original	text	Original title
tkt_event_description	wysiwyg	Localised description
tkt_event_type	text	Type (e.g. movie, music_group, exhibition, drama, service)
tkt_event_sections	text	Sections (joined labels)
tkt_event_version	text	Unique screening versions (joined)
tkt_event_genre	text	Genre
tkt_event_duration	text	Duration
tkt_event_year	text	Year
tkt_event_countries	text	Countries (localised, comma-separated)
tkt_event_original_languages	text	Original languages
tkt_event_audio	text	Audio languages
tkt_event_subtitles	text	Subtitles
tkt_event_l_min_age	text	Legal min age
tkt_event_s_min_age	text	Suggested min age
tkt_event_a_min_age	text	Accompanied min age
tkt_event_free_text_1 … tkt_event_free_text_6	wysiwyg	Free texts 1–6 (localised)

Cast / Mitwirkende

Name	Type	Meaning
tkt_event_directors	text	Names filtered on director-like activities
tkt_event_cast	text	Other people (non-directors)
tkt_event_people	textarea	Full list: one “Activity Name” line per person
tkt_event_people_list	repeater (Pro)	Subfields tkt_event_people_row_activity, tkt_event_people_row_name

Medien — ACF Free

Ticketack image roles :

• poster — poster art
• banner — banner
• still — still / frame

Name	Type	Meaning
tkt_event_first_poster_url / _credits / _focal	url / text / text	Poster
tkt_event_first_banner_url / _credits / _focal	url / text / text	Banner
tkt_event_first_still_url / _credits / _focal	url / text / text	Still
tkt_event_poster_url	url	BC alias = tkt_event_first_poster_url
tkt_event_trailer_url	url	First trailer

Fokuspunkt (Focal point)

*_focal fields hold a CSS object-position value, e.g. 50% 25%.

object-fit: cover;
object-position: /* value from tkt_event_first_poster_focal, e.g. 50% 25% */;

In Divi Dynamic Content : Image module → dynamic URL → ACF tkt_event_first_poster_url.

Medien — JSON-Fallback (ACF Free)

Name	Type	Meaning
tkt_event_posters_json	textarea	JSON [{ role, url, credits, focal, lang }, …] (URLs already proxied when configured)
tkt_event_trailers_json	textarea	JSON [{ url, lang, image }, …]

For advanced integrators / custom PHP — not ideal for pure Divi Dynamic Content.

Repeater — ACF Pro

Name	Type	Meaning
tkt_event_posters	repeater	Subfields tkt_event_poster_row_role, _url, _credits, _focal, _lang
tkt_event_trailers	repeater	Subfields tkt_event_trailer_row_url, _lang, _image
tkt_event_people_list	repeater	Subfields tkt_event_people_row_activity, tkt_event_people_row_name
tkt_event_countries_list	repeater	One row = one country; subfield tkt_event_countries_row_label
tkt_event_audio_list	repeater	One row = one audio language; subfield tkt_event_audio_row_label
tkt_event_subtitles_list	repeater	One row = one subtitle; subfield tkt_event_subtitles_row_label

ACF Pro bevorzugen, sobald Sie in einem Builder über mehrere Elemente iterieren müssen.

Vorstellungen / Séances

Name	Type	Meaning
tkt_event_screenings_summary	textarea	Import-time text snapshot: one line date | place | version (version when present)

Useful to archive a page without live ticketing. Imports usually load only the future (or the configured edition) — a re-import may replace this summary.

Divi- / PHP-Beispiele

$poster = get_field('tkt_event_first_poster_url', get_the_ID());
$focal  = get_field('tkt_event_first_poster_focal', get_the_ID());
$directors = get_field('tkt_event_directors', get_the_ID());

1. Single tkt-event template in Divi Theme Builder.
2. Image module → dynamic content → ACF Field → tkt_event_first_banner_url or tkt_event_first_poster_url.
3. Text module → ACF Field → tkt_event_directors or tkt_event_description.

Artikel (tkt-article) und Personen (tkt-person)

• Article : tkt_article_id, tkt_article_short_description, tkt_article_category, tkt_article_stock_type, tkt_article_poster_url, tkt_article_variants_summary.
• Person : tkt_person_internal_id, tkt_person_country, tkt_person_profession, tkt_person_company, tkt_person_tags, tkt_person_photo_url.

WordPress-Import-Hooks

Immer verfügbar, mit oder ohne ACF. Order per post : save post → metas → ACF sync (if active) → ticketack_*_imported. End of batch (including empty runs) : *_import_completed.

Hook	Arguments
ticketack_event_imported	$post_id, Event model, $lang, $is_new
ticketack_article_imported	$post_id, Article model, $lang, $is_new
ticketack_person_imported	$post_id, person details, $lang, $is_new
ticketack_events_import_completed	$stats (imported, failed, trashed_duplicates)
ticketack_articles_import_completed	$stats (imported, failed)
ticketack_people_import_completed	$stats (imported, failed) via WP-CLI

add_action('ticketack_event_imported', function ($post_id, $event, $lang, $is_new) {
    // …
}, 10, 4);

People : wp ticketack:people import or wp ticketack:people async_import.

Verfügbare Shortcodes

Das Plugin ermöglicht Ihnen die Verwendung von shortcodes folgende auf Ihren Seiten :

Anzeige des Warenkorbs

[tkt_cart][/tkt_cart]

[tkt_cart hide_wallet="true"][/tkt_cart]

Attribut

Mögliche Werte

Standardwert

Beschreibung

theme	dark|light	light	Thema
hide_wallet	true|false	false	Blendet die E-Wallet-Zahlung im Warenkorb aus

Anzeige des Warenkorbsymbols

[tkt_cart_icon][/tkt_cart_icon]

Ein Ereignis anzeigen

[tkt_event][/tkt_event]

Pantaflix VOD anzeigen

[tkt_pantaflix_player id=“12345678-1234-1234-1234-123456789012″ pantaflix_id_prefix=“pantaflix_id_prod“]
Attributes :
id=’screening_id‘
pantaflix_id_prefix=’pantaflix_id_prod‘ (par défaut)

Anzeige des Formulars zum Einlegen von Buchungen in den Warenkorb

[tkt_booking_form layout=“form“ theme=“dark“ ids=“12345678-1234-1234-1234-123456789012″][/tkt_booking _ form]

Attributes :

Attribute	Mögliche Werte	Standardmäßiger Wert	Beschreibung
layout	form|screenings_list	form	Anzeigemodus
Thema	dark|light	light	Thema
ids	ID_place1,…2,…3,…		Liste der Sitzungs-IDs

Anzeige eines Programmteils

[tkt_program layout=“events“ order=“chrono“ xsection_ids=“18_noday“][/tkt_program]

Beschreibung der attribute :

Attribut	Mögliche Werte	Standardwert	Beschreibung
layout	screenings | events	screenings	Bietet die Möglichkeit, Sitzungen oder Filme anzuzeigen 2
Vorlage	list | grid | gallery	list	Legt die Art der Anzeige fest (vgl.: Auswahl des Templates)
item_width	12/nb_colonne_par_item	12	Legt die Anzahl der Spalten pro Item fest 3
order	chrono / alpha	chrono si layout=screenings alpha si layout=events	Legt die Sortierung chronologisch oder alphabetisch fest
section_ids	ID_section1,…2,…3,….		Nützlich, wenn man einen bestimmten Abschnitt auswählen will
xsection_ids	ID_section1,…2,…3,…		Nützlich, wenn man einen bestimmten Abschnitt ausschließen will
day	2020-12-1		Legt das Datum der anzuzeigenden Events oder Screenings fest.
tags	Tag1,..2,..3		Ereignisse nach Tags filtern
screening_section_ids	ID_sreenings1,..2,…3,…		Filtert den Abschnitt der anzuzeigenden Sitzungen
top_filter	Screenings | events		Legt den Filter zwischen Filmen oder Sitzung fest
Plätze	ID_salle1,..2 ,..3,…		Zeigt Veranstaltungen nach Räumen an
filter_fields	Label | value |…		Nach Ereignissen anhand einer Filtertabelle filtern

Beispiele für Templates :

– list : Listenansicht mit einem Bild und einer anschließenden Beschreibung wie unten.

– grid : Anzeige des Ereignisses oder des Screenings mit einem Bild und dem Text darunter, die Anzahl der Spalten wird durch das Attribut item_width definiert, das weiter unten beschrieben wird.

– gallery : Anzeige nur von Bildern.

9.8.6.Anzeige der nächsten Sitzung

[tkt_next_screening output=“title“ with_link=“1″ Plätze=“12345678-1234-1234-1234-123456789012″][/tkt_next_screening]

Attributes :

Attribute	Mögliche Werte	Standardmäßiger Wert	Beschreibung
output	title|date|time|datetime|venue|poster|url		Zeigt das ausgewählte Feld an
with_link	0 | 1	1	Anzeige mit Link
Plätze	ID_place1,…2,…3,…		Anzeige der Sitzungen nach Räumen

9.8.7.Filter

Filter pro Tag :

[tkt_days_filter][/tkt_days_filter]

Dieser Shortcode zeigt eine Leiste mit Filtern nach Tagen an und ermöglicht es, Sitzungen nach ihrem
Anfang.
Beschreibung der attribute :

Attribut	Mögliche Werte	Standardwert	Beschreibung
min_start_at	aaaa-mm-jj	Datum des Tages	Erster Tag der Filterleiste
max_start_at	aaaa-mm-jj	Datum des Tages	Letzter Tag der Filterleiste
nb_days	Anzahl_der_Tage		Anzahl der Tage in der Filterleiste4

Filterlinien :

[tkt_filter_rows row-hall=“Salle 1|Salle 2|Salle 3″ row-next-days=“7″][/tkt_filter_rows]

Beschreibung der Attribute:

Attribut	Mögliche Werte	Standardwert	Beschreibung
row-hall	Salle1 | Salle 2| Salle 3| …		Ermöglicht das Erstellen einer Filterlinie über Räume
row-next-days	7		Ermöglicht die Erstellung einer Filterlinie über die nächsten X Tage

Kauf von Abonnements

[tkt_buy_pass][/tkt_buy_pass]

Beschreibung der attribute :

Attribut	Mögliche Werte	Standardwert	Beschreibung
Typen	ID_type1,…2,…3,…		Wählt den oder die Abonnementtypen, die angezeigt werden sollen

Formular für die Anmeldungmit einer TicketID

[tkt_ticket_connect][/tkt_ticket_connect]

Dieser Shortcode benötigt keine Attribute

Formular zur Authentifizierung mit einem Nutzer

[tkt_user_login][/tkt_user _ login]

Dieser Shortcode benötigt keine Attribute

Bestätigung der Bestellung

[tkt_checkout][/tkt_checkout]

[tkt_checkout hide_wallet="true"][/tkt_checkout]

Attribut	Mögliche Werte	Standardwert	Beschreibung
Felder	Firstname, lastname,email,adress,…		Definiert die Felder, die der Benutzer beim Kauf eines Artikels ausfüllen muss.
theme	dark|light	light	Thema
hide_wallet	true|false	false	Blendet die E-Wallet-Zahlung im Warenkorb aus

Danke-Seite

Nach einer erfolgreichen Bestellung wird der Kunde auf die Danke-Seite weitergeleitet (konfiguriert unter Einstellungen > Ticketack > Seiten > Danke-Seite / Page de remerciement). Platzieren Sie dort den Shortcode:

[tkt_thank_you][/tkt_thank_you]

Der Shortcode lädt den abgeschlossenen Warenkorb (URL-Parameter cart_id und result werden am Ende des Checkouts automatisch gesetzt) und zeigt die Bestellübersicht sowie Download-Links für die Tickets.

Attribut	Mögliche Werte	Standardwert	Beschreibung
theme	dark|light	light	Thema

Shop anzeigen

[tkt_shop][/tkt_shop]

Beschreibung der Attribute:

Attribute	Mögliche Werte	Standardwert	Beschreibung
Modèle	list | grid | gallery	list	Définit le type d’affichage (cf. : sélection du modèle)
category_ids	ID_category1,…2,…3 ,…		Legt die Artikelkategorie(n) fest, die angezeigt werden soll(en).
item_width	12/nb_colonnes	12	Legt die Anzeigegröße von Artikeln fest.
hide_sorters	0 | 1	1	Zeigt die mögliche Sortierung an
only_in_stock	0 | 1	1	Wählt aus, ob verfügbare Artikel angezeigt werden oder nicht
nb	nb_tot_article_affiché	-1 (zeigt alle Artikel an)	Wählt die Gesamtzahl der Artikel, die angezeigt werden sollen
exclude	ID_article1,..2,..3,…		Artikel anhand ihrer ID ausschließen
sort	alpha | rev-alpha | incr_price | decr-price | random		Ermöglicht das Sortieren von Artikeln
show	0 | 1	0	Eine Paginierung erstellen
tkt_page	numéro_de_page	1	Legt die anzuzeigende Seitennummer fest
nb_by_page	nb_article_par_page	9	Legt die Anzahl der Artikel pro Seite fest.

Anpassen von Rendering und Stil

Wenn die Wiedergabe (visuell, angezeigte Informationen usw.) dershortcodes nicht gefällt, können Sie sie in Ihrem eigenen Design überladen.

Stilblatt (style.css)

Um das Aussehen Ihrer Website nach Belieben zu ändern, gehen Sie zu: Erscheinungsbild → Individuelle Gestaltung → CSS zusätzlich. Hier können Sie im CSS-Format den Stil schreiben, den Sie ändern möchten.

Überlastung beim Rendern von Shortcodes

Die ursprünglichen Templates für das Ticketack-Plugin finden Sie inwp-content/plugins/ticketack/app/templates/. Jeder der in diesem Verzeichnis enthaltenen Ordner verwaltet die Anzeige eines Shortcodes.

Um den Stil eines Teils Ihrer Website zu überladen erzeugt durchein des shortcodes zuvor beschrieben,brauchen Sie im Stammverzeichnis Ihres Themas einen Ordner anlegen ticketack sowie ein Dossier templatesim Inneren desselben.

Anschließend können Sie die Anzeige überladen mit einem shortcode durch Kopieren des entsprechenden Ordners von wp-content/plugins/ticketack/app/templates/ zu wp-content/themes/ [votre_theme] /ticketack/templates/ , und dann durch Bearbeiten der Dateien von templates ..

Hier ist eine umfassende Liste von Ordnern, die Sie überladen können:

• article : Ändert die Ansicht eines Artikels.
• booking : Ändert die Ansicht der Reservierungen.
• buy_article : Ändert die Kaufansicht eines Artikels.
• buy_pass : Ändert die Ansicht für den Kauf eines Abonnements.
• cart : Ändert die Ansicht des Einkaufswagens.
• checkout : Ändert die Ansicht der Bestellungsbestätigung
• event : Ändert die Ansicht eines Films.
• filter : Ändert die Filteransicht.
• next_screenings : Ändert die Ansicht der nächsten Sitzungen.
• people : Ändert die Ansicht
• program : Ändert die Ansicht des Zeitplans
• shop : Ändert die Ansicht des Shops.

Wichtig: Warnung bei Aktualisierungen Ihres Themas

Es wird dringend empfohlen, mit einem untergeordneten Thema zu arbeiten, damit Ihre Änderungen nicht verloren gehen des Stils bei Aktualisierungen des themas.

Ein untergeordnetes Thema ist ein Thema, das auf Ihrem übergeordneten Thema basiert. Er übernimmt alle seine Funktionen, ohne ihn jemals zu verändern. So können Sie Änderungen an Ihrem untergeordneten Thema vornehmen und im Falle einer Aktualisierung des übergeordneten Themas gehen diese nicht verloren!

Jede Datei, die im untergeordneten Design platziert wird und denselben Namen wie im übergeordneten Design hat, übernimmt die Oberhand und überschreibt die Originaldatei (außerfunctions.php).

Verwendung mit einem Cache-Plugin

Wenn Sie ein Cache-Plugin wie Comet Cache und die Bildproxy-Funktion verwenden, werden die Bilder aus Ticketack browserspezifisch optimiert und können in das WebP-Format umgewandelt werden, das von einigen Browsern nicht unterstützt wird. Daher müssen Sie Ihr Cache-Plugin so konfigurieren, dass es eine Version der Seiten für Browser, die dieses Format unterstützen, und eine Version für Browser, die es nicht unterstützen, generiert.

Konfigurationsbeispiel für Comet Cache Pro :

Erstellen eines dynamischen Versionssalts für den Comet-Cache :

(strpos( $_SERVER[‚HTTP_ACCEPT‘], ‚image/webp‘ ) !== false ? ‚webp‘ : “)