Availability

 

Skip to end of metadata
Go to start of metadata

On this page

Overview

The Attachment Table macro produces a table of attachments based on various selection criteria, including powerful space and page selection.

Further customization is possible by specifying filters to select attachments by name, comment content, and labels. You can select and indicate the order in which columns are to be displayed based on their column name or number.  Refer to Columns Available to Display for details.

The resulting table can be customized and supports most common table capabilities.

Depending on the selection criteria used and number of attachments, pages, and spaces that need to be processed, this could be a long running process. Choose your selection criteria carefully and consider using the Cache Macro to limit the number of times the attachment list generation needs to be done and/or the Future Macro to defer processing. The limit parameter described below can also be used to limit processing.

Feature Video

Basic Use

This macro can be deployed using one of the following methods:

Selected from the Macro BrowserAttachment Table
Markup Shortcut{attachment-table}

Screenshot

See a live site creatively using the attachment-table macro

Parameters

(info) Click a column heading to toggle the sorting of that column.

Refer to Using Regex Expressions To Select Attachments to learn how to form the regular expressions that are supported by several parameters below.

Common Parameters

The following parameters are part of our common table capabilities that are available to many macros that produce or modify tables.

(info) Click a column heading to toggle the sorting of that column.


 

Columns Available for Display

The Attachment Table macro allows the user to select the columns to be displayed as well as the order. A default set of columns is displayed unless an explicit list is provided. You can select and indicate the order in which columns are to be displayed based on their column name or number. Use the columns parameter to specify a comma separated list of column names or numbers.

(info) Please note that column names are case insensitive.

In most cases the column heading can be used in place of the column name, but there are a few cases where that is ambiguous. In this case, the first column matching the heading will be used. 

Default columns for single page attachmentsfile, size, creator, created, comment
Default columns for multiple page attachmentspage, file, size, creator, created, comment

 

 

Examples

Other Macros

Below is a list of all other Macros available within this Add-on:

Additional References

 

 

 

 

 

4 Comments

  1. Using the attachment table macro to generate a list from a specific space doesn't seem to include attachments on blog posts within the space. Is there any solution possible to generate an attachment table based on the macro to pull the list from blog posts within a specific space?

    1. No. I created  TBL-277 - Getting issue details... STATUS  for you.

  2. Is there a way to customize the header, e.g. translate the column headers to a different language.

    1. No, not at this time. There is an existing improvement request:  TBL-241 - Getting issue details... STATUS .