= Intégration de [wiki:Metanol] à un site web dans une iframe =

[[PageOutline]]

== Exemple d'iframe ==

{{{
#!html
<iframe src="http://www.quoi-ou.org/compact?what=Formation&amp;where=Mulhouse+(68100)&amp;show_what_input=0&amp;show_where_input=0"
        height="450" width="500" scrolling="auto" frameborder="0"
        title="Recherche sur "Formation" dans l'annuaire de Mulhouse">
  <a href="http://www.quoi-ou.org/?what=Formation&amp;where=Mulhouse+(68100)">Recherche sur "Formation" dans l'annuaire de Mulhouse</a>
</iframe>
}}}

== Présentation de l'intégration par iframe ==

[wiki:Metanol] est disponible sous plusieurs formats adaptés à une utilisation dans une iframe :
  * compact
  * pleine page (aussi appelé "canvas")

Ces formats sont les mêmes que ceux des [wiki:Metanol/Integration/Gadget gadgets Metanol].

Chacun de ces 2 formats peut être personnalisé en utilisant les paramètres suivants :
|| '''Titre''' || '''Nom du paramètre''' || '''Description''' ||
|| Quoi || `what` || Valeur du champ « Quoi ? », que l'utilisateur peut ou non modififier (cf ci-dessous) ||
|| Où || `where` || Valeur du champ « Où ? », que l'utilisateur peut ou non modififier (cf ci-dessous) ||
|| Annuaire racine || `base_what` || Partie de l'annuaire à utiliser comme base.[[BR]]Quand ce paramètre est précisé, alors l'utilisateur ne peut pas consulter d'autres parties de l'annuaire.[[BR]]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 || `base_where` || Territoire couvert par l'annuaire.[[BR]]Quand ce paramètre est précisé, alors l'utilisateur ne peut pas consulter d'autres territoires.[[BR]]Par exemple, s'il vaut `auvergne`, alors il est impossible d'accéder à l'annuaire d'Aubervilliers ||
|| Champ Quoi || `show_what_input` || Indique si le gadget doit afficher ou non le champ « Quoi ? ».[[BR]]Peut valoir `1` (valeur par défaut) ou `0`. ||
|| Champ Où || `show_where_input` || Indique si le gadget doit afficher ou non le champ « Où ? ».[[BR]]Peut valoir `1` (valeur par défaut) ou `0`. ||
|| Chemin Quoi || `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.[[BR]]Peut valoir `1` (valeur par défaut) ou `0`. ||
|| Chemin Où || `show_where_path` || Indique si le gadget doit afficher ou non le fil d'Ariane menant au territoire où se trouve actuellement l'utilisateur.[[BR]]Peut valoir `1` (valeur par défaut) ou `0`. ||
|| Page blanche pour liens || `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 `1` ou `0` (valeur par défaut). ||
|| CSS || `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 "+".


== Iframe au format compact ==

En ajoutant le fragment HTML suivant à une page web
{{{
#!text/html
<iframe src="http://www.quoi-ou.org/compact?where=Lille%20(59000)&amp;show_what_input=0&amp;show_where_input=0"
        height="450" width="500" scrolling="auto" frameborder="0"
        title="Annuaire de Lille">
  <a href="http://www.quoi-ou.org/?where=Lille%20(59000)">Annuaire de Lille</a>
</iframe>
}}}

on obtient :
{{{
#!html
<iframe src="http://www.quoi-ou.org/compact?where=Lille%20(59000)&amp;show_what_input=0&amp;show_where_input=0"
        height="250" width="500" scrolling="auto" frameborder="0"
        title="Annuaire de Lille">
  <a href="http://www.quoi-ou.org/?where=Lille%20(59000)">Annuaire de Lille</a>
</iframe>
}}}

== Iframe au format pleine page ==

En ajoutant le fragment HTML suivant à une page web
{{{
#!text/html
<iframe src="http://www.quoi-ou.org/canvas?where=Nancy%20(54000)"
        height="600" width="800" scrolling="auto"
        title="Annuaire de Nancy">
  <a href="http://www.quoi-ou.org/?where=Nancy%20(54000)">Annuaire de Nancy</a>
</iframe>
}}}

on obtient :
{{{
#!html
<iframe src="http://www.quoi-ou.org/canvas?where=Nancy%20(54000)"
        height="500" width="800" scrolling="auto"
        title="Annuaire de Nancy">
  <a href="http://www.quoi-ou.org/?where=Nancy%20(54000)">Annuaire de Nancy</a>
</iframe>
}}}

== Avantages et inconvénients ==

  * L'utilisation d'une iframe 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.
  * Si le navigateur ne supporte pas les iframes, un lien profond vers le site [http://www.quoi-ou.org/] apparaît à la place.
  * L'intégration par iframe ne nécessite pas !JavaScript.
  * Contrairement aux [wiki:Metanol/Integration/Gadget gadgets], les iframes ne se retaillent pas dynamiquement en fonction de la hauteur de leur contenu, ce qui peut provoquer l'apparition de barres de défilement.
  * Le contenu de l'iframe n'est pas référencé par les moteurs de recherche comme appartenant au site.


== Support ==
Pour vous assister dans la mise en oeuvre de ces outils, plusieurs possibilités vous sont offertes :
  
 * Consulter et/ou participer à la [wiki:ListesDeDiffusion liste de diffusion Infos-Pratiques].
 * Contacter les prestataires de services [wiki:Partenaires] du projet.