Intégration de Metanol à un site web sous forme de gadget

Exemple de gadget

Présentation de l'intégration par gadget

Le gadget Metanol se présente sous 2 formats :

• compact
• pleine page (aussi appelé "canvas")

Chacun de ces 2 formats peut être personnalisé en utilisant les paramètres suivants :

Titre	Nom du paramètre	Description
Quoi	up_what	Valeur du champ « Quoi ? », que l'utilisateur peut ou non modififier (cf ci-dessous)
Où	up_where	Valeur du champ « Où ? », que l'utilisateur peut ou non modififier (cf ci-dessous)
Annuaire racine	up_base_what	Partie de l'annuaire à utiliser comme base. Quand ce paramètre est précisé, alors l'utilisateur ne peut pas consulter d'autres parties de l'annuaire. Par exemple, s'il vaut annuaire+de+l+administration, alors il est impossible d'accéder à l'annuaire des établissements sanitaires et sociaux
Territoire racine	up_base_where	Territoire couvert par l'annuaire. Quand ce paramètre est précisé, alors l'utilisateur ne peut pas consulter d'autres territoires. Par exemple, s'il vaut auvergne, alors il est impossible d'accéder à l'annuaire d'Aubervilliers
Champ Quoi	up_show_what_input	Indique si le gadget doit afficher ou non le champ « Quoi ? ». Peut valoir true (valeur par défaut) ou false.
Champ Où	up_show_where_input	Indique si le gadget doit afficher ou non le champ « Où ? ». Peut valoir true (valeur par défaut) ou false.
Chemin Quoi	up_show_what_path	Indique si le gadget doit afficher ou non le fil d'Ariane menant à la partie de l'annuaire où se trouve actuellement l'utilisateur. Peut valoir true (valeur par défaut) ou false.
Chemin Où	up_show_where_path	Indique si le gadget doit afficher ou non le fil d'Ariane menant au territoire où se trouve actuellement l'utilisateur. Peut valoir true (valeur par défaut) ou false.
Page blanche pour liens	up_blank_target	Indique si les liens externes affichés par le gadget doivent s'ouvrir dans une nouvelle page ou dans la page actuelle (valeur par défaut).Peut valoir true ou false (valeur par défaut).
CSS	up_css	URL d'une CSS à utiliser en lieu et place de la CSS par défaut.

Notes :

1. Le préfixe up_ utilisé pour les paramètres du gadget signifie User Preference.
2. Dans les les paramètres, les accents, les capitalisations et les caractères spéciaux sont ignorés. Il est préférable de tout écrire en majuscule sans accent en remplaçant les espaces et les caractères spéciaux par un "+".

Gadget Google

Metanol est disponible sous forme de  gadget Google.

Google propose une  interface web permettant d'intégrer Metanol à n'importe quelle page web.

Gadget Google au format compact

En ajoutant le fragment HTML suivant à une page web

<script src="http://www.gmodules.com/ig/ifr?url=http://www.quoi-ou.org/gadgets/annuaire.xml&amp;up_where=64120%20Larceveau-Arros-Cibits&amp;up_show_what_input=false&amp;up_show_where_input=false&amp;up_show_what_path=false&amp;up_show_where_path=false&amp;synd=open&amp;w=400&amp;h=600&amp;title=Annuaire+de+Larceveau-Arros-Cibits&amp;lang=fr&amp;country=ALL&amp;border=%23ffffff%7C3px%2C1px+solid+%23999999&amp;output=js"></script>
<noscript>
  <iframe src="http://www.quoi-ou.org/canvas?where=64120%20Larceveau-Arros-Cibits&amp;show_what_input=0&amp;show_where_input=0&amp;show_what_path=0&amp;show_where_path=0""
          height="600" width="400" scrolling="auto"
          title="Annuaire de Larceveau-Arros-Cibits">
    <a href="http://www.quoi-ou.org/?where=64120%20Larceveau-Arros-Cibits>Annuaire de Larceveau-Arros-Cibits</a>
  </iframe>
</noscript>

on obtient un gadget compact, n'affichant ni champ de saisie, ni fil d'Ariane :

Gadget Google au format pleine page

En ajoutant le fragment HTML suivant à une page web

<script src="http://www.gmodules.com/ig/ifr?view=canvas&url=http://www.quoi-ou.org/gadgets/annuaire.xml&amp;up_where=40000%20Mont-de-Marsan&amp;synd=open&amp;w=800&amp;h=1000&amp;title=Annuaire+de+Mont-de-Marsan&amp;lang=fr&amp;country=ALL&amp;border=%23ffffff%7C3px%2C1px+solid+%23999999&amp;output=js"></script>
<noscript>
  <iframe src="http://www.quoi-ou.org/canvas?where=40000%20Mont-de-Marsan"
          height="1000" width="800" scrolling="auto"
          title="Annuaire de Mont-de-Marsan">
    <a href="http://www.quoi-ou.org/?where=40000%20Mont-de-Marsan">Annuaire de Mont-de-Marsan</a>
  </iframe>
</noscript>

on obtient un gadget pleine-page (ie "canvas"), affichant les 2 champs de saisie et les 2 fils d'Ariane :

Note : Les différences entre les deux gadgets HTML sont les suivantes :

• la commune : 64120%20Larceveau-Arros-Cibits dans un cas, 40000%20Mont-de-Marsan dans l'autre
• le titre : title=Annuaire+de+l'administration+à+Larceveau-Arros-Cibits dans un cas, Annuaire+de+l'administration+à+Mont-de-Marsan dans l'autre
• l'ajout de view=canvas& pour le gadget au format pleine page
• la hauteur et la largeur par défaut : w=320&h=450 pour le format compact et w=800&h=1000 pour le format pleine page (sachant que la largeur peut être changée dans le script, mais que la hauteur est recalculée dynamiquement par le gadget)

Intégration du gadget Google dans une page personnelle iGoogle

Si vous disposez d'une page personnelle  iGoogle, vous pouvez y ajouter directement le gadget :

Avantages et inconvénients des gadgets Google

• Un gadget Google permet d'ajouter un annuaire de l'administration à n'importe quel site, en quelques minutes, en ajoutant seulement quelques lignes de HTML, sans avoir rien à installer.
• Les technologies utilisées par les gadgets Google sont libres.
• Un gadget Google est toujours accompagné d'un bandeau de pub pour iGoogle : .
• Quand JavaScript est désactivé, le gadget disparait complètement. Mais il suffit d'ajouter une <iframe> dans un élement <noscript>, pour que le gadget soit remplacé par une iframe dans ce cas (cf exemples ci-dessus, ainsi que la page expliquant l'intégration par iframe).
• Un gadget n'est pas indexé par les moteurs de recherche.

Support

Pour vous assister dans la mise en oeuvre de ces outils, plusieurs possibilités vous sont offertes :

• Consulter et/ou participer à la liste de diffusion Infos-Pratiques.
• Contacter les prestataires de services Partenaires du projet.