Bloc-notes de Darathor

Après avoir un peu cherché et trouvé plusieurs plugins gérant Open search mais aucun ne faisait précisément ce que je voulais.

J’ai donc codé ma propre version qui me semble plus complète. Donc qu’est-ce qu’elle fait ?

• elle intègre Open search à Worpress (forcément, c’est un peu le but…).
• elle recherche automatiquement l’icône de favoris, d’abord dans le répertoire du thème courant et ensuite à la racine et à défaut prend l’icône fournie avec le plugin. L’icône recherchée est supposée s’appeler favicon.jpg, favicon.png, favicon.ico ou favicon.gif. Ce qui gère à peu près tous les cas possibles. Y compris mon cas : plusieurs sites tournant avec la même instance de Wordpress.
• le fichier XML Open search est généré à partir du template présent dans templates/open-search-xml.php. Au cas où vous voudriez le changer (c’est peu probable mais bon, à tout hasard…), ce fichier peut être surchargé en ajoutant dans votre thème un fichier open-search-xml.php. Donc pas besoin de modifier directement le plugin, ce qui facilite les mises à jour.
• le plugin est localisé (à l’heure actuelle il n’y a qu’une chaine localisée mais bon). Cf le dossier languages du plugin.

Voilà voilà, l’essentiel est dit, manque plus que le lien pour le téléchargement : Plugin Open search 1.0.

Open Search est une série de format destinés à partager des recherches. En particulier, et c’est le point dont je vais parler ici, c’est via ce format que sont définis les moteurs de recherche gérés par la barre de recherche de Firefox 2 (et également celle d’IE 7 apparemment).

On peut donc assez facilement ajouter un moteur de recherche à la liste via un simple fichier XML, du moment qu’on a l’URL et les paramètres à passer à la page de recherche.

Format du fichier xml

Code (XML)

<?xml version="1.0" encoding="{ENCODAGE}" ?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:moz="http://www.mozilla.org/2006/browser/search/">
   <ShortName>{NOM}</ShortName>
   <Description>{DESCRIPTION}</Description>
   <InputEncoding>{ENCODAGE}</InputEncoding>
   <Image width="16" height="16">{ICÔNE}</Image>
   <Url type="text/html" method="{MÉTHODE}" template="{URL_RÉSULTAT}"></Url>
</OpenSearchDescription>

• {NOM} : nom du moteur de recherche. C’est ce nom qui sera affiché dans la liste de sélection du navigateur, veillez donc à ce qu’ils reste aussi concis que possible.
• {DESCRIPTION} : description du moteur.
• {ENCODAGE} : encodage du moteur et de votre fichier XML.
• {ICÔNE} : icône de 16×16 piels associée à votre moteur. Cette icône doit être encodée en base 64, par exemple via ce formulaire.
• {MÉTHODE} : méthode de passage de paramètre : POST ou GET.
• {URL_RÉSULTAT} : URL où soumettre la recherche.

D’autres paramètres optionnels existent, je n’ai détaillé là que les parties nécessaires.

Et ensuite ?

Une fois le fichier réalisé, il peut être être ajouté dans votre répertoire de Firefox, dans le dossier searchplugins (nécessite de redémarrer Firefox).

Il est également possible s’il s’agit du moteur de recherche de votre site, de faire en sorte que Firefox le détecte automatiquement (de la même manière que pour un flux RSS) en ajoutant la balise title appropriée dans la section head de la page :

Code (XML)

<link rel="search" type="application/opensearchdescription+xml" title="{NOM}" href="{URL_DU_FICHIER_XML}">

Où {NOM} correspond au nom indiqué dans le fichier XML et où, vous l’aurez compris, {URL_DU_FICHIER_XML} est à remplacer par l’URL où vous aurez placé le dit fichier…

Ressources complémentaires

• Page dédié sur le Mozilla dev center
• Explications sur la base 64 (utilisée pour l’encodage de l’icône).