Page Comparison

Div

id	ProductTOC

Screenshot

Image RemovedImage Added

Info

title	See a live site creatively using the attachment-table macro

From vxvista.org: Recorded Webinars

...

Tabs

Macro editor label

Default

Description

Macro parameter

Page filtering

Source

current page

Select the available source of a page from which you can fetch the attachments.

Single page: This is the default option. Select the source Space and Page values from the respective drop-down lists to fetch the attachment from.
Regular expression: Enter the respective parameter values as explained in the succeeding four rows.

attachmentSource

Filter by space key or space name

Enter a regular expression (regex) to match with space keys or space names. Used in combination with the Page name regex parameter to select pages from which attachments are to be chosen. If left blank, the Page to list attachments from parameter is required.

The following options indicate:

@self - current space or page
@home - homepage of current space

@parent - parent page of current page or space

Note
It is possible that in page preview, before publishing for the first time, the result for @self and @parent are not displayed as expected. Once you save the document, you can view the result as expected.

spaceRegex

Include personal spaces

Off

Enable to control whether personal spaces matching Space key or space name regex are to be included or not, to process and render attachments from the specified spaces.

includePersonalSpaces

Filter by page name

Enter a regular expression (regex) pattern to match on page names (titles). Used in combination with the Space key or space name regex parameter to select pages from which attachments are to be chosen.

pageRegex

Filter by page label

Enter a regular expression (regex) pattern match on page labels. Used in combination with the Page name regex and Space key or space name regex parameters to select pages from which attachments are to be chosen. Pages must match with every selection criteria.

pageLabelRegex

Attachment filtering

Attachment name regex

Enter a regular expression (regex) pattern to match on attachment names. Used in combination with the Attachment comment regex and Attachment label regex parameters to select attachments. Attachment must match with every selection criteria.

attachmentRegex

Attachment comment regex

Enter a regular expression (regex) pattern to match on attachment comments. Used in combination with the Attachment name regex and Attachment label regex parameters to select attachments. Attachment must match with every selection criteria.

commentRegex

Attachment label regex

Enter a regular expression (regex) pattern to match on attachment labels. Used in combination with the Attachment name regex and Attachment comment regex parameters to select attachments. Attachment must match with every selection criteria. Matching technique is determined using the Label match option parameter.

labelRegex

Label match option

single

Specify the manner in which to apply the Attachment label regex parameter (for attachments) and the Page label regex parameter (for pages) when looking for matching labels. The options are:

single: An attachment, that has at least one label that matches the Page label regex or Attachment label regex pattern, is considered as selected.
all: Page label regex and Attachment label regex are used to match a blank separated list of all labels.

labelMatchOption

Data settings

Columns to display

default columns

Enter a comma-separated list of column names or numbers in any order. When blank, a default set of columns is shown. Columns are enumerated starting at 1.

See Columns available for display below for a list of columns.

columns

Text to display when no attachments match

Enter the text to be displayed when no attachments are found that match the given search criteria. If left blank, no text is displayed if no attachments are found.

textForNone

Date format

Confluence default

Enter a date format to format the dates in the created and modified columns. Use a simple date format string.

dateFormat

Limit number of attachments to retrieve

The default value is the admin-configured value for the parameter:

Global Configuration > Maximum attachments to process.

Enter the number of attachments that the macro must retrieve.The default value is the admin-configured limit for the parameter Maximum attachments to process in Global Configuration. The field description displays the admin-configured value in Global Configuration.

Info

Suppose the user configures a value for the parameter Limit number of attachments to retrieve.

In that case, while processing the attachments, the macro considers the least of the value configured between the parameters Limit number of attachments to retrieve, and Maximum attachments to process.
The processing stops after the number of attachments found matching the Page filtering selection criteria reaches the least of the value configured. For more information, refer to How to set the maximum number of attachments to process for the Attachment Table macro?
The space and page attachments are processed and ordered by the attachment name and displayed on the confluence page.

limit

Retrieve attachments from child pages

false

Enable this option to list the child page attachments of the specified page in Space and Page parameters in the Page filtering tab. By default, only the attachments on the specified page are displayed.

Note
This option works only if Single page is selected in Page filtering > Source.

fromAllChildPages

...

Selected from the macro browser	Advanced Tables - Attachment Table
Markup shortcut	{attachment-table}

Versions Compared

Old Version 28

New Version Current

Key

On this page

Screenshot