e-bourgogne Annuaires

Pour de configurer un annuaire, vous devez vous rendre dans le panneau de configuration du plugin "e-bourgogne" (ou "e-bourgogne->Annuaires" si vous avez déjà installé un autre module e-bourgogne). Dans ce panneau, vous verrez l'outil de configuration, où vous pourrez créer des configurations ou en modifier des existantes. Pour créer une nouvelle configuration :

1. Cliquez sur "Nouveau" en haut de la liste à droite.
2. Choisissez un nom pour votre configuration ainsi qu'un annuaire.
3. Si vous le souhaitez, ajoutez l'URL d'une feuille de style CSS à appliquer à l'annuaire. Il également possible de définir une zone géographique afin de restreindre l'affichage des résultats de l'annuaire à cette zone (voir "A quoi sert la définition du zone géographique pour un annuaire").
4. Sauvegardez votre annuaire en cliquant sur "Enregistrer l'annuaire".

Avant de pouvoir afficher un annuaire, vous devez l'avoir configuré (voir "Comment configurer mes annuaires ?"). Lors de la création ou de l'édition d'un nouvel article (ou d'une nouvelle page), cliquez sur le bouton "Ajouter un annuaire" (situé au dessus de l'éditeur). Une fenêtre s'ouvre dans laquelle vous pouvez choisir l'annuaire préalablement configuré que vous voulez insérer dans votre page. Validez la sélection et enregistrer l'article. En visitant la page, vous devriez voir votre annuaire affiché. Attention, il est fortement déconseillé d'afficher plusieurs annuaires sur une même page.

Il est fortement déconseillé d'intégrer plusieurs annuaires sur une même page, que ce soit dans des articles différents ou dans un même article. Cela reste néanmoins possible, mais peut conduire à des comportements anormaux des annuaires.

Lorsque l'utilisateur consultera votre annuaire sur votre page, les fiches affichés par défaut seront restreintes à la zone géographique que vous aurez définie. Néanmoins, l'utilisateur reste par la suite libre de parcourir l'intégralité des fiches de votre annuaire via la carte ou l'outil de recherche de l'annuaire.

La clé d'API permettant d'accéder aux services e-bourgogne via les plugins doit vous être fournie par l'administrateur de votre organisme. Elle doit ensuite être renseignée dans le panneau de configuration du plugin e-bourgogne. Note : la clé est partagée par tout les plugins e-bourgogne ; si plusieurs plugins e-bourgogne sont installés, modifier la clé pour l'un d'entre eux la modifiera pour tout les autres également.

Lorsque vous affichez le panneau de configuration de votre plugin e-bourgogne, vous verrez un champ "Clé d'API" en haut de la page. Inscrivez-y votre clé, puis cliquez sur "Enregistrer la clé". Si celle-ci est valide, vous verrez une coche verte apparaître à côté du champ. Dans le cas contraire, un message vous indiquera que votre clé est incorrecte.