Démarrage en cinq minutes

1. Composez votre widget

Ouvrez le configurateur. Choisissez la zone, puis, si vous le souhaitez, les besoins affichés, un titre, une couleur, et les fiches à mettre en avant ou à masquer. L’aperçu, à droite, montre le widget tel qu’il apparaîtra dans votre page, avec les vraies données.

2. Copiez l’extrait

Le bouton « Copier l’extrait » place dans votre presse-papiers quelques lignes de ce type :

<script async src="https://annuairesolidaire.fr/widget/v1.js"
  data-annuaire-config="eyJ2IjoxLCJ6b25lIjp7InR5cGUiOiJjb21tdW5lIiwiY29kZSI6IjMzMjQzIn19"
  data-annuaire-titre="Aides et services à Libourne"></script>

Toute votre configuration est dans l’attribut data-annuaire-config. Rien n’est enregistré chez nous : conservez cet extrait, c’est lui que vous recollerez dans le configurateur pour modifier le widget plus tard.

3. Collez-le dans votre page

Dans votre outil de gestion de contenu, ouvrez la page qui accueillera le widget et collez l’extrait à l’endroit exact où il doit apparaître, dans un bloc qui accepte du HTML brut (voir selon votre CMS). Enregistrez, puis affichez la page.

Résultat attendu : le widget apparaît à la place de l’extrait, prend toute la largeur disponible et ajuste sa hauteur à son contenu ; sous lui, une ligne « Propulsé par Annuaire Solidaire, données data·inclusion ». Si rien n’apparaît, la page Dépannage passe en revue les causes habituelles.

Ce qu’il faut savoir avant de commencer

• Gratuit, sans compte, sans engagement. Retirer l’extrait de votre page suffit à retirer le widget. Les conditions d’utilisation tiennent en une page.
• Les données viennent de data·inclusion, le référentiel public de l’offre d’insertion, et sont mises à jour chaque semaine dans le widget sans rien changer à votre extrait.
• Le widget vit dans un cadre isolé (iframe) : vos styles ne le touchent pas, les siens ne touchent pas votre page, et tout se consulte sur place, sans quitter votre site.
• Il est conçu pour le RGAA : navigation au clavier, focus géré, contrastes vérifiés, et sa déclaration d’accessibilité peut être référencée depuis la vôtre.
• Votre extrait est votre configuration. Le configurateur sait le relire pour la modifier, et vérifier que les fiches mises en avant existent toujours dans les données.

Pour aller plus loin

• L’extrait et ses attributs : ce que fait le script, l’intitulé du cadre, la ligne de crédit, l’iframe seule.
• Référence de la configuration : les clés, leurs valeurs, l’encodage, pour qui veut générer l’extrait lui-même.
• Technique et sécurité : HTTPS, politique de sécurité de contenu, confidentialité, performance.