Biggest heading

Bigger heading

Big Heading

Normal Heading

Small Heading

Smallest Heading

Example:

Some block quoted text

Quote a block of text that's longer than one paragraph.

here is quoteable
content to be quoted

Example: look ma, red text!

Example: pagetitle

If such a page doesn't already exist, it will allow you to create the page in the current space. Create page links will have a after them.

Example: anewpage

Example: link alias

If you attempt to link to a blog post that doesn't exist, no link will be created.

Example:

• /2004/01/12/My Blog Post
  
• my link name

Examples:

• /2004/01/12/My Blog Post
• my link name

Examples:

• Re: Webwork 2 Upgrade
• my link name

Examples:

• spacekey
• custom link title
• [nosuchspace:]

Examples:

• User Full Name
• custom link title
• [~nosuchuser]

Examples:

• confluence@Google
• custom link text

Note: the [] around external links are optional in the case you do not want to use any alias for the link.

Examples:

• http://confluence.atlassian.com
• Atlassian

Example: legendaryservice@atlassian.com

This only works on Internet Explorer
Creates a link to file on your computer or on a network share that you have mapped to a drive

Generates an 'Add Page' link which, when clicked, can take the user directly to a template and/or set the page parent.

• template - (optional) the name of the template to use when creating the page.
• live - (optional) if set to 'true', the template will be live when the page is created. Defaults to false.
• parent - (optional) the name of the parent page (empty by default). May also have the following markers:
  • @self - (default) the parent will be the page the macro is in.
  • @parent - the parent will be the parent of the page the macro is in.
  • @home - the parent will be home page for the Space the page is in.
• title - (optional) if you want popup text to appear when the mouse is hovered over the link, enter it here.
• labels - (optional) the list of labels to apply to the new page. Does not work for non-live templates.
• allowRename - (optional) if set to true, the user will be allowed to rename the page while it is being created.

Generates an 'Add Page' form with a field for the title.

• template - (optional) the name of the template to use when creating the page.
• live - (optional) if set to 'true', the template will be live when the page is created. Defaults to false.
• parent - (optional) the name of the parent page (empty by default). May also have the following markers:
  • @self - (default) the parent will be the page the macro is in.
  • @parent - the parent will be the parent of the page the macro is in.
  • @home - the parent will be home page for the Space the page is in.
• labels - (optional) the list of labels to apply to the new page. Does not work for non-live templates.
• allowRename - (optional) if set to true, the user will be allowed to rename the page while it is being created.
• width - (optional) The width of the title text field. Eg. '250px' or '70%'.

Links to a page in the current space. If the page doesn't exist or is untitled, it generates a 'Add Page' link which, when clicked, can take the user directly to a template and/or set the page parent.

The title may also contain substitution markers, indicated with '%' surrounding a Supplier key chain value. Eg:

{link-page:name=%content:title% - %global:current user > user:full name%}your page{link-page}

This will link to a page with the name being the parent page's title, followed by " - " followed by the current user's name.

• [default]/name - (optional) the title of the page. If not supplied, clicking the link will always create a new page.
• template - (optional) the name of the template to use when creating the page.
• live - (optional) if set to 'true', the template will be live when the page is created. Defaults to false.
• parent - (optional) the name of the parent page (empty by default). May also have the following markers:
  • @self - (default) the parent will be the page the macro is in.
  • @parent - the parent will be the parent of the page the macro is in.
  • @home - the parent will be home page for the Space the page is in.
• title - (optional) if you want popup text to appear when the mouse is hovered over the link, enter it here.
• labels - (optional) the list of labels to apply to the new page. Does not work for non-live templates.
• allowRename - (optional) if set to true, the user will be allowed to rename the page while it is being created.

Creates a link to special Confluence locations. All locations are non-case-sensitive.

• [default] - The location to link to. See the list of locations below.
• space - (optional) The spacekey to link to.
• page - (optional) The name of the page/news item/etc to link to.
• popup - (optional) If 'true', the link will open in a popup window.
• popupWidth - (optional) The width of the popup window. Defaults to 600px.
• popupHeight - (optional) The height of the popup window. Defaults to 400px.
• popupScroll - (optional) If false, no scrollbar is displayed. Defaults to true.
• target - (optional) The name of the popup window to open.
• title - (optional) if you want popup text to appear when the mouse is hovered over the link, enter it here.

• admin - The administration section.
• dashboard - The Dashboard.
• global templates - The global templates page.
• homepage - The user's homepage.
• login - The login page.
• logout - The logout page.
• signup - The signup page.
• notation guide - The notation guide.
• rss feed builder - The RSS Feed Builder (Confluence 2.x)
• spaces - The list of spaces the user has access to. (Confluence 1.4)
• user profile - The currently logged in user's profile.
• user history - The currently logged in user's history.

Space Locations
You can specify which space to link to by setting the 'space=key' parameter, or it will default to the current space.

• add news - Add a news post.
• browse space - Go to the 'Browse Space' view.
• mail - The mail page.
• news - The news page.
• pages alphabetical - The list of pages in alphabetical order.
• pages tree - The hierarchical view of pages in the space.
• pages updated - The recently updated pages list.
• space attachments - The attachments list for the space.
• space templates - The space templates list.
• popular labels - A page listing popular page labels in the space. (Confluence 2.x)
• all labels - A page listing all labels across the space. (Confluence 2.x)

RSS Feeds
Again, you can specify the space, or the current one will be used as the default.

• rss comments - New comments are added to this feed.
• rss news - News items for the space are added to the feed.
• rss new pages - Any new pages in the space are added to the feed.
• rss updated pages - Any updated pages in the space are added to the feed.

Page Locations
You can specify the space key as above, and you can specify the page or news item with the 'page=Page Name' parameter.

• @parent - Links to the page's parent, if it has one.
• @self - Links to the page the macro is on.
• add comment - Opens the 'add comment' section of the page.
• page comments - Jumps to the page comments.
• page attachments - The attachments tab for the page.
• page children - Jumps to the page children list.
• page edit - The edit tab for the page.
• page history - The page history view.
• page info - The page info view.
• page source - The page source view
• pdf export - Export the page to PDF.
• word export - Export the page in Microsoft Word format.
• print - The print view for the page.

Links to a page or URL, popping it up into a new window.

• [default]/href - The name of the page, or the URL.
• type - Either 'normal' (the default) or 'popup'. If set to popup, many of the settings below will default to those appropriate for a popup window.
• width - The width of the new window.
• height - The height of the new window.
• scrollbars - If false, the scrollbar will be hidden.
• menubar - If false, the menubar will be hidden.
• location - If false, the location bar will be hidden.
• statusbar - If false, the status bar will be hidden.
• resizable - If false, the window will not be resizable.
• target - The title of the target window. Use this to open multiple links in the same popup window.
• tip - The tip to display while the mouse is hovering over the link.
• icon - If false, the link will not have an 'open new window' icon.

Redirects the browser to the specified page or URL. Note: To allow editing of a page once it has been redirected, add '?redirect=false' to the query string.

• [default]/location - (required) The page or URL to redirect to.
• delay - (optional) The number of seconds to delay before redirecting.

Creates an alias for the current page. Any references to the alias will be redirected to this page.

• [default] - The alias. Must follow standard page naming conventions.
• parent - (optional) The parent the alias should have. May be set to any page in the current space. It will default to having no parent. It may also be one of two special parent markers:
  • @self - the parent will be the page being aliased.
  • @parent - the parent will be the parent of the page being aliased.

Example:

• some
• bullet
• indented
• bullets
• points

Example:

• different
• bullet
• types

Example:

1. a
2. numbered
3. list

# a
# numbered
#* with
#* nested
#* bullet
# list

* a
* bulletted
*# with
*# nested
*# numbered
* list

Example:

1. a
2. numbered
   • with
   • nested
   • bullet
3. list

• a
• bulletted
  1. with
  2. nested
  3. numbered
• list

The Dynamic Tasklist Macro displays a task list which can be modified in the page as it is viewed. Despite the fact that this plugin has an ajax UI, it is still fully versioned like a normal Confluence page.

What you need to type	What you will get
{dynamictasklist:Arthurs To-Do's}

If a fully qualified URL is given the image will be displayed from the remote source, otherwise an attached image file is displayed.

If no space key is defined, the current is space is used by default.

Insert a thumbnail of the image into the page (only works with images that are attached to the page). Users can click on the thumbnail to see the full-sized image.

Thumbnails must be enabled by the site administrator for this to work.

For any image, you can also specify attributes of the image tag as a comma separated list of name=value pairs like so.

Create a gallery of thumbnails of all images attached to a page. This will only work on pagesthat allow attachments, obviously.

The title parameter allows you to supply a title for the gallery

The columns parameter allows you to specify the number of columns in the gallery (by default, 4)

The exclude parameter allows you to specify the name of attached images to ignore (i.e., they will not be included in the gallery). You can specify more than one picture, separated by commas. Example: exclude=my picture.png,my picture2.gif

The include parameter allows you to specifically include one or more attached images. The gallery will show only those pictures. You can specify more than one picture, separated by commas. Example: include=my picture.png,my picture2.gif

The page parameter allows you specify the title of one or more pages which contains the images you want displayed. If a page is in the same space as the page containing the macro, use the format page=My Page Name. To specify a page in a different space, use page=SPACEKEY:My Page Name, such as page=DOC:Gallery Macro. You can specify more than one page, separated by commas. Example: page=Image Gallery,STAFF:Group Photos

If a page or attachment file name contains a comma, you can use it in the include, exclude, or page parameters by enclosing it in single or doublequotes. Example: include="this,that.jpg",theother.png

The sort parameter allows you to control the order of the images. The options are name,comment, date, or size.

The reverseSort parameter is used in conjunction with the sort parameter to reverse the order of the specified sort.

Previous versions of the Gallery macro had an additional slideshow parameter. This is no longer used in the latest version, and the slide show is always enabled. We have left the parameter here for compatibility with older versions of the macro.

Includes a Gliffy diagram in the page.

• name - (required) The name of the diagram. This name must be unique for the current page.
• space - (required if page attribute used, otherwise optional) The space key of the page that the diagram is attached to.
• page - (required if space attribute used, otherwise optional) The name of teh page that the diagram is attached to.
• size - (optional, default is L) The size of the image that will be shown. Possible values are 'L' (Full size), 'M' (medium), 'S' (small), 'T' (Thumbnail)
• align - (optional, default is left) Horizontal alignment of the diagram image on the page. Possible values are 'left','center', and 'right'.
• alt - (optional, default is diagram name) Image tag alternative text.
• border - (optional, default is true) Display the border around an image.

The code given here produces a table that looks like:

Defines a single column.

• width: - (optional) the width of the column.

If you want to use columns instead of tables, you can define them first by marking a {section}, and then placing any number of {column}s inside.

• border: - (optional) set to "true" to draw a border around the section and columns.

Example:

// Some comments here
public String getFoo()
{
  return foo;
}

<test>
    <another tag="attribute"/>
</test>

Displays a chart using data from the supplied table or tables.

• Chart type parameters - These parameters change what type of chart to display and the way the chart looks.
  • type - The type of chart to display. The following chart types are available:

    Standard charts

    • pie (default)
    • bar
    • line
    • area

    XY plots - The standard XY plot has numerical x and y axes.The x values may optionally be time based. See timeSeries.

    • xyArea
    • xyBar
    • xyLine
    • xyStep
    • xyStepArea
    • scatter
    • timeSeries

    Other charts

    • gantt - beta - See Gantt Charts.
    
    
  • orientation - A bar, line, or area chart will be displayed vertically (y axis is vertical) unless 'orientation=horizontal' is specified.
  • 3D - A pie, bar, or line chart will be shown in 3D if 3D=true is specified.
  • stacked - A bar or area chart will be shown with stacked values if stacked=true is specified.
  • showShapes - Shapes will be shown at each data point in a line chart unless showShapes=false.
  • opacity - A percent value between 0 (not visible) and 100 (non-transparent) that determines how opaque the foreground areas and bars display. Defaults are:
    • 75 percent for 3D charts
    • 50 percent for non-stacked area charts
    • 100 percent for all other charts
• Display control parameters
  • width - The width of the chart in pixels (default is '300')
  • height - The height of the chart in pixels (default is '300')
  • dataDisplay - Default is false to not display the rendered body of the macro (usually the data tables). When dataDisplay=true or dataDisplay=after, the data will be displayed after the chart. When dataDisplay=before, the data will be displayed before the chart.
  • imageFormat - Default is png. Format of generated image. Valid formats are png and jpg. Other formats may be also be valid if installed on your server.
• Title and label customization parameters
  • title - The title of the chart.
  • subTitle - A subtitle for the chart using a smaller font.
  • xLabel - The label to use for the x (domain) axis
  • yLabel - The label to use for the y (range) axis
  • legend - A legend will be displayed unless legend=false is specified.
• Data specification parameters - The data for the chart is taken from tables found when the macro body is rendered. These options control how this data is interpreted. By default, numeric and date values are interpreted according to the Confluence global default language (locale) formats. If conversion fails, other languages defined to Confluence will be tried. Additional conversion options can be specified using the parameters below.
  • tables - Comma separated list of table ids and/or table numbers contained within the body of the macro that will be used as the data for the chart. Defaults to all first level tables. If data tables are embedded in other tables, then table selection will be required. This occurs when more complex formatting is done (for example using section and column macros).
  • columns - Comma separated list of column labels and/or column titles and/or column numbers for tables used for chart data. This applies to all tables processed. Defaults to all columns. Columns are enumerated starting at 1. Column label is the text for the column in the header row. Column title is the (html) title attribute for the column in the header row.
  • dataOrientation - The data tables will be interpreted as columns (horizontally) representing domain and x values unless 'dataOrientation=vertical'.
  • timeSeries - If 'true', the x values in an XY plot will be treated as time series data and so will be converted according date formats.
  • dateFormat - For time series data, the date format allows for additional customization of the conversion of data to date values. By default, the Confluence language defined date formats will be used. If a dateFormat is specified, it will be the first format used to interpret date values. Specify a format that matches the format of the time series data. See Date Format.
  • timePeriod - Specify the time period for time series data. Default is 'Day'. This defines the granularity of how the data is interpreted. Valid values are: Day, Hour, Millisecond, Minute, Month, Quarter, Second, Week, Year.
  • language - If provided, the language and country specification will be used to create additional number and date formats to be used for data conversion. This specification will be used before the default languages automatically used. Valid values are 2 character ISO 639-1 alpha-2 codes.
  • country - Used in combination with the language parameter. Valid values are 2 character ISO 3166 codes.
  • forgive - Default is true to try to convert numeric and date values that do not totally match any of the default or user specified formats. Specify forgive=false to enforce strict data format. Data format errors will cause the chart to not be produced.
• Color customization parameters - See Colors for how to specify colors.
  • bgColor - Color (default is 'white') to use as the background of the chart.
  • borderColor - Color of a border around the chart. Default is to not show a border.
  • colors - Comma separated list of colors used to customize category, sections, and series colors.
• Axis customization parameters - Depending on the chart type, the range and domain axis may be customized. These values are automatically generated based on the data but can be overridden by specifying one or more more of these paramters.
  • rangeAxisLowerBound - range axis lower bound
  • rangeAxisUpperBound - range axis upper bound
  • rangeAxisTickUnit - range axis units between axis tick marks
  • rangeAxisLabelAngle - angle for the range axis label in degrees
  • domainAxisLowerBound - domain axis lower bound. For a date axis, this value must be expressed in the date format specified by the dateFormat parameter
  • domainAxisUpperBound - domain axis upper bound. For a date axis, this value must be expressed in the date format specified by the dateFormat parameter
  • domainAxisTickUnit - domain axis units between axis tick marks. For a date axis, this value represents a count of the units specified in the timePeriod parameter. The time period unit can be overridden by specifying a trailing character: y for years, M for months, d for days, h for hours, m for minutes, s for seconds, u - milliseconds
  • domainAxisLabelAngle - angle for the domain axis label in degrees
  • categoryLabelPosition - allows axis label text position for categories to be customized
    • up45 - 45 degrees going upward
    • up90 - 90 degrees going upward
    • down45 - 45 degrees going downward
    • down90 - 90 degrees going downward
  • dateTickMarkPosition - placement of the date tick mark
    • start (default) - tick mark is at the start of the date period
    • middle - tick mark is in the middle of the date period
    • end - tick mark is at the end of the date period
• Pie chart customization parameters
  • pieSectionLabel - Format for how pie section labels are displayed. :
    • %0% is replaced by the pie section key.
    • %1% is replaced by the pie section numeric value.
    • %2% is replaced by the pie section percent value.
    Example 1: "%0% = %1%" would display something like "Independent = 20"
    Example 2: "%0% (%2%)" would display something like "Independent (20%)"
  • pieSectionExplode - Comma separated list of pie keys that are to be shown exploded. Defaults to no exploded sections. Note: requires jFreeChart version 1.0.3 or higher.
• Attachment parameters - These are advanced options that can be used for chart versioning, automation enablement, and to improve performance. Use these options carefully! Normally, the chart image is regenerated each time the page is displayed. These options allow for the generated image to be saved as an attachment and have subsequent access re-use the attachment. This can be useful especially when combined with the cache macro to improve performance. Depending on the options chosen, chart images can be versioned for historical purposes.
  • attachment - Chart image will be saved in a attachment.
    • ^attachment - chart.macro.param.attachment.attachment
    • page^attachment - The chart is saved as an attachment to the page name provided.
    • space:page^attachment - The chart is saved as an attachment to the page name provided in the space indicated.
  • attachmentVersion - Defines the the versioning mechanism for saved charts.
    • new - (default) Creates new version of the attachment.
    • replace - Replaces all previous versions of the chart. To replace an existing attachment, the user must be authorized to remove attachments for the page specified.
    • keep - Only saves a new attachment if an existing export of the same name does not exist. An existing attachment will not be changed or updated.
  • attachmentComment - Comment used for a saved chart attachment.
  • thumbnail - Default is false. If true, the chart image attachment will be shown as a thumbnail.

Colors

Date Format

Copied from Java SimpleDateFormat specification.

Date and time formats are specified by date and time pattern strings. Within date and time pattern strings, unquoted letters from 'A' to 'Z' and from 'a' to 'z' are interpreted as pattern letters representing the components of a date or time string. Text can be quoted using single quotes (') to avoid interpretation. "'" represents a single quote. All other characters are not interpreted; theyre simply copied into the output string during formatting or matched against the input string during parsing.

The following pattern letters are defined (all other characters from 'A' to 'Z' and from 'a' to 'z' are reserved):

• Text: For formatting, if the number of pattern letters is 4 or more, the full form is used; otherwise a short or abbreviated form is used if available. For parsing, both forms are accepted, independent of the number of pattern letters.
• Number: For formatting, the number of pattern letters is the minimum number of digits, and shorter numbers are zero-padded to this amount. For parsing, the number of pattern letters is ignored unless its needed to separate two adjacent fields.
• Year: For formatting, if the number of pattern letters is 2, the year is truncated to 2 digits; otherwise it is interpreted as a number.

  For parsing, if the number of pattern letters is more than 2, the year is interpreted literally, regardless of the number of digits. So using the pattern "MM/dd/yyyy", "01/11/12" parses to Jan 11, 12 A.D.

  For parsing with the abbreviated year pattern ("y" or "yy"), SimpleDateFormat must interpret the abbreviated year relative to some century. It does this by adjusting dates to be within 80 years before and 20 years after the time the SimpleDateFormat instance is created. For example, using a pattern of "MM/dd/yy" and a SimpleDateFormat instance created on Jan 1, 1997, the string "01/11/12" would be interpreted as Jan 11, 2012 while the string "05/04/64" would be interpreted as May 4, 1964. During parsing, only strings consisting of exactly two digits, will be parsed into the default century. Any other numeric string, such as a one digit string, a three or more digit string, or a two digit string that isnt all digits (for example, "-1"), is interpreted literally. So "01/02/3" or "01/02/003" are parsed, using the same pattern, as Jan 2, 3 AD. Likewise, "01/02/-3" is parsed as Jan 2, 4 BC.

• Month: If the number of pattern letters is 3 or more, the month is interpreted as text; otherwise, it is interpreted as a number.
• General time zone: Time zones are interpreted as text if they have names. For time zones representing a GMT offset value, the following syntax is used:

       GMTOffsetTimeZone:
               GMT Sign Hours : Minutes
  
       Sign: one of
               + -
       Hours:
               Digit
               Digit Digit
  
       Minutes:
               Digit Digit
       Digit: one of
               0 1 2 3 4 5 6 7 8 9

  Hours must be between 0 and 23, and Minutes must be between 00 and 59. The format is locale independent and digits must be taken from the Basic Latin block of the Unicode standard.

  For parsing, RFC 822 time zones are also accepted.

• RFC 822 time zone: For formatting, the RFC 822 4-digit time zone format is used:

       RFC822TimeZone:
               Sign TwoDigitHours Minutes
       TwoDigitHours:
               Digit Digit

  TwoDigitHours must be between 00 and 23. Other definitions are as for general time zones.

  For parsing, general time zones are also accepted.

Used to force the collapse/display of the sidebars on a page-by-page basis

Parameters:

• default - the sidebar to be affected (left/right)
• collapse - should the sidebar be collapsed? (true/false)
• force - override any cookie stored value for the state (true/false - default false)

See Also: User Guide and Examples

creates a child page to the current page (if it doesnt already exist)

Parameters:

• default - The child page title (if it already exists but is not a child of the current page then a number will be appended)
• template - the name of the template to apply to the child page
• portal - the name of the portal to inject into the child page
• content - the content to place into the child page
• render - pre-render the child page (default false)

See Also: User Guide and Examples

Used to display a menubar

Parameters:

• _default_ - The HTML ID (must be unique for the entire web page) associated with an item in the menu
• id - alternative (original) way of specifying the html id
• class - The CSS class name to assign to div wrapping the menu
• classname - The CSS class name to assign to items in the menu
• electric - true (or number) - Pop-up menus will automatically open when the mouse hovers over their parent item, or their parent item gets keyboard focus, false - Pop-up menus will only be displayed when the parent item is clicked or when the the parent item is selected and the left arrow key (or spacebar) is pressed (default true)
• timeout - Defines the number of milliseconds to wait before menus are automatically shown when the "electric" parameter is set to true
• vertical - false - Items on the top level of the menu bar are shown horizontally, true - Items on the top level of the menu bar are shown vertically (ideal for putting menus in sidebars) (default false)
• context - see userguide
• tooltips - true - Tooltips, if specified in linked menu items, are shown when the mouse hovers over a menu item, false - Tooltips are not shown, useful when your target audience is using a slow internet connection or slow computer (default true)
• shadows - see userguide
• smooth - true - Shadows will look smoother in most browsers (requires an additional image to be loaded), false - Basic shadows will be used (slightly faster loading of pages) (default true)
• blink - false - Menu items do not blink when clicked, true - Menu items blink a few times when clicked to give more visual feedback to the end-user (default false)
• lazy - false - After the web page loads, the entire menu is "built" immediately, true - After the web page loads, only the top level of the menu is "built" and subsequent levels (i.e. pop-up menus) are only built when they are first displayed (default false)
• toolbar - false - The top level of the menu displays normally, true - Additional styling is applied which makes items on the top level of the menu take up less space, ideal for toolbars. Note that some menu styles (e.g. the Longhorn style) don't currently support this feature (default false)
• clone - see userguide
• focus - automatically focus the menu (default false)
• scrolling - true - If a menu is too big to fit in the browser window, scroll buttons will appear at either end to allow the user to "scroll" the menu. It's a really nice feature!, false - Menus will be shown in their entirety, even if that means that part of them can't be seen within the browser window (default true)

See Also: User Guide and Examples

Used to create a menu with an icon based on the current space & page watch state

Parameters:

• class - The CSS class name to assign to an item in a menu
• subclass - The CSS class name to assign to a pop-up menu that's associated with an item in a menu
• id - The HTML ID (must be unique for the entire web page) associated with an item in the menu
• subid - The HTML ID (must be unique for entire web page) associated to a pop-up menu that's associated with an item in a menu
• autohide - true : the item will be removed if it doesn't contain a hyperlink, false : the item will always be shown regardless of whether it contains a hyperlink or not, disabled : the item will always be shown, but if it doesn't contain a hyperlink it will be "visually" disabled (e.g. grey text and faded icon) (default true)
• custom - false : a normal menu item, which may contain a pop-up menu if there are hierarchically lower items found, true : allows you to embed just about anything in a menu item, defaults the "autohide" setting to false and prevents you from having a pop-up menu associated with the item (default false)
• flat - false : a normal menu item designed for use in a hierarchical structure, true : a "flat" (non-hierarchical) menu item (default false)
• notitle - false : removes the title from submenus
• size - the size of the icon to use

See Also: User Guide and Examples

Used to create a menu

Parameters:

• class - The CSS class name to assign to an item in a menu
• subclass - The CSS class name to assign to a pop-up menu that's associated with an item in a menu
• id - The HTML ID (must be unique for the entire web page) associated with an item in the menu
• subid - The HTML ID (must be unique for entire web page) associated to a pop-up menu that's associated with an item in a menu
• autohide - true : the item will be removed if it doesn't contain a hyperlink, false : the item will always be shown regardless of whether it contains a hyperlink or not, disabled : the item will always be shown, but if it doesn't contain a hyperlink it will be "visually" disabled (e.g. grey text and faded icon) (default true)
• custom - false : a normal menu item, which may contain a pop-up menu if there are hierarchically lower items found, true : allows you to embed just about anything in a menu item, defaults the "autohide" setting to false and prevents you from having a pop-up menu associated with the item (default false)
• flat - false : a normal menu item designed for use in a hierarchical structure, true : a "flat" (non-hierarchical) menu item (default false)
• notitle - false : removes the title from submenus

See Also: User Guide and Examples

Used to create a submenu

Parameters:

• class - The CSS class name to assign to an item in a menu
• subclass - The CSS class name to assign to a pop-up menu that's associated with an item in a menu
• id - The HTML ID (must be unique for the entire web page) associated with an item in the menu
• subid - The HTML ID (must be unique for entire web page) associated to a pop-up menu that's associated with an item in a menu
• autohide - true : the item will be removed if it doesn't contain a hyperlink, false : the item will always be shown regardless of whether it contains a hyperlink or not, disabled : the item will always be shown, but if it doesn't contain a hyperlink it will be "visually" disabled (e.g. grey text and faded icon) (default true)
• custom - false : a normal menu item, which may contain a pop-up menu if there are hierarchically lower items found, true : allows you to embed just about anything in a menu item, defaults the "autohide" setting to false and prevents you from having a pop-up menu associated with the item (default false)
• flat - false : a normal menu item designed for use in a hierarchical structure, true : a "flat" (non-hierarchical) menu item (default false)
• notitle - false : removes the title from submenus

See Also: User Guide and Examples

Used to create a submenu

Parameters:

• class - The CSS class name to assign to an item in a menu
• subclass - The CSS class name to assign to a pop-up menu that's associated with an item in a menu
• id - The HTML ID (must be unique for the entire web page) associated with an item in the menu
• subid - The HTML ID (must be unique for entire web page) associated to a pop-up menu that's associated with an item in a menu
• autohide - true : the item will be removed if it doesn't contain a hyperlink, false : the item will always be shown regardless of whether it contains a hyperlink or not, disabled : the item will always be shown, but if it doesn't contain a hyperlink it will be "visually" disabled (e.g. grey text and faded icon) (default true)
• custom - false : a normal menu item, which may contain a pop-up menu if there are hierarchically lower items found, true : allows you to embed just about anything in a menu item, defaults the "autohide" setting to false and prevents you from having a pop-up menu associated with the item (default false)
• flat - false : a normal menu item designed for use in a hierarchical structure, true : a "flat" (non-hierarchical) menu item (default false)
• notitle - false : removes the title from submenus

See Also: User Guide and Examples

Used to create a menuitem

Parameters:

• class - The CSS class name to assign to an item in a menu
• subclass - The CSS class name to assign to a pop-up menu that's associated with an item in a menu
• id - The HTML ID (must be unique for the entire web page) associated with an item in the menu
• subid - The HTML ID (must be unique for entire web page) associated to a pop-up menu that's associated with an item in a menu
• autohide - true : the item will be removed if it doesn't contain a hyperlink, false : the item will always be shown regardless of whether it contains a hyperlink or not, disabled : the item will always be shown, but if it doesn't contain a hyperlink it will be "visually" disabled (e.g. grey text and faded icon) (default true)
• custom - false : a normal menu item, which may contain a pop-up menu if there are hierarchically lower items found, true : allows you to embed just about anything in a menu item, defaults the "autohide" setting to false and prevents you from having a pop-up menu associated with the item (default false)
• flat - false : a normal menu item designed for use in a hierarchical structure, true : a "flat" (non-hierarchical) menu item (default false)
• notitle - false : removes the title from submenus

See Also: User Guide and Examples

Used to create a menuitem which contains a menulink and icon

Parameters:

• caption - the text to use in the link
• default - the piece of confluence functionality you wish to link to
  • RSS - go to rss feed editor
  • activity - show site/space activity
  • advanced - go to advanced config page
  • builderadmin - link to builder administration
  • children - show/hide children toggle
  • colourscheme - go to colour scheme selector
  • comments - show/hide comments toggle
  • configuretheme - configure the theme
  • copy - copy the current page
  • custom - define a custom link
  • dashboard - go to dashboard
  • edit - edit the current page
  • emailpage - link to email page action
  • exportMail - export email to page
  • exportPDF - export page to pdf
  • exportWord - export page to word doc
  • favourite - add page to favourites
  • favouritespace - add space to favourites
  • first - the first sibling page
  • firstchild - the first child page
  • globaltemplates - display list of global templates
  • history - show account history
  • home - go to space home page
  • index - go to space index
  • information - show page information
  • labels - show labels heatmap
  • last - the last sibling page
  • lastchild - the last child page
  • login - go to login screen
  • logout - log out
  • mail - show space email
  • managelayouts - link to manage layouts
  • map - go to space map
  • newcomment - add a comment
  • newnews - create a new blogpost
  • newpage - create a new page
  • news - view space news
  • newspace - create a new space
  • next - the next sibling page
  • normalView - view page as normal
  • notationguide - link to the macro notation guide
  • pageView - view the page in normal mode
  • pageattachments - show page attachments
  • parent - the current page's parent
  • people - show the people directory
  • prev - the previous sibling page
  • printableView - view page as printable
  • profile - show user profile
  • recent - view recently updated in space
  • remove - delete the current page
  • search - links to the search screen
  • signup - create a new account
  • siteadmin - go to site administration
  • spaceadmin - go to space administration
  • spaceattachments - display space attachments
  • spacetemplates - display list of space templates
  • toggleSidebar - toggle the visibility of a sidebar
  • toggleVisibility - toggle the visibility of an html element
  • use-layout - change the layout
  • userspace - show user's space
  • viewSource - view the page source
  • viewattachments - show page attachments without checking attachment permission
  • watch - watch current page/space
  • watchspace - watch current space
  • webui - show a webui link, requires location & key parameters
  • wikipage - link to the page specified by the page & space parameters
• tooltip - the tooltip that should be displayed by the link
• accesskey - the keypress that should be associated with this link
• target - the target for the link (eg _blank)
• space - the spacekey whose context the link generation should be calculated against
• page - the title of the page whose context the link generation should be calculated against
• parent - used by the exportMail link type to define the parent where the page generated from the mail shuld be created
• class - the css class to be applied to the link
• toggle - the html ID of the element whose visibility is to be toggled
• sidebar - the name of the sidebar whose visibility is to be toggled (left/right)
• link - the custom link
• icon - the icon to use as one of SPACEKEY:pagename^filename.ext/custom url/inbuilt icon (use 'noicon' to prevent an icon being displayed)
• imginside - should the icon appear inside the link (default=false)
• layoutId - the layoutId to use with use-layout
• latch - whether use-layout should latch the layout
• class - The CSS class name to assign to an item in a menu
• id - The HTML ID (must be unique for the entire web page) associated with an item in the menu
• autohide - true : the item will be removed if it doesn't contain a hyperlink, false : the item will always be shown regardless of whether it contains a hyperlink or not, disabled : the item will always be shown, but if it doesn't contain a hyperlink it will be "visually" disabled (e.g. grey text and faded icon) (default true)
• custom - false : a normal menu item, which may contain a pop-up menu if there are hierarchically lower items found, true : allows you to embed just about anything in a menu item, defaults the "autohide" setting to false and prevents you from having a pop-up menu associated with the item (default false)
• flat - false : a normal menu item designed for use in a hierarchical structure, true : a "flat" (non-hierarchical) menu item (default false)
• location - the webui location to use with webui links
• key - the webui key to use with webui links

See Also: User Guide and Examples

Inserts a separator into a menu

Parameters:

• class - The CSS class name to assign

See Also: User Guide and Examples

Inserts a gif/png icon from the embedded library, see the userguide for more details

Parameters:

• size - the size the icon should be displayed at
• tooltip - the alternate description that should be used for the icon
• force - force the menu icon to be displayed regardless of menu settings

See Also: User Guide and Examples

Generates a link to the specified piece of confluence functionality, see the userguide for more information

Parameters:

• default - the piece of confluence functionality you wish to link to
  • RSS - go to rss feed editor
  • activity - show site/space activity
  • advanced - go to advanced config page
  • builderadmin - link to builder administration
  • children - show/hide children toggle
  • colourscheme - go to colour scheme selector
  • comments - show/hide comments toggle
  • configuretheme - configure the theme
  • copy - copy the current page
  • custom - define a custom link
  • dashboard - go to dashboard
  • edit - edit the current page
  • emailpage - link to email page action
  • exportMail - export email to page
  • exportPDF - export page to pdf
  • exportWord - export page to word doc
  • favourite - add page to favourites
  • favouritespace - add space to favourites
  • first - the first sibling page
  • firstchild - the first child page
  • globaltemplates - display list of global templates
  • history - show account history
  • home - go to space home page
  • index - go to space index
  • information - show page information
  • labels - show labels heatmap
  • last - the last sibling page
  • lastchild - the last child page
  • login - go to login screen
  • logout - log out
  • mail - show space email
  • managelayouts - link to manage layouts
  • map - go to space map
  • newcomment - add a comment
  • newnews - create a new blogpost
  • newpage - create a new page
  • news - view space news
  • newspace - create a new space
  • next - the next sibling page
  • normalView - view page as normal
  • notationguide - link to the macro notation guide
  • pageView - view the page in normal mode
  • pageattachments - show page attachments
  • parent - the current page's parent
  • people - show the people directory
  • prev - the previous sibling page
  • printableView - view page as printable
  • profile - show user profile
  • recent - view recently updated in space
  • remove - delete the current page
  • search - links to the search screen
  • signup - create a new account
  • siteadmin - go to site administration
  • spaceadmin - go to space administration
  • spaceattachments - display space attachments
  • spacetemplates - display list of space templates
  • toggleSidebar - toggle the visibility of a sidebar
  • toggleVisibility - toggle the visibility of an html element
  • use-layout - change the layout
  • userspace - show user's space
  • viewSource - view the page source
  • viewattachments - show page attachments without checking attachment permission
  • watch - watch current page/space
  • watchspace - watch current space
  • webui - show a webui link, requires location & key parameters
  • wikipage - link to the page specified by the page & space parameters
• tooltip - the tooltip that should be displayed by the link
• accesskey - the keypress that should be associated with this link
• target - the target for the link (eg _blank)
• space - the spacekey whose context the link generation should be calculated against
• page - the title of the page whose context the link generation should be calculated against
• parent - used by the exportMail link type to define the parent where the page generated from the mail shuld be created
• class - the css class to be applied to the link
• toggle - the html ID of the element whose visibility is to be toggled
• sidebar - the name of the sidebar whose visibility is to be toggled (left/right)
• link - the custom link
• icon - the icon to use as one of SPACEKEY:pagename^filename.ext/custom url/inbuilt icon (use 'noicon' to prevent an icon being displayed)
• size - the size of the icon to use
• imginside - should the icon appear inside the link (default=false)
• title - page title to use with newpage menulink
• layout - the layoutId to use with use-layout
• latch - whether use-layout should latch the layout
• checkexists - whether userspace menulink should check to see if the user has a personal space (default false)
• force - force the comments or children link to be displayed when there are no comments or children to the page (default false)
• forceicon - force the icon to be displayed irrespective of the layout (default false)
• location - the webui location to use with webui links
• key - the webui key to use with webui links

See Also: User Guide and Examples

Used for simplifying menu configuration by allowing the view menu to be edited separately, and then injected into another menu using this macro.

Parameters:

• hideanon - hide the menu to anonymous users (default false)

See Also: User Guide and Examples

Used for simplifying menu configuration by allowing the edit menu to be edited separately, and then injected into another menu using this macro.

Parameters:

• hideanon - hide the menu to anonymous users (default false)

See Also: User Guide and Examples

Allows menus to be created using wiki markup or macros which return an unordered list

See Also: User Guide and Examples

Allows additions to be made to menulink replacements

Parameters:

• default - The replacement text

See Also: User Guide and Examples

Used to display an unordered list of debug data.

Parameters:

• builder - display builder data (default - true)
• context - display RenderContext parameters (default - false)
• request - display ServletRequest attributes (default - false)
• session - display Session attributes (default - false)

Inserts the confluence space/site logo into a builder panel

Parameters:

• global - force macro to display global logo
• class - HTML classname to apply (use 'png' to allow PieNG to recognise PNG logos)

See Also: User Guide and Examples

Inserts the confluence breadcrumb trail into a builder panel

See Also: User Guide and Examples

Returns the title of the current page/action

See Also: User Guide and Examples

Inserts the confluence quick label editor into a builder panel

See Also: User Guide and Examples

Used to display a chunk of wiki-markup dependant on what is being displayed

Parameters:

• context - comma separated list of contexts (the kind of page being displayed eg: page, blogpost, dashboard) where the content should be shown
• mode - comma separated list of modes that the content is being viewed as (eg: view, edit) where the content should be shown
• decorator - comma separated list of decorators (eg: printable) where the content should be shown
• action - comma separated list of actions (eg: viewpage/login/logout) where the content should be shown
• spacekey - the space against which permission checks will be made (default current space)
• pagetitle - the page against which permission checks will be made (default current page)
• space - comma separated list of spaces if the content is within one of these spaces then it will be shown
• page - the name of a confluence page whose existance defines whether the content should be shown (@parent can be used to show data if the page not at the root level, @child/@children can be used to show data if the page has children, @childless can be used to show data if the page has no children)
• pluginkey - the key of a plugin which must be enabled for the content to be shown
• spacelabel - comma separated list of labels applied to the space for which the content should be shown
• teamlabel - comma separated list of team-labels applied to the space for which the content should be shown
• label - comma separated list of labels for which the content should be shown (recursable)
• metadata - comma separated list of metadata name:value pairs where the content should be shown (recursable)
• title - the title that the page must have for the content to be shown (recursable)
• recurse - check the page's parents for the value (default false)
• withuser - username that user/group/permission checks should be run against (inc @anonymous, @creator, @author, @current - default = @current)
• user - comma separated list of usernames that should view the content (inc @anonymous, @creator & @author)
• group - comma separated list of groups whose members should should view the content (inc @anonymous, @creator & @author)
• permission - comma separated list of permissions who can view the content (view, comment, label, createpage, createnews, edit, remove, attach, export, createspace, spaceadmin, siteadmin)
• restriction - display content if the page has a restriction in place (none/view/edit/vieworedit/viewandedit - recursable)
• useragent - comma separated list of strings which if found in the user agent will display the content
• attachment - comma separated list of filenames, one of which must be attached to the current page for the content to be displayed
• olderthan - show if current page was modfied before the given time period from the current date, eg olderthan=1y6m1d1h (year/month/day/hour)
• newerthan - show if current page was modfied after the given time period from the current date, eg newerthan=1y6m1d1h (year/month/day/hour)
• ip - comma separated list of ip addresses to which the content should be shown

See Also: User Guide and Examples

Used to hide a chunk of wiki-markup dependant on what is being displayed

Parameters:

• context - comma separated list of contexts (the kind of page being displayed eg: page, blogpost, dashboard) where the content should be hidden
• mode - comma separated list of modes that the content is being viewed as (eg: view, edit) where the content should be hidden
• decorator - comma separated list of decorators (eg: printable) where the content should be hidden
• action - comma separated list of actions (eg: viewpage/login/logout) where the content should be hidden
• spacekey - the space against which checks will be made (default current space)
• pagetitle - the page against which checks will be made (default current page)
• space - comma separated list of spaces if the content is within one of these spaces then it will be hidden
• page - the name of a confluence page whose existance defines whether the content should be hidden (@parent can be used to hide data if the page not at the root level, @child/@children can be used to hide data if the page has children, @childless can be used to hide data if the page has no children)
• pluginkey - the key of a plugin which must be enabled for the content to be hidden
• spacelabel - comma separated list of labels applied to the space for which the content should be hidden
• teamlabel - comma separated list of team-labels applied to the space for which the content should be hidden
• label - comma separated list of labels for which the content should be hidden (recursable)
• metadata - comma separated list of metadata name:value pairs where the content should be hidden (recursable)
• title - the title that the page must have for the content to be hidden (recursable)
• recurse - check the page's parents for the value (default false)
• withuser - username that user/group/permission checks should be run against (inc @anonymous, @creator, @author, @current - default = @current)
• user - comma separated list of usernames that should not view the content (inc @anonymous, @creator & @author)
• group - comma separated list of groups whose members should not should view the content (inc @anonymous, @creator & @author)
• permission - comma separated list of permissions who cannot view the content (view, comment, createpage, createnews, edit, remove, attach, export, createspace, spaceadmin, siteadmin)
• restriction - hide content if the page has a restriction in place (none/view/edit/vieworedit/viewandedit - recursable)
• useragent - comma separated list of strings which if found in the user agent will hide the content
• attachment - comma separated list of filenames, one of which must be attached to the current page for the content to be hidden
• olderthan - hide if current page was modfied before the given time period from the current date, eg olderthan=1y6m1d1h (year/month/day/hour)
• newerthan - hide if current page was modfied after the given time period from the current date, eg newerthan=1y6m1d1h (year/month/day/hour)
• ip - comma separated list of ip addresses from which the content should be hidden

See Also: User Guide and Examples

Inserts the confluence favourite icon into a builder panel

See Also: User Guide and Examples

Inserts the confluence watch icon into a builder panel

See Also: User Guide and Examples

Inserts the confluence comments display and editor into a builder panel

See Also: User Guide and Examples