Page contents and components

Learn about dependent assets and components and how you can add, edit, and conditionalize content displayed in these assets.

When you add certain assets in Squiz Matrix, such as a standard page, Matrix creates a few additional "dependent assets" by default.

A page contents asset and its parent asset (for example, a standard page) are dependent on each other. The page contents cannot exist without its parent asset, and it cannot be moved, cloned, or linked to another asset.

page content components

Each of these asset types serves a specific purpose:

Home (Standard page)

Holds the main attributes and details such as the page name, status, metadata, workflow, URLs, among other screens.

Page contents

Controls the page structure/order of all the content components.

Content component

Holds the configuration and attributes of a content block such as the HTML class, presentation type, content templates, among other configurations.

Component content

Defines the type of content block, such as a WYSIWYG, nested content, or code, and holds the actual content for a component.

The structure of the asset gets defined under the page contents by adding content components. The content of the asset gets added to these components.

By default, a content component gets created along with the page contents asset; these components can be viewed and edited on the Edit contents screen of the asset.

Linking components between assets

Avoid linking components between multiple assets.

When you edit the parent asset, it automatically gets the locks on the page contents and its child components. Because you can link a component to multiple parent assets, you may not be able to edit a component if someone else is already editing it.

Additionally, a linked component’s status does not change if it is lower than its other parent asset. For example, say "component-1" gets linked under the "Home" and "About Us" pages, and both pages are live. If you change the "About Us" page to under construction, the status of "component-1" will not change, and it will remain live.

Add a component

You add content components to a page from the Content screen.

page contents add component

  1. Click + to open the Add component panel.

  2. Select a component type.

    content components

Once you have created the new component, it also appears in the asset tree.

Once you have two or more components under a Page contents asset, you can re-order them by dragging and dropping them in the asset tree to the desired order.

Edit the properties of a component

The gear button opens the basic and advanced properties of a component in the Properties panel.

page contents component toolbar

Once you have edited the properties, click Save.

The properties are saved independently of the changes you make to component content on the Content screen.

Basic properties

Name

The asset name of the component.

Description

A short description of the component displayed when you use the component as a snippet and when listed under the Insert snippet drop-down in the WYSIWYG toolbar.

Component template

If your system has templates set up, you can select a template from the available options.

Component type

Change the component to another component type. The available options are:

WYSIWYG

A component with the WYSIWYG editor available.

Markdown

A code editing component that lets you enter markdown code.

Code

A code editing component that lets you enter raw HTML into the component. You can use this component to enter any code, such as HTML, XML, or scripting code, such as JavaScript.

Snippet

This component allows you to select from a list of pre-defined content snippets available within the system.

Nested content

This component allows you to nest content from another page into this component.

Read Content components for more information about the available content components in Matrix.

Advanced settings

Component ID

The HTML ID of the component. By default, this ID is automatically generated based on the asset name and the asset ID of the component to ensure the HTML ID attribute becomes unique on the frontend. Click Customize ID to change the component ID.

The component ID is not the same as the asset ID, but rather the ID that appears within the component’s HTML structure on the frontend. For example:
<div id="content_component_1234">
...content...
</div>
Disable keywords

Enable this to prevent Matrix keywords from being evaluated within this component. You can do this if you want to include text enclosed by percentage signs, which is interpreted as a keyword replacement. For example, you may wish to include the text %New Products% in the component.

Presentation tag

Select the HTML tag to wrap around this component. If Raw is selected, no wrapping HTML tag is used.

Custom class

Enter any class names you want to add to this component.

Custom class names only appear on the frontend if the Presentation setting is not set to Raw.
Text direction

The default direction the text will run in your component. This setting will set the dir HTML attribute on the component.

The text direction attribute will only appear on the frontend if the Presentation setting is not set to Raw.

Configuring the component display conditions

page contents conditions

Click Edit display conditions to open the component Display Conditions pop-up will appear.

The Display conditions settings panel lets you enable display conditions and configure the content display conditions within the selected content component.

The Settings section allows you to enable conditional content on the current content component and define the logic to use when matching conditions.

Display Conditions

Select whether or not to enable to use of conditional content on the content component. If this option is enabled, the content will only be displayed if the conditions match, as configured.

Logical Grouping

Select the logic to use when matching the configured groups defined on the content component. The options available are:

All groups must match

Each configured group must match to display the content of the component.

At least one group must match

One or more configured groups must match to display the content of the component.

Add a display condition group

Display condition groups define the conditions that must be met for the component’s content to be displayed.

This component toolbar item only displays when you have set display conditions up within the Conditions screen. Read Asset conditions screen for more information about setting up conditions for component condition groups.

No groups display when you first open the display conditions.

To add a group:

  1. Click Add group to create a new group logic and condition set.

  2. Configure the group logic and conditions based on the following options:

    Logical Grouping

    Select the logic to use when matching the Condition Group’s configured conditions. The options available are:

    All conditions are true

    Each Condition specified on the group must be met for the group to match.

    At least one condition is true

    One or more Conditions specified on the group must be met for the group to match.

    All conditions are False

    Each Condition specified on the group must NOT be met for the group to match.

    At least one condition is False

    One or more Conditions specified on the Group must NOT be met for the group to match.

    Condition

    Select a condition to use on the group. The available conditions in this field are those configured on the Conditions screen of the asset.

    Read the Asset conditions screen documentation for more information about configuring conditions.

  3. To add more conditions to a group, click Add condition and select from the configured conditions.

  4. Click Apply changes.

    Click Cancel to revert any changes you’ve made.

Delete a component

page contents delete component

Click Delete component to send the component to the trash.

Read Trashing and purging assets for more information about how deleted assets are managed in Matrix.

© 2015- Squiz Pty Ltd