Skip to content
  1. Extras
  2. ModTree

ModTree

Component for linking site resources. Linked resources are shown as a tree on the page.

Create links between resources in the manager.

Create links between resources

Demo: examples.

On page load an initial query runs:

  • &queryLinks=`1` (default) — linked resources for &parent (default: current resource),
  • &queryLinks=`0` — child resources for &parent.

Clicking node icons then loads linked resources for those nodes.

Clicking a resource shows its content.

Clicking a resource shows its content

Uses AJAX. jQuery not required.

Snippet call examples

Show child resources

modx
&queryLinks=`0`

Show child resources of resource 7 on page load.

modx
[[modTree?
  &parent=`7`
  &limitList=`5`
  &queryLinks=`0`
]]

Show linked resources

Show linked resources of resource 15 on page load.

modx
[[modTree?
  &parent=`15`
  &limitList=`5`
]]

Snippet parameters

Display parameters

ParameterDefaultDescription
&tplOutertpl.ModTree.outerMain template
&tplListtpl.ModTree.itemListTemplate for initial list items
&tplTreetpl.ModTree.itemTreeTemplate for tree child items
&tplSearchFieldtpl.ModTree.itemSearchFieldSearch field template
&tplButtonstpl.ModTree.paginateBtnsPagination buttons template
&sortBymenuindexSort field
&sortDirASCSort direction
&limit0Max child resources
&limitList15Max initial query results
&contentIdPrefixmodtree-ID prefix for content areas. With two or more snippet calls per page, use a different template and prefix per call. Content areas can be anywhere on the page
&customCss01 — do not load component CSS (use your own styles)

Search parameters

ParameterDefaultDescription
&queryLinks1Initial query: 1 — linked resources, 0 — child resources
&parentCurrent resourceResource for initial query
&queryForce1When to run initial query: 1 — on page load, 0 — only on "Search" click
&linkWay0Link direction: 1 — master to slave, -1 — slave to master, 0 — both
&searchFieldspagetitle,contentComma-separated search fields. Use &searchFields=`` to disable