Macros Quick Reference

See Macros for a detailed description of how to use Macros

Predefined Macros

• ACTIVATEDPLUGINS -- list of currently activated plugins
• ADDTOHEAD -- deprecated, use ADDTOZONE instead
• ADDTOZONE -- add content to a named zone on the page
• ALLVARIABLES -- list of currently defined macros
• ATTACHURL -- full URL for attachments in the current topic
• ATTACHURLPATH -- path of the attachment URL of the current topic
• AUTHREALM -- authentication realm
• BASETOPIC -- base topic where an INCLUDE started
• BASEWEB -- base web where an INCLUDE started
• BUTTON -- renders a nice button
• CALC -- add spreadsheet calculations to tables and outside tables
• CALCULATE -- add spreadsheet formulae calls using standard Macro evaluation order.
• COMMENT -- insert an edit box into the topic to easily add comments.
• COVER -- current skin cover
• DATE -- signature format date
• DISPLAYTIME -- display formatted time
• DOCUMENTVIEWER -- Embed a presentation, spreadsheet, PDF or other document in a viewer
• EDITTABLE{ attributes } -- edit tables using edit fields and other input fields
• ENCODE -- encode characters in a string
• ENDCOLOR -- end colored text
• ENDINCLUDE -- end position of topic text if included
• ENDSECTION -- marks the end of a named section within a topic
• ENDTAB -- ending marker for a tab of a tabpane
• ENDTABPANE -- ending tag for tabpane widget
• ENDTWISTY -- complements an opening TWISTY tag to close a twisty
• ENDTWISTYTOGGLE -- Twisty closure
• ENV -- inspect the value of an environment variable
• EXAMPLETAG -- example macro tag
• EXPAND -- expand macros in a string as if they were used in another topic
• FAILEDPLUGINS -- debugging for plugins that failed to load
• FORMAT -- format a list of objects
• FORMFIELD -- renders a field in the form attached to some topic
• GMTIME -- formatted Greenwich Mean Time (UTC)
• GROUPINFO -- retrieve details about a group
• GROUPS -- a formatted list of groups
• HISTORY -- control attributes of tables and sorting of table columns
• HOMETOPIC -- home topic in each web
• HOMEWEB -- name of default home web
• HTTP -- get HTTP headers
• HTTP_HOST -- environment variable
• HTTPS -- get HTTPS headers
• ICON -- small documentation graphic or icon of common attachment types
• ICONURL -- URL of small documentation graphic or icon
• ICONURLPATH -- URL path of small documentation graphic or icon
• IF -- simple conditionals
• INCLUDE -- include another topic, or subsection of a topic, or a URL, or Foswiki embedded documentation
• INCLUDINGTOPIC -- name of topic that includes current topic
• INCLUDINGWEB -- web that includes current topic
• JQICON -- render an image
• JQICONPATH -- render the url path to an image icon
• JQPLUGINS -- display a summary of available plugins
• JQREQUIRE -- enable a plugin on the current page
• JQTHEME -- switch jQuery UI theme
• LANG -- the language specified by the server locale
• LANGUAGE -- language code for the current user
• LANGUAGES -- list available languages
• LOCALSITEPREFS -- web.topicname of site preferences topic
• LOGIN -- present a full login link
• LOGOUT -- present a full logout link
• MAINWEB -- deprecated synonym for USERSWEB
• MAKETEXT -- creates text using Foswiki's I18N infrastructure
• META -- displays meta-data
• METASEARCH -- special search of meta data
• MIMEICON{"filename"} -- return a meaningful icon for this filename
• NONCE -- generate a nonce (developers only)
• NOP -- template text not to be expanded in instantiated topics
• NOTIFYTOPIC -- name of the notify topic
• PERLDEPENDENCYREPORT -- report perl module dependencies
• PLUGINDESCRIPTIONS -- list of plugin descriptions
• PLUGINVERSION -- the version of a Foswiki Plugin, or the Foswiki Plugins API
• POPUPWINDOW -- opens a topic or url in a new window
• PUBURL -- generate an URL for an attachment
• PUBURLPATH -- generate a relative URL for an attachment
• QUERY -- get the value of meta-data
• QUERYPARAMS -- show parameters to the query
• QUERYSTRING -- full, unprocessed string of parameters to this URL
• REMOTE_ADDR -- environment variable
• REMOTE_PORT -- environment variable
• REMOTE_USER -- environment variable
• RENDERLIST -- render bullet lists in a variety of formats
• RENDERZONE - render the content of a zone
• REVARG -- &rev=n parameter of current request
• REVCOMMENT -- Display the revision comments for a topic..
• REVINFO -- revision information of current topic
• REVTITLE -- The requested revision as displayed in topic breadcrumbs
• SCRIPTNAME -- name of current script
• SCRIPTSUFFIX -- script suffix
• SCRIPTURL -- URL of script(s)
• SCRIPTURLPATH -- URL path of script(s)
• SEARCH -- search content
• SERVERINFORMATION -- report detailed web server information
• SERVERTIME -- formatted server time
• SESSIONID -- unique ID for this session
• SESSIONVAR -- name of CGI and session variable that stores the session ID
• SESSION_VARIABLE -- get, set or clear a session variable
• SET -- set a preference setting during runtime
• SHOWPREFERENCE -- show where preferences are defined.
• SKIN -- current skin
• SLIDESHOWEND -- end slideshow
• SLIDESHOWSTART -- convert a topic with headings into a slideshow
• SPACEDTOPIC -- topic name, spaced and URL-encoded deprecated
• SPACEOUT -- renders string with spaces inserted in sensible places
• STARTINCLUDE -- start position of topic text if included
• STARTSECTION -- marks the start of a section within a topic
• STATISTICSTOPIC -- name of statistics topic
• STOPINCLUDE -- Alias for ENDINCLUDE
• STOPSECTION -- Alias for ENDSECTION
• SUBSCRIBE{ attributes } - subscribe the current user for notification of changes to the current topic
• SYSTEMWEB -- name of documentation web
• TAB -- tab inside a tabpane widget
• TABLE -- control attributes of tables and sorting of table columns
• TABPANE -- tabpane widget
• TOC -- table of contents
• TOPIC -- name of current topic
• TOPICLIST -- topic index of a web
• TWIKIWEB -- synonym for SYSTEMWEB
• TWISTY -- generate content block with interactive visibility controls
• TWISTYBUTTON -- Shorthand version for TWISTYSHOW & TWISTYHIDE
• TWISTYHIDE - Hide/close link
• TWISTYSHOW - Show/open link
• TWISTYTOGGLE -- Twisty Toggle contents section
• URLPARAM -- get URL or HTTP POST parameter value
• USERINFO -- retrieve details about a user
• USERNAME -- your login username
• USERSWEB -- name of users web
• VAR -- get a preference value from another web
• WEB -- name of current web
• WEBLINK
• WEBLIST -- index of all webs
• WEBPREFSTOPIC -- name of web preferences topic
• WIKIAGENTEMAIL -- From: email address in emails sent by Foswiki.
• WIKIAGENTNAME -- From: Name used in emails sent by Flatiron Institute Documentation Center
• WIKIHOMEURL -- site home URL
• WIKINAME -- your Wiki username
• WIKIPREFSTOPIC -- name of site-wide preferences topic
• WIKITOOLNAME -- name of your site
• WIKIUSERNAME -- your Wiki username with web prefix
• WIKIUSERSTOPIC -- name of topic listing all registered users
• WIKIVERSION -- the version of the installed Foswiki engine
• WIKIWEBMASTER -- feedback email address for site
• WIKIWEBMASTERNAME -- Name of the administrator for the site

Deprecated macros

The following macros are deprecated and should not be used.

• ADDTOHEAD -- deprecated, use ADDTOZONE instead
• ALLVARIABLES -- list of currently defined macros
• GROUPS -- a formatted list of groups
• MAINWEB -- deprecated synonym for USERSWEB
• METASEARCH -- special search of meta data
• REVARG -- &rev=n parameter of current request
• TWIKIWEB -- synonym for SYSTEMWEB

Shortcuts

• TOPICURL -- absolute URL for the current topic
• BR -- line break
• CLEAR -- clear floats
• BULLET -- •
• VBAR -- |
• CARET -- ^
• BB -- line break and bullet

For example, %CARET% will appear as ^

Icons

• H -
• I -
• M -
• N -
• P -
• Q -
• S -
• T -
• U -
• X -
• Y -

---

Related Topics: Macros, PreferenceSettings, UserDocumentationCategory