%META:TOPICINFO{author="PeterThoeny" date="1097127214" format="1.0" version="1.3"}%
%META:TOPICPARENT{name="TWikiVariables"}%
__Note:__ This topic is included by TWikiVariables

-----
%STARTINCLUDE%
#VarNOTIFYTOPIC
---+++ NOTIFYTOPIC -- name of the notify topic
	* Syntax: =%<nop>NOTIFYTOPIC%=
	* Expands to: =%NOTIFYTOPIC%=, renders as [[%NOTIFYTOPIC%]]
	* Related: [[#VarHOMETOPIC][HOMETOPIC]], [[#VarSTATISTICSTOPIC][STATISTICSTOPIC]], [[#VarTOPIC][TOPIC]]

#VarPLUGINVERSION
---+++ PLUGINVERSION -- the version of the TWiki Plugin API
	* This is the =$TWiki::Plugins::VERSION= number, also indicating the version of the TWikiFuncModule
	* Syntax: =%<nop>PLUGINVERSION{}%=
	* Expands to: =%PLUGINVERSION{}%=
	* Related: [[#VarPLUGINVERSION2][PLUGINVERSION{"name"}]], [[#VarWIKIVERSION][WIKIVERSION]]

#VarPLUGINVERSION2
---+++ PLUGINVERSION{"name"} -- the version of an installed Plugin
	* Syntax: =%<nop>PLUGINVERSION{"name"}%=
	* Example: =%<nop>PLUGINVERSION{"DefaultPlugin"}%= expands to =%PLUGINVERSION{"DefaultPlugin"}%=
	* Related: [[#VarPLUGINVERSION][PLUGINVERSION]], [[#VarWIKIVERSION][WIKIVERSION]]

#VarPUBURL
---+++ PUBURL -- the base URL of attachments
	* Syntax: =%<nop>PUBURL%=
	* Expands to: =%PUBURL%=
	* Example: You can refer to a file attached to another topic with =%<nop>PUBURL%/%<nop>WEB%/OtherTopic/image.gif=
	* Related: [[#VarATTACHURL][ATTACHURL]], [[#VarPUBURLPATH][PUBURLPATH]], [[#VarSCRIPTURL][SCRIPTURL]], FileAttachments

#VarPUBURLPATH
---+++ PUBURLPATH -- the base URL path of attachments
	* Syntax: =%<nop>PUBURLPATH%=
	* Expands to: =%PUBURLPATH%=
	* Related: [[#VarATTACHURL][ATTACHURL]], [[#VarPUBURL][PUBURL]], FileAttachments

#VarREMOTEADDR
---+++ REMOTE_ADDR -- environment variable
	* Syntax: =%<nop>REMOTE_ADDR%=
	* Expands to: =%REMOTE_ADDR%=
	* Related: [[#VarHTTPHOST][HTTP_HOST]], [[#VarREMOTEPORT][REMOTE_PORT]], [[#VarREMOTEUSER][REMOTE_USER]]

#VarREMOTEPORT
---+++ REMOTE_PORT -- environment variable
	* Syntax: =%<nop>REMOTE_PORT%=
	* Expands to: <code>%REMOTE_PORT%</code>
	* Related: [[#VarHTTPHOST][HTTP_HOST]], [[#VarREMOTEADDR][REMOTE_ADDR]], [[#VarREMOTEUSER][REMOTE_USER]]

#VarREMOTEUSER
---+++ REMOTE_USER -- environment variable
	* Syntax: =%<nop>REMOTE_USER%=
	* Expands to: <code>%REMOTE_USER%</code>
	* Related: [[#VarHTTPHOST][HTTP_HOST]], [[#VarREMOTEADDR][REMOTE_ADDR]], [[#VarREMOTEPORT][REMOTE_PORT]], [[#VarUSERNAME][USERNAME]], [[#VarWIKINAME][WIKINAME]], [[#VarWIKIUSERNAME][WIKIUSERNAME]]

#VarREVINFO
---+++ REVINFO -- revision information of current topic
	* Syntax: =%<nop>REVINFO%=
	* Expands to: <code>%REVINFO%</code>
	* Related: [[#VarREVINFO2][REVINFO{"format"}]]

#VarREVINFO2
---+++ REVINFO{"format"} -- formatted revision information of topic
	* Syntax: =%<nop>REVINFO{"format"}%=
	* Supported parameters:
	  | *Parameter:* | *Description:* | *Default:* |
	  | ="format"= | Format of revision information, see supported variables below | ="r1.$rev - $date - $wikiusername"= |
	  | =web="..."= | Name of web | Current web |
	  | =topic="..."= | Topic name | Current topic |
	  | =rev="1.5"= | Specific revison number | Latest revision |
	* Supported variables in format:
	  | *Variable:* | *Unit:* | *Example* |
	  | =$web= | Name of web | Current web |
	  | =$topic= | Topic name | Current topic |
	  | =$rev= | Revison number. Prefix =r1.= to get the usual =r1.5= format | =5= |
	  | =$date= | Revision date | =11 Jul 2004= |
	  | =$username= | Login username of revision | =jsmith= |
	  | =$wikiname= | WikiName of revision | =JohnSmith= |
	  | =$wikiusername= | <nop>WikiName with %MAINWEB% web prefix | =%MAINWEB%.JohnSmith= |
	* Example: =%<nop>REVINFO{"$date - $wikiusername" rev="1.1"}%= returns revision info of first revision
	* Related: [[#VarREVINFO][REVINFO]]

#VarSCRIPTURL
---+++ SCRIPTURL -- script URL of %WIKITOOLNAME%
	* Syntax: =%<nop>SCRIPTURL%=
	* Expands to: =%SCRIPTURL%=
	* Example: To get the authenticated version of current topic write =%<nop>SCRIPTURL%/viewauth%<nop>SCRIPTSUFFIX%/%<nop>WEB%/%<nop>TOPIC%= which expands to =%SCRIPTURL%/viewauth%SCRIPTSUFFIX%/%WEB%/%TOPIC%=
	* Related: [[#VarPUBURL][PUBURL]], [[#VarSCRIPTSUFFIX][SCRIPTSUFFIX]], [[#VarSCRIPTURLPATH][SCRIPTURLPATH]]

#VarSCRIPTURLPATH
---+++ SCRIPTURLPATH -- script URL path of %WIKITOOLNAME%
	* Syntax: =%<nop>SCRIPTURLPATH%=
	* Expands to: =%SCRIPTURLPATH%=
	* Related: [[#VarPUBURLPATH][PUBURLPATH]], [[#VarSCRIPTURL][SCRIPTURL]]

#VarSCRIPTSUFFIX
---+++ SCRIPTSUFFIX -- script suffix
	* Some %WIKITOOLNAME% installations require a file extension for CGI scripts like =.pl= or =.cgi=
	* Syntax: =%<nop>SCRIPTSUFFIX%=
	* Expands to: <code>%SCRIPTSUFFIX%</code>
	* Related: [[#VarSCRIPTURL][SCRIPTURL]]

%INCLUDE{TWikiSearch}%

#VarSERVERTIME
---+++ SERVERTIME -- server time
	* Syntax: =%<nop>SERVERTIME%=
	* Expands to: =%SERVERTIME%=
	* Related: [[#VarDISPLAYTIME][DISPLAYTIME]], [[#VarGMTIME][GMTIME]], [[#VarSERVERTIME2][SERVERTIME{"format"}]]

#VarSERVERTIME2
---+++ SERVERTIME{"format"} -- formatted server time
	* Same format qualifiers as =%<nop>GMTIME%=
	* Syntax: =%<nop>SERVERTIME{"format"}%=
	* Example: =%<nop>SERVERTIME{"$hou:$min"}%= expands to =%SERVERTIME{"$hou:$min"}%=
	* Related: [[#VarDISPLAYTIME][DISPLAYTIME]], [[#VarGMTIME][GMTIME]], [[#VarSERVERTIME][SERVERTIME]]

#VarSPACEDTOPIC
---+++ SPACEDTOPIC -- topic name, spaced and encoded
	* The current topic name with added spaces, for regular expression search of Ref-By
	* Syntax: =%<nop>SPACEDTOPIC%=
	* Expands to: =%SPACEDTOPIC%=
	* Related: [[#VarTOPIC][TOPIC]]

#VarSTARTINCLUDE
---+++ STARTINCLUDE -- start position of topic text if included
	* If present in included topic, start to include text from this location up to the end, or up to the location of the =%<nop>STOPINCLUDE%= variable. A normal view of the topic shows everyting exept the =%<nop>STARTINCLUDE%= variable itself.
	* Syntax: =%<nop>STARTINCLUDE%=
	* Related: [[#VarINCLUDE][INCLUDE]], [[#VarSTOPINCLUDE][STOPINCLUDE]]

#VarSTATISTICSTOPIC
---+++ STATISTICSTOPIC -- name of statistics topic
	* Syntax: =%<nop>STATISTICSTOPIC%=
	* Expands to: =%STATISTICSTOPIC%=, renders as [[%STATISTICSTOPIC%]]
	* Related: [[#VarHOMETOPIC][HOMETOPIC]], [[#VarNOTIFYTOPIC][NOTIFYTOPIC]], [[#VarTOPIC][TOPIC]]

#VarSTOPINCLUDE
---+++ STOPINCLUDE -- end position of topic text if included
	* If present in included topic, stop to include text at this location and ignore the remaining text. A normal view of the topic shows everyting exept the =%<nop>STOPINCLUDE%= variable itself.
	* Syntax: =%<nop>STOPINCLUDE%=
	* Related: [[#VarINCLUDE][INCLUDE]], [[#VarSTARTINCLUDE][STARTINCLUDE]]

#VarTOC
---+++ TOC -- table of contents of current topic
	* Syntax: =%<nop>TOC%=
	* Related: [[#VarTOC2][TOC{"SomeTopic"}]]

#VarTOC2
---+++ TOC{"Topic"} -- table of contents
	* Syntax: =%<nop>TOC{"SomeTopic" ...}%=
	* Table of Contents. Shows a TOC that is generated automatically based on headings of a topic. Headings in WikiSyntax (="---++ text"=) and HTML (="&lt;h2&gt;text&lt;/h2&gt;"=) are taken into account. Any heading text after ="!!"= is excluded from the TOC; for example, write ="---+!! text"= if you do not want to list a header in the TOC
	* Supported parameters:
	 | *Parameter:* | *Description:* | *Default:* |
	 | ="TopicName"= | topic name | Current topic |
	 | =web="Name"= | Name of web | Current web |
	 | =depth="2"= | Limit depth of headings shown in TOC | 6 |
	 | =title="Some text"= | Title to appear at top of TOC | none |
	* Example: =%<nop>TOC{depth="2"}%=
	* Example: =%<nop>TOC{"TWikiDocumentation" web="%TWIKIWEB%" title="Contents:"}%=
	* Example: see TWiki:Sandbox.TestTopicInclude
	* Related: [[#VarTOC][TOC]]

#VarTOPIC
---+++ TOPIC -- name of current topic
	* Syntax: =%<nop>TOPIC%=
	* Expands to: =%TOPIC%=, renders as [[%TOPIC%]]
	* Related: [[#VarBASETOPIC][BASETOPIC]], [[#VarINCLUDINGTOPIC][INCLUDINGTOPIC]], [[#VarTOPICLIST][TOPICLIST]], [[#VarWEB][WEB]]

#VarTOPICLIST
---+++ TOPICLIST{"format"} -- topic index of a web
	* The "format" defines the format of one topic item. It may include variables: The =$name= variable gets expanded to the topic name; the =$web= variable gets expanded to the name of the web.
	* Syntax: =%<nop>TOPICLIST{"format" ...}%=
	* Supported parameters:
	 | *Parameter:* | *Description:* | *Default:* |
	 | ="format"= | Format of one line, may include =$name= and =$web= variables | ="$name"= |
	 | =format="format"= | (Alternative to above) | ="$name"= |
	 | =separator=", "= | line separator | ="\n"= (new line) |
	 | =web="Name"= | Name of web | Current web |
	* Example: =%<nop>TOPICLIST{"	* $web.$name"}%= creates a bullet list of all topics
	* Example: =%<nop>TOPICLIST{separator=", "}%= creates a comma separated list of all topics
	* Example: =%<nop>TOPICLIST{" &lt;option&gt;$name&lt;/option&gt;"}%= creates an option list (for drop down menus)
	* Related: [[#VarSEARCH][SEARCH]], [[#VarWEBLIST][WEBLIST]]

#VarTWIKIWEB
---+++ TWIKIWEB -- name of TWiki documentation web
	* The web containing all documentation and site-wide preference settings for %WIKITOOLNAME%
	* Syntax: =%<nop>TWIKIWEB%=
	* Expands to: =%TWIKIWEB%=
	* Related: [[#VarMAINWEB][MAINWEB]]

#VarURLPARAM
---+++ URLPARAM{"name"} -- get value of a URL parameter
	* Returns the value of a URL parameter. Note that there is a risk that this variable could be misused for cross-scripting
	* Syntax: =%<nop>URLPARAM{"name"}%=
	* Supported parameters:
	  | *Parameter:* | *Description:* | *Default:* |
	  | ="name"= | The name of a URL parameter | required |
	  | =default="..."= | Default value in case parameter is empty or missing | empty string |
	  | =newline="&lt;br /&gt;"= | Convert newlines in textarea to other delimiters | no conversion |
	  | =encode="entity"= | Encode special characters into HTML entities, like a double quote into =&amp;#034;=. This is needed if text is put into an HTML form field | no encoding |
	  | =encode="url"= | Encode special characters for URL parameter use, like a double quote into =%22= | no encoding |
	  | =multiple="on"= %BR% =multiple="[<nop>[$item]]"= | If set, gets all selected elements of a =&lt;select multiple="multiple"&gt;= tag. A format can be specified, with =$item= indicating the element, e.g. =multiple="Option: $item"= | first element |
	  | =separator=", "= | Separator between multiple selections. Only relevant if multiple is specified | ="\n"= (new line) |
	* Example: =%<nop>URLPARAM{"skin"}%= returns =print= for a =.../view/%WEB%/%TOPIC%?skin=print= URL. [[%SCRIPTURL%/viewauth%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=print#VarURLPARAM][Test this]]: %URLPARAM{"skin"}%
	* Related: [[#VarSEARCH][SEARCH]], FormattedSearch

#VarUSERNAME
---+++ USERNAME -- your login username
	* TWiki makes names available in three formats: USERNAME like =jsmith=, WIKINAME like =JohnSmith= and WIKIUSERNAME like =%MAINWEB%.JohnSmith=. A user is a %MAINWEB%.TWikiGuest in case the topic is not authenticated
	* Syntax: =%<nop>USERNAME%=
	* Expands to: =%USERNAME%=
	* Related: [[#VarREMOTEUSER][REMOTE_USER]], [[#VarWIKINAME][WIKINAME]], [[#VarWIKIUSERNAME][WIKIUSERNAME]], TWikiUserAuthentication

#VarVAR
---+++ VAR{"NAME" web="Web"} -- get a preference value from another web 
	* Syntax: =%<nop>VAR{"NAME" web="Web"}%=
	* Example: To get =%<nop>WEBBGCOLOR%= of the %MAINWEB% web write =%<nop>VAR{"WEBBGCOLOR" web="%MAINWEB%"}%=, which expands to =%VAR{"WEBBGCOLOR" web="%MAINWEB%"}%=
	* Related: [[#VarWEBPREFSTOPIC][WEBPREFSTOPIC]]

#VarWEB
---+++ WEB -- name of current web
	* Syntax: =%<nop>WEB%=
	* Expands to: =%WEB%=
	* Related: [[#VarBASEWEB][BASEWEB]], [[#VarINCLUDINGWEB][INCLUDINGWEB]], [[#VarTOPIC][TOPIC]]

#VarWEBLIST
---+++ WEBLIST{"format"} -- index of all webs
	* List of all webs. Hidden webs are excluded, e.g. webs with a =NOSEARCHALL=on= preference variable. The ="format"= defines the format of one web item. The =$name= variable gets expanded to the name of the web, =$qname= gets expanded to double quoted name, =$marker= to =marker= where web matches =selection=.
	* Syntax: =%<nop>WEBLIST{"format" ...}%=
	* Supported parameters:
	  | *Parameter:* | *Description:* | *Default:* |
	  | ="format"= | Format of one line, may include =$name= variable | ="$name"= |
	  | =format="format"= | (Alternative to above) | ="$name"= |
	  | =separator=", "= | line separator | ="\n"= (new line) |
	  | =webs="public"=	| comma sep list of Web, public expands to all non-hidden | ="public"= |
	  | =marker="selected"= | Text for =$marker= where item matches =selection=, otherwise equals =""= | ="selected"= |
	  | =selection="%<nop>WEB%"= | Current value to be selected in list | =section="%<nop>WEB%"= |
	* Example: =%<nop>WEBLIST{"	* [<nop>[$name.%HOMETOPIC%]]"}%= creates a bullet list of all webs.
	* Example: =%<nop>WEBLIST{"&lt;option $marker value=$qname&gt;$name&lt;/option&gt;" webs="Trash,public" selection="%WEB%" separator=" "}%= Dropdown of all public Webs + Trash Web, current Web highlighted.
	* Related: [[#VarTOPICLIST][TOPICLIST]], [[#VarSEARCH][SEARCH]]

#VarWEBPREFSTOPIC
---+++ WEBPREFSTOPIC -- name of web preferences topic
	* Syntax: =%<nop>WEBPREFSTOPIC%=
	* Expands to: =%WEBPREFSTOPIC%=, renders as [[%WEBPREFSTOPIC%]]
	* Related: [[#VarHOMETOPIC][HOMETOPIC]], [[#VarWIKIPREFSTOPIC][WIKIPREFSTOPIC]], [[#VarVAR][VAR]]

#VarWIKIHOMEURL
---+++ WIKIHOMEURL -- site home URL
	* The base URL of %WIKITOOLNAME%, is the link of the Home icon in the upper left corner, defined in TWiki.cfg
	* Syntax: =%<nop>WIKIHOMEURL%=
	* Expands to: =%WIKIHOMEURL%=
	* Related: [[#VarWIKITOOLNAME][WIKITOOLNAME]]

#VarWIKINAME
---+++ WIKINAME -- your Wiki username
	* The WikiName is the same as %<nop>USERNAME% if not defined in the %MAINWEB%.%WIKIUSERSTOPIC% topic
	* Syntax: =%<nop>WIKINAME%=
	* Expands to: =%WIKINAME%=
	* Related: [[#VarREMOTEUSER][REMOTE_USER]], [[#VarUSERNAME][USERNAME]], [[#VarWIKIUSERNAME][WIKIUSERNAME]], [[#VarWIKIUSERSTOPIC][WIKIUSERSTOPIC]]

#VarWIKIPREFSTOPIC
---+++ WIKIPREFSTOPIC -- name of site-wide preferences topic
	* Syntax: =%<nop>WIKIPREFSTOPIC%=
	* Expands to: =%WIKIPREFSTOPIC%=, renders as [[%WIKIPREFSTOPIC%]]
	* Related: [[#VarHOMETOPIC][HOMETOPIC]], [[#VarWEBPREFSTOPIC][WEBPREFSTOPIC]]

#VarWIKITOOLNAME
---+++ WIKITOOLNAME -- name of your TWiki site
	* Syntax: =%<nop>WIKITOOLNAME%=
	* Expands to: =%WIKITOOLNAME%=
	* Related: [[#VarWIKIHOMEURL][WIKIHOMEURL]], [[#VarWIKIVERSION][WIKIVERSION]]

#VarWIKIUSERNAME
---+++ WIKIUSERNAME -- your Wiki username with web prefix
	* Your %<nop>WIKINAME% with %MAINWEB% web prefix, useful to point to your %WIKITOOLNAME% home page
	* Syntax: =%<nop>WIKIUSERNAME%=
	* Expands to: =%WIKIUSERNAME%=, renders as %WIKIUSERNAME%
	* Related: [[#VarREMOTEUSER][REMOTE_USER]], [[#VarUSERNAME][USERNAME]], [[#VarWIKINAME][WIKINAME]]

#VarWIKIUSERSTOPIC
---+++ WIKIUSERSTOPIC -- name of topic listing all registers users
	* Syntax: =%<nop>WIKIUSERSTOPIC%=
	* Expands to: =%WIKIUSERSTOPIC%=, with %MAINWEB% prefix renders as %MAINWEB%.%WIKIUSERSTOPIC%
	* Related: [[#VarWIKIUSERNAME][WIKIUSERNAME]]

#VarWIKIVERSION
---+++ WIKIVERSION -- the version of the installed TWiki engine
	* Syntax: =%<nop>WIKIVERSION%=
	* Expands to: =%WIKIVERSION%=
	* Related: [[#VarPLUGINVERSION][PLUGINVERSION]], [[#VarWIKITOOLNAME][WIKITOOLNAME]]
%STOPINCLUDE%

-- TWiki:Main.PeterThoeny - 14 Aug 2004

