Details screen

Select the types of assets to list on the page. To select more than one asset type, click on the More button. An additional list will appear on the screen. You can also check the Inherit box to specify that the asset listing should include all child types of the selected asset type.

Select the asset’s status to be included in the asset listing. For example, if you want to show all Under Construction and Live assets, select both statuses. To select multiple statuses, hold down the Ctrl key on the keyword and click on the status in the list. If no statuses are selected, the asset listing will work out which assets to show based on the user’s permissions viewing the page. For example, a public user will only see the live assets that have Public read permission granted.

Select what permission the user must have on the asset to be included in the list. For example, if you select Write, it will only show the assets for which the user has write permission. Include effective permissions allows you to select whether the user only sees the assets if they have that specific permission. For example, selecting Write and Include effective permissions will show the assets on which the user has write and admin permission. If you clear this option, it will only show the assets on which the user has write permission.

Select which assets from the asset tree to exclude in the asset listing. For example, if you do not want to show the home page in the list, select it from the asset tree in this field.

Select which root nodes to be excluded from the asset listing. For example, if you do not want to show the files in the documents folder in the list, select it from the asset tree in this field.

Select whether to list the asset that is currently being viewed. For example, if the asset listing page is nested in the site design, it will not list an asset if a user is currently viewing it.

Select which section of the system to show in on the asset listing page. For example, if you want to list all of the PDF files under your site, select your site asset in this field.

Select whether the asset must be a child of all root nodes or at least one root node. For example, if you have two or more root node folders selected, you must select whether the asset must be a child of both folders or at least one folder.

Select Yes to only show direct child assets of the root node. These are the assets that are directly linked to the root node.

Select the Up the tree option to list assets above the root node. Select the Down the tree option to list assets below the root node.

Enter the minimum level from which to list assets.

Enter the maximum level from which to list assets.

Select the type of link the assets must be included on the asset listing page. The default value for this field is Menu and Hidden. This setting only applies if the Direct links only field is on. To select multiple link types from the list, hold down the Ctrl key on the keyboard and click on the link type.

Enter a value by which to filter the listed assets. This value will be checked against what you enter on the linking screen of an asset-based on the selected Link value filtering logic. For this to work, the field Enable link value filtering needs to be set to Yes.

Select if the listed assets should have link values equal or different to the link value. The values available in this field are Match and Does not Match. For example, choose an image orientation on the Linking screen of each image. You can create an asset listing that will only show images in that orientation using that choice as the link value and setting the Link value filtering logic to Match. If the Link value filtering logic were set to Does not match, the asset listing would only show images not in the chosen orientation. By default, this field is set to Match.

Select whether to enable filtering by the link value. If this is set to Yes, only assets with the link value that meets the Link Value and Link Value Filtering Logic criteria will be returned.

This option allows you to change the format of the list. The options that are available in this list are as follows:

Enter the number of assets to show on a page. You can use this field to restrict the number of assets seen on the page or break up the assets into several pages. To do this, add the keyword replacements Previous page link and Next page link to the page contents bodycopy so a user can navigate to the next page of the asset on the frontend. Keyword replacements can also be used within this field to set the number of assets per page dynamically.

This field allows you to specify an asset position to start the listing. By default, this field is set to 0, meaning it is disabled, and the listing will list the assets as usual. Setting this field to 5, for example, will start the listing from the fifth asset and list the remaining assets from that position, as shown:

This preference allows you to determine whether to list assets on a single page or multiple pages using the A-Z list format. By default, this preference will be set to Multiple pages. This default means that users will navigate through pages of assets, with each page representing a different letter. A single page A-Z listing will list all these assets on the one page, categorized under letter headings. Clicking a letter on the page list at the top of the screen will automatically take you to the page’s corresponding section. For more information on the A-Z list format, refer to the A-Z Listing chapter in this manual.

This field allows you to format the letter headings on an A-Z listing using multiple pages. This format uses the keyword replacement %letter_group% to display the letters in the headings. For more information on the A-Z list format, refer to the A-Z Listing chapter in this manual.

Enter the text used for the hyperlink to the previous results page. This text will be shown when you add the keyword replacement Previous page link to the page contents bodycopy. By default, this is set to Previous.

Enter the text used for the hyperlink to the next results page. This text will be shown when you add the keyword replacement Next page link to the page contents bodycopy. By default, this is to Next.

By default, this field will only appear on the Details screen when the list format has been set to A-Z listing. It allows you to change the wording for the hyperlink [Other]. This hyperlink will display the assets that start with numbers or special characters. For more information on the A-Z listing, refer to the A-Z Listing chapter in this manual.

This field defines the individual layout of items on the listing’s linked page list when you list results over multiple pages. If you are using the A-Z list format, this will define the individual layout of items on the linked character list.

This format defines the layout of the current page number on the listing’s linked page list when listing results over multiple pages. For example, you can use the A-Z listing format to define an item’s layout in the linked character list when no results are found under that particular letter.

This option allows you to hide any unlinked navigation text on the search results when you list results over multiple pages. That means the previous page link will not appear on the first page of the results, and the next page link will not appear on the last page of the results.

Select the parameter to replace in this field. The options available include Replacement root node for the listing or Array of specific asset IDs or selection group.

This will allow you to supply one or more asset IDs as the root nodes for the asset listing.

This will allow you to supply one or more asset IDs as the specific assets to list.

Select where the asset listing should source the alternate root node. You can select one of the following options:

This allows you to set the asset listing root node according to the asset the user is viewing. For example, say you have an article folder on your site. There are several topic pages with articles for that topic stored beneath it in the hierarchy under that folder. When a user views a topic page, you want to display the articles for that page in the design sidebar. In this case, you would nest an asset listing in your design and set the root node for the asset listing in the dynamic parameters section to be the current asset. The asset listing will then list the articles for the topic the user is currently viewing.

This allows you to set the asset listing root node to the user who is currently viewing the page. This function can be a signed-in user.

This allows you to set the asset listing root node to the site the user is currently viewing.

This allows you to enter a static value. You can set multiple root nodes using this source type by entering a comma-separated list of asset IDs, e.g., 2000,2001,2005.

This allows you to enter a value for any of the major "super global" arrays. The SESSION, POST, and GET variables will be checked in succession until a value is found.

Reverts back to the asset listing Page’s static root node settings. This setting will either be an asset(s) configured in the Root Nodes field or the asset listing page itself.

Returns no results on the asset listing Page. This option is the default value for this field.

Reverts back to the asset listing Page’s static root node settings. This setting will either be an asset(s) configured in the Root Nodes field or the asset listing page itself.

Returns no results on the asset listing page.

Enter the name for the structured root selector. The name you enter into this field must be the same as the name you use for the GET variable name parameter in the Dynamic Parameters section.

Select the parent asset for the list of assets.

Enter the number of levels of assets to include in the list. For example, if you only want to show the assets under the root node, enter 1 into this field. If you enter 0, it will show all the specified asset types under the root node.

Select the asset types to show in the list. For example, if you only want to show the folders under the root node in the list, select Folder.

Choose the style of the list to show on the asset listing page. You can choose from a drop-down list, radio buttons, or checkboxes.

Enter the width of the list. If you leave this as 0, the list will automatically resize to the longest name.

Enter the height of the list.

Enter the separator character to use in the list to show the asset’s hierarchy. By default, this is set to -.