Différences entre versions de « Agendas Externes »

De WIKI-BOKEH
Aller à : navigation, rechercher
m
m (Changement de l'image de création)
Ligne 26 : Ligne 26 :
  
 
[[Fichier:external agenda.png]]
 
[[Fichier:external agenda.png]]
 +
  
 
== Ajout et Modification ==
 
== Ajout et Modification ==
  
[[Fichier:Cms external agenda add.png]]
+
[[Fichier:CMS Agenda Add.png|Ajout d'agenda]]
  
 
* '''Libellé''' : '''obligatoire''', nom du flux
 
* '''Libellé''' : '''obligatoire''', nom du flux

Version du 29 novembre 2019 à 13:01

Bokeh permet de gérer un agenda d'évènements en définissant des articles ayant des dates ou une périodicité d'évènement, voir la documentation.

Bokeh vous permet aussi de moissonner des agendas provenants d'autres portails sous forme d'articles.


Les formats supportés à ce jour sont :


La gestion des agendas externes est réservée aux administrateurs du portail.

Video.png Voir la démonstration

Liste[ ]

Dans l'administration rendez-vous dans le menu "Gestionnaire de contenu" > "Agendas externes".
Cms external agenda menu.png

La liste des agendas externes présente un bouton pour ajouter un nouveau flux ainsi que la liste des fluxs existants. Pour chacun, la liste présente

  • son libellé
  • le nombre d'évènements actuellement présents en tant qu'article dans Bokeh suivi du lien vers la suppression de tous les événements de l'agenda
  • l'adresse du flux
  • les liens d'action : moissonnage, édition et suppression

External agenda.png


Ajout et Modification[ ]

Ajout d'agenda

  • Libellé : obligatoire, nom du flux
  • Format : obligatoire (le type de flux)
  • URL : obligatoire, adresse de moissonnage, Pour Openagenda, c'est ici que vous vollez toute l'url de votre agenda au format json, avec tous les paramètres.
  • Catégorie racine : obligatoire, catégorie d'article dans laquelle importer les évènements de cet agenda. Si l'évènement définit une valeur pour son champ ical "CATEGORIES", une sous-catégorie est automatiquement créée.
  • Moissonage automatique : optionnel, pour savoir si le moissonnage automatique de l'agenda doit se faire
  • Supprimer les événements orphelins : optionnel, permet de supprimer les événements qui ont été créés automatiquement via cet agenda qui ne sont plus dans le flux exporté.
  • Catégorie racine : obligatoire, catégorie de rattachement des articles automatiquement créés (Ce sera souvent la catégorie Portail > Agenda ).
  • Lieu : optionnel, lieu de rattachement des articles (non géré et invisible dans le cas du format openagenda.
  • Statut : optionnel, statut de validation adopté par les articles, n'apparait que si le workflow est activé dans votre Bokeh

Suppression[ ]

Suppression des événements[ ]

La suppression des événements va supprimer tous les articles qui ont été générés via l'import de l'agenda spécifié, ainsi que toutes les catégories ne contenant plus d'articles dans le répertoire dédié à l'import.

External agenda delete events.png

Suppression de l'agenda[ ]

La suppression de l'agenda ne va pas supprimer les articles qui ont pu être créés lors du moissonnage. Une fois l'agenda supprimé il sera impossible de supprimer ces articles.

Moissonnage[ ]

Format[ ]

ICalendar[ ]

ICalendar est un format souvent utilisé par exemple dans les calendrier gmail, outlook et Lightning (calendrier thunderbird)

La spécification est accessible et doit être strictement respectée.

NB : Vous pouvez le vérifier dans un validateur.

OpenAgenda[ ]

OpenAgenda est un site dans lequel vous pouvez créer et gérer vos agendas de façon collaborative.

Bokeh moissonne les données au format JSON exporté par openagenda.

Pour créer un agenda, il faut créer votre utilisateur et activer votre compte openagenda.

Là, vous pouvez créer des agenda et des événements.

La documentation utilisateur openagenda vous permet d'avoir davantage d'information.

Pour connaître l'url que vous devez insérer dans bokeh, il faut consulter l'agenda.

Cliquer sur exporter.

Puis aller sur le bouton JSON, faire un clic gauche dessus et sélectionner copier la localisation (l'url).

Et aller la coller dans l'interface d'administration des Agendas Externes.


Tips:

  • Les événements futurs, tous les événements ou ceux mis en valeur peuvent être exportés dans des calendrier spécifiques.

Pour avoir plus d'information, plus de possibilité vous pouvez consulter la documentation openAgenda.

  • pour la liaison avec les lieux, OpenAgenda gère des listes de lieux, et Bokeh aussi. L'information pour relier un lieu OpenAgenda à un lieu Bokeh est sa géolocalisation (Latitude / Longitude) dans openstreetmap (préférez utiliser openstreetmap à google pour éviter tout décalage entre Bokeh et OpenAgenda).

Moissonnage : test[ ]

Un clic sur le lien de moissonnage d'un agenda enclenche un moissonnage immédiat.
Bokeh présente un rapport de moissonnage listant les titres des évènements créés et mis à jour.
Chaque titre est cliquable et affiche le formulaire de modification de l'article.

Cms external agenda import.png

Le moissonnage crée les nouveaux articles si nécessaires, et met à jour les articles qui ont déjà été importés si la Variable d'administration AGENDA KEEP LOCAL CONTENT est positionnée à 0.

Il supprime aussi les articles qui ne se trouvent plus dans le flux qui étaient précédemment importés si vous avez coché la case Supprimer les événements orphelins.

Moissonnage : automatisation[ ]

Démonstration vidéo:

Pour les agenda que l'on souhaite mettre à jour automatiquement il faut d'abord activer la mise à jour automatique en éditant l'agenda depuis la page des agendas externes. View external agendas.png

Cocher la case 'Moissonnage automatique'.

Harvest agenda activate.png

Activer ensuite le moissonnage depuis l'écran des batchs.

Batch select task.png

Harvest external agenda.png

Bloquer l'écrasement des articles[ ]

Par défaut, lors d'un moissonnage, les articles déjà importés sont systématiquement écrasés par la nouvelle mise à jour.

Si vous souhaitez modifier les articles importés et bloquer l'écrasement lors des prochains moissonnages, il faut aller dans les variables et activer "AGENDA KEEP LOCAL CONTENT"

Agendakeep.png


Suppression[ ]

La suppression d'un agenda externe n'entraîne pas la suppression des évènements déjà importés à partir de cet agenda.

Démonstration de la fonctionnalité[ ]