Mycroft Project: Search Engine Plugins

Submission Utility

Have made a number of changes to the way this form works recently...

Bugs / Suggestions - please file a bug or email mail(at)mycroftproject.com

If you would like to use a plugin previously submitted as a starting point, enter its numeric id here - available by mousing over a plugin name or if you received a deletion email, in the subject.

If you would like to upload an OpenSearch description file (max 20k) use this field and most of the details will be parsed into the form:

Please fill all fields and hit 'Generate Plugin'. It is then possible to review the OpenSearch description.
When you are ready, press 'Submit Plugin'.

Show full instructions? There is detailed documentation at OpenSearch.org and with reference to Firefox at the Mozilla Developer Center.
Plugin Name:	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.
Plugin Description:	This is currently underused but is part of the spec. Please include a brief description of the search performed.
Search URL:	GET POST 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 IE 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 https://mycroftproject.com/search-engines.html?name={searchTerms}&opensearch=yes&submitform=Search while for POST it is likely to just be https://mycroftproject.com/search-engines.html Both here and in the POST parameters {searchTerms} will be replaced by the user entered value.
POST Parameters:	NB. POST not compatible with IE A list of name=value POST parameter pairs with pairs separated by an ampersand. For example query={searchTerms}&examplename2=examplevalue2&examplename3=examplevalue3
Input Encoding:	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 ????"
Suggestions URL:	Search suggestions supported? 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}
Search Form URL:	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"
Reference:	This is 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. If you are submitting a new plugin it must be a unique reference eg 'googleuk_web', 'allmusic-artist' or 'domaintld-category' rather than 'plugin', etc.
Select Icon:Filetype (ico,png,gif,jpg):	Upload Local File Copy existing plugin Please select a 16x16 ICO (preferred for IE support), PNG, GIF or JPG icon. This can be a local upload or copied from a current plugin by providing the relevant numeric id.
Plugin category:
Plugin country:	(Request new countries by email)
Language of the results:	(Request new languages by email)
Your name:	Anonymous submission? If and how you would like to be credited on this website and also in the <Developer> tag of the plugin. Please don't consider it an advert.
Your email:	Include email in Plugin? (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.
Comment:	This comment will not be public. Please use it to describe updates or to say which plugin is being replaced, etc.
	Please generate and then install to test before submitting if you are not sure a plugin will work.