Difference between revisions of "Localized Search in Firefox Search Box"

From CDOT Wiki
Jump to: navigation, search
(Added placeholders for future targets and formatted the page.)
Line 1: Line 1:
−
<b><font style="font-size:160%"> Project Name </font></b>
+
= '''Project Name''' =
−
 
 
−
----
 
−
 
 
  
 
Localized Search in Firefox Search Box
 
Localized Search in Firefox Search Box
  
  
−
<b><font style="font-size:160%"> Project Description </font></b>
+
= '''Project Description''' =
−
 
 
−
----
 
−
 
 
  
 
Firefox features a search box that can be customized to work with different search engines (e.g., Google, Yahoo!, Wikipedia, etc.). Most websites have their own search facilities, but the location of the search box on the page varies considerably. This project creates a mechanism for Firefox to pick up a web site's search mechanism and make it accessible to the user through the Firefox search box so that users have a consistent place to look for site-specific search.
 
Firefox features a search box that can be customized to work with different search engines (e.g., Google, Yahoo!, Wikipedia, etc.). Most websites have their own search facilities, but the location of the search box on the page varies considerably. This project creates a mechanism for Firefox to pick up a web site's search mechanism and make it accessible to the user through the Firefox search box so that users have a consistent place to look for site-specific search.
  
  
−
<b><font style="font-size:160%"> Project Leader </font></b>
+
= '''Project Leader''' =
−
 
 
−
----
 
−
 
 
  
 
[http://zenit.senecac.on.ca/wiki/index.php/User:Sinker Kerry M. Singh]
 
[http://zenit.senecac.on.ca/wiki/index.php/User:Sinker Kerry M. Singh]
  
  
−
<b><font style="font-size:160%"> Project Details </font></b>
+
= '''Project Details''' =
−
----
 
  
  
−
<b><font style="font-size:140%">Release v.01</font></b>
+
== '''Release v.01''' ==
  
 
This release demonstrates my understanding of how some searchbar features currently work in the Firefox browser. I've uploaded a [http://zenit.senecac.on.ca/wiki/index.php/Image:Localsearchpatch_v01.txt.zip patch file] that outputs a series of dump("DIAGNOSTIC MESSAGE: function name - what the source code is doing") statements to the terminal window while running a debug build of Firefox (i.e. Minefield). Specifically, what functions/methods are called and what is happening in the source code with respect to the searchbar menu when the following events occur:
 
This release demonstrates my understanding of how some searchbar features currently work in the Firefox browser. I've uploaded a [http://zenit.senecac.on.ca/wiki/index.php/Image:Localsearchpatch_v01.txt.zip patch file] that outputs a series of dump("DIAGNOSTIC MESSAGE: function name - what the source code is doing") statements to the terminal window while running a debug build of Firefox (i.e. Minefield). Specifically, what functions/methods are called and what is happening in the source code with respect to the searchbar menu when the following events occur:
Line 39: Line 29:
  
  
−
<b><font style="font-size:120%">Downloading and applying the patch:</font></b>
+
=== '''Downloading and applying the patch:''' ===
  
 
1. Download the [http://zenit.senecac.on.ca/wiki/index.php/Image:Localsearchpatch_v01.txt.zip patch file] to the root mozilla directory of your source tree and unzip the file there. I suggest renaming the file localsearchpatch_v01.txt.
 
1. Download the [http://zenit.senecac.on.ca/wiki/index.php/Image:Localsearchpatch_v01.txt.zip patch file] to the root mozilla directory of your source tree and unzip the file there. I suggest renaming the file localsearchpatch_v01.txt.
Line 68: Line 58:
  
  
−
<b><font style="font-size:120%">How to use the patch:</font></b>
+
=== '''How to use the patch:''' ===
  
 
1. Navigate to a web site that offers a search engine plugin:  
 
1. Navigate to a web site that offers a search engine plugin:  
Line 103: Line 93:
  
  
−
----
+
== '''Release Target for v.02''' ==
 +
 
 +
* When Firefox loads a web page with an available search engine plugin, dynamically load the search engine and propagate it to the top of the searchbar's menu as the current engine.
 +
 
 +
 
 +
== '''Release Target for v.03''' ==
  
 +
* When the user navigates away from the web page with the search engine plugin, dynamically remove the search plugin.
  
−
<b><font style="font-size:140%">Release Target for v.02</font></b>
 
  
−
* When Firefox loads a web page with an available search engine plugin, dynamically load the search engine and propagate it to the top of the searchbar's menu as the current engine.
+
== '''Release Target for v.04''' ==
 +
 
 +
* TBA
 +
 
 +
 
 +
== '''Release Target for v.05''' ==
 +
 
 +
* TBA
 +
 
 +
 
 +
== '''Release Target for v.06''' ==
 +
 
 +
* TBA
 +
 
 +
 
 +
== '''Release Target for v.07''' ==
 +
 
 +
* TBA
  
  
−
----
+
== '''Release Target for v.08''' ==
  
 +
* TBA
  
−
<b><font style="font-size:140%">Release Target for v.03</font></b>
 
  
−
* When the user navigates away from the web page with the search engine plugin, dynamically remove the search plugin.
+
== '''Release Target for v.09''' ==
  
 +
* TBA
  
−
----
 
  
 +
== '''Release Target for v1.0''' ==
  
−
<b><font style="font-size:160%">Resources:</font></b>
+
* TBA
  
−
----
 
  
 +
= '''Resources''' =
  
 
[https://bugzilla.mozilla.org/ Bugzilla@Mozilla]
 
[https://bugzilla.mozilla.org/ Bugzilla@Mozilla]
Line 138: Line 151:
  
  
−
<b><font style="font-size:160%"> Project-Related Bugs </font></b>
+
= '''Project-Related Bugs''' =
−
 
 
−
----
 
−
 
 
  
 
[https://bugzilla.mozilla.org/show_bug.cgi?id=236587 Bug 236587 - Allow bookmark keyword searches from the search bar]
 
[https://bugzilla.mozilla.org/show_bug.cgi?id=236587 Bug 236587 - Allow bookmark keyword searches from the search bar]
Line 155: Line 165:
 
[https://bugzilla.mozilla.org/show_bug.cgi?id=360907 Bug 360907 – Search current site with OpenSearch]
 
[https://bugzilla.mozilla.org/show_bug.cgi?id=360907 Bug 360907 – Search current site with OpenSearch]
  
−
[https://bugzilla.mozilla.org/show_bug.cgi?id=408244 Bug 408244 – show opensearch plugin availability same as feed availabilitiy]
+
[https://bugzilla.mozilla.org/show_bug.cgi?id=408244 Bug 408244 – show opensearch plugin availability same as feed availability]
  
 
[https://bugzilla.mozilla.org/show_bug.cgi?id=405443 Bug 405443 – Making search engine discovery more discoverable]
 
[https://bugzilla.mozilla.org/show_bug.cgi?id=405443 Bug 405443 – Making search engine discovery more discoverable]
Line 164: Line 174:
  
  
−
<b><font style="font-size:160%"> Project News </font></b>
+
= '''Project News''' =
−
 
 
−
----
 
−
 
 
  
 
For up-to-date information about my project, visit my blog: [http://kmsingh.blogspot.com/ Kerry's Open Source Blog]
 
For up-to-date information about my project, visit my blog: [http://kmsingh.blogspot.com/ Kerry's Open Source Blog]

Revision as of 21:50, 1 February 2008

Project Name

Localized Search in Firefox Search Box


Project Description

Firefox features a search box that can be customized to work with different search engines (e.g., Google, Yahoo!, Wikipedia, etc.). Most websites have their own search facilities, but the location of the search box on the page varies considerably. This project creates a mechanism for Firefox to pick up a web site's search mechanism and make it accessible to the user through the Firefox search box so that users have a consistent place to look for site-specific search.


Project Leader

Kerry M. Singh


Project Details

Release v.01

This release demonstrates my understanding of how some searchbar features currently work in the Firefox browser. I've uploaded a patch file that outputs a series of dump("DIAGNOSTIC MESSAGE: function name - what the source code is doing") statements to the terminal window while running a debug build of Firefox (i.e. Minefield). Specifically, what functions/methods are called and what is happening in the source code with respect to the searchbar menu when the following events occur:

  • The browser auto-detects a site that has a search plugin available.
  • The user selects the button to display the search engine list when a search plugin is available.
  • The user selects the option to "Add this search engine".
  • The user changes the current search engine by selecting it from the search bar drop-down list (menu).
  • The user moves the position of a search engine using the Search Engine Manager.
  • The user removes an auto-detected search engine from the list of "installed" search engines.


Downloading and applying the patch:

1. Download the patch file to the root mozilla directory of your source tree and unzip the file there. I suggest renaming the file localsearchpatch_v01.txt.

2. Apply the patch. 

 $ cd mozilla
 $ patch -p0 < localsearchpatch_v01.txt
  • NOTE: Use the -p0 option to strip 0 leading directories from each filename in the patch because it is being applied in the same directory where the patch was created.


3. Build your source tree. 

 $ cd mozilla
 $ make -f client.mk build


4. Run the browser to test the patch. 

 $ cd objdir/dist/bin
 $ ./firefox --ProfileManager --no-remote


How to use the patch:

1. Navigate to a web site that offers a search engine plugin:

Note the DIAGNOSTIC MESSAGE in the terminal window.


2. Click the searchbar's dropdown menu button.

  • Note the DIAGNOSTIC MESSAGE in the terminal window and the "Add this engine" option on the searchbar menu.


3. Click the "Add this engine" option on the searchbar menu.

  • Note the DIAGNOSTIC MESSAGE in the terminal window and the position of the newly added search engine on the searchbar menu.


4. Select "Manage Search Engines..." from the searchbar menu and select the newly installed engine from the list. Click the "Remove" button and then click "OK".

  • Note the DIAGNOSTIC MESSAGES in the terminal window.


5. Select "Manage Search Engines..." from the searchbar menu and select one of the installed engines on the list. Next, click the "Move Up" and "Move Down" buttons and then click "OK".

  • Note the DIAGNOSTIC MESSAGES in the terminal window.


6. Click the searchbar's dropdown menu button and select a different search engine as the current engine.

  • Note the DIAGNOSTIC MESSAGES in the terminal window.


Release Target for v.02

  • When Firefox loads a web page with an available search engine plugin, dynamically load the search engine and propagate it to the top of the searchbar's menu as the current engine.


Release Target for v.03

  • When the user navigates away from the web page with the search engine plugin, dynamically remove the search plugin.


Release Target for v.04

  • TBA


Release Target for v.05

  • TBA


Release Target for v.06

  • TBA


Release Target for v.07

  • TBA


Release Target for v.08

  • TBA


Release Target for v.09

  • TBA


Release Target for v1.0

  • TBA


Resources

Bugzilla@Mozilla

Mozilla Cross-Reference

MDC- Mozilla Developer Center

Search Service: Code Design - Automatic Detection

SearchLoad Options :: Firefox Add-ons


Project-Related Bugs

Bug 236587 - Allow bookmark keyword searches from the search bar

Bug 249481 – User-defined searches available not only as bookmark keywords, but also from the Search box

Bug 374268 – Quicksearch/keyword should be integrated into search engine manager

Bug 261124 – Textbox context menu should have "Add to Search Bar..."

Bug 335448 – Autodetect repeated use of a search field, and ask the user if they want that engine added to the browser search box

Bug 360907 – Search current site with OpenSearch

Bug 408244 – show opensearch plugin availability same as feed availability

Bug 405443 – Making search engine discovery more discoverable

Bug 356332 – Select default search engine again after searching with another

Bug 384124 – Option to reset search bar engine to default when starting Firefox


Project News

For up-to-date information about my project, visit my blog: Kerry's Open Source Blog

Retrieved from "https://wiki.cdot.senecapolytechnic.ca/w/index.php?title=Localized_Search_in_Firefox_Search_Box&oldid=14736"