API Update site tree hierarchy to use a MarkingSet and template

This commit is contained in:
Damian Mooyman 2017-04-06 17:38:15 +12:00
parent 904f18cc48
commit d75a3cb0e9
7 changed files with 133 additions and 316 deletions

View File

@ -4,6 +4,7 @@ namespace SilverStripe\CMS\Controllers;
use SilverStripe\Admin\AdminRootController; use SilverStripe\Admin\AdminRootController;
use SilverStripe\Admin\CMSBatchActionHandler; use SilverStripe\Admin\CMSBatchActionHandler;
use SilverStripe\Admin\LeftAndMain_SearchFilter;
use SilverStripe\Admin\LeftAndMainFormRequestHandler; use SilverStripe\Admin\LeftAndMainFormRequestHandler;
use SilverStripe\CMS\Model\VirtualPage; use SilverStripe\CMS\Model\VirtualPage;
use SilverStripe\Forms\Tab; use SilverStripe\Forms\Tab;
@ -50,6 +51,7 @@ use SilverStripe\ORM\DataObject;
use SilverStripe\ORM\DB; use SilverStripe\ORM\DB;
use SilverStripe\ORM\FieldType\DBHTMLText; use SilverStripe\ORM\FieldType\DBHTMLText;
use SilverStripe\ORM\HiddenClass; use SilverStripe\ORM\HiddenClass;
use SilverStripe\ORM\Hierarchy\MarkedSet;
use SilverStripe\ORM\SS_List; use SilverStripe\ORM\SS_List;
use SilverStripe\ORM\ValidationResult; use SilverStripe\ORM\ValidationResult;
use SilverStripe\SiteConfig\SiteConfig; use SilverStripe\SiteConfig\SiteConfig;
@ -429,132 +431,112 @@ class CMSMain extends LeftAndMain implements CurrentPageIdentifier, PermissionPr
$filterFunction = null, $filterFunction = null,
$nodeCountThreshold = 30 $nodeCountThreshold = 30
) { ) {
// Provide better defaults from filter
// Filter criteria
$filter = $this->getSearchFilter(); $filter = $this->getSearchFilter();
if ($filter) {
// Default childrenMethod and numChildrenMethod
if (!$childrenMethod) { if (!$childrenMethod) {
$childrenMethod = ($filter && $filter->getChildrenMethod()) $childrenMethod = $filter->getChildrenMethod();
? $filter->getChildrenMethod()
: 'AllChildrenIncludingDeleted';
} }
if (!$numChildrenMethod) { if (!$numChildrenMethod) {
$numChildrenMethod = 'numChildren';
if ($filter && $filter->getNumChildrenMethod()) {
$numChildrenMethod = $filter->getNumChildrenMethod(); $numChildrenMethod = $filter->getNumChildrenMethod();
} }
} if (!$filterFunction) {
if (!$filterFunction && $filter) {
$filterFunction = function ($node) use ($filter) { $filterFunction = function ($node) use ($filter) {
return $filter->isPageIncluded($node); return $filter->isPageIncluded($node);
}; };
} }
// Get the tree root
$record = ($rootID) ? $this->getRecord($rootID) : null;
$obj = $record ? $record : singleton($className);
// Get the current page
// NOTE: This *must* be fetched before markPartialTree() is called, as this
// causes the Hierarchy::$marked cache to be flushed (@see CMSMain::getRecord)
// which means that deleted pages stored in the marked tree would be removed
$currentPage = $this->currentPage();
// Mark the nodes of the tree to return
if ($filterFunction) {
$obj->setMarkingFilterFunction($filterFunction);
} }
$obj->markPartialTree($nodeCountThreshold, $this, $childrenMethod, $numChildrenMethod); // Build set from node and begin marking
$record = ($rootID) ? $this->getRecord($rootID) : null;
$rootNode = $record ? $record : DataObject::singleton($className);
$markingSet = MarkedSet::create($rootNode, $childrenMethod, $numChildrenMethod, $nodeCountThreshold);
// Set filter function
if ($filterFunction) {
$markingSet->setMarkingFilterFunction($filterFunction);
}
// Mark tree from this node
$markingSet->markPartialTree();
// Ensure current page is exposed // Ensure current page is exposed
$currentPage = $this->currentPage();
if ($currentPage) { if ($currentPage) {
$obj->markToExpose($currentPage); $markingSet->markToExpose($currentPage);
} }
// Pre-cache permissions
SiteTree::prepopulate_permission_cache( SiteTree::prepopulate_permission_cache(
'CanEditType', 'CanEditType',
$obj->markedNodeIDs(), $markingSet->markedNodeIDs(),
[ SiteTree::class, 'can_edit_multiple'] [ SiteTree::class, 'can_edit_multiple']
); );
// getChildrenAsUL is a flexible and complex way of traversing the tree // Render using full-subtree template
$controller = $this; return $markingSet->renderChildren(
$recordController = CMSPageEditController::singleton(); [ self::class . '_SubTree', 'type' => 'Includes' ],
$titleFn = function (&$child, $numChildrenMethod) use (&$controller, &$recordController, $filter) { $this->getTreeNodeCustomisations()
$link = Controller::join_links($recordController->Link("show"), $child->ID); );
$node = CMSTreeNode::create($child, $link, $controller->isCurrentPage($child), $numChildrenMethod, $filter);
return $node->forTemplate();
};
// Limit the amount of nodes shown for performance reasons.
// Skip the check if we're filtering the tree, since its not clear how many children will
// match the filter criteria until they're queried (and matched up with previously marked nodes).
$nodeThresholdLeaf = SiteTree::config()->get('node_threshold_leaf');
if ($nodeThresholdLeaf && !$filterFunction) {
$nodeCountCallback = function ($parent, $numChildren) use (&$controller, $nodeThresholdLeaf) {
if (!$parent->ID || $numChildren <= $nodeThresholdLeaf) {
return null;
} }
return sprintf(
'<ul><li class="readonly"><span class="item">'
. '%s (<a href="%s" class="cms-panel-link" data-pjax-target="Content">%s</a>)' /**
. '</span></li></ul>', * Get callback to determine template customisations for nodes
_t('LeftAndMain.TooManyPages', 'Too many pages'), *
Controller::join_links( * @return callable
$controller->LinkWithSearch($controller->Link()), */
'?view=listview&ParentID=' . $parent->ID protected function getTreeNodeCustomisations()
{
$rootTitle = $this->getCMSTreeTitle();
$linkWithSearch = $this->LinkWithSearch($this->Link());
return function (SiteTree $node) use ($linkWithSearch, $rootTitle) {
return [
'listViewLink' => Controller::join_links(
$linkWithSearch,
'?view=listview&ParentID=' . $node->ID
), ),
_t( 'rootTitle' => $rootTitle,
'LeftAndMain.ShowAsList', 'extraClass' => $this->getTreeNodeClasses($node),
'show as list', ];
'Show large amount of pages in list instead of tree view'
)
);
}; };
} else {
$nodeCountCallback = null;
} }
// If the amount of pages exceeds the node thresholds set, use the callback /**
$html = null; * Get extra CSS classes for a page's tree node
if ($obj->ParentID && $nodeCountCallback) { *
$html = $nodeCountCallback($obj, $obj->$numChildrenMethod()); * @param SiteTree $node
* @return string
*/
public function getTreeNodeClasses(SiteTree $node)
{
// Get classes from object
$classes = $node->CMSTreeClasses();
// Flag as current
if ($this->isCurrentPage($node)) {
$classes .= ' current';
} }
// Otherwise return the actual tree (which might still filter leaf thresholds on children) // Get status flag classes
if (!$html) { $flags = $node->getStatusFlags();
$html = $obj->getChildrenAsUL( if ($flags) {
"", $statuses = array_keys($flags);
$titleFn, foreach ($statuses as $s) {
CMSPagesController::singleton(), $classes .= ' status-' . $s;
true, }
$childrenMethod,
$numChildrenMethod,
$nodeCountThreshold,
$nodeCountCallback
);
} }
// Wrap the root if needs be. // Get additional filter classes
if (!$rootID) { $filter = $this->getSearchFilter();
// This lets us override the tree title with an extension if ($filter && ($filterClasses = $filter->getPageClasses($node))) {
if ($this->hasMethod('getCMSTreeTitle') && $customTreeTitle = $this->getCMSTreeTitle()) { if (is_array($filterClasses)) {
$treeTitle = $customTreeTitle; $filterClasses = implode(' ', $filterClasses);
} elseif (class_exists(SiteConfig::class)) { }
$siteConfig = SiteConfig::current_site_config(); $classes .= ' ' . $filterClasses;
$treeTitle = Convert::raw2xml($siteConfig->Title);
} else {
$treeTitle = '...';
} }
$html = "<ul><li id=\"record-0\" data-id=\"0\" class=\"Root nodelete\"><strong>$treeTitle</strong>" return trim($classes);
. $html . "</li></ul>";
}
return $html;
} }
/** /**
@ -604,7 +586,13 @@ class CMSMain extends LeftAndMain implements CurrentPageIdentifier, PermissionPr
if (!$record) { if (!$record) {
continue; // In case a page is no longer available continue; // In case a page is no longer available
} }
$recordController = CMSPageEditController::singleton();
// Create marking set with sole marked root
$markingSet = MarkedSet::create($record);
$markingSet->setMarkingFilterFunction(function () {
return false;
});
$markingSet->markUnexpanded($record);
// Find the next & previous nodes, for proper positioning (Sort isn't good enough - it's not a raw offset) // Find the next & previous nodes, for proper positioning (Sort isn't good enough - it's not a raw offset)
// TODO: These methods should really be in hierarchy - for a start it assumes Sort exists // TODO: These methods should really be in hierarchy - for a start it assumes Sort exists
@ -624,8 +612,11 @@ class CMSMain extends LeftAndMain implements CurrentPageIdentifier, PermissionPr
->first(); ->first();
} }
$link = Controller::join_links($recordController->Link("show"), $record->ID); // Render using single node template
$html = CMSTreeNode::create($record, $link, $this->isCurrentPage($record))->forTemplate(). '</li>'; $html = $markingSet->renderChildren(
[ self::class . '_TreeNode', 'type' => 'Includes'],
$this->getTreeNodeCustomisations()
);
$data[$id] = array( $data[$id] = array(
'html' => $html, 'html' => $html,
@ -2087,4 +2078,16 @@ class CMSMain extends LeftAndMain implements CurrentPageIdentifier, PermissionPr
) )
); );
} }
/**
* Get title for root CMS node
*
* @return string
*/
protected function getCMSTreeTitle()
{
$rootTitle = SiteConfig::current_site_config()->Title;
$this->extend('updateCMSTreeTitle', $rootTitle);
return $rootTitle;
}
} }

View File

@ -1,200 +0,0 @@
<?php
namespace SilverStripe\CMS\Controllers;
use SilverStripe\Admin\LeftAndMain_SearchFilter;
use SilverStripe\CMS\Model\SiteTree;
use SilverStripe\View\SSViewer;
use SilverStripe\View\ViewableData;
/**
* Wrapper around objects being displayed in a tree.
* Caution: Volatile API.
*
* @todo Implement recursive tree node rendering.
*/
class CMSTreeNode extends ViewableData
{
/**
* Object represented by this node
*
* @var SiteTree
*/
protected $obj;
/**
* Edit link to the current record in the CMS
*
* @var string
*/
protected $link;
/**
* True if this is the currently selected node in the tree
*
* @var bool
*/
protected $isCurrent;
/**
* Name of method to count the number of children
*
* @var string
*/
protected $numChildrenMethod;
/**
*
* @var LeftAndMain_SearchFilter
*/
protected $filter;
/**
* @param Object $obj
* @param string $link
* @param bool $isCurrent
* @param string $numChildrenMethod
* @param LeftAndMain_SearchFilter $filter
*/
public function __construct(
$obj,
$link = null,
$isCurrent = false,
$numChildrenMethod = 'numChildren',
$filter = null
) {
parent::__construct();
$this->obj = $obj;
$this->link = $link;
$this->isCurrent = $isCurrent;
$this->numChildrenMethod = $numChildrenMethod;
$this->filter = $filter;
}
/**
* Returns template, for further processing by {@link Hierarchy->getChildrenAsUL()}.
* Does not include closing tag to allow this method to inject its own children.
*
* @todo Remove hardcoded assumptions around returning an <li>, by implementing recursive tree node rendering
*
* @return string
*/
public function forTemplate()
{
$obj = $this->obj;
return (string)SSViewer::execute_template(
[ 'type' => 'Includes', self::class ],
$obj,
array(
'Classes' => $this->getClasses(),
'Link' => $this->getLink(),
'Title' => sprintf(
'(%s: %s) %s',
trim(_t('LeftAndMain.PAGETYPE', 'Page type'), " :"),
$obj->i18n_singular_name(),
$obj->Title
),
)
);
}
/**
* Determine the CSS classes to apply to this node
*
* @return string
*/
public function getClasses()
{
// Get classes from object
$classes = $this->obj->CMSTreeClasses($this->numChildrenMethod);
if ($this->isCurrent) {
$classes .= ' current';
}
// Get status flag classes
$flags = $this->obj->hasMethod('getStatusFlags')
? $this->obj->getStatusFlags()
: false;
if ($flags) {
$statuses = array_keys($flags);
foreach ($statuses as $s) {
$classes .= ' status-' . $s;
}
}
// Get additional filter classes
if ($this->filter && ($filterClasses = $this->filter->getPageClasses($this->obj))) {
if (is_array($filterClasses)) {
$filterClasses = implode(' ', $filterClasses);
}
$classes .= ' ' . $filterClasses;
}
return $classes ?: '';
}
/**
* Get page backing this node
*
* @return SiteTree
*/
public function getObj()
{
return $this->obj;
}
/**
* Set object backing this node
*
* @param SiteTree $obj
* @return $this
*/
public function setObj($obj)
{
$this->obj = $obj;
return $this;
}
/**
* Get link to this node
*
* @return string
*/
public function getLink()
{
return $this->link;
}
/**
* Set link to this node
*
* @param string $link
* @return $this
*/
public function setLink($link)
{
$this->link = $link;
return $this;
}
/**
* Check if this is the currently selected node
*
* @return bool
*/
public function getIsCurrent()
{
return $this->isCurrent;
}
/**
* Set this node to current, or not current
*
* @param bool $bool
* @return $this
*/
public function setIsCurrent($bool)
{
$this->isCurrent = $bool;
return $this;
}
}

View File

@ -46,6 +46,7 @@ use SilverStripe\ORM\DataObject;
use SilverStripe\ORM\DB; use SilverStripe\ORM\DB;
use SilverStripe\ORM\HiddenClass; use SilverStripe\ORM\HiddenClass;
use SilverStripe\ORM\Hierarchy\Hierarchy; use SilverStripe\ORM\Hierarchy\Hierarchy;
use SilverStripe\ORM\Hierarchy\MarkedSet;
use SilverStripe\ORM\ManyManyList; use SilverStripe\ORM\ManyManyList;
use SilverStripe\ORM\ValidationResult; use SilverStripe\ORM\ValidationResult;
use SilverStripe\Versioned\Versioned; use SilverStripe\Versioned\Versioned;
@ -2966,10 +2967,9 @@ class SiteTree extends DataObject implements PermissionProvider, i18nEntityProvi
/** /**
* Return the CSS classes to apply to this node in the CMS tree. * Return the CSS classes to apply to this node in the CMS tree.
* *
* @param string $numChildrenMethod
* @return string * @return string
*/ */
public function CMSTreeClasses($numChildrenMethod = "numChildren") public function CMSTreeClasses()
{ {
$classes = sprintf('class-%s', static::class); $classes = sprintf('class-%s', static::class);
if ($this->HasBrokenFile || $this->HasBrokenLink) { if ($this->HasBrokenFile || $this->HasBrokenLink) {
@ -2992,13 +2992,6 @@ class SiteTree extends DataObject implements PermissionProvider, i18nEntityProvi
$classes .= " notinmenu"; $classes .= " notinmenu";
} }
//TODO: Add integration
/*
if($this->hasExtension('Translatable') && $controller->Locale != Translatable::default_locale() && !$this->isTranslation())
$classes .= " untranslated ";
*/
$classes .= $this->markingClasses($numChildrenMethod);
return $classes; return $classes;
} }

View File

@ -7,6 +7,7 @@ use SilverStripe\Forms\LiteralField;
use SilverStripe\Forms\ReadonlyTransformation; use SilverStripe\Forms\ReadonlyTransformation;
use SilverStripe\Forms\TreeDropdownField; use SilverStripe\Forms\TreeDropdownField;
use SilverStripe\ORM\DataObject; use SilverStripe\ORM\DataObject;
use SilverStripe\ORM\Hierarchy\MarkedSet;
use SilverStripe\ORM\ValidationResult; use SilverStripe\ORM\ValidationResult;
use SilverStripe\Versioned\Versioned; use SilverStripe\Versioned\Versioned;
use SilverStripe\Security\Member; use SilverStripe\Security\Member;
@ -354,13 +355,9 @@ class VirtualPage extends Page
$this->ImageTracking()->setByIDList($this->CopyContentFrom()->ImageTracking()->column('ID')); $this->ImageTracking()->setByIDList($this->CopyContentFrom()->ImageTracking()->column('ID'));
} }
/** public function CMSTreeClasses()
* @param string $numChildrenMethod
* @return string
*/
public function CMSTreeClasses($numChildrenMethod = "numChildren")
{ {
return parent::CMSTreeClasses($numChildrenMethod) . ' VirtualPage-' . $this->CopyContentFrom()->ClassName; return parent::CMSTreeClasses() . ' VirtualPage-' . $this->CopyContentFrom()->ClassName;
} }
/** /**

View File

@ -0,0 +1,21 @@
<!-- Only render root node if it's the true root -->
<% if not $node.IsInDB %>
<ul><li id="record-0" data-id="0" class="Root nodelete"><strong>$rootTitle</strong>
<% end_if %>
<% if $limited %>
<ul><li class="readonly">
<span class="item">
<%t LeftAndMain.TooManyPages 'Too many pages' %>
(<a href="{$listViewLink.ATT}" class="cms-panel-link" data-pjax-target="Content">
<%t LeftAndMain.ShowAsList 'show as list' %>
</a>)
</span>
</li></ul>
<% else_if $children %>
<ul>
<% loop $children %><% include SilverStripe\\CMS\\Controllers\\CMSMain_TreeNode %><% end_loop %>
</ul>
<% end_if %>
<% if not $node.IsInDB %>
</li></ul>
<% end_if %>

View File

@ -0,0 +1,7 @@
<li id="record-{$node.ID}" data-id="{$node.ID}" data-pagetype="{$node.ClassName}" class="$markingClasses $extraClass">
<ins class="jstree-icon">&nbsp;</ins>
<a href="{$node.CMSEditLink.ATT}" title="{$node.Title.ATT}"><ins class="jstree-icon">&nbsp;</ins>
<span class="text">{$node.TreeTitle}</span>
</a>
$SubTree
</li>

View File

@ -1,4 +0,0 @@
<li id="record-$ID" data-id="$ID" data-pagetype="$ClassName" class="$Classes"><ins class="jstree-icon">&nbsp;</ins>
<a href="$Link" title="$Title.ATT"><ins class="jstree-icon">&nbsp;</ins>
<span class="text">$TreeTitle</span>
</a>