Plugins OpenSearch : Différence entre versions
(→Fichier de description OpenSearch) |
(→Fichier de description OpenSearch) |
||
| Ligne 17 : | Ligne 17 : | ||
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" | <OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" | ||
xmlns:moz="http://www.mozilla.org/2006/browser/search/"> | xmlns:moz="http://www.mozilla.org/2006/browser/search/"> | ||
| − | <OFPutVar name=" | + | <OFPutVar name="babSkinPath"><OFPutVar name="babUrl"> |
<ShortName>Ovidentia</ShortName> | <ShortName>Ovidentia</ShortName> | ||
<Description>Recherche Ovidentia</Description> | <Description>Recherche Ovidentia</Description> | ||
<InputEncoding>ISO-8859-15</InputEncoding> | <InputEncoding>ISO-8859-15</InputEncoding> | ||
| − | <Image width="16" height="16" type="image/vnd.microsoft.icon">< | + | <Image width="16" height="16" type="image/vnd.microsoft.icon"><OVbabSkinPath>images/Puces/favicon.ico</Image> |
<Url type="text/html" | <Url type="text/html" | ||
method="get" | method="get" | ||
Version du 30 mai 2007 à 10:03
Les dernières générations de navigateurs (Firefox 2 et Internet Explorer 7) disposent d'une barre de recherche intégrée qui permet à l'utilisateur d'accéder rapidement à un certain nombre de moteurs de recherche (Google, Yahoo, Wikipedia...) La liste des moteurs proposée par ces navigateurs n'est pas figée et il est possible pour l'utilisateur d'en ajouter de nouveaux.
Pour être intégrable, un moteur de recherche doit être compatible avec certains standards. OpenSearch définit, entre autres, un format de description de moteur de recherche permettant aux navigateurs d'obtenir les informations nécessaires à leur intégration dans la barre de recherche.
Il est possible de définir un plugin pour accéder au moteur d'Ovidentia.
Fichier de description OpenSearch
Afin de permettre au navigateur de savoir comment dialoguer avec notre moteur de recherche, il est nécessaire de lui fournir une description de celui-ci. OpenSearch définit un fichier de description au format XML contenant toutes les informations nécessaires.
Pour Ovidentia nous nous servirons de l'OvML pour générer le fichier XML. OvML nous permettra d'insérer des éléments dépendants de l'installation d'Ovidentia sur le site (url de base, nom du skin...) et nous n'aurons donc pas besoin de modifier le fichier en cas de changement de paramétrage du site.
Le fichier OvML, que nous appellerons par exemple ovisearch.xml sera placé dans le répertoire ovml du skin (skins/nom_du_skin/ovml). Son contenu sera le suivant :
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/"
xmlns:moz="http://www.mozilla.org/2006/browser/search/">
<OFPutVar name="babSkinPath"><OFPutVar name="babUrl">
<ShortName>Ovidentia</ShortName>
<Description>Recherche Ovidentia</Description>
<InputEncoding>ISO-8859-15</InputEncoding>
<Image width="16" height="16" type="image/vnd.microsoft.icon"><OVbabSkinPath>images/Puces/favicon.ico</Image>
<Url type="text/html"
method="get"
template="<OVbabUrl>index.php?tg=search&pat=abcdefgh&idx=find&what={searchTerms}">
</Url>
<moz:SearchForm><OVbabUrl>index.php?tg=search&pat=abcdefgh</moz:SearchForm>
</OpenSearchDescription>
Les spécifications détaillées (en anglais) du format de fichier de description sont accessibles à cette page : OpenSearch description document
Découverte automatique du moteur
Une fois le fichier de description en place, il est possible d'indiquer au navigateur que notre site dispose d'un moteur de recherche compatible avec le standard OpenSearch. Le navigateur avertira ainsi l'utilisateur qu'un moteur de recherche est disponible sur le site et lui permettra de l'ajouter automatiquement à la liste de sa barre de recherche. Pour cela, il suffit d'ajouter dans la section <head> du template page.html du skin la ligne suivante :
<link rel="search"
type="application/opensearchdescription+xml"
title="Recherche Ovidentia"
href="{ babUrl }index.php?tg=oml&file=ovisearch.xml&echo=1">
