%META:TOPICINFO{author="TWikiGuest" date="1142926767" format="1.1" 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

