Asset linking screen

The Linking screen lists all the current links associated with the asset. It lets you change the link type of the asset to another link type as well as set up a linking job to happen at a future date and time.

Understanding the different link types in Matrix is essential when creating assets for a Site. The link type you select affects how an asset displays on your Site’s frontend. The way you reuse assets in your Site (referred to as linking assets) is also heavily reliant on link types.

The available link types have corresponding numeric values for use in system configurations (for example, web services).
Table 1. Link types reference
UI link System link Link value Description

Menu link

TYPE_1

1

Assets with this link type display in the asset tree, and usually appear in the navigation menu and breadcrumbs on a site’s frontend.

Hidden link

TYPE_2

2

Assets with this link type display in the asset tree (with an orange icon) but usually do not appear in navigation menus and breadcrumbs on the frontend.

Invisible link

TYPE_3

4

Assets with this link type do not display in the asset tree, nor do they typically appear on the frontend.

This link type indicates that a special or hidden relationship exists between the assets.

For example, a submission asset created as a result of a website user completing a custom form creates a TYPE_3 linked asset relationship.

Reference link

NOTICE

8

Matrix creates links of this type to indicate that another asset is affected if you delete this asset.

The following scenarios apply to the Reference link type:

  • An asset has been linked within the bodycopy content of another asset.

    For example, if you create a hyperlink to a PDF Document within the bodycopy of a standard page, this link will appear as a Reference link on the Linking screen of the bodycopy container.

  • An asset is the Index Page or home page of a Site.

Current linking

This section lists all the current links associated with the asset and lets you change the link type of the asset.

The Current linking section of the Linking screen showing linked children
Figure 1. Current linking section
Parent links display by default (the location of the asset). Select Display type  Linked children to show all assets linked to this asset.
Asset example
Figure 2. A hidden link asset

An asset is linked to its parent through the Link type field when created. You can change this link type to change how the asset displays on the front end.

For example, if you create an asset as a Menu link asset, it displays in the navigation menu of a site. Changing it to a Hidden link asset means it is not visible on the menu.

Alternatively, you can change the link type of the current asset’s link to its child from, for example, a Menu link to a Hidden link. This change works the opposite way, making the child asset hidden from the site’s navigation menu.

The Hidden link icon (a yellow dot) displays on assets in the asset tree that are Hidden link links.

Magnified image of the hidden link icon
Figure 3. Magnified Hidden link icon

For example, in the figure shown above, the Page Contents asset is a Hidden link asset type. It does not show in the navigation menu of the site.

From the Current linking section’s Link type field select Hidden link and then click Save. The Hidden link assets will not appear in the menu navigation of the site, and the icon in the asset tree will be updated.

The Current linking section lists either the Linked parents or Linked children associated with the asset. Hyperlinks are displayed when viewing the linked parents list.

The Current linking section of the Linking screen showing linked children
Figure 4. Current linking section showing linked children

For example, if you are viewing the linked parents of a Microsoft Word Document, it will list all the assets in the system that have a hyperlink to the Word Document.

The following information is available for each asset listed in the Associated Links section:

Asset ID

The ID of the asset to which this asset is linked. You can access more info about the asset if you click the colored More info button. This button also indicates the status of the asset by its colour.

Link ID

This is the ID of the link used internally within Matrix.

Link type

This is the type of link described in Link types.

Value

Enter a value for links that are Menu link, Hidden link, or Reference link.

For example, you can use the Value associated link to filter assets in an Asset Listing when you only want to list assets with a specific type of link value. More advanced use cases include targeting specific links from a Trigger action or ensuring you only affect certain links when running a JavaScript API call.

Locked

Select whether to lock the asset link. Prevents the link from being manipulated, such as being moved elsewhere in the system or trashed. Only selected System Asset links, such as those under the System management folder, are locked by default.

Lineage

This field shows the location of the asset in the hierarchy of the asset tree.

This section lets you create a new link for the asset at a future date and time.

Create link
Figure 5. The Create Link section of the Linking screen

The create link function creates the same asset in a new position in the system.

To set up a new link job, enter the following information:

  1. In the Current linking section, select either Display type  Linked parents or Display type  Linked children to display the existing hierarchical links for the asset.

  2. Complete the following information to set a link

    New link parent/New link child

    Select the parent or child asset for the new linked asset. For example, if you link the asset under the About Us page, the parent asset is the About Us page.

    New link type

    Select the type of link for the linked asset as described in Link types.

    Use the link value

    Enter a value for links that are Menu link, Hidden link, or Reference link.

    At

    Select the date and time for when the linking job should occur from the options provided:

    Leave the At field empty and click Save to create the link immediately.
    Next run

    Click Next run button to set the date and time to the next run of the scheduled jobs manager.

    Or in

    You can set the linking job change to take place in a certain number of minutes, hours, days, weeks, months, or years. Enter the number into the text box and select the appropriate time frame from the list provided.

  3. Once you have filled out the required fields, click Save.

  4. On the HIPO screen, click Next

The linking job appears in the Future linking section of the screen, as shown:

Future Linking
Figure 6. The future linking section

To delete a future linking job, click Delete and click Save.

This section lets you create a job to move an asset link to the trash at a specified date and time.

To set up a New trash link job, enter the following information:

Trash link

Select the asset link to move to the trash. If there is already a direct child link under the trash asset for this asset, the link is trashed instead. You can select to trash all links by selecting All from the list or only a specific link.

All linked assets are trashed if you select All, and leave the At field empty.

At

Select the date and time to move the selected link to the trash using the Scheduled jobs manager. If you do not set a time, the link moves to the Trash immediately.

Next run

Alternatively, click the Next run button to set the date and time to the next run of the scheduled jobs manager.

Or in

You can set the Trash to take place in a certain number of minutes, hours, days, weeks, months, or years. Enter the number into the text box and select the appropriate time frame from the list provided.

Once you have filled out the required fields, click Save.

The trash linking job will appear under the Future Linking section of the screen, as shown:

Future linking
Figure 7. The Future linking section

To delete a future linking job, select the Delete box and then click Save.

Dependent children

This section lists the dependent child assets of an asset, whether they are locked and their Status. Some examples of a dependent asset include the page contents, DIV, and DIV content.

Dependent children section
Figure 8. Dependent children section

Each dependent child asset shows the following information:

Asset name

The name and asset ID for each asset in the list. To find out more information about the asset, hover the mouse over the Information icon icon. To find the asset in the asset tree, click on the Binoculars icon icon.

Lock status

Whether the asset is locked. If someone has a lock on the asset, [LOCKED] will appear next to the asset name.

Status

The status of each dependent asset in the list. Because you can link dependent assets under many assets, it can have a different status to the current asset you are viewing. If the status of the dependent asset is higher than the status of the current asset, then * appears against the status. If the status is lower than Safe edit, then ** will appear against the Status.

Dependants can generally not have a lower status than their parent assets (unless moved, cloned, or linked under).

When a link to another asset is created within a component using the WYSIWYG Editor, Matrix links these assets using a format of <a href="./?a=1234"> in the HTML content, where 1234 is the linked Asset ID.

When Matrix generates the page, this value gets converted to a full URL on the frontend. Asset relationships are made through an ID rather than a URL because the URL can change at any time.

You can also use this format when creating links between assets in Code components and the Parse File.

This process creates a Reference link between the two assets to relate them to each other, which adds the link value to the asset’s Linking screen.

© 2015- Squiz Pty Ltd