There is detailed documentation at OpenSearch.org and with
reference to Firefox at the
Mozilla Developer Center. |
|
Please select a 16x16 ICO (preferred), PNG, GIF or JPG icon from your computer. It is currently not possible to paste a URL here. |
|
This is used as the key for updates. If you are submitting an update please use the same reference as the existing plugin - available by mousing over the
plugin in search results - ignore the number. If you are submitting a new plugin it must be a unique reference so please be descriptive eg 'googleuk_web' rather than 'favicon'.
By default the filename of your icon is used but this may need to be altered. |
|
This is how you would like to be credited on this website and also in the <Developer> tag of the plugin.
By all means use a nickname but please don't consider it an advert. |
|
(Not required) Your email will not be displayed on the site. It will form the <Contact> tag in the plugin if you
tick the box and will also be used to inform you if the plugin is removed for any reason and in future if your plugin is broken. |
|
This is the name of the plugin displayed on Mycroft and also the name that will be displayed in the searchbox of the
browser. Please standardise where appropriate and omit 'search' and 'plugin' unless part of the brand. It is possible to alter the name after generating the
plugin but this is only necessary where the site uses one format and another format is more appropriate for the searchbox (mainly Google et al.) |
|
This is currently underused but is part of the spec. Please include a brief description of the search performed. |
|
This is the most important element of the plugin - if it is not correct the plugin will not function. The best way to
construct this is by examining the <form> elements in the source code of the webpage. But for simple cases it will be possible to search for, say, 'TEST'
and copy and paste the url from the location bar substituting {searchTerms} for TEST. Unfortunately IE7 does not support the POST method so GET is preferred
where it works even if the site specifies POST. For GET the url will be similar to http://mycroft.mozdev.org/download.html?name={searchTerms}&opensearch=yes&submitform=Search
while for POST it is likely to just be http://mycroft.mozdev.org/download.html Both here and in the POST parameters {searchTerms} is where the term that is searched
for will be entered by the browser. |
|
A list name,value POST parameter pairs with each pair separated by a comma and pairs separated by a semicolon.
For example name,{searchTerms};opensearch,yes;submitform,Search |
|
The encoding that should be used when the search query is sent by the browser. Typically this will be UTF-8, ISO-8859-1,
ISO-8859-2, ISO-8859-5, windows-1251, Big5, GB2312, Shift_JIS, etc. Wrong values will lead to errors of the type: "you searched for ????" |
|
This is currently only supported by a few of the largest websites. An example of a working value is:
http://suggestqueries.google.com/complete/search?output=firefox&client=firefox&hl=en&q={searchTerms} |
|
This is where Firefox will direct the browser when the user searches with no term selected and it is also displayed on and
indexed by Mycroft. It should point to the location where a user would normally go to access the search function of a webpage. That might be the front page
or it might be a special page with advanced options where that is more useful. It should not always be the same page as the Search URL as this may lead to errors
of the type: "you didn't search for anything" |
|
(Category discussion bug) |
|
(Request new country) |
|
(Request new language) |
|
This comment will not be public. Please use it to describe updates or to say that this replaces another plugin, etc. |
| |
|
| |
![[boxes]](../www.mozdev.org/sharedimages/boxes.gif)
