Add internet.com Web Developer Sites to Your Search Bar
Search Us: Adding Search Engines to Browser Search Toolbars
Once you click the appropriate Add Engine link below (as of this writing, Firefox 1.5+ and Internet Explorer 7+ are the only browsers that the Add Engine links support), you will be able to select that site as the target for searches in your Firefox or Internet Explorer search toolbar. Just select the site, key in your search term, and press enter: You will then be taken directly to our own search engine results for the terms you entered!
The WebReference Search Engine
in the Mozilla search Sidebar
To allow users to add your own search engine to their browser search bars, you must first create the supporting configuration files used by each of the browsers, and then provide an Add Engine link to your page(s) that will allow the users to utilize those files. Optionally (but recommended) you can add a link reference to the OpenSearch description file, so that browsers that support it can auto-discover the file and add the option to their search toolbars so long as they're viewing the page.
Before adding an Add Engine link to your pages, you must first create supporting configuration files that will describe to the browser how to access and utilize your search engine. To support Firefox 1.5+ and Internet Explorer 7, you'll need to create two files: a Mycroft Definition File, and an OpenSearch Definition File. The Mycroft file will be used in Firefox, and the OpenSearch file will be used in Internet Explorer 7 (Firefox 2 also supports discovery and use of the OpenSearch description file). We're not going to examine these files in detail, but in brief they provide the appropriate parameters to the browser that it will in turn provide to the search engine in order to generate (and, in the case of the Mycroft files, interpret) the results of the search. For the full skinny on how to create these files, we refer you to the following sites:
Adding an Add Engine Link (addSearchEngine and AddSearchProvider)
In the addSearchEngine call, you will need to replace our WebRef stuph with your own values. The first entry is the location of your .src file, that's the Mycroft file you created above. The second is the location of the image icon that will be used to label your search engine in the browser. The third entry is a name for this search engine; it will be used when the browser prompts the user for their permission to add this engine. Finally, the fourth entry is the category for this entry; which may be useful in the Mozilla or Firefox sidebar search tools.
In the AddSearchProvider call, which is the logic that allows adding an engine to IE7 and Firefox 2.0, you need to provide the location of the OpenSearch .xml file that you created above.
To provide a link to the user to launch the script, add a link such as the following:
<a href="addsearch.html" onclick="return addEngine();">Add our Search Engine to your toolbar</a>
Adding an Auto-Discovery Link
While the above are the only steps that are necessary for your users to add your search engine to their toolbar, you should also consider adding an auto-discovery link to your pages, per the OpenSearch specs. Such a link would look like this:
<link title="WebReference" type="application/opensearchdescription+xml" rel="search" href="http://www.webreference.com/cgi-bin/ase/q/jupm_webref.xml" />
and would allow browsers that understand the OpenSearch spec to find and use your definition file automatically. In Firefox 2, for example, when you land on this page, Add WebReference automatically appears as a choice in your search engine toolbar drop down list. In the above example, replace the "title" value with the name of your search engine entry (usually just a short name representing your site), and the href with the OpenSearch .xml file that you created above.
Adding your own site's search engine to the search toolbar can increase your traffic while providing your loyal visitors with a simple means of finding the information you have to offer--from wherever in the Web they happen to be at the time. We hope that the tools provided on this page can help you to offer this valuable service to your own visitors.
Created: August 28, 2006
Revised: November 3, 2006