wiki:Metanol/Integration/Gadget

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)
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&amp;h=450 pour le format compact et w=800&amp;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 :

Add to Google

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 : Publicité accompagnant un gadget Google.
  • 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 :

Last modified 9 years ago Last modified on Mar 20, 2009, 7:55:00 AM

Attachments (1)

Download all attachments as: .zip