Connecteur OClocher — Import des actualités

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

À quoi ça sert

Beaucoup de diocèses et paroisses communiquent déjà sur OClocher. Pour éviter de ressaisir les actualités dans Isi-APP, le connecteur OClocher récupère automatiquement les publications d'une organisation OClocher (articles et événements) et les crée comme actualités dans le portail Isi-APP.

Chaque actualité importée est marquée d'une source d'entrée (OClocher), 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 OClocher et l'installer (gratuit, installation en un clic). Une instance est créée dans Mes connecteurs.
2. Configurer l'instance :
   • Identifiant de l'organisation (organization_id) : l'identifiant de la paroisse / diocèse côté OClocher (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é

Les autres types de publications (intentions, horaires…) sont ignorés.

Comportement de la synchronisation

• Sans doublon : une publication déjà importée est mise à jour, pas recréée (correspondance par identifiant OClocher).
• Mises à jour : si une publication change côté OClocher, l'actualité liée est mise à jour.
• Désactivation : si une publication est désactivée côté OClocher, l'actualité liée est archivée dans Isi-APP.
• Date de publication = date de la synchronisation (et non la date de la publication OClocher) : l'actualité est publiée immédiatement. La date OClocher 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.
• 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…). Une colonne Source est également disponible à l'affichage et à l'export.

Les actualités issues d'un connecteur portent une pastille de provenance (« OClocher », « Venio ») 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. Au moins une source doit être cochée ; les widgets existants conservent la source qui était sélectionnée. On peut donc soit placer côte à côte un widget des actualités internes et un widget des actualités importées du diocèse, soit n'avoir qu'un seul widget mélangeant les deux flux (la pastille de provenance distinguant l'origine).

Limites connues (V1)

• L'API OClocher ne fournit ni pagination ni filtre par date : toutes les publications de l'organisation sont parcourues à chaque synchronisation (le delta est géré côté Isi-APP).
• L'organization_id se saisit manuellement (l'API n'expose pas de hiérarchie diocèse → paroisse).

Voir aussi

• Documentation technique : .claude/technical-docs/store/oclocher.md
• Cahier des charges Store : docs/store/store-connectors-spec.md