Resources

What is a Resource?¶

A Resource is a page or another item in the Resource tree: a Document, a Weblink, a Symlink, or a Static Resource. Custom Resource Classes add more types.

Every Resource has an ID. Use the ID in link tags so MODX generates the URL; aliases and Content Types can then change without breaking links.

Managing Resources¶

Resources appear in the Resources tree on the left. Click a Resource to edit it, or right-click it and choose Edit. The edit page opens:

Resource Groups tab and Access¶

The Resource Groups tab lists every Resource Group. Access is membership, not an ACL grant.

• Check Access and save: the Resource joins the group.
• Uncheck Access and save: the Resource leaves the group.

The Resource stays public until the group is paired with a User Group and an ACL. See Resource Groups.

A new Resource under a parent that belongs to groups starts with those Access boxes checked. The resourcegroup_resource_edit permission is required to see and change them.

Resource Fields¶

The tables list the fields on the Resource edit page. id is inherited; the other fields are columns in modx_site_content.

Content fields¶

Content by Resource type¶

Publishing and menu fields¶

System fields¶

Using Resource Fields¶

Resource fields are available in templates and content through the Template Variable syntax.

[[*pagetitle]]
[[*id]]
[[*createdby]]

Output Filters can modify the value:

[[*introtext:ellipsis=`100`]]
[[*editedby:userinfo=`username`]]
[[*publishedby:userinfo=`email`]]

ellipsis limits introtext to 100 characters and adds an ellipsis. userinfo returns the username or email of the user stored in the field.

Accessing Resource Fields in a Snippet¶

A Snippet receives the current Resource as $modx->resource. This returns pagetitle reversed:

$output = $modx->resource->get('pagetitle');
return strrev($output);

Linking to a Resource¶

Link tags generate URLs for Resources:

[[~123]]

123 is the Resource ID. MODX renders the URL at request time.

Also see Named Anchor.

URL Parameters for Link Tags¶

Add parameters to a Link Tag with backticks:

[[~42? &tag=`Snacks` &sort=`Taste`]]

If Resource 42 resolves to store/items.html, the tag renders:

store/items.html?tag=Snacks&sort=Taste

URL Schemes in Link Tags¶

Set the scheme with the scheme property:

[[~123? &scheme=`https`]]

The available schemes are:

See Also¶

1. Content Types
2. Custom Resource Classes
3. Named Anchor
4. Static Resource
5. Symlink
   1. Using Resource Symlinks
6. Weblink
7. Resource Groups