Defining Custom Variables#

You can use the "SET" directive to define a variable that exists only in the page.
For example:

  [{SET foo='bar'}]

creates a variable called "foo", which has the value of "bar". You can access this value anywhere on your page by using the shorthand "[{$foo}]".

Pre-defined Variables#

JSPWiki also defines all kinds of other variables, and tags and plugins can also add their own variables. For example, see the Counter plugin. The following variables are pre-defined by JSPWiki:

applicationname#

This is the name of this Wiki. It has been set by the administrator in "jspwiki.properties". This Wiki is called JSPWiki.

baseurl#

The base URL address for this wiki. The value is .

encoding#

Describes the character encoding used in this Wiki. An encoding of "UTF-8" means that the Wiki accepts any character, including Chinese, Japanese, etc. Encoding "ISO-8859-1" means that only western languages are supported. This wiki uses the UTF-8 encoding.

inlinedimages#

Lets you know which image types are being inlined. The value is *.png, *.jpg.

Writes HTML code for supported InterWiki links. The value is TWiki --> http://twiki.org/cgi-bin/view/TWiki/%s, WikiWikiWeb --> http://c2.com/cgi/wiki?%s, Reader --> Wiki.jsp?page=%s&skin=reader, Wikipedia --> http://www.wikipedia.com/wiki/%s, Raw --> Wiki.jsp?page=%s&skin=raw, Doc --> http://jspwiki-wiki.apache.org/Wiki.jsp?page=%s, Google --> http://www.google.com/search?q=%s, JIRA --> https://issues.apache.org/jira/browse/JSPWIKI-%s, RSS --> rss.jsp?page=%s&mode=wiki, Group --> Group.jsp?group=%s, Edit --> Edit.jsp?page=%s, Location --> https://maps.google.com/maps?q=%s, MeatballWiki --> http://usemod.com/cgi-bin/mb.pl?%s, JSPWiki --> https://jspwiki-wiki.apache.org/%s.

jspwikiversion#

Inserts the version number of the JSPWiki engine. For example, this version is 2.12.1.

keywords#

adds keywords to a page. They will be shown in the info drop-down menu, and are added as META tags to the page. This keywords will also be used to index the page.

loginstatus#

Shows how the current user has logged in. For example, you are anonymous.

pagename#

Inserts the current page name. Example: This page is called WikiVariable.

pageprovider#

The current PageProvider. The current provider is org.apache.wiki.providers.CachingProvider.

pageproviderdescription#

A verbose, HTML description about the currently used page provider. The description for the current provider is Real provider: org.apache.wiki.providers.VersioningFileProvider. Page cache hits: 950545593. Page cache misses: 1. History cache hits: 81331. History cache misses: 407.

requestcontext#

The current RequestContext. For example, this is the view context.

totalpages#

The total number of pages available in this Wiki. This wiki contains 409 pages.

uptime#

Inserts the amount of time since this Wiki has been last restarted. This wiki has been up for 68d, 9h 12m 50s.

username#

Inserts the current user name: For example, you are now logged in as 18.97.9.171.

Inserting JSPWiki properties#

You can also access some of the JSPWiki properties (that have been defined by the site maintainer) by using their property names directly. See SystemInfo for an example.

Note that some properties might not be accessible due to security reasons.

Variable evaluation order#

The variables are evaluated in the following order:

  1. 'Preset' variables (or constants), as those listed on this page.
  2. 'Context' variables, as those set by plugins and tags.
  3. 'Property' variables, like those set in jspwiki.properties.
  4. 'Page' variables, like those set using the "SET" directive.


Category.Documentation