Suppose you are browsing http://www.wired.com and you want to search for an article on "Firefox" on the site
Either: you locate the search field on the webpage [by eventually scrolling up/down or do a "mouse-over" to display an HTML search widget; see: http://www.animesuki.com ], set focus on it and enter/submit your query
Or: if you use the "Search This Site" searchbar: access quickly with your mouse (shortcut: ALT+Q) and enter/submit your query (the search address for the site is automatically determined)
Both ways will lead you to: "http://www.wired.com/search?query=Firefox&siteAlias=all" but one is less time-consuming.
HOW DOES IT WORK?
Firefox provides a "way to search specific websites directly from the Firefox Location bar" called "Smart keywords". See: http://support.mozilla.com/en-US/kb/Smart+keywords for details.
Based on this, the "Search This Site" searchbar works by determining the search field and the search URL for the page (in our example: http://www.wired.com/search?query=%s&siteAlias=all). Upon submitting, the addon replaces "%s" by the query string (in our example: "Firefox").
Note that the SearchThisSite add-on supports both GET and POST forms.
CAVEATS:
1) , The addon may fail on some sites, especially those where Javascript formatting code is executed before submitting the code (example: timesonline.co.uk with [form onsubmit="someJavascriptFunction();"...]). The internal Firefox "Smart keywords" will equally dysfunction on these sites.
When (simple) Javascript formatting code is present, the searchbar will display: "Search: !example.com" (with an exclamation mark)
When (simple) Javascript formatting code is absent, the searchbar will display: "Search: example.com" (without the exclamation mark)
Complex Javascript formatting code (use of listeners, etc...) is not yet handled.
2) search results are displayed in the same tab only (no configuration yet to open in new tab or new window)
3) access key fixed to ALT+Q (no configuration yet to change it)
Product's homepage
Requirements:
· Mozilla Firefox
What's New in This Release: [ read full changelog ]
· Minor corrections.