Improved tree docs

silverstripe · Aug 5, 2012 · b4e3c13 · b4e3c13
1 parent bbbec35
commit b4e3c13
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 0 deletions.
diff --git a/docs/en/howto/customize-cms-tree.md b/docs/en/howto/customize-cms-tree.md
@@ -2,6 +2,11 @@
 
 ## Overview
 
+The CMS tree for viewing hierarchical structures (mostly pages) is powered
+by the [jstree](http://jstree.com) library. It is configured through
+`sapphire/admin/javascript/LeftAndMain.Tree.js`, as well as some
+HTML5 metadata generated on its container (see the `data-hints` attribute).
+
 The tree is rendered through `[api:LeftAndMain->getSiteTreeFor()]`,
 which recursively collects all nodes based on various filtering criteria.
 The node strictly just has to implement the `[api:Hierarchy]` extension,

diff --git a/docs/en/reference/cms-architecture.md b/docs/en/reference/cms-architecture.md
@@ -334,6 +334,18 @@ so you don't need to worry about it. The same concept applies for
 'X-Title' (change the window title) and 'X-ControllerURL' (change the URL recorded in browser history).
 Note: You can see any additional HTTP headers through the web developer tools in your browser of choice.
 
+## Tree
+
+The CMS tree for viewing hierarchical structures (mostly pages) is powered
+by the [jstree](http://jstree.com) library. It is configured through
+`sapphire/admin/javascript/LeftAndMain.Tree.js`, as well as some
+HTML5 metadata generated on its container (see the `data-hints` attribute).
+For more information, see the [Howto: Customize the CMS tree](../howto/customize-cms-tree).
+
+Note that a similar tree logic is also used for the 
+form fields to select one or more entries from those hierarchies
+(`[api:TreeDropdownField]` and `[api:TreeMultiselectField]`).
+
 ## Related
 
  * [Howto: Extend the CMS Interface](../howto/extend-cms-interface)