In articolul anterior am prezentat un Search Plugin folosit pentru cautarea formelor conjugate a verbelor germane, cautarea efectuindu-se pe situl Verbix.com.
In articolul de azi voi vorbi despre modul in care se pot crea acest tip de plugin-uri.
Pluginul exemplificat respecta standardul OpenSearch si poate fi folosit (pentru moment) numai in Firefox 2 si Internet Explorer 7.
In sectiunea urmatoare este prezentata sursa fisierului XML folosit pentru creare pluginului:
<?xml version="1.0"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
<ShortName>Verbix DE</ShortName>
<Description>Conjugarea verbelor germane </Description>
<Image height="16" width="16" type="image/x-icon"> http://www.verbix.com/favicon.ico</Image>
<Url type="text/html"
template="http://www.verbix.com/webverbix/go.php?T1={searchTerms}
&D1=22&H1=122"></Url>
<InputEncoding>UTF-8</InputEncoding>
<AdultContent>false</AdultContent>
<Developer>cotarlea.ro</Developer>
<Attribution>Search data copyright Verbix.com</Attribution>
</OpenSearchDescription>
Descrierea elementelor componente
Dintre toate elementele, <OpenSearchDescription> si <Url>
sunt cele mai importante si singurele elemente necesare pentru a crea
un Search Plugin.
<OpenSearchDescription> - nodul radacina al fisierului XML, este obligatoriu la fel ca si namespace-ul definit de atributul xmlns
<ShortName> - contine numele pluginului, acest nume va
apare in lista cu pluginurile de cautare
<Description> - descriere detaliata a functionalitatii pluginului
<Image> - Imaginea care v-a aparea in casuta de cautare cand pluginul current este selectat.
<Url> - definiste prin intermediul atributului Template adresa URL care va chemata pentru efectuarea cautarii. Un element important este parametrul {searchTerms} care va fi inlocuit cu valoare introdusa de utilizator in casuta de cautare.
Astfel, la cautarea verbului haben URL-ul va arata in modul urmator:
http://www.verbix.com/webverbix/go.php?T1=haben&D1=22&H1=122
http://www.verbix.com/webverbix/go.php?T1={searchTerms}&D1=22&H1=122″>
Unde parametrul T1 reprezinta numele verbului cautat iar D1 si H1 sunt folositi de Verbix.com pentru a determina limba pentru care trebuie efectuata cautarea.
Elementul <Url> are si alte atribute dar nu le voi mai prezenta aici. Pentru detalii vedeti linkul din sectiunea Resurse.
<InputEncoding> - specifica faptul ca situl pe care vom efectua cautarea suporta aceasta familie de caractere.
<Developer> - creatorul pluginului
<Attribution> - persoane/institutii care trebuie credidate pentru rezultate generate la cautare
Instalarea pluginului
Dupa ce ati salvat codul XML intr-un fisier pentru instalare se va folosi metoda JavaScipt window.external.AddSearchProvider(sUrl) unde sUrl reprezinta adresa unde se regaseste fisierul XML, in cazul de fata apelul metodei va arata asa:
window.external.AddSearchProvider(“http://www.cotarlea.ro/resurse/verbixde.xml”)
Folosirea plugin-ului pentru o alta limba
Pentru a folosi pluginul curent pentru o alta limba trebuie modificate numai valorile parametrilor D1 si H1 din elementul <Url>. Pentru a afla valorile acestor parametrii urmeaza pasii urmatori:
- Deschide http://www.verbix.com/webverbix/
- Alege limba dorita
- In browser apasa click-dreapta si alege optiunea View Page Source
- In sursa pagini cauta dupa name=”D1″ respectiv name=”H1″ si foloseste valoarea atributelor value.
- Specificatii OpenSearch Description Document
- Articol similar - http://developer.mozilla.org/…_plugins_for_Firefox
- MSDN AddSearchProvider Method
- Verbix.com
http://www.opensearch.org/…/OpenSearch/1.1
http://msdn.microsoft.com/…/addsearchprovider.asp
