FAQ
Comment procéder pour installer un flux ?
- Demander un compte développeur (dev@culturoscope.ch);
- Vérifier que le CMS du site permette d’exporter les champs requis pour le flux;
- Créer le flux JSON sur le site de l’organisateur·trice et utiliser les outils de tests pour vérifier qu’il soit
conforme;
- Nous informer lorsque le flux est en place pour que nous l’attribuions au compte de l’organisateur·trice.
Comment fonctionne l’importation
Le culturoscoPe consulte à intervalle régulier le flux et importe les modifications et ajouts ou masque les événements effacés sur le site de l’organisateur·trice.
Les images des événements sont copiées sur le serveur du culturoscoPe et redimensionnées automatiquement pour garantir un affichage fluide.
Bonnes pratiques
Dans la mesure du possible, n’exportez que les événements à venir dans le flux, les événements importés antérieurement sont conservés dans la base de données du culturoscoPe.
Si le CMS le permet donnez le statut de publication « PRIVATE » aux événements non publiés et intégrez-les dans le flux de façon alimenter l’agenda prévisionnel (par défaut seul la localité et la catégorie de l’événement sont affichées dans l’agenda prévisionnel).
Une API est disponible pour récupérer les catégories, les labels, les statuts de dates et de publication de façon dynamique, si votre CMS le permet modifiez-le pour qu’il récupère ces informations, cela vous évitera de devoir effectuer des modifications lors de l’ajout de nouvelles valeurs de notre côté.
Remarques
- Le flux est considéré comme la source la plus fiable: l’organisateur·trice ne peut dès lors plus modifier les événements via son compte sur le culturoscoPe, mais doit effectuer les corrections sur son propre site. De même, la modération peut uniquement modifier l’image et le crédit photo s’il devait y avoir un problème de qualité ou de cadrage avec le visuel) ou masquer l’événement (dans le cas où celui-ci aurait déjà été annoncé par un·e autre organisateur·e ou ne serait pas conforme à la ligne éditoriale du culturoscoPe);
- Le champ de description de l'événement accepte les balises a, p, b, strong, u, li, hr, br ainsi que les liens;
- Le label « AG Culturel » est attribué aux organisateurs·trices et n’est donc pas inclus dans le flux.