Configurer le calendrier

OpenDataSoft permet de créer simplement des calendriers à partir de jeux de données publiés sur la plateforme.

../../_images/calendar__result--fr.png

Un calendrier généré à partir d’un jeu de données contenant les événements disponibles sur OpenAgenda

Pré-requis pour les jeux de données

La vue calendrier considère chaque enregistrement du jeu de données comme un événement indépendant. Chacun de ces événements doit contenir un horaire de début et de fin ainsi qu’un titre. Ce qui signifie que le jeu de données doit contenir deux champs datetime et un champ texte pour que la vue calendrier soit disponible.

../../_images/calendar__processing-settings--fr.png

Configuration de deux colonnes en datetime

Les enregistrements sans titres seront affichés par le calendrier comme des événements vides, mais l’absence de l’horaire de début ou de celui de fin empêchera purement et simplement leur affichage.

Evénements sur un jour entier

La règle des deux champs datetime et du champ texte est certes simple, mais elle ne permet pas de configurer un événement comme durant une journée entière. Ces événements doivent donc être paramétrés comme commençant à minuit et finissant à minuit moins une seconde à la fin de la journée (de 00h00m00s à 23h59m59s).

Configuration

Activer la vue calendrier

Après avoir configuré deux des champs du jeu de données comme datetime et un troisième champ en texte, l’onglet calendrier devient disponible.

../../_images/calendar__tab-unavailable--fr.png

Onglet calendrier indisponible

../../_images/calendar__tab-available--fr.png

Onglet calendrier disponible

Cela ne signifie pas pour autant que la vue est paramétrée. Si elle devient disponible, elle n’est pas pour autant activée.

../../_images/calendar__checkbox--fr.png

Cette case active la vue calendrier pour le jeu de données

Paramétrage des événements

Une fois la vue calendrier activée, il faut s’assurer que les événements soient bien configurés. Par défaut ce sont le premier champ texte et les deux premiers champs datetime qui sont sélectionnés pour (respectivement) le titre, l’horaire de début et l’horaire de fin. Le dataset pouvant comporter de nombreux autres champs texte et/ou datetime, il faut sélectionner ceux qui déterminent les caractéristiques des événements.

C’est aussi dans cette section qu’il est possible de choisir la couleur utilisée pour le rendu des événements.

../../_images/calendar__event-default-settings--fr.png

Configuration par défaut pour ce calendrier. Les trois champs texte et datetime sont pré-sélectionnés mais incorrects.

../../_images/calendar__event-settings--fr.png

Configuration correcte

Paramétrage de l’infobulle

Dans la vue calendrier, cliquer sur un événement fait apparaître une infobulle contenant toutes les informations disponibles sur cet événement.

Calendar tooltip

Vous pouvez configurer l’infobulle exactement de la même manière que pour la carte ou les images.

Partage

Une fois le jeu de données correctement paramétré et publié, il est possible de partager la vue calendrier avec n’importe qui (sous réserve que celui-ci ait les droits nécessaires à la vue du jeu de données).

Il est bien évidemment toujours possible de copier/coller l’URL de la page depuis la barre d’adresse du navigateur, mais vous trouverez sous le calendrier 3 autres possibilités de partage.

  1. Partage de l’URL

../../_images/calendar__share--fr.png

Les 3 options de partage, avec en premier lieu l’URL

  1. Code HTML pour une intégration dans n’importe quelle page web

../../_images/calendar__embed--fr.png

Code HTML pour une intégration dans n’importe quelle page web.

  1. Code HTML pour l’intégration dans les tableaux de bords et pages personnalisées de la plateforme.

../../_images/calendar__widget--fr.png

Code HTML pour l’intégration dans les tableaux de bords et pages personnalisées de la plateforme