---
title: "Connecteur OClocher — Import des actualités"
module: store
type: functional
status: active
updated: 2026-07-30
---

# 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é

| Côté OClocher | Devient dans Isi-APP |
|---------------|----------------------|
| Publication `kind = article` | Actualité de type **Article** |
| Publication `kind = event` | Actualité de type **Événement** (avec date de fin) |
| Titre (`name`) | Titre de l'actualité |
| Contenu (`content`) / description | Corps + chapô |
| Image (`medias`) | Image de l'actualité |
| Date (création / début d'événement) | Date de l'actualité |

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`