Creació_de_connectors_MozSearch

by 1 contributor:

El Firefox 2 utilitza una forma simplificada del format OpenSearch per a emmagatzemar els connectors de cerca. Un connector de cerca MozSearch és un fitxer XML que descriu el motor de cerca, el seu URL, i els paràmetres que cal passar a l'URL.

Avís: MozSearch no és estàndard i només és per a ús intern dins del projecte Mozilla. Només hauria d'utilitzar-se si la vostra intenció és distribuir el connector de cerca juntament amb una extensió del Firefox, o si n'esteu creant perquè puguin anar-hi per defecte amb el programa. Per a crear connectors de cerca que s'instal·lin des del web, consulteu Creació de connectors OpenSearch per al Firefox

El fitxer del connector

El format MozSearch és similar al de l'OpenSearch. L'única diferència és l'element arrel i l'espai de noms XML.

Exemple: cercar amb Yahoo!

El següent XML és el connector de cerca de Yahoo! que s'inclou al Firefox 2:

<SearchPlugin xmlns="http://www.mozilla.org/2006/browser/search/">
<ShortName>Yahoo</ShortName>
<Description>Cerca de Yahoo!</Description>
<InputEncoding>UTF-8</InputEncoding>
<SuggestionUrl>http://ff.search.yahoo.com/gossip?output=fxjson&command=</SuggestionUrl>
<Image width="16" height="16">data:image/x-icon;base64,R0lGODlhEAAQAJECAP8AAAAAAP///wAAACH5BAEAAAIALAAAAAAQABAAAAIplI+py+0NogQuyBDEnEd2kHkfFWUamEzmpZSfmaIHPHrRguUm/fT+UwAAOw==</Image>
<Url type="text/html" method="GET" template="http://ct.search.yahoo.com/search">
  <Param name="p" value="{searchTerms}"/>
  <Param name="ei" value="UTF-8"/>
  <Param name="fr" value="moz2"/>
</Url>
<SearchForm>http://ct.search.yahoo.com/</SearchForm>
</SearchPlugin>

Suposem que l'usuari tria el connector del motor de cerca de Yahoo! i introdueix «mozilla» en el quadre de cerca, i a continuacó prem la tecla Retorn. El Firefox farà servir la descripció del motor de cerca anterior per a construir la següent URL de cerca:

http://ct.search.yahoo.com/search?p=mozilla&ei=UTF-8&fr=moz2

Si l'usuari clica la icona de la lupa de barra de cerca, o bé tria l'opció de Cerca Web al menú d'Eines quan la barra de cerca no sigui visible, el navegador el portarà a <tt>http://ct.search.yahoo.com/</tt>, el valor de l'element <SearchForm>.

Exemple: cercar al MDC

Aquest connector us permet cercar fàcilment el lloc web del Centre de desenvolupament de Mozilla.

<SearchPlugin xmlns="http://www.mozilla.org/2006/browser/search/">
<ShortName>MDC</ShortName>
<Description>Cerca del Centre de desenvolupament de Mozilla</Description>
<InputEncoding>UTF-8</InputEncoding>
<Image width="16" height="16">data:image/x-icon;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8%2F9hAAAABGdBTUEAAK%2FINwWK6QAAABl0RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAAHWSURBVHjaYvz%2F%2Fz8DJQAggJiQOe%2Ffv2fv7Oz8rays%2FN%2BVkfG%2FiYnJfyD%2F1%2BrVq7ffu3dPFpsBAAHEAHIBCJ85c8bN2Nj4vwsDw%2F8zQLwKiO8CcRoQu0DxqlWrdsHUwzBAAIGJmTNnPgYa9j8UqhFElwPxf2MIDeIrKSn9FwSJoRkAEEAM0DD4DzMAyPi%2FG%2BQKY4hh5WAXGf8PDQ0FGwJ22d27CjADAAIIrLmjo%2BMXA9R2kAHvGBA2wwx6B8W7od6CeQcggKCmCEL8bgwxYCbUIGTDVkHDBia%2BCuotgACCueD3TDQN75D4xmAvCoK9ARMHBzAw0AECiBHkAlC0Mdy7x9ABNA3obAZXIAa6iKEcGlMVQHwWyjYuL2d4v2cPg8vZswx7gHyAAAK7AOif7SAbOqCmn4Ha3AHFsIDtgPq%2FvLz8P4MSkJ2W9h8ggBjevXvHDo4FQUQg%2FkdypqCg4H8lUIACnQ%2FSOBMYI8bAsAJFPcj1AAEEjwVQqLpAbXmH5BJjqI0gi9DTAAgDBBCcAVLkgmQ7yKCZxpCQxqUZhAECCJ4XgMl493ug21ZD%2BaDAXH0WLM4A9MZPXJkJIIAwTAR5pQMalaCABQUULttBGCCAGCnNzgABBgAMJ5THwGvJLAAAAABJRU5ErkJggg%3D%3D</Image>
<Url type="text/html" method="GET" template="http://developer.mozilla.org/ca/docs/Special:Search?search={searchTerms}"/>
<SearchForm>http://developer.mozilla.org/ca/docs/Special:Search</SearchForm> 
</SearchPlugin>

Tingueu en compte que en aquest cas, en comptes de fer servir <Param> per a definir els paràmetres per al motor de cerca, aquests simplement s'inclouen dins de l'URL de plantilla. Aquesta és, de fet, la forma recomanable de fer-ho quan s'utilitzi GET com a mètode. <Param> ha d'utilitzar-se per a POST.

Vegeu també

Document Tags and Contributors

Contributors to this page: Toniher
Last updated by: Toniher,