The OpenSearch description document is used to describe the search engine's web interface.
It is possible to set the description document in the OpenSearch tab of the Integrations section of the Administration menu.
-
In the Description document section, provide a description of the search engine.
By default, the following content is displayed:
<?xml version="1.0" encoding="UTF-8"?> <OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/"> <ShortName>$PORTAL_URL</ShortName> <Description>This example must be edited in order to reflect your own engine</Description> <Url type="text/html" rel="results" template="https://$PORTAL_URL/search/all?query={searchTerms}"/> <Url type="application/atom+xml" rel="results" template="https://$PORTAL_URL/api/opensearch?query={searchTerms}&limit={count?}&startIndex={startIndex?}&content-lang={language?}"/> <Query role="example" searchTerms="how" /> </OpenSearchDescription>
Where:
-
ShortName
expects a human-readable name for the portal. By default, it is the hostname. -
Description
may be customized. -
Url type="text/html"
expects the URL used by the browser to send an HTML response. -
Url type="application/atom+xml"
expects the URL used by the browser to send an ATOM response. -
Query
expects an example word to replace{searchTerms}
in theUrl
elements for OpenSearch integration tests.
This list of parameters is not exhaustive. See the OpenSearch official documentation for additional tags.
The XML is validated on the fly.
-
-
Select Save to apply the updated configuration.