Knowledge Base

Publish to One File

Last Modified:
25 Feb 2019
User Level:
Power User


With the Publish to One File Navigation Object you can publish the content from an entire Branch on a single page. This can be used to create a content listing, for example, all Event content from a Branch could be used to create an Event listing.

The Navigation Object can be added to Content Types and Content Layouts.

How to Create a Publish to One File object

To create this object, go to Assets > Navigation, click Create New Navigation and select Publish to One File. You can use this 

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

Content Type name Choose your Content Type from the drop-down list. If a specific Content Type is selected, only that content is used. If you select All content types, all content will be included.
Start Section

The Start Section you select will only publish Content Items from the Child Sections below it. Content Items from the Start Section will not be published with this Navigation Object.  

  • Use current Section: Collect all Content Items below the current Section
  • Use a specific Section: Collect all Content Items below the selected Section
  • Take Section from Content Type element: The location of the Content Items that will be used is determined by the value of a Section or content link element within the Content Type that the Navigation Object is used. Collect all content below the selected Section.
Specify Section If Use a specific Section is selected, select the Section to use.
Start Section element If Take Section from Content Type element is selected, specify the name of the Section/content link element that will determine the location of the content.
Show hidden Sections?

Checkbox to include hidden Sections in the Navigation Object.

Publish to One File will not include any content within Sections listed in the Ignore Section names on publish per Channel configuration option.

Number of levels to recurse Specify the number of levels to recurse. If set to 0, all content under the selected Section will be displayed. When set to 2 it displays one Section below the current Section.
Before HTML HTML output before the Navigation Object.
After HTML HTML output after the Navigation Object.
Display the Section name as part of the output When checked, the name of each Section will be displayed.
Show Section name when hidden Checkbox to show the name of each Section even if the Section is hidden from navigation. Left unchecked, Section names of Sections that are hidden from navigation are not displayed.
Before Section HTML HTML output before the name of the Section.
After Section HTML HTML output after the name of the Section.
Surrounding Page Layout The selected Page Layout will output the header before the first Section at each level and the footer after the last Section at each level. If no Page Layout is required, then select No Page Layout. This may be useful if you need to create nested divs for the content structure or for an XML output.
Content Layouts Use Channel default (specified on the Channel settings) or select alternate Content Layout.
Alternate Content Layout If the Channel default is not used, enter the name of the alternate Content Layout.
Enable caching of output 

If you choose this option, TERMINALFOUR keeps a cache of each Content Item used by the object in separate .ser files. With the next publish, if the content has not changed, the system uses the cached version of that content item. If the content has changed, the system uses the new version of that content item. Selecting this option results in significant performance improvements when publishing.

If your selection uses a fulltext (and the fulltext content is NOT published elsewhere on the site, and cleanup is enabled on your Channel) TERMINALFOUR does not re-publish the fulltext content - this results in it being deleted on cleanup.

Pagination output across pages Checkbox to paginate the content that is displayed from this Navigation Object. This automatically creates pagination links to navigate between the pages of content.
Display Specify the number of Content Items you want to display on each page if you use pagination.
Before pagination HTML Enter the code to be output before the pagination links.
Between pagination HTML Enter the code to be output between each pagination link.
After pagination HTML Enter the code to be output after the pagination links.

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 Content Layout or a Content Item.

This object does not work in a Page Layout.

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.