Formatting the asset listing

When you create an Asset listing page, many bodycopy assets are automatically created beneath it. These assets allow you to format the layout of the asset listing page.

Default format bodycopy

The Default format bodycopy asset defines what information to display for each asset in the list through keyword replacements and metadata fields. For example, in the asset listing shown, each asset in the list shows a link to the asset, and information added to the description metadata field.

This configuration is defined in the Default format bodycopy.

An example asset listing
Figure 1. An example asset listing page

To change what information is shown:

  1. Right-click on the Default format bodycopy in the asset tree.

  2. Select Edit contents.

  3. Click on the Edit icon.

  4. The WYSIWYG editor will appear.

You can use keyword replacements and formatting to configure the information shown in the list.

By default, the Asset name linked keyword replacement will appear in the WYSIWYG Editor.

Keyword replacements on the default format bodycopy

A list of keyword replacements is provided in the WYSIWYG editor toolbar on the Edit contents screen of the default format bodycopy. You can use these keyword replacements in conjunction with text, images, and links to layout what to show for each asset in the list. Read Keyword replacements and modifiers for more information about keyword replacements.

The additional keyword replacements that are available include the following:

Asset lineage

This will show the path of where the asset exists in the system.

Asset lineage linked

This will show the path of where the asset exists in the system. Each asset in the path is hyperlinked.

Asset contents (including paint layout)

This will show the asset’s content and include any paint layouts applied to the asset.

Asset name linked

This will show the name of the asset. It will be hyperlinked to the asset.

Short asset name linked

This will show the short name of the asset. It will be hyperlinked to the asset.

Asset position

This will show the position of the asset in the list.

Asset’s position is odd or even

This will show whether the asset is in a position number that is odd or even.

Root nodes (separated by commas)

This will show the asset ID of the root node in which the asset is located.

Asset contents (excluding paint layout)

This will show the asset’s content but will not include any paint layouts applied to the asset.

The description of the asset’s status

This will show the description of the asset’s current status.

The color that corresponds to the asset’s status

This will show the hash value for the color of the current status of the asset.

The full name of the page

This will show the name of the asset.

The short name of the page

This will show the asset’s short name, and is often used in menus.

Asset Contents (user-defined paint layout)

This will show the asset’s content and include the user-defined paint layout specified in the keyword replacement. Alternatively, the asset ID can be used in this keyword replacement instead of the asset name.

Along with the standard list of keyword replacements, you can also use the metadata keyword replacement to display a metadata field for an asset on the default format bodycopy.

For more information on this, refer to the Metadata keyword replacements Matrix Manuals documentation.

Page contents bodycopy

The page contents bodycopy defines the layout of the asset listing page, including where to put the list of assets, a heading for the page, and an introduction about it.

This example asset listing shows a heading, an introduction, and the list. This configuration is defined in the page contents bodycopy.

An example asset listing
Figure 2. An example asset listing page

To change what information is shown:

  1. Right-click Page contents bodycopy in the asset tree.

  2. Select Edit contents.

  3. Click on the Edit icon.

  4. The WYSIWYG editor will appear where you can use keyword replacements and formatting to layout the information to show on the page.

By default, the keyword replacement asset listing will appear in the WYSIWYG editor.

If you do not include the keyword replacement asset listing on the page contents bodycopy, the assets list will not appear.

Keyword replacements on the page contents bodycopy

A list of keyword replacements is provided in the WYSIWYG editor toolbar on the Edit contents screen of the page contents bodycopy. You can use these keyword replacements in conjunction with text, images, and links to layout the asset listing page. The standard keyword replacements that are available include the following:

Sort by

This will show the list of options by which to sort the list. These options are defined on the Asset sorting screen.

Sort order

this will show the list options to change the sort order of the list. These options are defined on the Asset sorting screen.

Reset button

This will show the Reset button.

Submit button

This will show the Submit button. You would show this button if you were using the Sort by or Structure root node selector keyword replacements.

Root nodes (separated by commas)

This will show the asset ID for each of the Root Nodes selected on the Details screen of the asset listing page.

Asset listing

This will show the list of assets. If you do not include this keyword replacement, the list will not appear on the page.

Previous page link

If you have split the list of assets over several pages, this will link to the previous page of assets. You can change this link’s wording in the Previous link field on the Details screen of the asset listing.

Previous page HREF

If you have split the list of assets over several pages, this will show an HREF to the previous page of assets.

Next page link

If you have split the list of assets over several pages, this will link to the next page of assets. You can change this link’s wording in the Next link field on the Details screen of the asset listing.

Next page HREF

If you have split the list of assets over several pages, this will show an HREF to the next page of assets.

Page list

If you have split the list of assets over several pages, this will show a hyperlink to each page. If you are using the A-Z list format, this will show a hyperlink for each character. When you click on one of the characters, the list’s assets starting with that character will be shown.

Page list (without unused letters)

If you are using the A-Z list format, this will show a hyperlink for each character with assets that start with that letter. For example, if there are no assets that start with the letter G, it will not be included. When you click on one of the characters, the list’s assets starting with that character will be shown.

Sliding page list showing X page numbers at a time

If you have split the list of assets over several pages, this setting will show a sliding list of page numbers that are hyperlinked. The number of pages shown at once is defined in X. For example, if you enter 3 for the X value of the keyword replacement, the system will initially show pages 1 2 and 3. If you click on 3, the system will 'slide' down the list of pages and display 2, 3 and 4.

Page number

If you have split the list of assets over several pages, this will show the number of the page you are currently viewing.

Total assets listing

This shows the total number of assets in the list.

Assets listed on this page

If you have split the list of assets over several pages, this will show the number of the page you are currently viewing.

Total pages

If you have split the list of assets over several pages, this will show the total number of pages there are for the list.

First asset on page’s position number

This will show the number of the first asset’s position.

Last asset on page’s position number

This will show the number of the last asset’s position. For example, if you have 10 assets in the list, 10 displays.

Number of unique assets

This will show the number of unique assets in the list.

Structured root node selector

This will show the list of root nodes selected in the Structured root node fields on the Details screen of the asset listing page.

Select all script code

If you are using asset selections, this option will add the code so the user can select all the options.

Page contents (no results) bodycopy

Page contents (no results) bodycopy defines the asset listing page layout when there are no assets to show.

To change what information is shown:

  1. Right-click on Page contents (no results) bodycopy in the asset tree.

  2. Select Edit Contents.

  3. Click on the Edit icon

  4. The WYSIWYG editor will appear, and you can enter the information to show on the page.

By default, No results were found appears in the WYSIWYG editor.

© 2015- Squiz Pty Ltd