Configurer un import récurrent
La page des imports récurrents liste tous les imports qui sont configurés sur l'instance.
Visualisation d'un import
On peut visualiser un import déjà fonctionnel:
Édition d'un import
L'interface d'édition d'un import existant ou de la création d'un nouvel import est identique. Elle permet de configurer cet import:
En particulier, on sera soigneux à décrire:
- le nom de l'import (car il apparaît publiquement sur la page
à proposde l'instance) - le processeur, correspondant à un grand nombre de formats d'entrée de sites internet
- le téléchargeur, qui est soit simple, soit qui utilise un chromium pour se faire passer pour un humain auprès des sites, voire même qui simule des pauses pour laisser le temps au site de se charger
- la source, telle qu'elle sera récupérée par le téléchargeur, qui à son tour transmettra le contenu de la page au processeur
- l'url navigable, présentée à l'utilisateur si nécessaire
- le statut des événements lorsqu'ils sont récupérés par l'importeur (publié ou en brouillon)
- la localisation (sous forme de texte libre) si tous les événements de cette source se déroulent au même endroit, et que les événements récupérés ne fournissent pas d'information de lieu
- l'organisation, la catégorie et les tags par défaut (en plus de ceux qui seront récupérés par le processeur d'import)
Quelques points importants à considérer
Certains processeurs (comme celui destiné à Facebook par exemple) ne fonctionnent que si on choisi d'utiliser le téléchargeur chromium.
Le téléchargeur Chromium est plus lent et prend plus de RAM que le téléchargeur simple.
Certaines sources nécessitent des clés d'API, qui sont décrites dans le fichier .env. En particulier:
- Pour EchoSciences, on doit définir un token: ECHOSCIENCES_TOKEN
- Pour HelloAsso, on doit définir un ID et un secret: HELLOASSO_ID et HELLOASSO_SECRET
Cas particuliers
Certains imports nécessitent quelques explications.
Ical
Il existe plusieurs imports ical:
- ical: l'import standard
- ical sans busy: l'import qui ignore les événements avec un titre spécifique ("Busy", "Accueils bénévoles", "Occupé"), utile pour des lieux avec une organisation interne explicite
- ical sans description: l'import élimine les événements sans description
- ical sans VC: l'import qui nettoie des composants graphiques issus de l'outil de génération (
vc_column,vc_row, etc) - ical timezone naïve: si l'ical a des heures sans fuseau horaire, on considère que l'heure donnée est celle du fuseau horaire du serveur
et on trouve sur le dépôt pdl-extractors un exemple de processeur avec un filtrage qui ne prend que les événements avec une étiquette PDL.
L'adresse donnée à l'import facebook pour l'import récurrent est celui de sa page événements, par exemple https://www.facebook.com/clermontkizconnection/events.
Agenda trad
L'import pour l'agenda trad prend une adresse de la forme https://agendatrad.org/calendar/France/Auvergne-Rhone-Alpes/Puy-de-Dome, correspondant à la sélection d'un département spécifique.
HelloAsso
L'import des événements de HelloAsso prend une adresse de la forme https://www.helloasso.com/associations/neuf-x-sept, correspondant à la page d'une association.
Mobilizon
L'import des événements de Mobilizon prend une adresse de la forme https://mobilizon.fr/@attac63/events correspondant aux événements d'une association.