Versions Compared

Old Version 10

changes.mady.by.user Bob Swift

Saved on

compared with

New Version 11

changes.mady.by.user Bob Swift

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table plus
autoNumbertrue
VariableReplacement
$current_user_idCurrent logged in user's id or blank if not logged in.
$current_user_nameCurrent user's full name or blank if not logged in.
$current_user_emailCurrent user's email address or blank if not logged in.
$current_user_timezone_idCurrent user's time zone setting id (example: America/Chicago). The default time zone will be used if the user is not logged in.
$current_user_timezone_offsetCurrent user's time zone setting offset (in hours) from GMT (examples: -6, 5.5) The default time zone will be used if the user is not logged in.
$current_timeCurrent date and time in the default Confluence format or format specified by the dateFormat parameter.
$page_titleTitle of the current page.
$page_idNumeric id of the current page.
$page_urlFull url of the current page.
$page_tinyurlTiny url of the current page.
$space_nameSpace name of the current space.
$space_keySpace key of the current space.
$confluence_homePath to the Confluence Home directory.
$base_urlBase URL for Confluence.
$request_stringEncoded request parameters after a button press.
$include_page(<page reference>)

Includes un-rendered page source at the point of the variable and then proceeds to apply variable replacements as normal. This means that the variables on the page being included will be replaced under the context of the original page. This means things like $page_title will represent the original page. Further more, this enables scenarios where one wants a template like page that can be brought in with substitution variables based on fixed parameters (run-now) or user input (run). This can prevent duplication in a number of user cases. The included content is inline with the surrounding content but starts a new line. Included pages cannot have ) in the title to avoid ambiguity. There may be some cases where this may not produce the expected results because the context of the included page is not used and some content and macros depend on that. For instance, finding attachments or page properties. User needs to be aware of the consequences and differences of including page source versus including rendered content. Even with that restriction, there are many examples where this will work nicely. Recursion is not supported. Some macro interactions may also not work as expected. For example,cache macro refresh and similar. Examples: $include_page(include) $include_page(myspacekey:The title of the page to include)

%property_key%Property value. See content-properties for more information.
%metadata_name%Metadata value. See content-properties for more information.
$include_page(include)
$include_page(myspacekey:The title of the page to include)
 
Tip
titleReplacement

Replacement occurs for variables found within the body of the macro just prior to rendering the body. It cannot replace variables produced by the rendering process like data produced by downstream macros.