You are here: Foswiki>Users Web>WebSearch (30 Jan 2012, AndyPryke)Edit Attach

Search in Users Web

Search basics

By default a search looks into topic titles, topic texts and form fields in the current web. Extend your search to "all public webs" to get more results.

Search this site as you are used to with Google:
  • Type the words you want to find
  • Multiple words are combined: intranet web service returns all pages that have the three words anywhere in the page
  • Use double quotes for literal search (also known as phrase search) to search the exact words in that exact order, for example "web service"
  • Exclude words using minus signs, for instance: soap -shampoo (use double quotes if you want to search for a leading minus sign, like "-nowarn")

TIP TIP: to search for all topics that contain "SOAP", "WSDL", a literal "web service", but not "shampoo", write: soap wsdl "web service" -shampoo

Troubleshooting

"My search returned less than I expected"

Perhaps your search words are listed in the stop word list and excluded from the results. a, all, am, an, and, any, as, at, b, be, by, c, d, e, for, from, g, h, how, i, i'm, i.e., in, is, isn't, it, it's, its, j, k, l, m, n, o, of, on, or, p, q, r, s, t, that, that's, the, this, to, u, v, w, was, wasn't, what, what's, when, where, who, who's, will, with, x, y, z

TIP If you want to search for a word in the stop word list, prefix the word with a plus sign

Definitions

Some explanations of used terms.

Keyword search Use Google-like queries as in soap "web service" -shampoo; searches word parts: using the example, topics with "soapsuds" will be found as well, but topics with "shampoos" will be excluded
Word search Identical to keyword but searches whole words: topics with "soapsuds" will not be found, and topics with "shampoos" will not be excluded
Literal search Also known as phrase search; search the exact words in that exact order
Regular expression search Universal way of writing advanced search queries
Query search Extend the search to form fields, parent relationships and file attachment information
Case sensitive By default searches are not case sensitive, so writing "Wiki" or "wiki" will get the same results
Public webs You won't see results from Webs that you don't have access to

Go to advanced search to see your search query translated to a SEARCH macro. It will look somewhat like this:
%SEARCH{
   "\"stuff I've read\""
   type="word"
   scope="all"
   order="editby"
   reverse="on"
   limit="10"
   zeroresults="on"
}%
You can copy and paste this text to any topic to get show search results on that page.

More search options

  • SEARCHDEFAULTTTYPE: Default search type for search forms which calls the search script
    • Currently keyword
  • SEARCHVARDEFAULTTYPE: Default search type for %SEARCH{} macro
    • Currenty literal
  • SEARCHSTOPWORDS: List of stop words (common words and characters to exclude from a keyword search)
    • Currently a, all, am, an, and, any, as, at, b, be, by, c, d, e, for, from, g, h, how, i, i'm, i.e., in, is, isn't, it, it's, its, j, k, l, m, n, o, of, on, or, p, q, r, s, t, that, that's, the, this, to, u, v, w, was, wasn't, what, what's, when, where, who, who's, will, with, x, y, z

Define or change these settings in Site Preferences.

%INCLUDE{"%TOPIC%" section="title"}%
%INCLUDE{"%TOPIC%" section="form"}%
%INCLUDE{"%TOPIC%" section="searchresults"}%


%INCLUDE{"%TOPIC%" section="title"}%
%INCLUDE{"%TOPIC%" section="form"}%
%INCLUDE{"%TOPIC%" section="searchresults"}%
%INCLUDE{"%TOPIC%" section="querysearchexample"}%



%INCLUDE{"%TOPIC%" section="title"}%
%INCLUDE{"%TOPIC%" section="tabs"}%
%INCLUDE{"%SYSTEMWEB%.SearchHelp"}%



---+!! %MAKETEXT{"Search in [_1] Web" args="<nop>%BASEWEB%"}%


%INCLUDE{"%TOPIC%" section="tabs"}%<noautolink>
<div class='foswikiWebSearchForm'>
<form name='WebSearchForm' action='%SCRIPTURLPATH{view}%/%BASEWEB%/%TOPIC%'>
<input type='hidden' name='tab' value='%URLPARAM{"tab" default="search"}%' />
<div class='foswikiFormSteps'>
<div class='foswikiFormStep'>
<input type='text' class='foswikiInputField foswikiFocus' name='search' value='%URLPARAM{"search" encode="entity"}%' size='40' style='width:99%' placeholder='%MAKETEXT{"Search"}%' />   
</div>
<div class='foswikiFormStep'>
%TWISTY{
   id="searchOptions"
   mode="div"
   start="%IF{
      "$'URLPARAM{search}'=''"
      then="show"
      else="hide"
   }%"
   link="<strong>%MAKETEXT{"Search options"}%</strong>"
   showimgleft="%ICONURLPATH{toggleopen}%"
   hideimgleft="%ICONURLPATH{toggleclose}%"
}%%IF{
   "$'URLPARAM{tab}'='search' OR $'URLPARAM{tab}'='' AND NOT $TAB='advanced'" 
   then="$percentINCLUDE{$quot%TOPIC%$quot section=$quotoptionssimple$quot}$percent"
}%%IF{
   "$'URLPARAM{tab}'='searchadvanced' OR $TAB='advanced'" 
   then="$percentINCLUDE{$quot%TOPIC%$quot section=$quotoptionsadvanced$quot}$percent"
}%%ENDTWISTY%</div>
<div class='foswikiFormStep'>
<input type='submit' class='foswikiSubmit' value='%MAKETEXT{"Search"}%' /> 
</div>
</div><!--//foswikiFormSteps-->
</form>
</div></noautolink>


search=%URLPARAM{"search" encode="url"}%;scope=%URLPARAM{"scope" encode="url" default="all"}%;web=%URLPARAM{"web" encode="url"}%;recurse=%URLPARAM{"recurse" encode="url"}%;type=%URLPARAM{"type" encode="url" default="%SEARCHDEFAULTTTYPE%"}%


%INCLUDE{"%TOPIC%" section="searchparamssimple"}%;type=%URLPARAM{"type" encode="url" default="%SEARCHDEFAULTTTYPE%"}%;nosearch=%URLPARAM{"nosearch" encode="url"}%;limit=%URLPARAM{"limit" encode="url"}%;excludetopic=%URLPARAM{"excludetopic" encode="url"}%;casesensitive=%URLPARAM{"casesensitive" encode="url"}%


<noautolink><div class='foswikiTabs'>
   <ul>
      <li%IF{
         "$'URLPARAM{tab}'='search' OR $'URLPARAM{tab}'='' AND NOT $TAB='advanced'"
         then=" class='foswikiActiveTab'"
      }%><a href='%SCRIPTURL{view}%/%BASEWEB%/%TOPIC%?%INCLUDE{"%TOPIC%" section="searchparamssimple"}%;tab=search'>%MAKETEXT{"Search"}%</a></li>
      <li%IF{
         "$'URLPARAM{tab}'='searchadvanced' OR $TAB='advanced'" then=" class='foswikiActiveTab'"
      }%><a href='%SCRIPTURL{view}%/%BASEWEB%/%TOPIC%?%INCLUDE{"%TOPIC%" section="searchparamsadvanced"}%;tab=searchadvanced'>%MAKETEXT{"Advanced search"}%</a></li>
      <li%IF{
         "$'URLPARAM{tab}'='az'" then=" class='foswikiActiveTab'"
      }%><a href='%SCRIPTURL{view}%/%BASEWEB%/%TOPIC%?%INCLUDE{"%TOPIC%" section="searchparamsadvanced"}%;tab=az'>%MAKETEXT{"A-Z"}%</a></li>
      <li%IF{
         "$'URLPARAM{tab}'='help'" then=" class='foswikiActiveTab'"
      }%><a href='%SCRIPTURL{view}%/%BASEWEB%/%TOPIC%?%INCLUDE{"%TOPIC%" section="searchparamsadvanced"}%;tab=help'>%MAKETEXT{"Help"}%</a></li>
   </ul>
   <div class='foswikiClear'></div>
</div></noautolink>


<table id='foswikiSearchTable' class='foswikiSearchTable' border='0' cellspacing='0' cellpadding='0'>
<tr>
<th>%MAKETEXT{"Search where:"}%</th>
<td>
<input type='radio' class='foswikiRadioButton' id='textbody' name='scope' value='text' %IF{
   "'%URLPARAM{"scope"}%'='text'"
   then="checked='checked'"
}% /><label for='textbody'> %MAKETEXT{"Text body"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='topictitle' name='scope' value='topic' %IF{
   "'%URLPARAM{"scope" default="all"}%'='topic'"
   then="checked='checked'"
}% /><label for='topictitle'> %MAKETEXT{"Topic title"}% </label><br />
<input type='radio' class='foswikiRadioButton' id='both' name='scope' value='all' %IF{
   "'%URLPARAM{"scope" default="all"}%'='all'"
   then="checked='checked'"
}% /><label for='both'> %MAKETEXT{"Both body and title"}%</label>
<hr />
<input type='checkbox' class='foswikiCheckbox' id='web' name='web' value='all' %IF{
   "'%URLPARAM{web}%'='all'"
   then="checked='checked'"
}% /><label for='web'> %MAKETEXT{"All public webs"}%</label> <span class='foswikiSmall'>%MAKETEXT{"(otherwise search [_1] Web only)" args="<nop>%BASEWEB%"}%</span>
<input type='checkbox' class='foswikiCheckbox' id='recurse' name='recurse' value='on' %IF{
   "'%URLPARAM{recurse}%'='on'"
   then="checked='checked'"
}% /><label for='recurse'> %MAKETEXT{"Subwebs"}%</label>
</td>
</tr>
</table>


<table id='foswikiSearchTable' class='foswikiSearchTable' border='0' cellspacing='0' cellpadding='0'>
<tr>
<th>%MAKETEXT{"Search where:"}%</th>
<td>
<input type='radio' class='foswikiRadioButton' id='textbody' name='scope' value='text' %IF{
   "'%URLPARAM{"scope"}%'='text'"
   then="checked='checked'"
}% /><label for='textbody'> %MAKETEXT{"Text body"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='topictitle' name='scope' value='topic' %IF{
   "'%URLPARAM{"scope" default="all"}%'='topic'"
   then="checked='checked'"
}% /><label for='topictitle'> %MAKETEXT{"Topic title"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='both' name='scope' value='all' %IF{
   "'%URLPARAM{"scope" default="all"}%'='all'"
   then="checked='checked'"
}% /><label for='both'> %MAKETEXT{"Both body and title"}%</label>
<hr />
<input type='checkbox' class='foswikiCheckbox' id='web' name='web' value='all' %IF{
   "'%URLPARAM{web}%'='all'"
   then="checked='checked'"
}% /><label for='web'> %MAKETEXT{"All public webs"}%</label> <span class='foswikiSmall'>%MAKETEXT{"(otherwise search [_1] Web only)" args="<nop>%BASEWEB%"}%</span>
<input type='checkbox' class='foswikiCheckbox' id='recurse' name='recurse' value='on' %IF{
   "'%URLPARAM{recurse}%'='on'"
   then="checked='checked'"
}% /><label for='recurse'> %MAKETEXT{"Subwebs"}%</label>
</td>
</tr>
<tr>
<th>%MAKETEXT{"Sort results by:"}%</th>
<td>
<input type='radio' class='foswikiRadioButton' id='topic' name='order' value='topic' %IF{
   "'%URLPARAM{"order" default="topic"}%'='topic'"
   then="checked='checked'"
}% /><label for='topic'> %MAKETEXT{"Topic name"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='modified' name='order' value='modified' %IF{
   "'%URLPARAM{order}%'='modified'"
   then="checked='checked'"
}% /><label for='modified'> %MAKETEXT{"Last modified time"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='editby' name='order' value='editby' %IF{
   "'%URLPARAM{order}%'='editby'"
   then="checked='checked'"
}% /><label for='editby'> %MAKETEXT{"Last editor"}%</label>
<hr />
<input type='checkbox' class='foswikiCheckbox' name='reverse' id='reverse' %IF{
   "'%URLPARAM{reverse}%'='on'"
   then="checked='checked'"
}% /><label for='reverse'> %MAKETEXT{"In reversed order"}%</label>
</td>
</tr>
<tr>
<th>%MAKETEXT{"Make search:"}%</th>
<td>%MAKETEXT{"Selections apply to search in \"text body\""}% <span class='foswikiUnvisited foswikiSmall'>%POPUPWINDOW{"%SYSTEMWEB%.SearchHelp" label="%MAKETEXT{"Help"}%"}%</span>
<hr />
<input type='checkbox' class='foswikiCheckbox' id='casesensitive' name='casesensitive' %IF{
   "'%URLPARAM{casesensitive}%'='on'"
   then="checked='checked'"
}% /><label for='casesensitive'> %MAKETEXT{"Case sensitive"}%</label><br />
<hr />
<input type='radio' class='foswikiRadioButton' id='word' name='type' value='word' %IF{
   "'%URLPARAM{"type" default="%SEARCHDEFAULTTTYPE%"}%'='word'" 
   then="checked='checked'"
}% /><label for='word'> %MAKETEXT{"Word search"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='keyword' name='type' value='keyword' %IF{
   "'%URLPARAM{"type" default="%SEARCHDEFAULTTTYPE%"}%'='keyword'" 
   then="checked='checked'"
}% /><label for='keyword'> %MAKETEXT{"Keyword search"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='literal' name='type' value='literal' %IF{
   "'%URLPARAM{type}%'='literal'"
   then="checked='checked'"
}% /><label for='literal'> %MAKETEXT{"Literal search"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='regex' name='type' value='regex' %IF{
   "'%URLPARAM{type}%'='regex'"
   then="checked='checked'"
}% /><label for='regex'> %MAKETEXT{"Regular expression search"}%</label><br />
<input type='radio' class='foswikiRadioButton' id='query' name='type' value='query' %IF{
   "'%URLPARAM{type}%'='query'"
   then="checked='checked'"
}% /><label for='query'> %MAKETEXT{"Query Search"}%</label>
</td>
</tr>
<tr>
<th><b>%MAKETEXT{"Don't show:"}%</b></th>
<td><input type='checkbox' class='foswikiCheckbox' id='nosearch' name='nosearch' %IF{
   "'%URLPARAM{nosearch}%'='on'"
   then="checked='checked'"
}% /><label for='nosearch'> %MAKETEXT{"Search string"}%</label><br />
<input type='checkbox' class='foswikiCheckbox' id='nosummary' name='nosummary' %IF{
   "'%URLPARAM{nosummary}%'='on'"
   then="checked='checked'"
}% /><label for='nosummary'> %MAKETEXT{"Summaries"}%</label><br />
<input type='checkbox' class='foswikiCheckbox' id='nototal' name='nototal' %IF{
   "'%URLPARAM{nototal}%'='on'"
   then="checked='checked'"
}% /><label for='nototal'> %MAKETEXT{"Total matches"}%</label><br />
</td>
</tr>
<tr>
<th class='foswikiLast'>%MAKETEXT{"Limit results to:"}%</th>
<td class='foswikiLast'><input type='text' class='foswikiInputField' id='limit' name='limit' size='3' value='%IF{
   "'%URLPARAM{"limit" default="all"}%'='all'"
   then="all"
   else="%URLPARAM{limit}%"
}%' /><label for='limit'> %MAKETEXT{"Topics per web"}% </label><span class='foswikiSmall'>%MAKETEXT{"(=all= to show all topics)"}%</span>
</td>
</tr>
</table>


%IF{
   "$'URLPARAM{search}'!=''"
   then="<h2>%MAKETEXT{"Search results"}%</h2>
$percentINCLUDE{$quot%SYSTEMWEB%.%TOPIC%$quot section=$quotsearchfeed$quot}$percent"
}%%SEARCH{
   "%URLPARAM{"search" encode="entities, quote"}%" decode="entities"
   type="%URLPARAM{"type" default="word"}%"
   scope="%URLPARAM{"scope" encode="safe, quote"}%"
   web="%URLPARAM{"web" encode="safe, quote"}%"%IF{
      "{EnableHierarchicalWebs}"
      then="recurse=\"%URLPARAM{"recurse" encode="safe, quote"}%\""
   }%
    topic="%URLPARAM{"searchtopic" encode="safe, quote"}%"
   excludetopic="%URLPARAM{"excludetopic" encode="safe, quote"}%"
   nosearch="%URLPARAM{"nosearch" encode="safe, quote"}%"
   casesensitive="%URLPARAM{"casesensitive" encode="safe, quote"}%"
   nosummary="%URLPARAM{"nosummary" encode="safe, quote"}%"
   nototal="%URLPARAM{"nototal" encode="safe, quote"}%"
   order="%URLPARAM{"order" encode="safe, quote"}%"
   reverse="%URLPARAM{"reverse" encode="safe, quote"}%"
   pager="on"
   limit="%URLPARAM{"limit" encode="safe, quote" default="%DEFAULTPAGESIZE%"}%"
   pagesize="%DEFAULTPAGESIZE%"
   zeroresults="%IF{
      "defined search and $search!=''"
      then="on"
      else="off"
   }%"
}%


<div>%ICON{"rss-small"}%%INCLUDE{"%SYSTEMWEB%.%TOPIC%" section="searchfeedlink"}%</div>


 <a href='%SCRIPTURL{"view"}%/%BASEWEB%/WebRss?search=%URLPARAM{"search" encode="url"}%;type=%IF{
   "'%URLPARAM{"regex"}%'='on' OR '%URLPARAM{"type"}%'='regex'"
   then="regex"
   else="word"
}%;excludetopic=%URLPARAM{"excludetopic" encode="url" default="%TOPIC%,%HOMETOPIC%,%STATISTICSTOPIC%"}%;web=%URLPARAM{"web" encode="url" default="%BASEWEB%"}%;recurse=%URLPARAM{"recurse" encode="url"}%;limit=%URLPARAM{"limit" encode="url" default="all"}%;scope=%URLPARAM{"scope" encode="url" default="text"}%;casesensitive=%URLPARAM{"casesensitive" encode="url" default="off"}%'>%MAKETEXT{"Get notified on changes on this search"}%</a>


%IF{
   "$'URLPARAM{search}'!=''"
   then='$percentINCLUDE{$quot%TOPIC%$quot section=$quot_querysearchexample$quot}$percent'
}%


<p /><div class='foswikiHelp'>
%MAKETEXT{"To display the above search results in a topic, copy-paste the following markup:"}%
<pre class='tml'>
%<nop>SEARCH{
   "%URLPARAM{"search" encode="entities, quote"}%"
   type="%URLPARAM{"type" default="%SEARCHDEFAULTTTYPE%"}%"%FORMAT{
      "scope,web,recurse,nosearch,casesensitive,nosummary,nototal,order,reverse,limit"
      type="string"
      header="$n"
      format="$percntIF{
        \"(defined $item AND $'$item') AND ('$item' != 'recurse' OR {EnableHierarchicalWebs})\"
        then=\"   $item=\\"$percntURLPARAM{\"$item\" encode=\"safe, quote\"}$percnt\\"$n\"
      }$percnt"
      separator=""
   }%}%
</pre>
</div>


%IF{
   "$'URLPARAM{searchletter}'='%letter%'"
   then="<strong>%letter%</strong>"
   else="<a href='%SCRIPTURLPATH{"search"}%/%BASEWEB%/%TOPIC%?scope=topic&amp;type=regex&amp;search=%5E%letter%;$percentINCLUDE{$quot%TOPIC%$quot section=$quotsearchparamsadvanced$quot}$percent;searchletter=%letter%;tab=az'>%letter%</a>"
}%


%INCLUDE{"%TOPIC%" section="title"}%
%INCLUDE{"%TOPIC%" section="tabs"}%
<div class='foswikiWebSearchForm'>
%MAKETEXT{"List topics that start with the letter:"}% %INCLUDE{"%TOPIC%" section="letterlist"}%
</div>
%IF{
   "$'URLPARAM{searchletter}'"
   then="$percentINCLUDE{$quot%TOPIC%$quot section=$quotsearchresults$quot}$percent$percentINCLUDE{$quot%TOPIC%$quot section=$quotquerysearchexample$quot}$percent"
}%

<div class='foswikiHorizontalList foswikiUnvisited'>
<ul>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="A"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="B"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="C"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="D"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="E"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="F"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="G"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="H"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="I"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="J"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="K"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="L"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="M"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="N"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="O"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="P"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="Q"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="R"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="S"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="T"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="U"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="V"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="W"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="X"}%</li>
   <li>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="Y"}%</li>
   <li class='foswikiLast'>%INCLUDE{"%TOPIC%" section="searchbyletterlink" letter="Z"}%</li>
</ul>
<div class='foswikiClear'></div>
</div>
Topic revision: r2 - 30 Jan 2012, AndyPryke
 

This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback