Spleasure
06-19-2006, 10:00 PM
NCODE OPENSEARCH FOR VBULLETIN 3.6.0
version: 1.1
I. What does it do
This plugin adds OpenSearch capabilities to you vBulletin board. OpenSearch is a standard defined by A9.com and defines a unified interface for search engines. The definitions are devided into four parts:
- OpenSearch Description: defines an XML format for describing search services
- OpenSearch Query Syntax: defines the query method and format, which is embedded in the OpenSearch Description file
- OpenSearch Response: defines RSS and ATOM extensions to return machinereadable search results.
- OpenSearch Query: defines a way of referring to a set of search results
This plugin provides a OpenSearch Description file, and thus implements OpenSearch Description and OpenSeach Query Syntax. OpenSearch Response is not implemented, and might get implemented in a future update, when the demand is sufficient, and when vBulletin allows for an easy integration.
This plugin is based around OpenSearch 1.1 Draft 3.
The plugin adds an autodiscovery tag to the <head> section of all pages, as recommended by the OpenSearch Description specification.
The current versions of the two largest browsers will support OpenSearch.
Information about the Internet Explorer 7 implementation can be found on:
http://blogs.msdn.com/ie/archive/2006/02/07/527266.aspx
Firefox 2 has supporting documents on:
http://developer.mozilla.org/en/docs/Creating_OpenSearch_plugins_for_Firefox
Please note that you might run into the following bugs when using Firefox 2:
OpenSearch: plugin not added if description not in utf-8 encoding
https://bugzilla.mozilla.org/show_bug.cgi?id=357830
Work around this bug by not using non-UTF-8 characters in the bbtitle, description
and keywords fields.
Can't use remote search engine icons larger than 10KB
https://bugzilla.mozilla.org/show_bug.cgi?id=361923
Don't use favicon.ico images larger than 10 KB. The default vBulletin icon is sized
9.9 KB and doesn't seem to work as well. However, this icon is a little bugged: it
contains double data (see vB 3.6 bug #716). I have attached an improved favicon.ico
with this plugin.
More on OpenSearch in general can be found on:
http://www.opensearch.org/
II. Installation
Use the product manager in vBulletin to upload the XML file.
III. Configuration
All settings are read from your vBulletin settings.
nCode OpenSearch makes use of the following settings:
- bbtitle
- description
- keywords
- webmasteremail
- languagecode
It also links to your favicon.ico image in the Description file.
In the control panel you'll find fields to alter the SyndicationRight
and AdultContent values of the OpenSearch Description file.
The SyndicationRight value is currently useless, because is controls
the OpenSearch Response part, which isn't implemented. It's provided
for completeness.
IV. Version history
1.1 (February 18th, 2007)
- added correct content-type to XML files
- secured the xml with CDATA sections
- support for the mozilla specific moz:SearchForm tag
- added notices about Firefox 2 bugs in the readme
1.0 (February 16th, 2007)
- Fixed templates
1.0 beta 1 (June 20th, 2006)
- First public release
V. Copyright
please keep in mind that:
THIS IS NOT FREE SOFTWARE
You are allowed to install this in your forum, and you are allowed to make suggestions for improvements. It is not allowed to redistribute the files in any other way than as a zipfile with the XML and this readme in original state.
(c) 2006 nCode - www.ncode.nl (http://www.ncode.nl) - info@ncode.nl
Below you can find screenshots from Internet Explorer 7 and Firefox 2.
Support site:
http://www.ncode.nl/vbulletinplugins/
Like it? Please donate
You can donate by PayPal: USD (https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=jorrit%40ncode%2enl&item_name=nCode%20vBulletin%20Plugins&item_number=ncode_vbulletin&no_shipping=1&cn=Comments&tax=0¤cy_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8) or EUR (https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=jorrit%40ncode%2enl&item_name=nCode%20vBulletin%20Plugins&item_number=ncode_vbulletin&no_shipping=1&cn=Comments&tax=0¤cy_code=EUR&lc=UK&bn=PP%2dDonationsBF&charset=UTF%2d8)
version: 1.1
I. What does it do
This plugin adds OpenSearch capabilities to you vBulletin board. OpenSearch is a standard defined by A9.com and defines a unified interface for search engines. The definitions are devided into four parts:
- OpenSearch Description: defines an XML format for describing search services
- OpenSearch Query Syntax: defines the query method and format, which is embedded in the OpenSearch Description file
- OpenSearch Response: defines RSS and ATOM extensions to return machinereadable search results.
- OpenSearch Query: defines a way of referring to a set of search results
This plugin provides a OpenSearch Description file, and thus implements OpenSearch Description and OpenSeach Query Syntax. OpenSearch Response is not implemented, and might get implemented in a future update, when the demand is sufficient, and when vBulletin allows for an easy integration.
This plugin is based around OpenSearch 1.1 Draft 3.
The plugin adds an autodiscovery tag to the <head> section of all pages, as recommended by the OpenSearch Description specification.
The current versions of the two largest browsers will support OpenSearch.
Information about the Internet Explorer 7 implementation can be found on:
http://blogs.msdn.com/ie/archive/2006/02/07/527266.aspx
Firefox 2 has supporting documents on:
http://developer.mozilla.org/en/docs/Creating_OpenSearch_plugins_for_Firefox
Please note that you might run into the following bugs when using Firefox 2:
OpenSearch: plugin not added if description not in utf-8 encoding
https://bugzilla.mozilla.org/show_bug.cgi?id=357830
Work around this bug by not using non-UTF-8 characters in the bbtitle, description
and keywords fields.
Can't use remote search engine icons larger than 10KB
https://bugzilla.mozilla.org/show_bug.cgi?id=361923
Don't use favicon.ico images larger than 10 KB. The default vBulletin icon is sized
9.9 KB and doesn't seem to work as well. However, this icon is a little bugged: it
contains double data (see vB 3.6 bug #716). I have attached an improved favicon.ico
with this plugin.
More on OpenSearch in general can be found on:
http://www.opensearch.org/
II. Installation
Use the product manager in vBulletin to upload the XML file.
III. Configuration
All settings are read from your vBulletin settings.
nCode OpenSearch makes use of the following settings:
- bbtitle
- description
- keywords
- webmasteremail
- languagecode
It also links to your favicon.ico image in the Description file.
In the control panel you'll find fields to alter the SyndicationRight
and AdultContent values of the OpenSearch Description file.
The SyndicationRight value is currently useless, because is controls
the OpenSearch Response part, which isn't implemented. It's provided
for completeness.
IV. Version history
1.1 (February 18th, 2007)
- added correct content-type to XML files
- secured the xml with CDATA sections
- support for the mozilla specific moz:SearchForm tag
- added notices about Firefox 2 bugs in the readme
1.0 (February 16th, 2007)
- Fixed templates
1.0 beta 1 (June 20th, 2006)
- First public release
V. Copyright
please keep in mind that:
THIS IS NOT FREE SOFTWARE
You are allowed to install this in your forum, and you are allowed to make suggestions for improvements. It is not allowed to redistribute the files in any other way than as a zipfile with the XML and this readme in original state.
(c) 2006 nCode - www.ncode.nl (http://www.ncode.nl) - info@ncode.nl
Below you can find screenshots from Internet Explorer 7 and Firefox 2.
Support site:
http://www.ncode.nl/vbulletinplugins/
Like it? Please donate
You can donate by PayPal: USD (https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=jorrit%40ncode%2enl&item_name=nCode%20vBulletin%20Plugins&item_number=ncode_vbulletin&no_shipping=1&cn=Comments&tax=0¤cy_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8) or EUR (https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=jorrit%40ncode%2enl&item_name=nCode%20vBulletin%20Plugins&item_number=ncode_vbulletin&no_shipping=1&cn=Comments&tax=0¤cy_code=EUR&lc=UK&bn=PP%2dDonationsBF&charset=UTF%2d8)