Tworzenie wtyczek MozSearch

 

Firefox 2 używa uproszczonej formy formatu OpenSearch do przechowywania wtyczek wyszukiwania. Wtyczka MozSearch jest plikiem XML, który opisuje silnik wyszukiwarki, jej adres URL i parametry, które mają być przekazane do tego adresu URL.

Ostrzeżenie: MozSearch nie jest standardem i jest przeznaczony tylko na wewnętrzne potrzeby projektu Mozilla. Wtyczka ta powinna być użyta tylko wtedy, gdy zamierzasz rozpowszechniać wtyczkę wyszukiwarki spakowaną w rozszerzenie Firefoksa lub jeśli tworzysz wtyczkę, która ma być dostarczana jako domyślna w Firefoksie. Zobacz Tworzenie wtyczek OpenSearch dla Firefoksa, aby dowiedzieć się o tworzeniu wtyczek instalowanych z Internetu.

Plik wtyczki

Format MozSearch jest podobny do formatu OpenSearch. Jedyną różnicą jest element root i przestrzeń nazw XML.

Przykład: wyszukiwarka Yahoo!

Poniższy kod XML jest wbudowaną wtyczką Firefox 2 odpowiadającą za wyszukiwarkę Yahoo!:

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

Przypuśćmy, że użytkownik wybierze silnik wyszukiwania Yahoo! i wprowadzi "mozilla" w polu wyszukiwania, po czym naciśnie klawisz enter. Firefox użyje powyższego opisu wyszukiwarki, aby stworzyć taki adres URL:

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

Jeśli użytkownik kliknie ikonę lupy w panelu wyszukiwania lub wybierze opcję Znajdź w Internecie w menu Narzędzia, gdy panel wyszukiwania nie jest widoczny, przeglądarka przeniesie go do strony http://search.yahoo.com/, która została wpisana jako wartość elementu <SearchForm>.

Przykład: wyszukiwarka MDC

Ta wtyczka pozwoli Ci w prosty sposób przeszukiwać stronę Mozilla Developer Center.

<SearchPlugin xmlns="http://www.mozilla.org/2006/browser/search/">
<ShortName>MDC</ShortName>
<Description>Mozilla Developer Center search</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/en/docs/Special:Search?search={searchTerms}"/>
<SearchForm>http://developer.mozilla.org/en/docs/Special:Search</SearchForm> 
</SearchPlugin>

Zauważ, że w tym przypadku zamiast używania <Param> do zdefiniowania parametrów silnika wyszukiwarki, są one po prostu osadzone wewnątrz szablonowego URL. Jest to właściwie preferowany sposób, gdy używamy GET jako metody. <Param> powinien być użyty dla POST.

Zobacz także

Autorzy i etykiety dokumentu

 Autorzy tej strony: Dwar, Mgjbot, Diablownik, Marcoos, Ptak82
 Ostatnia aktualizacja: Dwar,