mozdev.org

Mycroft[boxes]

bullet Users: Home | Search | Uninstall | Requests | Contact | Hosting plugins
bullet Developers: Contribute | Submit Plugins | Judge Plugins | Broken Plugins | Mailing List | Bugs
bullet Documentation: Table of Contents | Quick Start | Introduction | Installing | Header | <SEARCH> | <INPUT> | <INTERPRET> | <BROWSER> | Icons | Additional Documentation

Advanced Mozilla-Search Plugin Documentation.

Back to Main Table of Contents

The <BROWSER> tag information

Top^

alsomatch

The alsomatch tag is used for issues such as redirects and additional result URLs. For example if your plugin uses:

action="http://www.searchsite.com/search

but the output returns from:

http://search2.searchsite.com/searchprogram

use this code:

alsomatch="http://search2.searchsite.com/searchprogram"

It will enable Mozilla-Search to propagate the sidebar with links from http://search2.searchsite.com/searchprogram as well as the URL in the action code.

Use alsomatch when you have an additional result URL.
For example:

alsomatch="'http://search2.searchsite.com/searchprogram','http://downloads.searchsite.com/search','http://documents.searchsite.com/searchprogram'" 

this can come in handy for sites that have multiple search engines, sites that have multiple redirects and sites that have multiple mirrors. If the site has multiple search engines that do not display output in the same format. You will need to add an addition <interpret> tag for the new format if you want it to work with alsomatch. For more information on <interpret> visit the interpret section of this document.

Top^

update

update="http://mycroft.mozdev.org/update.php/id0/myplugin.src"

The update tag should point to the script update.php which will retrieve the latest version of the .src file. The only part to change is 'myplugin'. The 'id0' section is for future development to allow us to do some simple counting.

Top^

updateIcon

updateIcon="http://mycroft.mozdev.org/update.php/id0/myplugin.png"

The updateIcon tag should point to the script update.php which will retrieve the latest version of the icon. The only part to change is 'myplugin.png'. (Remember to change the file extension if using .gif, .jpg or .jpeg).

Top^

updateCheckDays

updateCheckDays="7"

The updateCheckDays tag determines the interval or number of days that should pass before the plugin should check for an update for the (updateIcon)image and (update)source files.

Top^ Back to Main Table of Contents Next>

User Contributed Notes for this section

Have a useful tip or trick to add to this section? You can use the form below to add your comment to the user contributed notes.

If you find something that no longer works, is invalid, or is no longer needed. Please let us know by contacting us through the Mycroft Mailing List.

Please do not place corrections in the user notes section, it is for helpful tips and tricks only.

Have you found and documented a feature that is not documented in these pages? Send it to us for inclusion in these documents and we will add your name to the list of contributors for this document.

User Notes: [?]

If you do not get a response to a question posted in this forum, please try sending a message to the project's mailing list or to the project owner directly.

[1] Submitted by: remi on Monday November 18th 2002

What about relative URL used in search engines ?
Have a look at bug #65453 (http://bugzilla.mozilla.org/show_bug.cgi?id=65453)
where I use a baseUrl tag (added with a patch) to work around this problem. I'd like to read your thoughts about it because it is a really annoying bug for me

[2] Submitted by: mat @mycroft on Monday November 18th 2002

That is a very annoying bug. Thank you for providing a patch for it. I've added myself to the CC: list for that bug and will add the appropriate tag to our documentation when I hear that it is in the nightly releases.

[3] Submitted by: Ian Anderson on Monday June 14th 2004

Are the update* tags optional? If I want to disable update altogether so that custom changes don't get overwritten, will changing updateCheckDays to 0 work? If not, should I change the update URL to point to the local file?

Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.6) Gecko/20040206 Firefox/0.8
[4] Submitted by: localhost on Tuesday June 15th 2004

In reply to Ian Anderson who wrote:
Are the update* tags optional? If I want to disable update altogether so that custom changes don't get overwritten, will changing updateCheckDays to 0 work? If not, should I change the update URL to point to the local file?

If you leave it out, your plugin will still work. The lines are very usefull though. This way plugins stay up to date without the user having to visit the site after every update on the plugin.
Perhaps it is an idea to post your customisation back to Mycroft. Could be worth a new plugin!

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8a2) Gecko/20040614
[5] Submitted by: Mike Koenecke on Wednesday June 16th 2004

With regard to disabling updates, one reason to do so is to customize a plugin slightly and keep it that way. For instance, I prefer having the Wikipedia plugin simply read "Wikipedia" in the dropdown list instead of "Wikipedia (EN)", which is a simple edit. I'd rather it not change back to "Wikipedia (EN)" (potentially) every three days, though.

Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.7) Gecko/20040614 Firefox/0.9
[6] Submitted by: Sam Prince on Sunday 25th July 2004 at 07:37 -0400

Re: [5] Have you tried making the .src file read only?

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7) Gecko/20040707 Firefox/0.9.2
[7] Submitted by: NeuVeu Coder on Saturday 11th September 2004 at 19:40 -0400

I have made more search engine plugins but i do not know how to submit them. can someone help me with that?

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7) Gecko/20040803 Firefox/0.9.3
[8] Submitted by: Lahiru Thiwanka on Wednesday 18th May 2005 at 04:29 -0400

Thanking You. i was larn it.

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.8) Gecko/20050511 Firefox/1.0.4
[9] Submitted by: Bjarki [Iceland] on Tuesday 7th June 2005 at 18:53 -0400

Where can I find the location of the *.src file...I'm not the owner of the search engine

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.5) Gecko/20041107 Firefox/1.0
[10] Submitted by: RandomEcho.com on Sunday 16th October 2005 at 19:20 -0400

9 - Locate and look inside the searchplugins folder of where you've installed Firefox.

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.12) Gecko/20050915 Firefox/1.0.7
[11] Submitted by: Alexey Kiselev on Tuesday 18th October 2005 at 21:52 -0400

Which URI should I enter for "update" and "updateIcon" in section for NEW searchplugin? There is an error: "Error: Update URI 'http://mycroft.mozdev.org/plugins/easycracks.src' does not point to the correct location.". How to get write location?

Mozilla/5.0 (Windows; U; Windows NT 5.1; ru-RU; rv:1.7.12) Gecko/20050919 Firefox/1.0.7
[12] Submitted by: Sam Stevens on Thursday 20th October 2005 at 15:21 -0400

Same issue as Alexey... with my previous plugin submissions, I always used "http://mycroft.mozdev.org/plugins/mypluginname.src", but this now throws up an error. I tried pointing the update URI's to my web server, but the submission app balked at that too. Is this a bug in the submission app, or a new protocol? Where should those update URI's point to?

cheers
SAM :)

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.12) Gecko/20050915 Firefox/1.0.7
[13] Submitted by: Sean Q on Sunday 23rd October 2005 at 02:19 -0400

I have made some australian search engine plugins:
- eBay Australia
- Google Australia Search
- Anzwers
- Dick Smith Electronics
- StaticICE

When I try to upload I get a URI error for update icon, and the .src file. Can somebody please tell me where I point the URI to? Cheers.

http://aussearch.blogspot.com
crazytalkingpie@gmail.com

Sean

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.8) Gecko/20050511 Firefox/1.0.4
[14] Submitted by: ������� on Saturday 5th November 2005 at 16:22 -0500

����� � php ��������� � ������ ������ ��� �������� � �� ���� �������� ��� ��������� �� ��� ������� ��� ������� ������� ���� � ��� ������

Mozilla/5.0 (Windows; U; Windows NT 5.1; ru-RU; rv:1.7.12) Gecko/20050919 Firefox/1.0.7
[15] Submitted by: ������� on Saturday 5th November 2005 at 16:24 -0500

2 Alexey Kiselev - ������, ���� ��������� ����� ����� ��� ������

The update tag should point to the script update.php which will retrieve the latest version of the .src file

Mozilla/5.0 (Windows; U; Windows NT 5.1; ru-RU; rv:1.7.12) Gecko/20050919 Firefox/1.0.7
[16] Submitted by: Sam Stevens on Tuesday 8th November 2005 at 13:13 -0500

It appears that several of us need to know what URI to point to for UPDATE. Finally, Alexey has chimed in, stating that the UPDATE tag should point to "the script update.php". OK, but what then is the full URI to this script?

thanks!
SAM :)

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.12) Gecko/20050915 Firefox/1.0.7
[17] Submitted by: Logan on Thursday 10th November 2005 at 19:51 -0500

I figured there would need to be a script to point the update lines to, but where can we get the source to the update script?

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.12) Gecko/20050915 Firefox/1.0.7
[18] Submitted by: Charles at Mycroft on Wednesday 16th November 2005 at 21:09 -0500

Sam, this document was changed on 12/10/2005 - see:
http://www.mozdev.org/source/browse/mycroft/www/deepdocs/browsertag.html?rev=1.28&content-type=text/x-cvsweb-markup
Logan, source here:
http://www.mozdev.org/source/browse/mycroft/www/update.php?rev=1.1&content-type=text/x-cvsweb-markup
(The logic is to look for the latest known good version)

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv:1.7.12) Gecko/20050919 Firefox/1.0.7
[19] Submitted by: Sam Stevens on Tuesday 22nd November 2005 at 13:31 -0500

Thanks for the clarification, Charles! I have successfully submitted my plugin using:

update="http://mycroft.mozdev.org/update.php/id0/phpdirectory.src"
updateIcon="http://mycroft.mozdev.org/update.php/id0/phpdirectory.gif"

cheers
SAM :)

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.12) Gecko/20050915 Firefox/1.0.7
[20] Submitted by: Justin on Saturday 31st December 2005 at 03:56 -0500

did the update URI get changed again, because I tried the one Sam used but it doesn't work, and the deep docs don't help me. Can someone please write them out in the same fashion as he did? (e.g. update=, updateIcon=)

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8) Gecko/20051111 Firefox/1.5
[21] Submitted by: Ray on Sunday 12th February 2006 at 03:37 -0500

Just tried submitting a plugin and I'm getting the same error regarding the updateIcon - any help would be appreciated.

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1
[22] Submitted by: Ray on Sunday 12th February 2006 at 03:57 -0500

Found a work-around regarding the above - I just switched the two lines of code, and it got accepted.

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1
[23] Submitted by: Charles at Mycroft on Sunday 12th February 2006 at 12:02 -0500

Could you email me the one that didn't work and the one that did at mycroft.mozdev.org AT googlemail.com and I'll see if I can work out the problem...

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1
[24] Submitted by: Ken Clarke on Thursday 23rd February 2006 at 16:36 -0500

One problem I'm having with the submitter is that it doesn't like the extension .ico for the updateIcon parameter.

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1
[25] Submitted by: Charles at Mycroft on Friday 24th February 2006 at 21:44 -0500

Re #24
That would be because .ico is invalid. It must be .png, .gif or .jpg (or .jpeg but I think that might cause problems as I think I assumed it's always 3 characters somewhere)

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1
[26] Submitted by: Daniel on Wednesday 15th March 2006 at 16:26 -0500

How do I update a plugin that I made? just resubmit it?

Mozilla/5.0 (Windows; U; Win98; en-US; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1
[27] Submitted by: devil_friend on Friday 21st April 2006 at 18:17 -0400

i have made som search engine plugins too but the site ask me for tag, and i dont have any, if i put it alone it ask me for atributes

Mozilla/5.0 (Windows; U; Windows NT 5.1; es-AR; rv:1.8.0.2) Gecko/20060308 Firefox/1.5.0.2
[28] Submitted by: Tony Potter on Monday 24th April 2006 at 21:35 -0400

is your tag and your attribute is the first part of your url link

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.2) Gecko/20060308 Firefox/1.5.0.2
[29] Submitted by: Martin Josefsson on Friday 26th May 2006 at 15:34 -0400

Iam getting the error:
# Error: Update URI 'update=' does not point to the correct location. Please see documentation.
# Error: UpdateIcon URI 'updateIcon=' does not point to the correct location. Please see documentation.

My code is:


I have also tried to do it on my own apache web server, but i get the same errors(but now for mycroft.mozdev.org, instead my own server and domain of
course).

Mozilla/5.0 (Windows; U; Windows NT 5.1; sv-SE; rv:1.8.0.3) Gecko/20060426 Firefox/1.5.0.3
[30] Submitted by: Martin Josefsson on Friday 26th May 2006 at 15:36 -0400

Fixed my proglem with #19 Sam Stevens answer, thanks:D

Mozilla/5.0 (Windows; U; Windows NT 5.1; sv-SE; rv:1.8.0.3) Gecko/20060426 Firefox/1.5.0.3
[31] Submitted by: sodometal on Thursday 30th November 2006 at 23:32 -0800

hi,
i created a plugin for my phpbb forum. however, when i do the search through the search bar, the search page of the forum appears. it does not recognize my query. do we have to something different for phpbb forums?

sorry if this has been replied before...

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv:1.8.1) Gecko/20061010 Firefox/2.0
[32] Submitted by: /me on Sunday 7th January 2007 at 14:27 -0800

phpbb forums use post method

Mozilla/5.0 (PLAYSTATION 3; 2.00)
[33] Submitted by: Georg Jaehnig on Thursday 31st May 2007 at 13:24 -0700

Hi,

is there a way to replace sherlock plugins with new opensearch plugins, so that they will update automatically via the tag?

I will implement suggestions on my search site Serchilo.net and would like to make them available for my users without forcing them to install the opensearch plugin manually.

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.3) Gecko/20070309 Firefox/2.0.0.3
[34] Submitted by: Georg Jaehnig on Thursday 31st May 2007 at 17:08 -0700

Continuing [33]: I just had the idea to upload a sherlock plugin with a browser-update-url to the new opensearch-plugin, but I'm not allowed to point at updateos.php in Sherlock-plugins :-(

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.4) Gecko/20070515 Firefox/2.0.0.4

Contact the Mycroft Project at mycroft.mozdev.org AT googlemail.com or see other options.
Copyright © 2000-2008. All rights reserved. Terms of Use & Privacy Policy.