Web content management
- At a basic level, Terminalfour is used for building and maintaining large amounts of digital content.
- Users at various levels can be given permission to add and modify content. All content goes through an approval cycle, at which point dedicated "approvers" review the content. In some cases, this may be the authors who wrote the content; in other cases, a more complex workflow may be used to allow several people to review the content.
- Once content has been approved, it is ready to "go live". This happens in the publishing process. Page layouts (header/footer) and content layouts are wrapped around the content to ensure the content is displayed correctly.
- One piece of content may be published to various channels. These are simply output mechanisms, like websites, mobile sites, paper publishing, etc. By applying the page layouts and content types, different displays can be achieved whilst still just producing one piece of content.
- At the publishing stage, external data can also be incorporated. This could be information from a database, website or similar.
User roles
- There are 5 user roles in Terminalfour, meet the team below:
Visitor Vinny
Hi, I’m a student at the University and a member of the library.
There’s a password-controlled area of the library’s website which I access using my student authentication details. I can keep track of my library account from there.
Contributor Carla
I work at the University library.
I don’t update content very often, but when I do I like to use Direct-Edit as it’s easy to update the content. I have a moderator check my work before it gets published.
Moderator Mike
I also work at the library.
Content that Carla and other Contributors create comes to me and I decide what gets published.
I have permission to add new pages to the website when needed.
Power User Pete
I oversee the library website.
I can add content, but my main duties are to look after the look and feel of the library site, I can change the page layouts and create/edit content types for the Contributors and Moderators to use.
Administrator Ann
I oversee all the Websites here at the University.
My duties are like Power User Pete’s, but I get to oversee all the websites and have access to all areas within Terminalfour.
User rights
- The default rights of each user type are detailed below.
- Some rights and roles are customizable by going to:
Administration > User Rights & Roles > Role Customization
Action | Contributor | Moderator | Power User | Administrator |
---|---|---|---|---|
Add/Modify/Delete Content | ✓ | ✓ | ✓ | ✓ |
Manage Site Structure | ✓ | ✓ | ✓ | |
Approve/Reject Content | ✓ | ✓ | ✓ | |
Modify User Profile | ✓ | ✓ | ✓ | ✓ |
Purge Content | ✓ | ✓ | ||
Manage Users | ✓ | ✓ | ||
Manage Groups | ✓ | ✓ | ||
Assign Rights to Contributors | ✓ | ✓ | ✓ | |
Assign Rights to Moderators | ✓ | ✓ | ||
Assign Rights to Groups | ✓ | ✓ | ||
Manage Channels | ✓ | ✓ | ||
Manage Page Layouts | ✓ | ✓ | ||
Manage Content Types | ✓ | ✓ | ||
Manage Navigation Objects | ✓ | ✓ | ||
Manage Languages | ✓ | ✓ | ||
Manage Workflows | ✓ | ✓ | ||
View Audit/Error Reports | ✓ | |||
Configure Terminalfour | ✓ | |||
Publish Content | ✓ | ✓ | ✓ |
Create a User
- To complete the training, you need a power user or administrator user account. For the training, you may be asked to use an account specifically set up for you.
- The steps below will instruct you how to create a new user in Terminalfour.
- Users can also be managed externally via LDAP, SAML, CAS or Remote user. Information on how to do that is available at docs.terminalfour.com
How to create a User
- Go to Administration > User Rights & Roles > User Management > Add new user
- Fill in the relevant information:
- First name: enter the user’s first name.
- Last name: enter the user’s surname.
- Username: enter a username.
- Password: enter a password of minimum six characters.
- Confirm password: confirm the password by entering it again here.
- Email address: enter the user’s email address. This is used for alerts and notifications.
- User type: select the relevant level of user access (as instructed by the trainer).
- Terminalfour user interface language: select the language you wish to use for the interface.
- Default language: select the language you wish to use for the site structure. The languages available will depend on your specific installation.
- HTML editor: select the editor you wish to use for HTML elements. Depending on your set-up, several may be available.
- Preview channel: select a channel the user works within, if possible. If you leave this as "no default", the user needs to select the relevant channel when previewing content.
- Click Save changes to save the details. The new user has now been created and can log in.
Community access
- Select End User access or Administrator access if you want the user to have access to the Terminalfour Community.
- End User access gives restricted access.
Authentication methods
- Configure authentication methods available for this user.
- This is where you indicate what authentication methods are necessary for the user.
- The three columns are for the Name, Status and Identifier. Select status to correspond with the user's requirements. Using the user's username - enter the username as the identifier.
Download Training Material
- Training material for this course can be downloaded from the Terminalfour Knowledge Base.
- The Terminalfour Knowledge Base is your source of all information about Terminalfour.
- Being part of the Terminalfour Community gives you access to training materials and documentation about the product.
How to download training materials
- Your trainer will show you where to download the materials required for this course, or use this url:
https://docs.terminalfour.com/training/materials/terminalfour-83/implementers/ - Download the Training Files.
Create a Group and add Users
- Groups are used to group users as well as assets. By grouping users, you can assign a group to the site structure, rather than having to assign each individual user.
- By grouping assets, you can restrict who can update and use the assets.
- Create a group to use in this training. Users are added to this group, allowing you to organize users and assets.
How to create a Group and add Users
- Expand Administration > User Rights and Roles > Group Management > Create new group
- Fill in the relevant information:
- Name: enter a name for your group.
- Description: enter a description for your group to indicate what it is used for.
- Email address: enter an email address for the group if desired. This can be practical if all members of a group have a shared inbox.
- Default preview channel: select a channel the group works within, if possible. If you leave this as "No default", the members of the group need to select the relevant channel when previewing content, unless they have a default set in their user profiles.
- Group inheritance: sets the group as the main/parent group of the groups selected. This feature is currently limited to the group select content element and access control only.
- A group must contain at least one user. Add your user to the group.
- Locate the list of available users and click +add beside the users you wish to add as members of this group.
- Click Save changes to save the group details. Members can be added and removed at any point.
Site Structure
- The first part of building a website is identifying at least the high-level architecture. In Terminalfour this involves building a site structure consisting of sections.
- There are many types of Section, and each type has an icon so you can identify it.
- Once the different options have been explained by the trainer, build a small site structure you can use as a foundation for your new website.
How to create sections
- On the Site Structure screen, locate the section under which you wish to add your first section. Click Actions > Create section.
- Enter the relevant information to create a section. As a minimum, the Name must be filled in. All other default options are explained on the next page.
- Click Save changes to save the section.
- Repeat the steps above to add additional sections. Section information can be modified at any stage.
General Section Details
When creating sections, the only required element is Name. Additional elements are described below:
Name: This is the name of your section and is typically used in the menu navigation and forms the basis of the URL for the published page (if an Output URI is not specified).
Status: There are three status levels:
Approved: Sections are published when they have at least one approved Content Item.
Pending: Pending Sections will not publish, even if the content within the Section is Approved.
Inactive: Deleted Sections have an Inactive status. Sections can be restored by changing the
status to Approved.
Mark as link section: Link Sections contain no content and instead link to another Section in the Site Structure or an external URL.
eForm section: This option is used if you want to submit an eForm. Refer to the documentation for eForms for further details.
Advanced Settings
It should be noted that depending on your Section metadata content type, more fields may be available at the top of the Advanced settings. These fields are installation specific and hence not covered here.
Custom Page Title: This is an example of an installation specific element, added using the Section meta content type. This element is not used in this T201 training.
Content owner: Select the Content Owner from the list. If left blank, it will inherit from the parent section. The content owner can be used in workflows or get notified when content expires.
Output URI: Lets you specify the Uniform Resource Identifier (URI) as the destination of the new Section. Using this field improves the Search Engine Optimization (SEO) for this Section. Otherwise, with the field left blank, the Section's name is used when publishing.
Output file name: Specify the file name used for the page. When you leave this blank, the system uses the default file name configured in the Channel Settings.
Want to hide this option from your users?
Go to Administration > Hierarchy & Content Settings > Hierarchy > Enable output to filename
Default workflow: The default Workflow for this Section's content.
Access key: You can enter a single character which is used as a shortcut within a Link Menu Navigation Object.
Edit Rights
- Administrator users by default have edit rights to the entire site structure. All other user types need to be given edit rights.
- Give your users/groups the right to edit your site structure.
How to assign edit rights
- To give a user or group edit rights, go to the Site Structure, and click on the relevant section.
- Expand the More tab and click Edit rights.
- Use the Filter to find the relevant users or groups.
- Click +Add beside the users/groups you want to give access to the Section.
- Click Save changes.
Page Layouts
- Page Layouts provide a consistent structure and style to the pages on your website.
- A Page Layout in Terminalfour consists of at least a header and footer and it typically also includes one or multiple media references and navigation objects.
- To get started, build a basic “blank” Page Layout consisting of only a basic header and footer.
How to create a blank Page Layout
- Go to Assets > Page Layouts > Add new layout
- There are 3 tabs to complete on the General information tab, you can fill in the following information:
- Name: enter a name for your page layout.
- Description: enter a description for your page layout.
- File extension: if you are not going to use the default, select the relevant extension here.
- Syntax type: if you wish to use syntax highlighting, select it here.
- Layout processor: you can select the processor you wish to use. Select the default option T4 Tag Page, as using an alternative layout processor is not covered in these exercises.
- Primary group: Select your group from the list. You can share your page layout with other groups by clicking Toggle shared groups and selecting the groups to share with; shared groups can be granted either read only or full access to your page layout.
Header and Footer of a Page Layout
- When building your Page Layout, you will need to consider what will appear in the header and footer of every page that uses the Page Layout.
- Typically, the Header tab will feature HTML elements up to and including the opening body tag, while the Footer tab will feature HTML from the closing body tag.
- Use the code from the header and footer below to build your initial blank Page Layout.
<!DOCTYPE html>
<html lang="en">
<head>
<title>Page Title</title>
</head>
<body>
</body>
</html>
- Copy the HTML from the header and footer above and paste it into the Header code and Footer code tabs in your Page Layout.
- Click Save changes to save the Page Layout.
Channels
- A channel creates a way for content to be assembled and directed to the website or alternative output. The space for the site itself must exist on a target web server accessible to Terminalfour to publish content to it.
How to create a Channel
- To create a channel, go to Administration > Set up Sites & Channels > Channels > Add new channel
- General information
- Name: give your channel a name, e.g.,"My University Website".
- Description: enter a description to accurately describe what the channel is used for.
- Type: assign a "type" to your channel, e.g.,text/html. This is used when publishing a site, so only items with the right type is published. It allows you to have several types in use for the same content to, for instance, display content in one way on the website and a different way on the mobile site.
- Root Section: click Select section to open the site structure. Select the root section for your site. This will be your "homepage" and is always considered as level 1 in the site structure.
- Languages: select the languages you wish to publish to by checking the relevant boxes. Only languages set up in your installation will appear on the list.
- Output information
- Output directory: specify the output directory to indicate the operating system’s folder to which the channel will be published. The folder structure needs to match the Site Structure.
- Default filename: specify the default filename, e.g., index.html.
- Base HREF: this holds the published URL for the channel, e.g., http://www.oursite.com or http://www.someisp.com/ourwebsite, etc. It is used to correctly preview content in Terminalfour.
- Site root: the Site Root refers to the part of the URL after the domain name. If the published channel is http://www.oursite.com/, the Site Root would be "/". If the published channel is http://www.someisp.com/ourwebsite/, the Site Root would be "/ourwebsite/
- Channel publish URL:
- Path conversion: specify if upper or lower case should be used – this is especially useful if the host server is case sensitive, e.g., UNIX/Linux servers.
- Convert spaces in:
- Output URI
- Section name
- Retained filenames
- Favicon: if desired, you can select a favorite icon from the Media Library.
- Page Layouts and Content
- Page layouts: select the default page layout you wish to use for this channel.
- Inheritable page layout: select the page layout your sub-sections should "inherit". If not set, subsections will automatically inherit the main page layout you have selected.
- Publish empty sections: check this box to allow sections to publish even if they contain no content.
- Full text Defaults
- Type: this field specifies the "type" for the Layout of the second page of a full text Content Type. It is typically set to text/fulltext but can be set to anything you want.
- File extensions: this field contains the default file extension for the secondary full text Content Type, e.g.,"html".
- Fulltext publish period: if you do not wish to always publish full text content, you can specify how frequently this will publish. You can either use the global settings or specify this directly for the channel.
- Available file extensions
- Enable file extension overriding: if you have previously defined additional extensions, this allows you to publish your channel using alternative extensions such as PHP, RSS, JSP etc.
- Permitted file extensions: select the relevant extensions.
- Publish options
- Enable channel cleanup: this will clean up the publish directory after publishing by deleting any files which were not re-published. You can add exclusion rules.
- Publish reporting level: to access reports on how long publish takes, reporting needs to be enabled. The full report will include content and section information.
- Media publish options: if cleanup is globally enabled, specify if you wish to publish media which is not used. This can be done on a channel or category level.
- Access control and personalization
- Enable access control: adds a requirement to authenticate the published page when displayed to a user. This authentication may be via a login screen using any configured authentication service (e.g., NTLM, LDAP, Shibboleth, Site Manager Local User Login, IP address, .htaccess file etc.). Access Control may be inherited from a higher location in the Site Structure. Access Control can be combined with the use of personalization to determine who can see what content on the site.
- Configuration: allows you to specify what code will be added before and after the section.
- Enable personalization: allows you to enable section or page based personalization for certain sections; i.e. the user will be presented with the section and associated navigation links based on the sections he/she has been given access to. This may require authentication before the page is displayed to the user (see Access Control). Personalization can be configured to display specific sections and links based on the configuration (for example, if group-based personalization is used, users who are members of a "Student" group may see different content to users in a "Staff" group).
- Configuration: allows you to specify what code will be added before and after the link.
- Poll
- Default poll Icon: the poll functionality is no longer in use.
- Pending version output: The pending version of a channel will publish all content that is Pending (awaiting approval) to allow non Terminalfour users to see the content. This does not include pending sections. If this is configured, an extra option appears when publishing the channel, or scheduling the publish.
- Output directory: specify the output directory to indicate the operating system’s folder, to which the channel will be published, this will include Pending content. The folder structure needs to match the Site Structure.
- Base HREF: the Base HREF holds the published URL for the channel, e.g., http://www.oursite.com or http://www.someisp.com/ourwebsite, etc. It is used to correctly preview content in Terminalfour.
- Site root: the Site Root refers to the part of the URL after the domain name. If the published channel is http://www.oursite.com/, the Site Root would be "/". If the published channel is http://www.someisp.com/ourwebsite/, the Site Root would be "/ourwebsite/.
- General information
- Click Save changes to save the new channel. A channel can be updated at any point.
Content Types
- A Content Type is the structure of a Content Item and is made up of one or more Content Elements. You can think of Content Types as structured templates for the Content Items that you will create, edit and publish.
- Content types are used for adding different types of content (e.g., news, general content, events, etc.) to editable areas on your website.
- Content types contain elements and one or multiple layouts; elements are fields which an end user fills in when adding content and the layout determines how the content is displayed on the site.
- To determine the elements for a content type, you need to analyze the desired output and decide how to cut it up. In this example, you are going to build a generic content type containing a heading and main body.
How to create a simple Content Type
- Go to Assets > Content Types > Create content type
- Fill in the General content type information:
- Name: enter a name here. This should suggest what type of content it is used for.
- Description: describe in more detail when to use this Content Type.
- Minimum user level: if you wish to restrict who can use this content type, you can set a level here. If content types are created in groups, a user must be a member of the group as well as meet the minimum user level criteria to use the Content Type.
- Enable direct edit: decide if direct edit can be used for this content type.
- Mark as eForm: If checked, this allows your Content Type to collect eForm data.
- Workflow: if relevant, enable a workflow for content created using this content type.
- Primary group: Select your group. This allows you to select the group which is permitted to use this content type. Click Toggle shared groups to share the content type with more than one group.
- Select the Elements tab.
- Each content type has a Name element by default. This is used to name the content and is typically not displayed on the published site.
- Add the other elements you need by filling in the information as outlined in the table below. Click Add element to begin filling in the details for each element.
- Once you have added all your elements, click Save changes. The Content Layout tab opens.
Name | Description | Type | Max Size | Required | Show |
---|---|---|---|---|---|
Heading | Enter the main heading | Plain Text | 150 | No | Yes |
Main body | Enter the main body of the content | HTML | 1000000 | Yes | Yes |
- The Content Layout tab is a new Content Layout for your Content Type. Click +Add content layout.
- Name: text/html - this is the default Type set in the Channel. This ensures the content can be displayed.
- File Extension: Default - unless this is used with a different File Extension. This requires other extensions being permitted in the Channel
- Syntax Type: HTML/XML – this determines which syntax is highlighted.
- Content layout processor: must be set to T4 Tag Content.
- Content Layout code: this determines the output for your content. If you have created the HTML already, you can start by pasting that into the code field as displayed below.
- As each piece of content will have unique information in the Header and Main body, the text below needs to be replaced with what the user enters when creating the content. To do that you need to build some T4 Tags.
<h2>Terminalfour Web Developer training</h2>
<p>This training covers every aspect of the front-end administrative interface of Terminalfour.</p>
- In this example, the text Terminalfour Web Developer training is the Heading and needs to be replaced with a T4 Tag. To build this, click Generate T4 tag.
- Generate T4 tag:
- Tag Output: select Element;
This outputs the information the user enters in the element. - Content element: select the element you created earlier for the Heading.
- Output method: select Normal output (inline); this outputs the element by adopting the text layout of the page.
- The relevant Modifiers are automatically selected by TERMINALFOUR, these are:
- Strip out all HTML Tags.
- Encode special characters to their HTML equivalent.
- Decide if you wish to Disable direct edit for this element.
- Tag Output: select Element;
- The T4 Tag is automatically generated; click Copy to clipboard to copy the generated t4 tag. It should look something like the T4 Tag below.
<t4 type="content" name="Heading" output="normal" modifiers="striptags, htmlentities" />
- The T4 Tag you have copied should look like this (depending on which modifiers you have selected):
<t4 type="content" name="Heading" output="normal" modifiers="striptags, htmlentities"/>
- Replace the original heading TERMINALFOUR Web Developer Training with the new tag. By leaving thetags around the new T4 Tag, the information entered by the end user will be wrapped in a H2.
- Click the Generate T4 tag button again.
- Using what you have learned above, build a tag to output the Main body:
- Normal output (inline).
- Parse for media library t4 tags.
- Parse for navigation t4 tags.
- Click Copy to clipboard to copy the code from the Preview field.
- Replace the original content for the Main Body with the new tag. You do not need to leave tags around the tag as the HTML editor will generate the necessary tags.
- The code should look like the screen below.
- Click Save changes to save the new Content Layout. The main part of the Content Type is complete.
A note about elements
> Once you have created and saved an element, the element cannot be modified. If changes need to be made, delete the element, and create another.
Output Methods
> Normal output (inline): outputs the element by adopting the text layout of the page.
> Output to File: allows the file to be downloaded.
> Output to fulltext: outputs the element on a separate page, which can have its own layout.
> Output to Image: outputs the image directly on the page. This requires the use of an Image Element.
> Selective output: can be used to ensure a Content Type Element with no value is hidden from the published site and should be used for non-required elements.
Output Modifiers
> Parse for media library t4 tags: should be checked for HTML elements to ensure media elements are displayed. If left unchecked, media elements will not be displayed. This would be relevant for a text only format.
> Parse for navigation t4 tags: should be checked for HTML and Section/Content Link elements to ensure section navigation is displayed.
> Strip out all HTML tags: should be checked for plain text elements to avoid code being added when content is entered.
> Encode special characters to their HTML equivalent: should be checked for plain text elements if you wish to convert any non-standard characters to HTML.
> Change new lines to HTML line breaks: should be checked if you wish to convert line breaks in plain text fields into actual HTML line breaks.
> Convert invalid RSS characters to their XML equivalent: creates character code for valid RSS. This should never be used in combination with "Strip out all HTML tags".
> Convert output to be suitable for use in JavaScript: should be ticked if the element is going to be used with JavaScript.
> Encode email addresses to ASCII format: should be ticked if the element is going to be used for an email address. An email address posted on any website can be easily extracted with special email collection programs and used later for sending spam. Converting an email to ASCII allows it to display on a web page as normal but would prevent spam activity.
Add HTML Anchor to Content Type
- If you wish to be able to create links to specific pieces of content, you need to ensure you have placed an HTML Anchor in your Content Layout.
- Add an HTML Anchor by building a T4 Tag of the type: Tag output Metadata.
How to create an anchor
- To modify the Content Type, go to Assets > Content Types
- Using the Filter tool, locate your content type and click your content type’s name to edit it.
- Select the Content layouts tab and click the name of the Content layout you wish to edit e.g., text/html. The Content layouts screen opens.
- Click the Generate T4 tag </> button:
- Tag output: select the option Metadata.
- Type of metadata: select HTML Anchor.
- Click Copy to clipboard to save the Generated T4 tag.
- Paste the tag into the top of the Content layout code. This will place an HTML Anchor at the top of each piece of content, allowing users to link to this content.
- Your Content Type Layout should now be like what is displayed below.
- Click Save changes to save your work.
Enable a Content Type
- Now that you’ve built your content type, you need to decide where it can be used and by whom.
- You need to enable your new Content type to your Site structure to test it.
- Content types can only be used in Sections where they are enabled.
- If a Content Type is created in a Group, only users who are members of that Group can use the Content Type.
- Only users who meet the Minimum User Level criteria can use the Content Type.
How to enable a Content Type
- On the Site Structure screen, click on the name of your main section.
- The General information about this section screen appears, select the Content types tab.
- Using the Filter feature, locate your content type.
- Select the radio button to enable your content type for either the branch or section:
- Enabled (branch): the Content type can be used in this section as well as all its sub-sections.
- Enabled (section): the Content type can be used in this section only.
- Click Save changes to confirm your selection. You can now use the new Content Type to add content to your section.
Create content
- The trainer will demonstrate the basic concepts of working with content. This will give you an idea of what your end users will see.
- After the demonstration, add a piece of content using your new Content Type. This will be the test to ensure everything works and will allow you to tweak it if needed.
How to create content
- On the site structure screen, expand the Actions menu of the section you wish to add content to and select +Create content.
- A list of available content types is displayed; select the content type you wish to use.
- Fill in all required elements (marked with *).
- Enter a Name for the content. This will typically not be displayed on the published page, but simply act as a name within the system. This element is always present, no matter which content type is used.
- Use the Heading to enter the main heading for your content. This will automatically be wrapped in an H2 tag if you created your content type correctly.
- Use the Main body to add the rest of the content. This can, for instance, be copied from a word document (you can use the file Training Overview Document as an example), or you can simply type in the text.
- When you have created your content, Preview (top of the page) to ensure you are happy with the result.
- Use the Save changes drop-down menu to either Save changes, Save & approve, Save as Draft, or to publish your new content now, click on the green Publish button at the top of the page.
Links
- When working with links, a distinction is made between External and Internal links.
- An external link is used to create a link to an external website, such as https://www.terminalfour.com.
- Internal links are used to link to a Section or a specific piece of content in a Section. If you wish to use content links, you need to ensure you have HTML Anchors in your Content Type Layout Code.
- Add different types of links into your content to test that your Content Type has an HTML Anchor and the right modifiers have been set for the HTML element to allow parsing of Section Navigation.
How to edit content
- You can continue to work with the content you added previously (or add new content if preferred).
- From the Site Structure screen, click the Actions button belonging to the section which contains your content and select Edit content.
- Click on the content you wish to edit.
How to insert External links
- To insert an External Link in the Main Body of the content, click to where in your main body of content you wish to add the link.
- Click the link icon in the toolbar/WYSIWYG.
- Url: enter the external site’s URL. (e.g., https://www.terminalfour.com).
- Text to display: type the text that you wish to display as your link text.
- Title: add a title for your link. This may be spoken by a Screen-reader, rendered as a tool tip, etc.
- Target: select the relevant option for opening your hyperlink:
- None: the link will open in the existing window.
- New window: the link will open a new window.
- Click Ok to add your link.
How to insert Section links
- To create a Section Link in the Main Body of the content, highlight the text you wish to use as the link text or simply place your mouse where you want the link inserted.
- Select Insert Section link from the WYSIWYG.
- The Site Structure will appear in a pop-up window. Click on the section you want to link to.
- Click Select Section to create the link.
How to insert Content links
- To create a Content Link in the Main Body of the content, highlight the text you wish to use as the link text or simply place your mouse where you want the link inserted.
- Select Insert Content link from the WYSIWYG.
- As with a Section link, the Site Structure will appear in a pop-up window. Click on the section which contains the content you wish to link to.
- Click View Content to display a list of all content contained in your selected section.
- Click on the relevant content and click Insert Content to create the link.
Section/Content Link Title
By default, the Title for a Section Link is the full section path, and for a Content Link it is the full path as well as the name of the content. This default option can be changed via the HTML Editor in:
Administration > Hierarchy & Content Settings > HTML Editor > Default title in editor
History and Versions
- Terminalfour allows you to see all changes made to content, compare different versions and set previous versions of the content live.
- To see how this works, modify a piece of content; then compare the two versions of the content.
- Set the original version of the content live again.
How to review History and Versions
- Modify a piece of content: Select Edit content from the Actions menu beside the section containing the content.
- Click the content’s name to open it or select Edit from the Actions menu.
- Make changes to the content and click Save changes.
- Click back into the content and go to the History tab or select History from the Actions menu beside the content.
- Select the two versions of content you wish to compare by checking the box for each version (located in the far right column).
- Click Compare selected to display both versions of content in a side-by-side comparison; elements where changes have occurred are highlighted in yellow.
- Click Back to return to the History tab.
- You can set any version as the current version by clicking the Actions button > Make current > Confirm.
Content Options
- When adding a new piece of content or modifying an existing piece, there are additional options available to control and manage the publishing of the piece of content.
- The content options can be used to manage when the content will publish, expire, be reviewed, and archived. All the fields are optional.
Content Options
Publish date: schedules a publish date, i.e. the date the content will go live on the site. The content has to be approved before it can be published.
Expiry date: content will expire and be removed from the site.
Review date: TERMINALFOUR will email the Content Owner on the selected date. If no owner is set, the person who last modified the content will be notified instead.
Archive section: allows you to specify a section for the content to go to once it has expired. If you are publishing lots of content, it may be a good idea to create an Archive Section to store expired content in. This way the content can be used and published again later. Click Select section and select a section; the section id is inserted as a reference.
Content owner: Sets an owner to the Content Item.
How to manage publish dates
- To modify a piece of content, select Edit content from the Actions menu beside the section containing the content.
- Click on the content’s name to open it.
- Click the Options tab.
- Fill in the relevant fields by clicking the box to open the calendar; simply click on the date you wish to use and adjust the time by clicking the clock icon and selecting the hours and minutes. If you do not set the time, it will default to the current time.
- Click Save changes to save your work.
Mirror and Duplicate
- Branches of the Site Structure as well as individual pieces of content can be Mirrored and Duplicated.
- If you Mirror a piece of content, there is only one ID, and any changes made to the content will affect all instances of it.
Mirror Content/Sections Configuration
You can enable/disable the mirroring of sections or content by changing the settings:
Administration > Hierarchy & content settings > Hierarchy > Enable mirroring of sections
Administration > Hierarchy & content settings > Hierarchy > Allow non-mirroring of content
How to Mirror/Duplicate
Mirror/Duplicate Content
- Select Edit content from the Actions menu beside the section containing the content you wish to mirror or duplicate.
- Select Mirror or Duplicate from the Actions menu beside the content.
- The Site Structure opens. Click on the Section you wish the mirrored/duplicated content to appear in. A small icon appears beside the mirrored content. Hover the mouse over it to see the various locations of the content. The duplicated content, however, will appear as new content.
Mirror/Duplicate Branch
- Select Mirror Branch or Duplicate Branch from the Section Drop-Down Menu beside the section containing the content you wish to duplicate.
- Select the Section you wish to place the mirrored or duplicated section under.
- A mirrored section’s folder symbol will have an arrow pointing out for the original section and an arrow pointing in for the new section.
Media Library Overview
- The media library is used to store files of all sorts to use in content and assets. You can upload images, documents, videos, etc., if you have a means to output these files.
- You can assign read and write access to different users/groups, so not all users necessarily need to have permission to upload files into the media library.
Media Library Overview
> The Media Library can be accessed either as a separate item (go to Content and select Media Library) or directly from an Asset or piece of Content.
> By default, only Administrators have write access, and all user types have read access.
> The Actions button allows you to edit, create, or delete categories.
> If you click on a category, the uploaded media will appear on the right.
> If you modify a Category, you can determine the Write Access, Read Access, Workflow, Media Categories (manual and automatic ordering), Auto Publish and Access Control.
> The Add Media button allows you to add new media items to the category you have selected.
> You can Search for an item by entering keywords or an ID # in the #Jump box.
> You can Filter by selecting a specific type of file from the list.
Media Types and Media Content Type
- The Media Content Type controls all content added to the Media Library. This is a System Content Type for storing uploaded Media Library items.
- Different types of files are output in different ways (using different Content Layouts).
- The Media Content Type is a System Type. You can add additional Content Layouts or edit the existing ones. You can add to the list of file types in system settings.
How to view Media Content Types
- To edit the Media Content Type Content Layouts, go to: Assets > Content types
- Use the filter to search for the Media content type; click the name of the Media content type to edit.
- Each type of media uses a Content layout as displayed above. These are linked to the different Media Content Type Layouts, and the same Content Type Layout can be used for several types of media. One type of media can also use several Content Layouts, but one must be set as the default.
- Content Layouts in the Media Content Type are created exactly like Content Layouts in a Content Type. Changing a Content Layout will impact the media items which use the Content Layout.
- The default Content Layout used for images has the Content Layout image/* and contains the code above.
- The element Media outputs a file, the Description is used as the alt tag. You can customize this to your specific requirements using media attribute options to allow users to specify alt text, title, border, margin, float, etc.
How to edit Media Content Types
- To edit the Media Types (or add new ones), go to:
Administration > Settings > Media library > Media Types tab (see screen shot above). - Each Type is linked to one or more Layouts in the Media Content Type. To create a new Type, click +Create new media type.
- Name: enter a name for the new Media Type. This will display in the drop-down menu in the Media Library.
- Permitted file extensions: list all permitted extensions (comma separated list). If a file extension is not listed for a Media Type, it will not be automatically recognized and the user will have to manually select the Media Type. This can be further restricted in the Media Handler.
- Maximum file size: if you do not wish to use the default maximum size, you can specify a smaller size here (bytes).
- Media type options – Binary file: check this option if the files are binary. This can also be used for non-binary files to prevent users from being able to edit the text directly in the Media Library.
Associated content layouts
-
- Content Layouts: select the Media content layout you wish to associate to this Media Type. Each Media Type must have a default Content Layout but can have additional Content Layouts added.
- Click Save changes to save the new Media Type.
Upload and use an Image
- Now that you understand how the Media Content Type is pieced together, you should have a better idea of how the Media Library content is used.
- Upload an image to the Media Library, create Image Variants and use the image in content.
How to upload Media
- From the site structure screen, locate the section you added content to earlier.
- Go to the Actions menu and select Edit content. Click on the content you want to edit.
- In the main body of your content, place the mouse where you want to insert an image; click the media icon.
- The media library opens. Locate the category you wish to add the image to and click on it.
- Click +Add media (the use of Name, Description and Keywords is dependent on your Media Content Layouts):
- Media file: Drop your image file here or click to select the image from your drive.
- Name: enter a name for your Image. By default, this is not output on the site, but is used only as a name in the
Media Library to allow easy identification. - Description/Alt text: by default, this is used as the alt tag and should always be filled to describe the image.
- Media type: select Image -this is automatically detected where possible.
- Syntax highlighting language: for non-binary files you can select what syntax highlighting to use (if any).
- Media Language Dependence:
- Fully independent: the media is the same in all languages and cannot be translated.
- Independent media file: the file and thumbnail exist independent of language. Other elements can be modified based on language, such as the image description/alt text.
- Fully dependent: all elements depend on language and can be translated.
- Click Save changes to add your image.
- The image is ready to be used. Hover over it and click Select.
Edit Media Attributes
- If your Media Type Layout for images contains "style" options, you can set the Media Attributes in the content to specify Margin, Float, etc.
How to set Media Attributes
- The image (or image variant) has been inserted in your content. If your Media Type Layout for images contains "style" options, you can set those from the content.
- Double-click on the image to Set Media Attributes.
- Specify the values you wish to set. In the example above, a margin of 10px has been set, and the image has been set to float left (wrapping the text around the image with the image floating to the left).
- Click OK to return to the content screen.
- Click Save changes to save the changes made to the content.
Upload and use a PDF
- You can upload a PDF to the Media Library, use it in content and set the Media Attributes.
How to upload a PDF
- To add a PDF link to your content, click where you want the link to be and click the Insert from Media icon.
- The Media Library opens. Locate the Category you wish to add the PDF to and click on it.
- Click +Add Media (the use of Name, Description and Keywords is dependent on your Media Content Type Layouts):
- Media file: click here and select the relevant PDF.
- Media type: this will be automatically detected where possible. Alternatively, select the Media Type you want to use.
- Name: enter a name for your PDF. By default, this is used as a name in the Media Library to allow easy identification and serves as the link text in your content.
- Description: give your PDF a description; by default, the description of PDF’s is for internal use and does not appear on your webpage
- Syntax highlighting language: for non-binary files you can select what syntax highlighting to use (if any).
- Media language dependence:
- Fully independent: the media is the same in all languages and can hence not be translated.
- Independent media file: the file and thumbnail exist independent of language. Other elements can be modified based on language.
- Fully dependent: all elements depend on language and can be translated.
- Click Save changes to add your PDF document to the Media Library.
- The PDF is ready to be used. Click it to add a link to your content.
- The PDF link has been inserted into your content.
- If you do not wish to use the item’s Name as the link text, double-click on the PDF link text to open the Media attributes.
- In the empty Name element, enter the new link text.
- Click Ok to return to the content screen.
- Click Save changes to save the changes you’ve made.
Modify Header and Footer
- It’s time to update the look and feel of your website.
- You currently have an empty page layout (a blank page). Modify the page layout you created earlier to consist of a new header (green) and a new footer (red).
- The trainer will explain where to download the HTML for the header and footer.
How to modify an existing Page Layout
- To modify a page layout, go to Assets > Page layouts
- The page layouts screen opens. Locate the page layout you created earlier and click its name to begin modifying.
- On the general Information tab, you can update the following information, if needed:
- Name: enter a new name for your page layout.
- Description: enter a description for your page layout.
- Content layout: this needs to match what you set up in the channel, e.g., text/html.
- File extension: if you are not going to use the default, select the relevant extension here.
- Syntax type: if you wish to use syntax highlighting, select it here, e.g., HTML/XML.
- Layout processor: you can select the processor you wish to use. Select the default option T4 Standard Page, as using an alternative layout processor is not covered in these exercises.
- Primary group: Select your group from the list. You can share your page layout with other groups by clicking show shared groups and selecting the groups to share with; shared groups can be granted either read only or full access to your page layout.
Header and Footer for Page Layout
- Use the information from the header and footer files (located in the web developer training folder) to update your page layout.
- Drag & drop the header and footer files (located in the web developer training folder) into the header code and footer code tabs in the page layout.
- Click Save changes to save the updates to your page layout.
Add CSS files to Header
- There are 2 CSS files in the element of your header. These are not currently referenced correctly and hence do not display when you preview your site.
- Upload the required files to the media library and build T4 tags to reference them in your element.
How to add CSS files
- In your Page Layout, select the </> Header code tab and click Generate T4 tag, the T4 tag builder opens.
- Select the Media tab and click Select media. This opens the Media Library.
- To upload the css files to your Category in the Media Library, click +Add media:
- Media file: drop files here or click to choose.
- Name: enter a name for your css file.
- Description/Alt text: this is used to define the CSS media type such as print, screen, tv etc., etc. In the sample site the CSS files you upload are intended for use by all devices so we will set the value to all.
- Media type: set to CSS Stylesheet File
- Syntax highlighting language: set to Stylesheet CSS to avail of syntax highlighting.
- Media language dependence:
- Fully Independent: the media is the same in all languages and can hence not be translated.
- Independent media file: the file and thumbnail exist independent of language. Other elements can be modified based on language.
- Fully dependent: all elements depend on language and can be translated.
- Click Save changes.
- The CSS file is ready to be used. Hover over it and click it.
- A T4 Tag appears in the Preview field. Click Copy to clipboard to copy this tag. It should look like this:
<t4 type="media" formatter="css/*" id="1370"/>
- Locate the CSS reference in the Header and replace it with your T4 Tag to create a reference to it.
- Repeat these steps until you have replaced both CSS references with T4 Tags.
- Your Header code should now look like the screenshot below.
Modifying the Footer
- There are several JavaScript files in the new footer code that you added to your page layout. These are not currently referenced correctly and hence do not display when you preview your site.
- Add the 3 JavaScript files to your Footer code. The trainer will point you to the required files
How to add JavaScript files
- In your Page Layout, select the </> Footer code tab and click Generate T4 tag </>, the T4 tag builder opens.
- Select the Media tab and click Select media, this opens the Media Library.
- The Media Library opens. Click +Add media to upload the JavaScript files to your Category in the Media Library:
- Media file: drop files here or click to choose.
- Media type: set to JavaScript (based on standard configuration).
- Name: enter a name for your JavaScript file.
- Description: describe the file, i.e., Sample site JS.
- Syntax highlighting language: set to JavaScript to avail of syntax highlighting.
- Media language dependence:
- Fully Independent: the media is the same in all languages and can hence not be translated.
- Independent media file: the file and thumbnail exist independent of language. Other elements can be modified based on language.
- Fully dependent: all elements depend on language and can be translated.
- Click Save changes.
- The JavaScript file is ready to be used. Hover over it and click it.
- A T4 Tag appears in the Preview field. Click Copy to clipboard to copy this tag. It should look like this:
<t4 type="media" formatter="javascript/*" id="1376"/>
- Locate the JavaScript reference in the Footer and replace it with your T4 Tag to create a reference to it.
- Repeat these steps until you have replaced all 3 JavaScript references with T4 Tags.
- Your Footer code should now look like the screenshot below.
Assign a Page Layout
- You need to assign your new page layout to your site structure to test it. This will allow you to preview your sections and content with the new page layout wrapped around it.
- You can keep your preview window open and refresh it whenever you make changes. This saves you having to open a preview window all the time.
How to assign the page layout
- On the Site Structure screen, click the name of your main section.
- Select the Page Layouts tab.
- Select your Page Layout from the drop-down menu.
- Click Save changes to save the work. Your Page Layout has now been assigned to your section/branch.
Multiple Page Layouts
> You can create as many page layouts as required for your website design.
> But the more Page Layouts you have, the more you’ll need to maintain.
> Page layouts can be assigned to individual sections or entire branches of your site structure.
> Based on your website design, how many page layouts will you need?
Images in CSS
- There is an image in the CSS file which is not currently referenced correctly and hence does not display when you preview your site.
- Upload the image to the media library and build a T4 Tag to reference it in the CSS file.
- To avoid opening and closing screens all the time, consider having one screen open for the page layout and one for the CSS file in the Media Library.
How to add a header logo
- Go to Assets > Page Layouts
- Use the filter tool to search for your page layout and click the name to edit.
- Select the header tab.
- Click the Generate T4 tag </>.
- Select the Media tab and click Select media. This opens the Media Library.
- To upload a css image to your Category in the Media Library, click +Add media.
- Media file: drop files here or click to choose.
- Media type: set to Image Path (css) (based on standard configuration).
- Name: enter a name for your image.
- Description: give your file a description.
- Syntax highlighting language: Set this to None.
- Media language dependence:
- Fully Independent: the media is the same in all languages and can hence not be translated.
- Independent media file: the file and thumbnail exist independent of language. Other elements can be modified based on language.
- Fully dependent: all elements depend on language and can be translated.
- Click Save changes.
- The CSS Image is ready to be used. Hover over it and click it.
- A T4 Tag appears in the Preview field. Click Copy to clipboard to copy this tag. It should look like the tag shown above in the screen shot.
- Paste the T4 Tag of your CSS Image into your Style CSS:
- Click Generate T4 Tag.
- Click Select Media.
- Click the Category where your Style CSS file is.
- Click the Actions button belonging to your Style CSS file and select Edit.
- Select the Editor tab.
- Locate the image path for the CSS image and replace it with the T4 Tag you built to reference the image.
- Click Save changes to save the changes made to your Style CSS file.
- Refresh the preview of your site to see the changes.
Title Tag
- The T4 Title Tag outputs the name of the section being displayed in a web browser.
- Your Page Layout currently has "Name of page - T4 University" as the title. Make the page title dynamic by replacing the title with the T4 Title Tag.
- You can also update the Meta Tag with the T4 Title tag.
How to add a title tag
- Go to Assets > Page Layouts
- Click your Page layout name to edit it. (Use the Filter tool to search). Open the </> Header code tab.
- We will replace the actual title or part of it with a T4 title tag. Click on Generate T4 tag
- Click on the </> Misc tab
- Select "Title" from the drop-down options from “Available page layout tags”.
- Copy the tag to your clipboard, and copy the tag into the Header code at
<title>Name of Page - T4 University</title>
- Click Save changes to save the changes to your Page Layout.
- Update your preview to check the result.
Navigation Objects
- Navigation objects are primarily used to create navigation structures but also to create place holding objects to pull in content, etc.
- Navigation objects are created to change what they output depending on where on a site you are, so a breadcrumb navigation object will display one trail on the homepage and another trail on sub-pages.
- Navigation objects can be placed in page layouts, content types or content, depending on what function they will have.
How to access the navigation menu
In the example above, there is an image of a webpage as it is intended to look on completion of the build.
To determine what navigation objects you need to build this, consider each "function" on the page.
- To create a navigation object, go to Assets > Navigation > Add new navigation
An alphabetical list of each navigation object type is described. The exercises on the following pages will guide you through how to build the navigation objects highlighted above.
Link Menu Navigation Object
- With the Link Menu Navigation Object, you can add links to a specific Section and its Child Sections to your pages. Typically, the main and side navigation menus of a website are built with the Link Menu Navigation Objects.
- For your website, the top navigation and left navigation are both going to be built using link menu navigation objects.
- The example below requires you to create two navigation objects and use them in your page layout.
How to create your main/top link menu
- Go to Assets > Navigation > Add new navigation > Link menu
- The link menu contains the following options:
- Name: enter a name for the link menu.
- Description: enter a description for the Link Menu, i.e., what will be output.
- Primary group: Select the primary group you wish to add the navigation to, you can also share the navigation with other groups by clicking show shared groups and selecting the relevant groups from the list.
- View in preview: includes pending content when previewing a page.
- Menu type: determine where the links will be sourced from:
- Branch at level: links are to sections found at the specified level in your branch. The root section is always level 1.
- Children: links are to the child sections of the current or specific section.
- Siblings: links are to the sibling sections of the current or specific section.
- Siblings and children: links are to the sibling and child sections of the current or specific section.
- Display method: specify how to display the menu:
- Normal Menu: plain HTML links.
- Javascript drop-down: each link is an option in a select box. The visitor jumps to the link by clicking it.
- Level to branch for links: this is only used if the menu type is branch at level, as it specifies the level to find links at.
- Levels to recurse: enter the number of levels to create sub-menus for.
- Use "currentbranchN" class: allows you to use different css classes for different branches, so instead of using the regular "currentsection" span class, each link in the current branch gets its own span class of "currentbranchN" where N is that particular section's level in the channel hierarchy. This works best if the number of levels to recurse is set to 2 or greater.
- Make current section a link?: check this to display the current section as a link.
- Link options: Show children of non-current sections?: only relevant when creating a children menu. If checked, it will output the children of all sections.
- Title before menu: enter the title you wish to output before the menu or leave it blank if you do not wish to use a title.
- Add the section’s name in front of the title?: if checked, it will place the section's name in front of the title (assuming a title is used).
- Before menu HTML: the HTML to be output before the menu, i.e., <ul class="left large-8 columns">
- After menu HTML: the HTML to be output after the menu, i.e., </ul>
- Before link HTML: the HTML to be output before each link, i.e., <li>
- After link HTML: the HTML to be output after each link, i.e., </li>
- Between Links: the HTML to be output between the links.
- Click Next to save the navigation object.
Top Link Menu
<ul class="left large-8 columns">
<li></li>
</ul>
Left Link Menu
<ul class="side-nav">
<li></li>
</ul>
How to create a left/side Link Menu
- Using what you have learned, build another Link Menu Navigation object to be used to output your left menu. You can use the screenshot above as a reference when deciding on the properties to select.
Note: The left menu is referenced in the Footer of your Page Layout.
Apply Link Menu navigations to Page Layout
- The Link Menu navigation objects you just built now need to be applied to your page layout to replace the hardcoded menus.
- Build a T4 Tag to output the Top Menu and a T4 Tag to output the Left Menu.
How to apply Link Menu Navigations to the Page Layout
- Go to Assets > Page Layouts.
- Find your page layout and click the name to edit it.
- Select the Header tab.
- Click Generate T4 Tag.
- Use the Navigation T4 Tag Builder:
- Select Navigation Type: Link Menu.
- Choose a Navigation Object: select your Top Menu.
- Copy the Navigation T4 Tag.
- Paste the T4 Tag in to replace the HTML you entered in the Navigation Object.
- Click Save Changes.
- Preview your site to check the result. If you have a preview open already, simply refresh that one. Otherwise, you can preview the site from the Site Structure screen.
- Repeat the steps above to build a T4 Tag to output the Left Menu as well. The code for the Left Menu is in the Footer code.
Section Details - path to home
- To allow visitors to click on a link or logo to return to your Homepage, you need a Section Details Navigation.
- Build a T4 Tag to output a path to your Homepage.
- Upload a logo to the Media Library and build a T4 Tag to use instead of the link text.
How to add a path to home
- Go to Assets > Navigation > Add new navigation > Section Details
- Use the HTML from the header to determine how the Link to Home should be built. You need to replace the # with a path to the section/branch in the Site Structure, and the image path must be replaced with a media tag to allow you to select a logo in the Media Library.
- The Section Details contains the following options:
- Enabled: if the Navigation is used, it needs to be enabled or otherwise nothing will be output.
- Name: enter a name for the Link to Home.
- Primary group: select a primary group
- Description: enter a description for the Link to Home, i.e., what will be output.
- View in preview: lets you view non-approved content in preview.
- Detail method: Current section; Use section at level: if you selected Branch at Level, specify the level here. This will be ignored if you selected Specific Section. Use section: if you selected Specific Section, click Browse and select the section you wish to use. This will be ignored if you selected Branch at Level.
- Output detail: you can output the section's ID, Name or Path or alternatively output Link to Section.
- Click Next to save the Navigation Object.
Apply Section Details Navigation to Page Layout
- The Navigation Object you just built now needs to be applied to the Page Layout to replace the hardcoded path.
- Build a T4 Tag to output the Link to Home.
How to apply the path to home link to the page layout
- Go to Assets > Page Layouts.
- Click Edit beside your Page Layout. Go to the </>Header code tab.
- Click Generate T4 tag</>.
- Use the Navigation T4 Tag Builder:
- Restrict list by type: Section Details.
- Available navigation objects: select your Link to Home.
- Click Copy to clipboard to copy the T4 Tag.
- Paste the T4 Tag into your header to replace the original section path, i.e., the /home.html.
- Click Save changes.
- The path is now complete, but the image needs to be replaced with an actual image.
Add Logo to the home link
- Upload your logo into the Media Library and build a T4 Tag to output it as part of the Link to Home.
How to add a logo to the home link
- Go to Assets > Page Layouts.
- From the blue Actions bar, select Edit.
- From the Header code tab, click the Generate T4 tag button.
- From the Media tab, click the Select media button.
- The Media Library opens. Use what you have learned previously to upload the logo (image) to the Media Library.
- Hover over the image and click it. Copy the Media T4 Tag.
- Paste the T4 Tag in to replace the original image reference, i.e. the <svg width="303"...</svg>
- Click Save changes.
- Preview your site to check the result. If you have a preview open already, simply refresh that one. Otherwise, you can preview the site from the Site Structure screen.
Breadcrumbs Navigation
- To allow visitors to see how they got to a page, a breadcrumb trail may be useful.
- Build a Breadcrumbs Navigation Object and apply it to your Page Layout.
Breadcrumbs are used to provide the visitor with the ability to instantly see their location within the site structure. If links are enabled, the user can click any of the sections forming the path between the site root and current section. Start & end level can also be specified.
How to create Breadcrumbs
- Go to Assets > Navigation > Add new navigation > Breadcrumbs
- Use the HTML from the header to determine how the breadcrumb trail should be built.
- The breadcrumbs navigation object contains the following:
- Name: enter a name for the breadcrumb trail.
- Description: enter a description for the breadcrumb trail, i.e. what will be output
- Primary group: Select your group.
- View in preview: allows the breadcrumb output to be viewable in preview.
- Options
- Output each section level as a link.
- Output the current section as a link.
- Hide the Home or root level.
- Breadcrumb length
- Full path
- Set start & end levels.
- Set maximum length.
- Full text options
- Append content “name” for full text pages. This will add your fulltext contents to appear within the breadcrumb path (we will not use this feature in this activity as it has not been styled)
- Choose the content element you would like to display.
- Before HTML: the HTML to be output before the Breadcrumb trail.
- After HTML: the HTML to be output after the Breadcrumb trail.
- Separator HTML: leave this blank as the Style CSS will control the breadcrumb separator.
- Click Next to save the Navigation Object
- Copy the Navigation T4 Tag to your clipboard; to be pasted into your Page Layout later.
Apply Breadcrumb Navigation to Page Layout
- The Navigation Object you just built now needs to be applied to the Page Layout to replace the hardcoded breadcrumb trail.
- Build a T4 Tag to output the Breadcrumbs.
How to apply Breadcrumbs to Page Layout
- Go to Assets > Page Layouts.
- Click Edit beside your Page Layout.
- Select the Header tab.
- Paste the Breadcrumb Navigation T4 Tag in to replace the original breadcrumb trail as highlighted above.
- Click Save changes to apply these changes.
- Preview your site to check the result. If you have a preview open already, simply refresh that one. Otherwise, you can preview the site from the Site Structure screen.
News Content Type
- When adding news items to a site it is often useful to give the visitor a "quick overview" first and then provide a link to the full news item. You are going to create this effect by using a fulltext Content Layout.
- To first determine the elements for this Content Type, you need to analyze the desired output and decide how to cut it up. In this example, you are going to have two different outputs – the quick overview as well as the main news item.
How to create a News Content Type
- To start the work, go to Assets > Content Types > Create content type
- Fill in the General information:
- Name: enter a name here. This should suggest what type of content it is used for.
- Description: describe in more detail when to use this Content Type.
- Minimum user level: if you wish to restrict who can use this Content Type, you can set a level here. If Content Types are created in groups, a user must be a member of the group as well as meet the minimum user level criteria to use the Content Type.
- Enable direct edit: is checked as a default. Decide if Direct Edit should not be used for this Content type.
- eForm: check this if the Content type will be an e-form.
- Workflow: if relevant, enable a workflow for content using this Content Type.
- Primary group: Select your group.
- Select the Elements tab.
- Add the elements you need by filling in the information as outlined in the table below.
- Once you have added all your elements, click Save changes.
- From the Content Types table, search for your News content type and click on the name to edit.
- Select the Content Layout tab.
- Click Add content layout to begin creating a new Content Layout for your Content Type.
- Name: needs to be filled in with the default Type set in the Channel. This ensures the content can be displayed. Use text/html
- File Extension should be left at Default, unless this is used with a different file extension. This requires other extensions being permitted in the Channel.
- Syntax type: Select the relevant language to enable syntax highlighting. I.e., HTML/XML.
Name | Description | Element Type | Maximum Size | Required | Show |
---|---|---|---|---|---|
Headline | Enter the main headline here | Plain Text | 150 | Yes | Yes |
Release date | Select a date using the date picker | Date | *leave at default* | Yes | Yes |
Teaser | Enter a short summary of your news item | Plain Text | 2500 | Yes | Yes |
News story | Enter the main content for your news item | HTML | 100000 | Yes | Yes |
Image | Select an image from the Media Library | Media | *leave at default* | No | Yes |
Image caption | Enter a caption for the image | Plain Text | 150 | No | Yes |
- Content layout processor: select T4 Tag Content.
- Use the Content layout code to build the first output for your content. If you have created the HTML already, you can start by pasting that into the code field as displayed below (copy the code text in the code box below).
<h3><a href="#">The Terminalfour panel debates the challenges facing higher education</a></h3>
<em><strong>2024, 12 March</strong></em>
<p>We hosted our first panel debate of 2020 and got deep into a debate on a wide range of challenges facing institutions.</p>
<hr>
- As each piece of content will have unique information in the Headline, Release Date and Teaser, the text below needs to be replaced with what the user enters when creating the content. To do that you need to build some T4 Tags.
- In this example, the text The Terminalfour panel debates the challenges facing higher education is the Headline and needs to be replaced with a T4 Tag. To build this, click the Generate T4 tag button.
- Build Content Type T4 Tag:
- Tag output: as you need to output the information the user enters in this element, select the option Element.
- Content element: select the element you created earlier for the Headline.
- Output Method: select Normal Output (inline), as this outputs the element by adopting the text layout of the page.
- Select the relevant Modifiers:
- Strip out all HTML Tags.
- Encode special characters to their HTML equivalent.
- Decide if you wish to disable direct edit for this element.
- Click Copy to clipboard to copy the XML code.
- The T4 Tag you have copied should look like this (depending on which modifiers you have selected):
<t4 type="content" name="Headline" output="normal" modifiers="striptags, htmlentities" />
- Replace the original Headline with the new T4 Tag.
- Click the Generate T4 Tag button again.
- You are now going to build a tag to replace the date (Release date):
- Tag output: as you need to output the date the user selects in this element, select the option Element.
- Content Element: select the element you created earlier for Release date.
- Date format: choose your preferred date format from the drop-down menu.
- Output Method: select Normal Output (inline), as this outputs the element by adopting the text layout of the page.
- No Modifiers are relevant for a date element.
- Decide if you wish to disable direct edit for this element.
- Click Copy to clipboard to copy the XML code.
- Replace the original date 2024, 12 March with the new tag.
- Click the Generate T4 Tag button again.
- You are now going to build a tag to replace the Teaser.
- Tag output: as you need to output the information the user enters in this element, select the option Element.
- Content element: select the element you created earlier for Teaser.
- Output Method: select Normal Output (inline), as this outputs the element by adopting the text style of the page.
- Select the relevant Output Modifiers:
- Strip out all HTML Tags
- Encode special characters to their HTML equivalent
- Change new lines to HTML line breaks (this is not automatically selected—check the box)
- Click Copy to clipboard to copy the XML code.
- Replace the original teaser with the new tag. You need to leave a set of <p> tags around the T4 Tag or it will not display as a paragraph.
- Click the Generate T4 Tag button again.
- You are now going to build a tag to replace the path for the link (#)
- Tag output: select the option Element
- Content element: select any one of your elements, e.g., Headline.
- Output Method: select Output to fulltext, as this creates the path to the fulltext page (which we will build next).
- Fulltext URL: you can uncheck this box. See the information box below about a “Friendly URL”.
- Click Copy to clipboard to copy the XML code.
- Replace the # with the new tag.
- Click Save changes to save the new Content Layout. The first part of the Content Type is complete.
Friendly URL
> To control the URL of the fulltext version of the content, you can select to use one of your elements. By default the Name element is used.
> You can select an alternative element to be used in the URL of the fulltext version by checking the “Use element value as friendly URL” box at the Fulltext URL option.
> The URL for the fulltext version of the content will contain the text entered in the Headline (if you select this element). You can configure the converting of any spaces in the Friendly URL via the Channel and Configuration settings.
- To build the fulltext Content Layout, click Add content layout in the Content layout tab.
- Name: We have already used text/html. Use the default fulltext type set in the channel. We’ll use text/fulltext.
- File Extension should be left at Default unless this is used with a different File Extension. This requires other extensions being permitted in the Channel.
- Syntax type: Select the relevant language to enable syntax highlighting. E.g., HTML/XML.
- Content layout processor should be T4 Tag Content.
- Use the Content Layout Code to build the first output for your content. If you have created the HTML already, you can start by pasting that into the code field as displayed below (copy the code text in the code box below).
<h2>The Terminalfour panel debates the challenges facing higher education</h2>
<em><strong>Release date: 2024, 12 March</strong></em>
<div class="newsimage">
<img src="images/Image.jpg" alt="Image">
<div class="caption">Caption text</div>
</div>
<p>Last month we hosted our first webinar of 2024 with a panel discussion featuring our founder Piero Tintori, as well as Liz Gross and Claire Gibbons.</p>As each piece of content will have unique information in the Headline, Release Date, News Story, Image and Image Caption, the text below needs to be replaced with what the user enters when creating the content. To do that you need to build some T4 Tags.
- In this example, the text The Terminalfour panel debates the challenges facing higher education is the Headline and needs to be replaced with a T4 Tag. Use what you have learned to build the tag and replace the original Headline with the new tag.
- The text 2024, 12 March is the Release date element and needs to be replaced with a T4 Tag. Use what you have learned to build the tag and replace the original date with the new tag. Select the date format you’d like from the drop-down menu.
- <img src="/images/Image.jpg" alt="Image"> needs to be replaced with the image the user selects from the Media Library. To make that possible, build a T4 Tag for the Image:
- Tag output: select Element.
- Content element: select the element you created earlier for Image.
- Media formatter: select image/*
- Output Method: select Normal Output (inline).
- No modifiers are relevant.
- Click Copy to clipboard to copy the XML code.
- Replace the original image tag with the new T4 Tag. Based on the Media Content Type Layout, the Description in the Media Library will be used as the alt tag.
- The text Caption text is the Image Caption and needs to be replaced with a T4 Tag. Use what you have learned to build the tag and replace the original Image Caption with the new tag.
- The paragraph of text (News Story) needs to be replaced with a T4 Tag. Use what you have learned to build the tag and replace with the new tag.
- Click Save changes to save the new Content Layout. The Content Type is complete.
Enable News Content Type
- You need to enable your new Content Type to your Site Structure to test it.
- Content Types can only be used in Sections where they are enabled.
- If a Content Type is created in a Group, only users who are members of that Group can use the Content Type.
- Only users who meet the Minimum User Level criteria can use the Content Type.
How to enable the news Content Type
- On the Site Structure screen, beside your main section, click Actions menu > Edit section.
- Select the Content types tab.
- Click the radio button to enable the newly created Content Type for either the branch or section:
- Enabled (branch): the Content Type can be used in this section as well as all its sub-sections.
- Enabled (section): the Content Type can be used in this section only.
- Click Save changes to save the changes.
- Use the new Content Type to add content to your section.
Top Content Navigation
- A Top Content Navigation Object can be used to output, for instance, the most recent news items in a specific location on your site.
- In this example, build a Top Content Navigation Object to output the three most recent news stories in the Latest News box on the left.
- Build a third Content Layout for your News Content Type to output the Headline and the Publish Date.
How to create a Top Content Navigation
- Go to Assets > Navigation > Add new navigation > Top content
- Use the HTML from the footer to determine how the Top News should be built.
- The Top content contains the following options:
- Name: enter a name for the Top News.
- Description: enter a description for the Top News, i.e., what will be output.
- Primary group: Select a group to add the navigation to.
- Options
- Show pending content in preview: lets you view non-approved content in preview.
- Cache output: Check this option to cache the output of this Navigation Object, which can improve preview and publish performance. This is useful once the object is configured and working as expected.
- Title: enter the title you wish to output before the menu or leave it blank if you do not wish to use a title.
- Fetch Method: select the relevant option:
- Use section: content will be fetched only from the Section you specified above.
- Use branch: content will be fetched from the Branch, starting at the Section you specified above.
- Use current: content will be fetched from the current section. If you selected a Section above, this will be ignored.
- Use current branch: content will be fetched from the Branch, starting at the current section. If you selected a Section above, this will be ignored.
- Select section: click and navigate to the section you wish to fetch the content from.
- Content type name: select one or multiple Content Types from the list. Only content using these Content Types will be 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
- Use current content:
- Date element: enter the name of the date element in your Content Type(s). This must be an exact match.
- 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.
- Number of Content Items to display: specify the maximum number of content items you wish to display.
- Which Content Item to start at?: specify which piece of content to start with. This does not have to be the first piece.
- Content layouts
- Use channel default:
Select to use Channel default (specified in the channel settings) - Use alternate content layout:
Select to use an alternate Content Layout.
Alternate Content Layout: specify which Content Layout you wish to use. In this instance you have not created the Content Layout yet, but you can still set one, e.g., text/latest-news
- Use channel default:
- Before HTML: the HTML to be output before the list of items.
- After HTML: the HTML to be output after the list of items.
- Click Next to save the Navigation Object
How to create an alternate layout for Recent News
- To build the alternate Content Layout, go to Assets > Content Types.
- Click Edit beside your Content Type (News).
- Select the Content Layout tab and click Add content layout.
- The Content Layout Name will be empty, as you have also used the default fulltext Content Layout, you need to create a new one to match what you specified in the Navigation Object, e.g., text/latest-news.
- The File Extension should be left at Default unless this is used with a different File Extension. This requires other extensions being permitted in the Channel.
- Select the relevant Syntax type language to enable syntax highlighting.
- Use the Content layout code to build the output for your content. If you have created the HTML already, you can start by pasting that into the code field as displayed below (copy the code text in the code box below).
<h5><a href="#fulltext">Terminalfour wins "Company of the Year" at ICT Excellence Awards</a></h5>
<em><strong>17 May</strong></em>
<hr>
- As each piece of content will have unique information in the Headline and Release Date, the text below needs to be replaced with what the user enters when creating the content. To do that you need to build some T4 Tags.
- The Content Layout is very similar to the original text/html Content Layout, so you should be able to build this by using what you have learned.
Apply Top Content Navigation to Page Layout
- The Top Content Navigation Object you just built now needs to be added to your Page Layout to replace the hardcoded list of Top News.
- Build a T4 Tag to output the Top Content.
How to apply a new navigation object to page layout
- Go to Assets > Page Layouts.
- Use the Filter tool to locate your Page Layout and click the name to edit.
- Select the Footer tab.
- Paste the Navigation T4 Tag in to replace the original menu as highlighted above.
- Click Save changes.
- Preview your site to check the result. If you have a preview open already, simply refresh that one. Otherwise, you can preview the site from the Site Structure screen.
- You may wish to add a couple of news items to be able to check the result.
Related Content
- A Related Content Navigation Object fetches content which relates to the main content. This can be based on where the related content is added, what Content Layout is used, etc.
How to add a Related Content Navigation
- Go to Assets > Navigation > Add new navigation > Related content. Use the HTML from the footer to determine how the Related Content should be built.
- The Related Content contains the following options:
- Enabled: if the Navigation Object is used, it needs to be enabled, otherwise nothing will be output.
- Name: enter a name for the Related Content, to make it easy to identify what it is used for.
- Description: enter a description for the Related Content, i.e., what will be output.
- Show pending content in preview: allows you to view non-approved content in preview.
- Cache output: Check this option to cache the output of this Navigation Object, which can improve preview and publish performance. This is useful once the object is configured and working as expected.
- Output title: enter the title you wish to output before the menu or leave it blank if you do not wish to use a title.
- Fetch method: determine where the content will be fetched from:
- Use current: the content will be fetched from the current section. Unless an Alternate Content Layout is specified, it will fetch all content with the default (text/html) Content Layout from the current section.
- Use section: the content will be fetched from a specific section.
- Use child: the content will be fetched from a child section with a specific name. You need to specify the details in Child section name. Also, select the Content type(s) to be used, and number of pieces to display.
- Use grandchild: functions like the Use child option.
- Content layouts
Use channel default.
Select to use Channel default (specified in the channel settings)
Use alternate content layout.
Select to use an alternate Content Layout.
Alternate Content Layout: specify which Content Layout you wish to use. In this instance you have not created the Content Layout yet, but you can still set one, e.g., text/sidebar-box - Before HTML: the HTML to be output before the content.
- After HTML: the HTML to be output after the content.
- Click Next to save the Navigation Object
- You need a new Content Type for adding content in a sidebar box on the left-side of your page.
To create that, go to Assets > Content Types > Create content type - Fill in the General information:
- Name: enter a name here. This should suggest what type of content it is used for.
- Description: describe in more detail when to use this Content Type.
- Minimum user level: if you wish to restrict who can use this Content Type, you can set a level here. If Content Types are created in groups, a user must be a member of the group as well as meet the minimum user level criteria to use the Content Type.
- Options: decide if Direct Edit can be used for this Content Type and if the Content Type should be an eForm.
- Enable in direct edit
- Mark as eForm
- Mark as eForm: check this for eForms and xForms only. This will be described in detail later.
- Workflow: if relevant, enable a workflow for content using this Content Type.
- Primary group: restricts access to the Content Type based on the Primary Group a User is a member of
- Select the Elements tab.
- Add the elements you need by filling in the information as outlined in the table below.
Name | Description | Type | Max size | Required | Show |
---|---|---|---|---|---|
Heading | Enter your main heading | Plain Text | 150 | Yes | Yes |
Main body | Enter the main body for the left side | HTML | 2500 | Yes | Yes |
- Once you have added all your elements, click Save changes. The Content layouts tab opens.
- Add a new content layout by clicking on the Add content layout button.
- Fill in the General information:
- Name: enter the name of the content layout, text/sidebar-box.
- File extension: The File extension should be left at Default unless this is used with a different File Extension. This requires other extensions being permitted in the Channel.
- Syntax Type: Select the relevant Language to enable syntax highlighting, i.e., HTML/XML.
- Content layout processor: Select T4 Tag Content as the content layout processor.
- Use the Content Layout Code to build the first output for your content. If you have created the HTML already, you can start by pasting that into the code field as displayed below (copy the code text in the code box below).
<h4>Heading of related content</h4>
<div class="panel">
<p>Main body of related content</p>
</div><!-- /.panel -->
- As each piece of content will have unique information in the Heading and Main Body, the text below needs to be replaced with what the user enters when creating the content. To do that you need to build some T4 Tags.
- In this example, the text Heading of related Content needs to be replaced with a T4 Tag. To build this, select the Generate T4 Tag button.
- Generate T4 tag:
- Tag Output: select Content Element; This outputs the information the user enters in the element.
- Content element: select the element you created earlier for the Heading.
- Output method: select Normal output (inline); this outputs the element by adopting the text layout of the page.
- The relevant Modifiers are automatically selected by Terminalfour, these are:
- ✓ Strip out all HTML Tags.
- ✓ Encode special characters to their HTML equivalent.
- Decide if you wish to Disable direct edit for this element.
- The T4 Tag is automatically generated; click Copy to clipboard to copy the generated t4 tag. The T4 Tag you have copied should look like this (depending on which modifiers you have selected):
<t4 type="content" name="Heading" output="normal" modifiers="striptags, htmlentities" />
- Replace the original heading: Heading of related content, with the new tag.
- Select the Generate T4 Tag button again.
- Using what you have learned above, build a tag to output the Main Body:
- Normal Output (inline).
- ✓ Parse for navigation t4 tags.
- The T4 Tag is automatically generated; click Copy to clipboard to copy the generated t4 tag.
- Replace the original content for the Main Body with the new tag. You do not need to leave <p> tags around the tag as the HTML editor will generate the necessary tags.
- The Content Layout should look like the screen below.
- Click Save changes to save the new Content Layout. The Content Type is complete.
Enable your Sidebar Box Content Type
- You need to enable your new Content Type to your Site Structure to test it.
- Content Types can only be used in Sections where they are enabled.
- If a Content Type is created in a Group, only users who are members of that Group can use the Content Type.
- Only users who meet the Minimum User Level criteria can use the Content Type.
How to enable the Sidebar Box Content Type
- On the Site Structure screen click your main section name to edit it
- Select the Content types tab.
- Click the radio button to enable the Content Type for either the branch or section:
- Enabled (branch): the Content Type can be used in this section as well as all its sub-sections.
- Enabled (section): the Content Type can be used in this section only.
- Click Save changes to save the changes.
- Use the new Content Type to add content to your section.
Apply Related Content Navigation to Page Layout
- The Navigation Object you just built now needs to be applied to the Page Layout to replace the hardcoded Related Content.
- Build a T4 Tag to output the Related Content.
How to apply the new Navigation Object
- Go to Assets > Page Layouts
- Locate your page layout and edit it.
- Paste the T4 Tag in to replace the original content as highlighted above.
- Click Save changes.
- Preview your site to check the result. If you have a preview open already, simply refresh that one. Otherwise, you can preview the site from the Site Structure screen.
Site Map
- Build a Site Map Navigation Object and link to the Site Map by using a Section Details Navigation Object.
- A Site Map is typically used in a piece of content using a plain text Content Type to avoid having a Site Map appear on every page of your website.
- The Navigation Object outputs your Site Structure as links (with the ability to set a start and finish point).
How to create a Site Map
- To create the section for the Site Map Content, select Create section from the Actions menu beside your main section.
- Enter a Name for your section, e.g., Site Map.
- Uncheck the box Show in Navigation.
- Click Save changes. The section has been added to your Site Structure.
- To create the Content Type, go to Assets > Content Types > Create content type
- Fill in the General information:
- Name: enter a name here. This should suggest what type of content it is used for, e.g., Code container.
- Description: describe in more detail when to use this Content Type.
- Minimum user level: if you wish to restrict who can use this Content Type, you can set a level here. If content types are created in groups, a user has to be a member of the group as well as meet the minimum user level criteria in order to use the Content Type.
- Enable in direct edit: decide if Direct Edit can be used for this Content Type.
- Mark as eForm: check this for eForms and xForms only. This will be described in detail later.
- Workflow: if relevant, enable a workflow for content using this Content Type.
- Primary group: select the group that will use this content type.
- Select the Elements tab.
- Add the elements you need by filling in the information as outlined in the table below.
- Once you have added all your elements, click Save changes. The Content layout tab opens.
Name | Description | Type | Max size | Required | Show |
---|---|---|---|---|---|
Code | Enter your code here | Plain Text | 25000 | Yes | Yes |
How to create a Site Map
- Click Add content layout
The Content layouts screen is a new Content Layout for your Content Type.- Name: text/html -this is the default Type set in the Channel. This ensures the content can be displayed.
- File extension: Default- unless this is used with a different File Extension. This requires other extensions being permitted in the Channel
- Syntax type: HTML/XML – this determines which syntax is highlighted.
- Content layout processor: must be set to T4 Tag Content.
- Content layout code: this determines the output for your content.
To allow you to output the content, you need to generate a T4 Tag for the Code element.
- Click Generate T4 tag
- Tag output: as you need to output the information the user enters in this element, select the option Element.
- Content element: select the element you created earlier for the Code.
- Output method: select Normal output (inline), as this outputs the element by adopting the text style of the page.
- No Modifiers are relevant for this element. (Uncheck any that have been pre-selected).
- Decide if you wish to disable Direct edit in this element.
- The T4 tag is generated in the Preview area.
- Click Copy to clipboard to copy the T4 Tag.
- Paste the T4 Tag into the Content layout code field.
- Click Save changes to save the new Content Layout. The Content type is complete.
Enable a Content Type
- You need to enable your new Content Type to your Site Structure to test it.
- Content Types can only be used in Sections where they are enabled.
- If a Content Type is created in a Group, only users who are members of that Group can use the Content Type.
- Only users who meet the Minimum User Level criteria can use the Content Type.
How to enable the new Content Type
- On the Site Structure screen click your main section name to edit it
- Select the Content Types tab.
- Click the radio button to enable the Content Type for either the branch or section:
- Enabled (branch): the Content Type can be used in this section as well as all its sub-sections.
- Enabled (section): the Content Type can be used in this section only.
- Click Save changes to save the changes.
- Use the new Content Type to add content to your section.
Site Map Navigation Object
- The Navigation Object needs to output the Site Map for your part of the site.
- Build a T4 Tag to output the Site Map.
- Create a piece of Content with the Site Map Navigation Object.
How to create a Site Map Navigation Object
- Go to Assets > Navigation > Add new navigation > Site map
- The Site Map navigation object contains the following options:
- Name: enter a name for the Site Map; to make it easy to identify what it is used for; a descriptive name
should be considered. - Description: enter a description for the Site Map, i.e., what will be output.
- Primary group: Select a group to add the navigation to.
- Show pending content in preview: lets you view non-approved content in preview.
- Start section: decide where you want the site map to start.
- Child section links: check this option to hide the section you selected above as the root.
- Levels: leave this as 0 to show the full Site Map. Alternatively specify the number of levels.
- Add content count: check this option to count the pieces of content in each section and display it.
- Restrict content types: select the Content Types to include in the count above.
- Maximum level count: set a level if you wish to stop the count of content.
- Recursive count: if checked, this adds up all the sub-sections and outputs a total at the parent section, otherwise each section will have its own total.
- Text before: enter the text you wish to display before the count.
- Text after: enter the text you wish to display after the count.
- Name: enter a name for the Site Map; to make it easy to identify what it is used for; a descriptive name
- Click Next to complete the Navigation Object.
Use Navigation Object in content
- The Navigation Object you just built now needs to be used as a piece of Content in the hidden Section you created called Site Map.
- Build a T4 Tag (in your Page Layout) to output the Site Map.
- Create a piece of content using your Code Content Type and paste the T4 Tag in as the content.
How to use the new Navigation Object in content
- Once your navigation object has been created, copy the generated T4 tag embed code.
- Navigate to the Site Structure screen and select Add Content from the Action menu beside your Site Map section.
- Select your Code container Content Type.
- Give the piece of content a name and paste the T4 tag embed code into the Code element as displayed above.
- Click Preview to check the result.
- Return to the content screen and click either Save changes or Save and approve to save the content.
Section Details - Link to Section
- As the Site Map Section is hidden from navigation, you need a link for visitors to click on to get to the Site Map. To create that, you need a Section Details Navigation Object.
- Build a T4 Tag to output the Link to Site Map and apply it to your Page Layout.
How to link to a Hidden Section
- Go to Assets > Navigation > Add new navigation > Section details
- Use the HTML from the header to determine how the Link to Site Map should be built. In this case you can build a full link.
- The Section Details navigation contains the following options:
- Name: enter a name for the Link to Site Map.
- Description: enter a description for the Link to Site Map, i.e., what will be output.
- Primary group: The members of the Primary Group can modify the Navigation Object. Click Show Shared Groups to share an object with other Groups, providing either full access or read-only access for the members of that Group.
- Show pending content in preview: lets you view non-approved content in preview.
- Detail method: determine whether the detail refers to Use section at level or Use section; then use one of the following two options to specify the relevant details.
- Current section:
- Level: if you selected Use section at level, specify the level here.
- Select section: if you selected Use section, click Select section and select the section you wish to use.
- Output detail: you can output the section's ID, Name or Path or alternatively output Link to Section.
- Click Next to complete the Navigation Object.
- The T4 Tag is automatically generated; copy this tag to your clipboard, to be applied to your page layout later.
Apply Section Details Navigation to Page Layout
- The Navigation Object you just built now needs to be applied to the Page Layout to replace the hardcoded links in the header or footer.
- Build a T4 Tag to output the Link to Site Map.
How to apply the Section Details to page layout
- Go to Assets > Page Layouts
- Click your Page Layout’s name to edit it.
- Go into the </> Header code tab.
- Click on the </> Generate T4 tag button.
- Use the Navigation T4 Tag Builder:
- Restrict list by type: Section Details.
- Available navigation objects: select your Link to Site Map.
- Click Copy to clipboard to copy the Navigation T4 Tag.
- Paste the T4 Tag in to replace the original section link, i.e., <a href="#1">Header link 1</a>.
- Click Save changes to save the work.
- The link is now complete. Preview your site to check the result.
Direct Edit
- To allow users to update content directly from the published site, add an Edit this Page link in the footer of your Page Layout.
How to edit content from published site
- Go to Assets > Page Layouts
- Click Edit beside your Page Layout.
- Select the Footer tab and locate the "Header link 1" link as highlighted above.
- Replace the link with:
<t4 type="edit-page" action="direct-edit" text="Edit this page"/>
- Click Save changes. The link is now complete. Preview your site to check the result. If you have a preview open already, simply refresh that one. Otherwise, you can preview the site from the Site Structure screen.
Approve Content
- When content is added to Terminalfour, it needs to go through an approval process before it can be published; only published content will be visible on your website.
- The content you have created so far is all pending approval. Ensure your content is approved.
A note about Approving Content
> Approval of content can also be done from the Direct Edit screen.
> If selective approval is enabled, you can approve content by checking the Approve box beside the content and then clicking on Approve.
> The Approve Content screen will refresh itself periodically; the refresh rate can be set in Configuration.
> If content is assigned to a workflow, approving the content will advance it to the next step. Fast Track is an option available to Administrators allowing you to by-pass any further steps in the workflow and brings the content straight through to completion of the Approval workflow.
How to Approve Content
- To approve content, go to Content > Approve content.
Content Status Color Code
Approved Content
Pending Content
Inactive Content
- Use the Filter tool to filter for the items you wish to approve.
- Click Approve if you are happy to approve content; otherwise, click Reject.
- When content has been rejected, a Reject Reason can be added to explain the decision.
- Once content has been approved, it will disappear from the main list.
- In the Site Structure, the approved content appears in the green column
Workflow
- By default, content goes through an approval process in Terminalfour. Moderators + can approve content in sections they are assigned to. To specify a process for approving content, you can create workflows.
- Create a workflow to ensure all content added using your Content Type for generic content is approved by you.
- Assign the workflow to your Content Type.
Assigning Workflows
> Workflows can be assigned to:
Sections,
Content types,
Media library categories
How to set up a Workflow
- To build a workflow, go to Administration > User rights & roles > Workflow > Add new workflow
- Give your workflow a Name and Description and assign to your group; then click Save changes.
- The Steps tab appears. Click Add new step to add the first step to your workflow.
- Give your step a Name and Description.
- Select the Step priority; approvers can sort content by Priority in the Approval list.
- Check the box Restrict to editors if you wish to restrict the users who can review/approve this step to those who have editing rights to the content.
- Configure users:
Select the users or groups to be involved in this step. - Optional settings:
Select the radio button to specify what happens to a piece of content if it is rejected.- Content owner: will reject content back to the content owner.
- Last modified by: will reject content back to the person who last modified the content.
- Step X: send the content to a step within the same workflow and select the step.
- Different workflow: from a drop-down menu you can select a different workflow to send the content to.
- Do nothing: use this option if you do not wish to reject the content to anyone; content will therefore remain in the Approval list.
- Step approval settings:
If there is more than one approver in a workflow step, approval of content can be put to a vote; select the radio button for the option you wish to apply.- All moderators: if selected, all the approvers in this step will need to vote to approve the content.
- Majority: content will only be approved once a majority of approvers have approved the piece of content.
- X number of moderators: determines how many approvers will need to approve the content in order for it to be approved in this step; set a number by entering it into the field.
- Content owner: if selected, only the content owner can vote to approve content; this option requires that a content owner has been set. If no owner is set, the content may only be approved by an administrator.
- Enable active moderation if checked, the vote count will be for both approval and rejection with content being either approved or rejected once the configured “X” number has been reached.
- Notification settings:
Email alerts can be sent to content owners or those involved in the workflow step during the approval process. Avoid selecting all options as this generates large quantities of emails.- Start: an alert is sent to the content owner or those involved in the workflow step when a piece of content enters a step they participate in.
- In progress: an alert is sent to the content owner or those involved in the workflow step when a piece of content is either approved or rejected.
- End: an alert is sent to the content owner or those involved in the workflow step when a piece of content is either fully approved or rejected, hence completing the current step.
- User alert settings:
Specifies who receives alerts and notifications by email.- Content owner: this informs the content owner when any of the above alerts or triggers are fired.
- Step moderators: this informs any of those involved in the workflow step when any of the above notifications are sent.
- All content owners and moderators: this informs content owners and any of those involved in the workflow step when any of the above alerts or triggers are fired.
- Click Save changes to add the step to the workflow.
- Click Add new step to add a further step to the workflow if required, otherwise click Save changes.
- To assign the workflow to your content type, go to Assets > Content types > Edit your content type.
- From the Workflow drop-down list, select your workflow.
- Click Save changes.
Publish
- Once Content has been approved, it still needs to be published before the content will appear on the website.
- Publish the channel you have been working on. The trainer will advise you of the published URL.
How to Publish your website
- To publish your website, go toSites & Channels > Publish Channels
- Locate your channel and select Enable publish
- Click Publish channels to publish.
- You can also create a publish schedule by clicking Schedule publish.
- Next due: Use the calendar to select the next publish date and time.
- Execution interval: Select the frequency of the scheduled publish.
- Channel: Set the channel to publish.
- Publish archive sections: check the box to force a publish of archived sections.
- Override publish period restriction: If your channel has a publish period restriction on fulltext content check this box to override the restriction.
Feedback Survey
- Congratulations on completing the Implementer training course.
- Please click on the link below to open our on-line survey and provide your feedback.