Een eventswidget op je website insluiten

Met een eventswidget toon je een lijst of kalender van meerdere events tegelijk op je eigen website — bijvoorbeeld alle komende data van één terugkerend event. Bezoekers kiezen een event en kopen tickets zonder je site te verlaten.

Een widget aanmaken

1. Ga in je dashboard naar Widgets en klik op Nieuwe widget.
2. Geef de widget een naam (alleen jij ziet die).
3. Kies welke events hij toont:
   • Alle komende events — alles wat gepubliceerd en in de toekomst is.
   • Events uit templates — alle komende events van de gekozen templates; nieuwe data verschijnen automatisch.
   • Handmatig geselecteerde events — precies de events die je aanvinkt.
   • Events op locaties — alle komende events op de gekozen locaties. Je kan de widget extra beperken tot een datumbereik, en een maximum aantal events instellen — bijvoorbeeld enkel de volgende 5 op datum.
4. Kies de weergave: een compacte lijst of een maandkalender. Op kleine schermen valt de kalender automatisch terug op de lijst.
5. Kies de standaardtaal (datums en labels voor bezoekers volgen die).
6. Kies onder Ticketpagina of de titel en/of datum van het event boven de tickets verschijnen zodra een bezoeker een event kiest. Handig bij een kalender, waar een dagvakje maar een korte vermelding toont.

Kleuren en styling

Onder Uiterlijk kan je de primaire kleur, achtergrondkleur en tekstkleur overschrijven en een hoekafronding kiezen. Alles wat je niet instelt erft je organisatiebranding. Gevorderde gebruikers kunnen eigen CSS toevoegen op de vaste class-namen uit het formulier (.ctx-widget, .ctx-event-card, .ctx-calendar, .ctx-day, .ctx-event-entry).

Op je website plaatsen

Kopieer na het opslaan het insluitfragment en plak het in de HTML van je website. Omdat het fragment enkel naar het widget-ID verwijst, kan je de events, weergave of styling later aanpassen zonder je website opnieuw aan te raken.

Shopwidgets

Met de functie Shop (Studio en Pro) kan een widget je shop tonen in plaats van events. Kies onder Type voor Shop en kies wat hij toont:

• Volledige shop — elk product dat te koop is, met de filterknoppen per categorie boven de producten als je categorieën gebruikt.
• Gekozen categorieën — vink één of meer categorieën aan, bijvoorbeeld alleen Merchandise op je merchpagina.

Elke productkaart toont de afbeelding, naam, prijs en beschikbaarheid met twee knoppen: Bekijken opent de productpagina en In winkelmandje opent je shop met het product al in het mandje. Beide openen in hetzelfde venster, waar de koper de bestelling afrondt en betaalt. Uitverkochte producten blijven zichtbaar met de badge Uitverkocht. Een shopwidget heeft dezelfde opties onder Uiterlijk, dezelfde standaardtaal en hetzelfde insluitfragment als een eventswidget; producten die je later toevoegt, verschijnen automatisch.

Widgets via de API of een plugin

Op het Pro-plan is elke widgetactie ook beschikbaar via de REST API: widgets opvragen, aanmaken, wijzigen en verwijderen, het insluitfragment uitlezen en de events ophalen die een widget toont. Dat is de basis voor website-integraties zoals een WordPress-plugin die widgets voor je plaatst. Zie API & webhooks.

Goed om te weten

• Alleen gepubliceerde, komende events verschijnen; voorbije events vallen er automatisch uit.
• Uitverkochte events blijven zichtbaar met een "uitverkocht"-badge.
• De ticketcheckout gebeurt binnen de widget — kopers verlaten je site nooit. Een shopwidget stuurt kopers naar je shop om te betalen.
• Toegangscodes werken ook in de widget: kopers kunnen ze ingeven, en een ?unlock=-link naar de pagina met je widget ontgrendelt daar de verborgen tickets.
• Voor één enkel event: zie de gids over de ingesloten checkout.