Connecteur Venio — Import des événements

Catégorie Store : Widgets / Contenu · Sens : entrant (Venio → Isi-APP) · Coût : gratuit

À quoi ça sert

Venio est une plateforme française de billetterie et de gestion d'événements, utilisée notamment par des diocèses pour leurs pèlerinages et rassemblements. Pour éviter de ressaisir ces événements dans Isi-APP, le connecteur Venio récupère automatiquement les événements publics d'un organisateur Venio et les crée comme actualités de type Article dans le portail Isi-APP, avec un lien vers la page d'inscription.

Chaque actualité importée est marquée d'une source d'entrée (Venio), ce qui permet de la distinguer des actualités créées manuellement dans Isi-APP (Isi-APP) et de filtrer par provenance.

Mise en place

1. Store → Catalogue : ouvrir la fiche du connecteur Venio et l'installer (gratuit, installation en un clic). Une instance est créée dans Mes connecteurs.
2. Configurer l'instance :
   • Identifiant de l'organisateur (vendor_slug) : le slug de l'organisateur côté Venio, visible dans l'URL de sa page publique (obligatoire).
   • Entité de rattachement (idc) : l'entité Isi-APP à laquelle attacher les actualités importées (par défaut, l'entité courante).
   • Synchronisation : déclencheur manuel ou planifié + fréquence.
3. Synchroniser : manuellement (bouton) ou automatiquement selon la fréquence choisie.

Ce qui est importé

Seuls les événements en visibilité Publique de l'organisateur sont exposés par Venio et donc importés (les événements privés/brouillons ne sont jamais récupérés).

L'actualité créée est toujours de type Article.

Comportement de la synchronisation

• Sans doublon : un événement déjà importé est mis à jour, pas recréé (correspondance par identifiant Venio, le subdomain).
• Date de publication = date de la synchronisation (et non la date de l'événement) : l'actualité est donc publiée immédiatement, même pour un événement qui se déroulera dans plusieurs mois. La date de l'événement reste affichée comme date de l'actualité.
• Visible sur la page d'accueil par défaut : les actualités importées arrivent avec « Afficher sur la page d'accueil » activé.
• Vos réglages sont respectés : si vous retirez une actualité importée de la page d'accueil, changez sa date de publication ou activez son partage, une synchronisation ultérieure ne rétablit pas les valeurs d'origine (même si le contenu de l'événement a changé entre-temps).
• Mises à jour : si le contenu d'un événement change côté Venio, l'actualité liée est mise à jour.
• Pas d'archivage automatique : contrairement au connecteur OClocher, la disparition d'un événement de la liste Venio (terminé, dépublié…) ne déclenche aucune action — Venio n'expose pas d'indicateur de désactivation. L'actualité reste en l'état ; son archivage, le cas échéant, doit être fait manuellement.
• Une actualité archivée manuellement n'est jamais ressuscitée par la synchronisation.
• Chaque synchronisation est tracée (succès / erreurs, compteurs) dans les logs de l'instance.

Filtrer les actualités par source

Dans le module Actualités, un filtre Source permet d'afficher uniquement les actualités d'une provenance donnée (Isi-APP, OClocher, Venio…). Une colonne Source est également disponible à l'affichage et à l'export.

Les actualités qui proviennent d'un connecteur portent en plus une pastille de provenance (« Venio », « OClocher ») visible dans la liste des actualités, sur la fiche de l'actualité et dans les widgets du portail. Les actualités créées directement dans Isi-APP n'en portent pas.

Widgets « Actualités » du portail

Les widgets d'actualités (« Portail - Actualités » et « Vignettes X4 ») offrent un champ Sources des actualités dans leur configuration (admin widgets) : on coche une ou plusieurs provenances parmi Isi-APP, OClocher et Venio — un même widget peut donc mélanger les flux, la pastille permettant de distinguer l'origine de chaque actualité. Au moins une source doit être cochée. Les widgets existants conservent la source qui était sélectionnée.

Limites connues (V1)

• L'API Venio ne fournit ni pagination ni filtre par date : tous les événements publics de l'organisateur sont parcourus à chaque synchronisation.
• Aucun horodatage de mise à jour n'est exposé côté Venio : la détection des changements se fait par comparaison de contenu, pas par date.
• Aucun indicateur de désactivation : un événement qui disparaît de la liste Venio n'est jamais archivé automatiquement côté Isi-APP.
• Le vendor_slug se saisit manuellement (pas de recherche d'organisateur exposée par l'API).

Voir aussi

• Documentation technique : .claude/technical-docs/store/venio.md
• Connecteur miroir (comportement d'archivage différent) : docs/store/oclocher.md
• Cahier des charges Store : docs/store/store-connectors-spec.md