==================================================================
Snippet-title:		searcher v1.1
Creator:		Graham Keellings
E-mail:			pivot@keellings.com
Website:		http://www.keellings.com/software/pivot.php
Creation date:		14 May 2006, Singapore
==================================================================

Content of zipped file:
-----------------------
snippet_searcher.php
readme_searcher.txt (this file)


Usage:
------
1) unpack this package in your extensions/snippets/ folder.
2) place a [[searcher]] tag, with the appropriate parameters, in any of your template files, whereever you want the link to the search to appear
3) rebuild the FrontPage(s).
   
Description:
------------
* This snippet will add a URL to your entry which, when clicked, gives the 
* same result as if a user had submitted a search term to the search box and 
* clicked " go". The search term will be whatever you pass as a parameter
* to the snippet.
*
* You can also use your CSS to format the appearance of the generated link.
*
* Although intended for use in entries, it could be used elsewhere.
*
* Visit http://www.keellings.com/blog/_demos/searcher.php to see it
* in action


Parameters:
-----------
*
* @param  string  SearchText - text to serach for in all of your entries.
* @param  int     ToolTip    - if 1 (Default), hovering the cursor over the
*                              link will pop up a tooltip explaining that this
*                              is a link to search results.
*                              Pass zero to supress this.
* @param  string  cssClass   - You can use this parameter to influence the 
*                              appearance of the link which the snippet
*                              produces. Just pass the name of a class defined
*                              in your CSS file.
*                                            
* @return The requested HTML, as specified by the parameters.


Examples:
-----------
[[searcher:beer]] create a link which when clicked will display all entries about beer.



* History:
* 
* v 1.1 2006/05/14 Singapore
*   - make the seach url multi weblog safe
* 
* v 1.0 2006/09/04  Singapore
*   initial version