1
edit
Changes
→Project Details
<b><font style== "font-size:160%"> Project Details ==</font></b>----
<b><font style="font-size:140%">Release v.01</font></b> 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 function name - What what the functioning 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 happens 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.
<b><font style="font-size:120%">Downloading and applying the patch:</font></b>
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.
* '''NOTE:''' This patch requires that you use a DEBUG build of firefox.
* You can view the patch here: [[Localized Search in Firefox Search Box: Release v.01]]
2. Apply the patch.
<pre>
$ cd mozilla
$ patch -p0 < localsearchpatch_v01.txt
</pre>
* '''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.
<pre>
$ cd mozilla
$ make -f client.mk build
</pre>
4. Run the browser to test the patch.
<pre>
$ cd objdir/dist/bin
$ ./firefox --ProfileManager --no-remote
</pre>
<b><font style="font-size:120%">How to use the patch:</font></b>
1. Navigate to a web site that offers a search engine plugin:
* [https://bugzilla.mozilla.org/ Bugzilla@Mozilla]
* [http://developer.mozilla.org/en/docs/Main_Page Mozilla Developer Center]
* [http://www.theglobeandmail.com/ The Globe and Mail]
'''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.
----
<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.
----
* When the user navigates away from the web page with the search engine plugin, dynamically remove the search plugin.
<b><font style="font-size:160%">Resources:</font></b>
[https://bugzilla.mozilla.org/ Bugzilla@Mozilla]