%META:TOPICINFO{author="jmv" date="1142926756" format="1.0" version="1.5"}%
---++ Search form
<form action="%SCRIPTURLPATH%/plucsearch%SCRIPTSUFFIX%/%INTURLENCODE{"%INCLUDINGWEB%"}%/">
	<input type="text" name="search" size="32" /> <input type="submit" value="Search text" />
	in <select name="web">
	  <option value="all">all public webs</option>
	  <option value="%INCLUDINGWEB%">current web</option>
%WEBLIST{"	  <option>$name</option>"}%
	</select><br/>
	<input type="checkbox" name="nosummary" /> do not show summaries <br/>
	<input type="checkbox" name="nototal" /> do not show total matches <br/>
	<input type="checkbox" name="showlock" /> show locked topics <br/>
	limit result count to <input type="text" name="limit" size="5" value="all" />
</form>

<hr/>Note that you can redefine this form to suit your current needs, removing the options you don't want<hr/>

---+++ Search through all webs form (suited for top bar)
<verbatim>
<form action="%SCRIPTURLPATH%/plucsearch%SCRIPTSUFFIX%/%INTURLENCODE{"%INCLUDINGWEB%"}%/">
  <input type="text" name="search" size="32" /> <input type="submit" value="Search" />
  <input type="hidden" name="web" value="all">
</form>
</verbatim>

---+++ Search through current web (suited for left bar)
<verbatim>
<form action="%SCRIPTURLPATH%/plucsearch%SCRIPTSUFFIX%/%INTURLENCODE{"%INCLUDINGWEB%"}%/">
  <input type="text" name="search" size="32" /> <input type="submit" value="Go" />
  <input type="hidden" name="web"  value="%INCLUDINGWEB%">
</form>
</verbatim>

---++ Query syntax
	* you can use ==+== and ==-==, as Google query syntax, just for ==AND== and ==AND NOT== operators respectively
	* for a text search, just put the word or add the prefix ==text:== before it
	* for a sentence search, just put double quotes
	* if you want to search using some meta data, you should use the prefix ==field:== where _field_ is the meta data name (i.e. author).


---+++ Query examples (just type it in your ==PluceneSearch== site topic)
	* ==text:plucene== or just ==plucene==
	* ==text:"search engine"== or just =="search engine"==
	* ==author:JoanMVigo== note that you should use the login name
	* ==form:WebFormName== to get all topics with that form
	* ==CONTACTINFO:JoanMVigo== if you have declared ==CONTACTINFO== as a variable to be indexed
	* ==type:doc== to get all attachments of given type
	* ==web:Sandbox== to get all the topics of a given web
	* ==topic:WebHome== to get all the topics of a given name
	* ==+web:Sandbox +topic:Test== to get all the topics with word Test in name and belonging to Sandbox

__Notes:__ current version of Plucene does not support wildcards.

__See also:__ TWiki.SearchEnginePluceneAddOn

-- TWiki:Main/JoanMVigo - 21 Mar 2006

