Upgrade StorageThis is an old revision of the document!
Requirements
OpenSearch support requires Zotero 2.1b6 or later.
Creating OpenSearch Descriptions
Zotero uses OpenSearch 1.1 and OpenURL with some extensions to allow easy specification of locate engines. For a simple OpenURL endpoint, one can use something like:
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
<ShortName>CrossRef</ShortName>
<Description>CrossRef Search Engine</Description>
<Image width="16" height="16" type="image/x-icon">http://crossref.org/favicon.ico</Image>
<Url type="text/html" method="GET"
xmlns:z="http://www.zotero.org/namespaces/openSearch#"
template="http://crossref.org/openurl?{z:openURL}"/>
</OpenSearchDescription>
For a more complicated service:
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
<ShortName>Google Scholar</ShortName>
<Description>Google Scholar Search Engine</Description>
<Image width="16" height="16" type="image/x-icon">http://scholar.google.com/favicon.ico</Image>
<Url type="text/html" method="GET"
xmlns:rft="info:ofi/fmt:kev:mtx:journal"
xmlns:z="http://www.zotero.org/namespaces/openSearch#"
template="http://scholar.google.com/scholar?as_q=&as_epq={z:title}&as_occt=title&as_sauthors={rft:aufirst?}+{rft:aulast?}&as_ylo={z:year?}&as_yhi={z:year?}&as_sdt=1.&as_sdtp=on&as_sdtf=&as_sdts=22&"/>
</OpenSearchDescription>
Zotero supports most of the fields specified by the OpenURL specification in any of the following namespaces:
- info:ofi/fmt:kev:mtx:journal
- info:ofi/fmt:kev:mtx:book
- info:ofi/fmt:kev:mtx:patent
- info:ofi/fmt:kev:mtx:sch_svc
- info:ofi/fmt:kev:mtx:dissertation
These namespaces are treated interchangeably. For a full list of fields, see the OpenURL documentation.
Zotero also supports any Zotero field in the Zotero namespace (http://www.zotero.org/namespaces/openSearch#), as well as the special openURL field, which inserts an OpenURL 1.0 context object. Zotero fields should be used sparingly, as they will not be compatible with other implementations.
For more general details on the OpenSearch description format, see the OpenSearch documentation.
Advertising Engines
You can advertise locate engines by adding
<link rel="search" type="application/x-openurl-opensearchdescription+xml" title="Engine Name" href="http://www.example.com/myengine.xml" />
to the <head> section of any webpage (with the title and href attribute contents modified). The user can then install the locate engine under the locate menu when visiting the webpage.