The content node

A node, also called a location, is the place of a content object in the content tree. The object holds the content; the node says where it sits, who its parent and children are, and at which address it is shown. Templates usually work with nodes: the full view of a page is the view of a node.

One object, several locations

An object gets its first node when it is published, below the parent chosen when it was created. Editors can add more locations in the edit form's Locations window or with Add locations, so one article can appear below both News and Archive without being copied. All locations show the same object and the same version; changing the object changes it everywhere.

• The main location (main node) is the one the system uses when it needs one place: the object's main address, the default parent for breadcrumbs and the node that $object.main_node returns. Any location can be made the main one.
• Removing a location removes only that node and its subtree. Removing the last location removes the object (to the trash).
• Moving a node moves its whole subtree; the old address keeps working as a redirect (see URL translation).
• The object's section is the same at every location; visibility is set per location.

What a node has

Nodes in templates

{$node.name|wash}                       {* the object's name in the current language *}
{$node.node_id} {$node.parent_node_id} {$node.depth}
<a href={$node.url_alias|ezurl}>...</a>
{$node.object.id}                       {* the object behind it *}
{$node.data_map.title.content|wash}     {* its attributes *}
{foreach $node.path as $ancestor}{$ancestor.name|wash} / {/foreach}