SilverStripe\CMS\Model\SiteTree

Basic data-object representing all pages within the site tree. All page types that live within the hierarchy should inherit from this. In addition, it contains a number of static methods for querying the site tree and working with draft and published states.

<h2>URLs</h2>
A page is identified during request handling via its "URLSegment" database column. As pages can be nested, the full
path of a URL might contain multiple segments. Each segment is stored in its filtered representation (through
). The full path is constructed via , and
. You can allow these segments to contain multibyte characters through
.

Synopsis

class SiteTree extends DataObject implements PermissionProvider,i18nEntityProvider,CMSPreviewable,Resettable {

• // members
• private static array $allowed_children = ;
• protected static array $_allowedChildren = ;
• private static string $default_child = "Page";
• private static string $default_classname = "Page";
• private static  $default_parent = NULL;
• private static bool $can_be_root = true;
• private static  $need_permission = NULL;
• private static  $hide_ancestor = NULL;
• private static array $db = ;
• private static array $indexes = ;
• private static array $has_many = ;
• private static array $owned_by = ;
• private static array $cascade_deletes = ;
• private static array $casting = ;
• private static array $defaults = ;
• private static string $table_name = 'SiteTree';
• private static array $versioning = ;
• private static string $default_sort = "\"Sort\"";
• private static boolean $can_create = true;
• private static  $icon = NULL;
• private static array $extensions = ;
• private static array $searchable_fields = ;
• private static array $field_labels = ;
• private static boolean $nested_urls = true;
• private static boolean $create_default_pages = true;
• private static boolean $runCMSFieldsExtensions = true;
• private static boolean $enforce_strict_hierarchy = true;
• private static string $meta_generator = 'SilverStripe - http://silverstripe.org';
• protected  $_cache_statusFlags = NULL;
• private static string $base_plural_name = 'Pages';
• private static string $base_singular_name = 'Page';
• private static  $description = NULL;
• private static string $base_description = 'Generic content page';
• // methods
• public static SiteTree get_by_link()
• public static array page_type_classes()
• public static string link_shortcode_handler()
• public string Link()
• public string AbsoluteLink()
• public string PreviewLink()
• public void getMimeType()
• public string RelativeLink()
• public string getAbsoluteLiveLink()
• public string CMSEditLink()
• public string ElementName()
• public bool isCurrent()
• public bool isSection()
• public bool isOrphaned()
• public string LinkOrCurrent()
• public string LinkOrSection()
• public string LinkingMode()
• public bool InSection()
• public void onBeforeDuplicate()
• public SiteTree duplicateWithChildren()
• public void duplicateAsChild()
• public string Breadcrumbs()
• public ArrayList getBreadcrumbItems()
• public void setParent()
• public SiteTree getParent()
• public string NestedTitle()
• public bool can()
• public bool canAddChildren()
• public bool canView()
• public bool canPublish()
• public bool canDelete()
• public bool canCreate()
• public bool canEdit()
• public SiteConfig getSiteConfig()
• public static PermissionChecker getPermissionChecker()
• public bool collateDescendants()
• public string MetaTags()
• public $this ContentSource()
• public void requireDefaultRecords()
• protected void onBeforeWrite()
• public void syncLinkTracking()
• public void onBeforeDelete()
• public void onAfterDelete()
• public void flushCache()
• public void validate()
• public bool validURLSegment()
• public string generateURLSegment()
• public string getStageURLSegment()
• public string getLiveURLSegment()
• public ArrayList DependentPages()
• public DataList VirtualPages()
• public FieldList getCMSFields()
• public FieldList getSettingsFields()
• public array fieldLabels()
• public FieldList getCMSActions()
• public void onAfterPublish()
• public void onAfterRevertToLive()
• protected bool isParentArchived()
• public SiteTree doRestoreToStage()
• public bool isNew()
• protected array getClassDropdown()
• public array allowedChildren()
• public string defaultChild()
• public string defaultParent()
• public string getMenuTitle()
• public void setMenuTitle()
• public array getStatusFlags()
• public string getTreeTitle()
• public SiteTree Level()
• public int getPageLevel()
• public string getControllerName()
• public string CMSTreeClasses()
• public static void disableCMSFieldsExtensions()
• public static void enableCMSFieldsExtensions()
• public void providePermissions()
• public string singular_name()
• public string plural_name()
• public string|null classDescription()
• public string|null i18n_classDescription()
• public array provideI18nEntities()
• public string getParentType()
• public static void reset()
• protected void updateDependentPages()
}


Hierarchy

Extends

• SilverStripe\ORM\DataObject

Implements

• SilverStripe\Security\PermissionProvider
• SilverStripe\i18n\i18nEntityProvider
• SilverStripe\ORM\CMSPreviewable
• SilverStripe\Core\Resettable

Tasks

Line	Task
1304+	Move <title> tag in separate getter for easier customization and more obvious usage

Members

private

• $allowed_children — array
  Indicates what kind of children this page type can have.
• $base_description — string
  Description for Page and SiteTree classes, but not inherited by subclasses.
• $base_plural_name — string
  Plural form for SiteTree / Page classes. Not inherited by subclasses.
• $base_singular_name — string
  Plural form for SiteTree / Page classes. Not inherited by subclasses.
• $can_be_root — SilverStripe\CMS\Model\bool
  Controls whether a page can be in the root of the site tree.
• $can_create — boolean
  If this is false, the class cannot be created in the CMS by regular content authors, only by ADMINs.
• $cascade_deletes
• $casting
• $create_default_pages
• $db
• $default_child — string
  The default child class for this page.
• $default_classname — string
  Default value for SiteTree.ClassName enum {@see DBClassName::getDefault}
• $default_parent — string
  The default parent class for this page.
• $default_sort
• $defaults
• $description — string
  Description of the class functionality, typically shown to a user when selecting which page type to create. Translated through {@link provideI18nEntities()}.
• $enforce_strict_hierarchy — boolean
• $extensions
• $field_labels
• $has_many
• $hide_ancestor — string
  If you extend a class, and don't want to be able to select the old class in the cms, set this to the old class name. Eg, if you extended Product to make ImprovedProduct, then you would set $hide_ancestor to Product.
• $icon — string
  Icon to use in the CMS page tree. This should be the full filename, relative to the webroot.
• $indexes
• $meta_generator — string
  The value used for the meta generator tag. Leave blank to omit the tag.
• $need_permission — array
  List of permission codes a user can have to allow a user to create a page of this type.
• $nested_urls
• $owned_by
• $runCMSFieldsExtensions
  This controls whether of not extendCMSFields() is called by getCMSFields.
• $searchable_fields
• $table_name
• $versioning

protected

• $_allowedChildren — array
  Used as a cache for `self::allowedChildren()` Drastically reduces admin page load when there are a lot of page types
• $_cache_statusFlags

Methods

protected

• getClassDropdown() — Get the class dropdown used in the CMS to change the class of a page. This returns the list of options in the dropdown as a Map from class name to singular name. Filters by {@link SiteTree->canCreate()}, as well as {@link SiteTree::$needs_permission}.
• isParentArchived() — Determine if this page references a parent which is archived, and not available in stage
• onBeforeWrite()
• updateDependentPages() — Update dependant pages

public

• AbsoluteLink() — Get the absolute URL for this page, including protocol and host.
• Breadcrumbs() — Return a breadcrumb trail to this page. Excludes "hidden" pages (with ShowInMenus=0) by default.
• CMSEditLink() — Generates a link to edit this page in the CMS.
• CMSTreeClasses() — Return the CSS classes to apply to this node in the CMS tree.
• ContentSource() — Returns the object that contains the content that a user would associate with this page.
• DependentPages() — Returns the pages that depend on this page. This includes virtual pages, pages that link to it, etc.
• ElementName() — Return a CSS identifier generated from this page's link.
• InSection() — Check if this page is in the given current section.
• Level() — Returns the page in the current page stack of the given level. Level(1) will return the main menu item that we're currently inside, etc.
• Link() — Return the link for this {@link SiteTree} object, with the {@link Director::baseURL()} included.
• LinkOrCurrent() — Return "link" or "current" depending on if this is the {@link SiteTree::isCurrent()} current page.
• LinkOrSection() — Return "link" or "section" depending on if this is the {@link SiteTree::isSeciton()} current section.
• LinkingMode() — Return "link", "current" or "section" depending on if this page is the current page, or not on the current page but in the current section.
• MetaTags() — Return the title, description, keywords and language metatags.
• NestedTitle() — Return a string of the form "parent - page" or "grandparent - parent - page" using page titles
• PreviewLink() — Base link used for previewing. Defaults to absolute URL, in order to account for domain changes, e.g. on multi site setups. Does not contain hints about the stage, see {@link SilverStripeNavigator} for details.
• RelativeLink() — Return the link for this {@link SiteTree} object relative to the SilverStripe root.
• VirtualPages() — Return all virtual pages that link to this page.
• allowedChildren() — Returns an array of the class names of classes that are allowed to be children of this class.
• can() — This function should return true if the current user can execute this action. It can be overloaded to customise the security model for an application.
• canAddChildren() — This function should return true if the current user can add children to this page. It can be overloaded to customise the security model for an application.
• canCreate() — This function should return true if the current user can create new pages of this class, regardless of class. It can be overloaded to customise the security model for an application.
• canDelete() — This function should return true if the current user can delete this page. It can be overloaded to customise the security model for an application.
• canEdit() — This function should return true if the current user can edit this page. It can be overloaded to customise the security model for an application.
• canPublish() — Check if this page can be published
• canView() — This function should return true if the current user can view this page. It can be overloaded to customise the security model for an application.
• classDescription() — Get description for this page type
• collateDescendants() — Collate selected descendants of this page.
• defaultChild() — Returns the class name of the default class for children of this page.
• defaultParent() — Returns the class name of the default class for the parent of this page.
• disableCMSFieldsExtensions() — Stops extendCMSFields() being called on getCMSFields(). This is useful when you need access to fields added by subclasses of SiteTree in a extension. Call before calling parent::getCMSFields(), and reenable afterwards.
• doRestoreToStage() — Restore the content in the active copy of this SiteTree page to the stage site.
• duplicateAsChild() — Duplicate this node and its children as a child of the node with the given ID
• duplicateWithChildren() — Duplicates each child of this node recursively and returns the top-level duplicate node.
• enableCMSFieldsExtensions() — Reenables extendCMSFields() being called on getCMSFields() after it has been disabled by disableCMSFieldsExtensions().
• fieldLabels()
• flushCache()
• generateURLSegment() — Generate a URL segment based on the title provided.
• getAbsoluteLiveLink() — Get the absolute URL for this page on the Live site.
• getBreadcrumbItems() — Returns a list of breadcrumbs for the current page.
• getCMSActions() — Get the actions available in the CMS for this page - eg Save, Publish.
• getCMSFields() — Returns a FieldList with which to create the main editing form.
• getControllerName() — Find the controller name by our convention of {$ModelClass}Controller
• getLiveURLSegment() — Gets the URL segment for the currently published version of this page.
• getMenuTitle() — Get the title for use in menus for this page. If the MenuTitle field is set it returns that, else it returns the Title field.
• getMimeType()
• getPageLevel() — Gets the depth of this page in the sitetree, where 1 is the root level
• getParent() — Get the parent of this page.
• getParentType() — Returns 'root' if the current page has no parent, or 'subpage' otherwise
• getPermissionChecker()
• getSettingsFields() — Returns fields related to configuration aspects on this record, e.g. access control. See {@link getCMSFields()} for content-related fields.
• getSiteConfig() — Stub method to get the site config, unless the current class can provide an alternate.
• getStageURLSegment() — Gets the URL segment for the latest draft version of this page.
• getStatusFlags() — A flag provides the user with additional data about the current page status, for example a "removed from draft" status. Each page can have more than one status flag. Returns a map of a unique key to a (localized) title for the flag. The unique key can be reused as a CSS class. Use the 'updateStatusFlags' extension point to customize the flags.
• getTreeTitle() — getTreeTitle will return three <span> html DOM elements, an empty <span> with the class 'jstree-pageicon' in front, following by a <span> wrapping around its MenutTitle, then following by a <span> indicating its publication status.
• get_by_link() — Fetches the {@link SiteTree} object that maps to a link.
• i18n_classDescription() — Get localised description for this page
• isCurrent() — Returns true if this is the currently active page being used to handle this request.
• isNew() — Check if this page is new - that is, if it has yet to have been written to the database.
• isOrphaned() — Check if the parent of this page has been removed (or made otherwise unavailable), and is still referenced by this child. Any such orphaned page may still require access via the CMS, but should not be shown as accessible to external users.
• isSection() — Check if this page is in the currently active section (e.g. it is either current or one of its children is currently being viewed).
• link_shortcode_handler() — Replace a "[sitetree_link id=n]" shortcode with a link to the page with the corresponding ID.
• onAfterDelete()
• onAfterPublish()
• onAfterRevertToLive() — Update draft dependant pages
• onBeforeDelete()
• onBeforeDuplicate() — Reset Sort on duped page
• page_type_classes() — Return a subclass map of SiteTree that shouldn't be hidden through {@link SiteTree::$hide_ancestor}
• plural_name() — Default plural name for page / sitetree
• provideI18nEntities() — Overloaded to also provide entities for 'Page' class which is usually located in custom code, hence textcollector picks it up for the wrong folder.
• providePermissions()
• requireDefaultRecords() — Add default records to database.
• reset() — Clear the permissions cache for SiteTree
• setMenuTitle() — Set the menu title for this page.
• setParent() — Make this page a child of another page.
• singular_name() — Default singular name for page / sitetree
• syncLinkTracking() — Trigger synchronisation of link tracking
• validURLSegment() — Returns true if this object has a URLSegment value that does not conflict with any other objects. This method checks for: - A page with the same URLSegment that has a conflict - Conflicts with actions on the parent page - A conflict caused by a root page having the same URLSegment as a class name
• validate()