Knowledge Base

Top Content

Last Modified:
10 Jul 2020
User Level:
Power User

Description

The Top Content Navigation Object can be used to output content items from a specific location in your site. The object can search a full Channel, Branch or particular Section and return content from one or several specified Content Types (defined in the properties).

How to create a Top Content object

To create this object, go to Assets > Navigation and click Create New Navigation and select Top Content.

After completing the standard options used for all types of Navigation Objects, fill in each of the following, where relevant:

ItemDescription
Title A Title will be output preceding the output content. This can be left blank.
Fetch method
  • Use Section: content fetched from a specific Section but not the Subsections
  • Use Branch: content fetched from a specific Section and Subsections
  • Use Current: content fetched from the current Section
  • Use Current Branch: content fetched from the current Section and Subsections
Select section If "Use Section" or "Use Branch" has been selected, select the section via Browse or Search
Content type name Select one or multiple Content Types from the list. Only content using these Content Types are fetched.
Channel Content should be restricted to a specific Channel or Microsite.
Content dates
  • Use Current Content: display content where the date is in the past, up until the current date/time, with the most recent item shown first
  • Use Upcoming or Future Content: display content where the date is in the future, with the next upcoming item shown first
Date element

Enter the name of the date element in your Content Type(s). This must be an exact match. If you fetch content from multiple Content Types, the name of the date element must be the same in all those Content Types.

Enter "Last Modified" to show recently modified content based on the last modified date of the Content Items.

If this is left blank, the Publish date (on the Options tab when adding/editing content) is used.

To optimize publish performance, it may be advisable to add this Element to the System Cache.

Ignore date ordering Checkbox to order the content based on the order in the Section (only relevant if the Fetch method is Use Section or Use Current). Unchecked, the date element is used instead. 
Display Specify the number of Content Items to display.
Which piece of content to start at?

Specify the Content Item to start at. A value of 0 would begin at the first Content Item.

This is useful when the first Content Item requires a different layout to the second/third/fourth Content Item. For example, the latest news item could have a larger and more prominent layout than the second, third and fourth. In that case, 2 separate objects can be created:

  1. Outputting 1 item, starting at item 1
  2. Outputting 3 items, starting at item 2
Content layouts Use Channel default (specified in the channel settings) or select alternate Content Layout. If you choose an alternate enter the name in the field below.
Alternate content layout If the Channel default is not used, enter the name of the alternate Content Layout to be used.
Before HTML The HTML that will be output before the Navigation Object.
After HTML The HTML that will be output after the Navigation Object.

Review your entries and selections, if you are satisfied with your entries, click Next to generate the object.

Once generated, highlight the T4 Tag Embed Code, copy to your clipboard (Ctrl+C) and paste into a Page Layout or Content Layout or within a Content Item.

Mirrored Content

In Top Content and Keyword Search Content Navigation Objects, where a Content Item is mirrored into multiple Sections, the Navigation Object will recurse the Branch and only return the first instance of that Content Item. Re-ordering Sections can, therefore, affect the instance of the Content Item that is returned by the Navigation Object.

For Publish to One File Navigation Objects, where a Content Item is mirrored into multiple Sections, the Navigation Object returns all instances of a Content Item.