Exposer les évènements dans un formulaire

Les évènements peuvent être exposés dans un champ liste configuré pour utiliser une source de donnée.

Quelques minutes après la création d'un agenda évènements (ou après avoir cliqué sur « Actualiser les agendas » dans l'écran des sources de données), une source de données est disponible dans la liste des sources de données « Agendas ». Le champ présentera alors sous forme de liste déroulante le libellé des évènements.

{{agendas_url}}api/agenda/SLUG-AGENDA/datetimes/?min_places={{form_var_nombre_personnes}}

Lorsque l'on paramètre l'agenda, on peut choisir d'afficher d'autres informations dans la liste, en allant dans l'onglet « Paramètres d'affichage » pour configurer le gabarit d'affichage. Les variables suivantes sont utilisables dans le gabarit :

• {{ event.label }} : le libellé
• {{ event.start_datetime }} : date et heure de début
• {{ event.places }} :  le nombre total de places
• {{ event.remaining_places }} : le nombre de places restantes
• {{ event.duration }} : la  durée
• {{ event.pricing }} : le tarif
• {{ event.place }} : le lieu - attention, dans Chrono, cette variable n'est pas disponible lorsque le champ lieu utilise un modèle de fiches
• {{ event.custom_fields.foo }} : un champ avec un identifiant « foo » paramétré dans les types d'évènements utilisé par l'agenda.

Grâce au champ liste créé, il est également possible afficher dans un champs commentaire (ou d'utiliser ultérieurement dans le workflow), des informations comparables. Si le champ liste a pour identifiant « event » :

• Le libellé : {{ form_var_event_label }}
• La durée : {{ form_var_event_duration }}
• Le nombre de place restantes : {{ form_var_event_places_available }}
• L'info complet / pas complet : {{ form_var_event_places_full }}
• Places disponibles sur liste d'attente : {{ form_var_event_places_waiting_list_available }}
• La description : {{ form_var_event_description }}
• Le tarif : {{ form_var_event_pricing }}
• l'URL : {{ form_var_event_url }}
• le lieu :
  • cas où le champ Lieu de l'événement n'est pas lié à un modèle de fiches : {{ form_var_event_place }}
  • cas où le champ Lieu utilise un modèle de fiches comme source de données : différentes variables du modèle de fiche peuvent être utilisées, telles que {{ form_var_event_place_card_digest }}, ou par exemple, dans le cas où le modèle de fiche contient un champ Adresse, {{ form_var_event_place_card_fields_adresse }}.

Évènements récurrents

Il est possible d'exposer dans un formulaire les différents événements récurrents d'un agenda regroupés par leur libellé. Il faudra pour cela utiliser une URL JSON spécifique comme source de données du champ liste  avec le paramètre with_groups=True

{{ agendas_url }}api/agendas/recurring-events/?agendas=SLUG-AGENDA&with_groups=true

Par exemple, un agenda "cours de boxe" avec un événement récurrent "Boxe anglaise" le mardi et jeudi et un événement "Kickboxing" le mardi et jeudi on obtient l'affichage suivant :

Pointage

Il est possible de pointer les personnes qui se sont inscrites à un évènement et étaient présentes ou absentes.
Consultez la page Pointage des inscriptions à un évènement.