%META:TOPICINFO{author="PeterThoeny" date="1097558590" format="1.0" version="1.3"}%
%META:TOPICPARENT{name="TWikiVariablesNtoZ"}%
#VarSEARCH
---+++ SEARCH{"text"} -- search content
	* Inline search, shows a search result embedded in a topic
	* Syntax: =%<nop>SEARCH{"text" ...}%=
	* Supported parameters: [1]
	  | *Parameter:* | *Description:* | *Default:* |
	  | ="text"= | Search term. Is a keyword search, literal search or regular expression search, depending on the =type= parameter. SearchHelp has more | required |
	  | =search="text"= | (Alternative to above) | N/A |
	  | =web="Name"= <br /> =web="%MAINWEB%, Know"= <br /> =web="all"= | Wiki web to search: A web, a list of webs separated by comma, or =all= webs. [2] | Current web |
	  | =topic="%WEBPREFSTOPIC%"= <br /> =topic="*Bug"= | Limit search to topics: A topic, a topic with asterisk wildcards, or a list of topics separated by comma. | All topics in a web |
	  | =excludetopic="Web*"= <br /> =excludetopic="%HOMETOPIC%, <nop>WebChanges"= | Exclude topics from search: A topic, a topic with asterisk wildcards, or a list of topics separated by comma. | None |
	  | =type="keyword"= <br /> =type="literal"= <br /> =type="regex"= | Do a keyword search like =soap "web service" -shampoo=; a literal search like =web service=; or RegularExpression search like =soap;web service;!shampoo= | =%<nop>SEARCHVARDEFAULTTYPE%= [[TWikiPreferences][preferences]] setting (%SEARCHVARDEFAULTTYPE%) |
	  | =scope="topic"= <br /> =scope="text"= <br /> =scope="all"= | Search topic name (title); the text (body) of topic; or all (both) | ="text"= |
	  | =order="topic"= <br /> =order="created"= <br />  =order="modified"= <br /> =order="editby"= <br /> =order=<br />&nbsp;"formfield(name)"= | Sort the results of search by the topic names, topic creation time, last modified time, last editor, or named field of TWikiForms. The sorting is done web by web; in case you want to sort across webs, create a [[FormattedSearch][formatted]] table and sort it with TablePlugin's initsort | Sort by topic name |
	  | =limit="all"= <br /> =limit="16"= | Limit the number of results returned. This is done after sorting if =order= is specified | All results |
	  | =reverse="on"= | Reverse the direction of the search | Ascending search |
	  | =casesensitive="on"= | Case sensitive search | Ignore case |
	  | =nosummary="on"= | Show topic title only | Show topic summary |
	  | =bookview="on"= | BookView search, e.g. show complete topic text | Show topic summary |
	  | =nosearch="on"= | Suppress search string | Show search string |
	  | =noheader="on"= | Suppress search header <br /> <span style='background: #FFB0B0;'> *Topics: Changed: By:* </span> | Show search header |
	  | =nototal="on"= | Do not show number of topics found | Show number |
	  | =header="..."= <br /> =format="..."= | Custom format results: see *[[FormattedSearch]]* for usage, variables &amp; examples | Results in table |
	  | =expandvariables="on"= | Expand variables before applying a FormattedSearch on a search hit. Useful to show the expanded text, e.g. to show the result of a SpreadSheetPlugin =%<nop>CALC{}%= instead of the formula | Raw text |
	  | =multiple="on"= | Multiple hits per topic. Each hit can be [[FormattedSearch][formatted]]. The last token is used in case of a regular expression ";" _and_ search | Only one hit per topic |
	  | =separator=", "= | Line separator _between_ hits, effective only in FormattedSearch | Newline ="$n"= |
	  | =newline="%<nop>BR%"= | Line separator _within_ a search hit, effective only in FormattedSearch. Useful to capture multiple lines in a =$pattern()= and to show that in a TWiki table; or to perform a spreadsheet CALCulation on multiple lines | Newline ="$n"= |
	* Example: =%<nop>SEARCH{"wiki" web="%MAINWEB%" scope="topic"}%=
	* Example with format: =%<nop>SEARCH{"FAQ" scope="topic" nosearch="on" nototal="on" header="| *Topic: * | *Summary: * |" format="<nop>| $topic | $summary |"%= _(displays results in a table with header - [[FormattedSearch][details]])_
	* %H% If the TWiki:Plugins.TablePlugin is installed, you may set a =%<nop>TABLE{}%= variable just before the =%<nop>SEARCH{}%= to alter the output of a search.  Example: =%<nop>TABLE{ tablewidth="90%" }%=
	* Related: [[#VarMETASEARCH][METASEARCH]], [[#VarTOPICLIST][TOPICLIST]], [[#VarWEBLIST][WEBLIST]], FormattedSearch, SearchHelp

	* [1] __Note__: The search form uses identical names for input fields.
	* [2] __Note__: A web can be excluded from a =web="all"= search if you define a =NOSEARCHALL=on= variable in its %WEBPREFSTOPIC%
%STOPINCLUDE%

__Note:__ This topic gets included by TWikiVariablesNtoZ and TWikiVariables

-- Main.PeterThoeny - 07 Oct 2004