API Stop refering to "pages" when dealing with generic records

silverstripe · Nov 7, 2024 · 555907c · 555907c
1 parent ebd9317
commit 555907c
Show file tree

Hide file tree

Showing 10 changed files with 69 additions and 61 deletions.
diff --git a/client/dist/styles/bundle.css b/client/dist/styles/bundle.css
diff --git a/client/src/styles/legacy/_style.scss b/client/src/styles/legacy/_style.scss
@@ -953,7 +953,7 @@ html, body {
     margin-right: 10px;
   }
 
-  .page-icon {
+  .record-icon {
     display: inline-block;
     margin-right: 6px;
 

diff --git a/client/src/styles/legacy/_tree.scss b/client/src/styles/legacy/_tree.scss
@@ -312,7 +312,7 @@
           color: #FFF;
           border: 0;
           // Specificity override for icons in children pages
-          .jstree-pageicon {
+          .jstree-recordicon {
             color: #FFF;
           }
         }
@@ -324,7 +324,7 @@
         text-decoration: none;
         margin-right: 2px;
       }
-      .jstree-pageicon {
+      .jstree-recordicon {
         margin-top: 3px;
         margin-right: 5px;
       }
@@ -662,7 +662,7 @@
 
 /* Page icons */
 
-.page-icon, a .jstree-pageicon {
+.record-icon, a .jstree-recordicon {
   display: block;
   width: 16px;
   height: 16px;
@@ -673,7 +673,7 @@
   }
 }
 
-a .jstree-pageicon {
+a .jstree-recordicon {
   float: left;
   margin-right: 4px;
   position: relative;
@@ -686,7 +686,7 @@ a .jstree-pageicon {
 }
 
 @mixin tree-status-icon($label, $dotColor, $textColor, $bgColor) {
-  .cms-tree.jstree .status-#{$label} > a .jstree-pageicon:after {
+  .cms-tree.jstree .status-#{$label} > a .jstree-recordicon:after {
     content:"";
     display: block;
     width: 8px;
@@ -709,7 +709,7 @@ a .jstree-pageicon {
     color: $textColor;
   }
   // Dots
-  .cms-tree.jstree .status-#{$label} > a .jstree-pageicon:after  {
+  .cms-tree.jstree .status-#{$label} > a .jstree-recordicon:after  {
     background-color:$dotColor;
     box-shadow: 0 1px 1px rgba(0, 0, 0, 0.3), inset 0 0 0 1px $textColor;
   }
@@ -758,7 +758,7 @@ a .jstree-pageicon {
     .jstree-icon {
       background-image: none !important;
     }
-    .jstree-pageicon {
+    .jstree-recordicon {
       background: url('../../images/throbber.gif') top left no-repeat;
     }
   }

diff --git a/code/CMSBatchAction.php b/code/CMSBatchAction.php
@@ -2,6 +2,7 @@
 
 namespace SilverStripe\Admin;
 
+use SilverStripe\CMS\Controllers\CMSMain;
 use SilverStripe\CMS\Model\SiteTree;
 use SilverStripe\Control\Controller;
 use SilverStripe\Control\HTTPResponse;
@@ -107,9 +108,14 @@ public function batchaction(SS_List $objs, $helperMethod, $successMessage, $argu
 
             // Now make sure the tree title is appropriately updated
             $publishedRecord = DataObject::get_by_id($this->managedClass, $id);
+            if ($publishedRecord instanceof SiteTree) {
+                $treeTitle = CMSMain::singleton()->getRecordTreeMarkup($publishedRecord);
+            } else {
+                $treeTitle = $publishedRecord->TreeTitle;
+            }
             if ($publishedRecord) {
                 $status['modified'][$id] = [
-                    'TreeTitle' => $publishedRecord->TreeTitle,
+                    'TreeTitle' => $treeTitle,
                 ];
             } else {
                 $status['deleted'][$id] = $id;

diff --git a/code/CMSMenu.php b/code/CMSMenu.php
@@ -264,7 +264,7 @@ public static function get_viewable_menu_items($member = null)
                     $controllerObj = singleton($menuItem->controller);
                     if (Controller::has_curr()) {
                         // Necessary for canView() to have request data available,
-                        // e.g. to check permissions against LeftAndMain->currentPage()
+                        // e.g. to check permissions against LeftAndMain->currentRecord()
                         $controllerObj->setRequest(Controller::curr()->getRequest());
                         if (!$controllerObj->canView($member)) {
                             continue;
@@ -379,7 +379,7 @@ public static function get_cms_classes($root = null, $recursive = true, $sort =
         if (!$root) {
             $root = LeftAndMain::class;
         }
-        $abstractClasses = [LeftAndMain::class, CMSMain::class];
+        $abstractClasses = [LeftAndMain::class];
         $subClasses = array_values(ClassInfo::subclassesFor($root) ?? []);
         foreach ($subClasses as $className) {
             if ($recursive && $className != $root) {

diff --git a/code/CMSProfileController.php b/code/CMSProfileController.php
@@ -28,7 +28,7 @@ protected function init()
     {
         parent::init();
         if (!$this->getResponse()->isRedirect()) {
-            $this->setCurrentPageID(Security::getCurrentUser()->ID);
+            $this->setCurrentRecordID(Security::getCurrentUser()->ID);
         }
     }
 

diff --git a/code/LeftAndMain.php b/code/LeftAndMain.php
@@ -95,12 +95,8 @@ class LeftAndMain extends AdminController implements PermissionProvider
      *
      * Determines what is managed in this interface, through
      * {@link getEditForm()} and other logic.
-     *
-     * @config
-     * @var string
-     * @deprecated 5.4.0 Will be renamed to model_class
      */
-    private static $model_class = null;
+    private static ?string $model_class = null;
 
     /**
      * @var array
@@ -745,7 +741,7 @@ public static function menu_icon_class_for_class($class)
     public function show(HTTPRequest $request): HTTPResponse
     {
         if ($request->param('ID')) {
-            $this->setCurrentPageID($request->param('ID'));
+            $this->setCurrentRecordID($request->param('ID'));
         }
         return $this->getResponseNegotiator()->respond($request);
     }
@@ -931,15 +927,23 @@ public function PreviewPanel()
         return null;
     }
 
+    /**
+     * Get the class of the model which is managed by this controller.
+     * @return class-string<DataObject>
+     */
+    public function getModelClass(): string
+    {
+        return static::config()->get('model_class') ?? '';
+    }
+
     /**
      * Get dataobject from the current ID
      *
      * @param int|DataObject $id ID or object
-     * @return DataObject
      */
-    public function getRecord($id)
+    public function getRecord($id): ?DataObject
     {
-        $className = $this->config()->get('model_class');
+        $className = $this->getModelClass();
         if (!$className) {
             return null;
         }
@@ -1005,7 +1009,7 @@ protected function getSearchFilter()
     public function save(array $data, Form $form): HTTPResponse
     {
         $request = $this->getRequest();
-        $className = $this->config()->get('model_class');
+        $className = $this->getModelClass();
 
         // Existing or new record?
         $id = $data['ID'];
@@ -1018,7 +1022,7 @@ public function save(array $data, Form $form): HTTPResponse
                 $this->httpError(404, "Bad record ID #" . (int)$id);
             }
         } else {
-            if (!singleton($this->config()->get('model_class'))->canCreate()) {
+            if (!DataObject::singleton($className)->canCreate()) {
                 return Security::permissionFailure($this);
             }
             $record = $this->getNewItem($id, false);
@@ -1028,7 +1032,7 @@ public function save(array $data, Form $form): HTTPResponse
         $form->saveInto($record, true);
         $record->write();
         $this->extend('onAfterSave', $record);
-        $this->setCurrentPageID($record->ID);
+        $this->setCurrentRecordID($record->ID);
 
         $message = _t(__CLASS__ . '.SAVEDUP', 'Saved.');
         if ($this->getSchemaRequested()) {
@@ -1054,7 +1058,7 @@ public function save(array $data, Form $form): HTTPResponse
      */
     public function getNewItem($id, $setID = true)
     {
-        $class = $this->config()->get('model_class');
+        $class = $this->getModelClass();
         $object = Injector::inst()->create($class);
         if ($setID) {
             $object->ID = $id;
@@ -1064,7 +1068,7 @@ public function getNewItem($id, $setID = true)
 
     public function delete(array $data, Form $form): HTTPResponse
     {
-        $className = $this->config()->get('model_class');
+        $className = $this->getModelClass();
 
         $id = $data['ID'];
         $record = DataObject::get_by_id($className, $id);
@@ -1094,9 +1098,9 @@ public function delete(array $data, Form $form): HTTPResponse
      *
      * This is a "pseudo-abstract" method, usually connected to a {@link getEditForm()}
      * method in an entwine subclass. This method can accept a record identifier,
-     * selected either in custom logic, or through {@link currentPageID()}.
+     * selected either in custom logic, or through {@link currentRecordID()}.
      * The form usually construct itself from {@link DataObject->getCMSFields()}
-     * for the specific managed subclass defined in {@link LeftAndMain::$model_class}.
+     * for the specific managed subclass defined in {@link LeftAndMain::getModelClass()}.
      *
      * @param HTTPRequest $request Passed if executing a HTTPRequest directly on the form.
      * If empty, this is invoked as $EditForm in the template
@@ -1119,7 +1123,7 @@ public function EditForm($request = null)
     public function getEditForm($id = null, $fields = null)
     {
         if (!$id) {
-            $id = $this->currentPageID();
+            $id = $this->currentRecordID();
         }
 
         // Check record exists
@@ -1149,7 +1153,7 @@ public function getEditForm($id = null, $fields = null)
             $fields->push(new HiddenField('ClassName'));
         }
 
-        $modelClass = $this->config()->get('model_class');
+        $modelClass = $this->getModelClass();
         if ($modelClass::has_extension(Hierarchy::class)
             && !$fields->dataFieldByName('ParentID')
         ) {
@@ -1313,7 +1317,7 @@ public function EditFormTools()
      */
     public function batchactions()
     {
-        return new CMSBatchActionHandler($this, 'batchactions', $this->config()->get('model_class'));
+        return new CMSBatchActionHandler($this, 'batchactions', $this->getModelClass());
     }
 
     /**
@@ -1358,7 +1362,7 @@ public function BatchActionsForm()
 
     public function printable()
     {
-        $form = $this->getEditForm($this->currentPageID());
+        $form = $this->getEditForm($this->currentRecordID());
         if (!$form) {
             return false;
         }
@@ -1381,7 +1385,7 @@ public function printable()
     public function getSilverStripeNavigator(?DataObject $record = null)
     {
         if (!$record) {
-            $record = $this->currentPage();
+            $record = $this->currentRecord();
         }
         if ($record && (($record instanceof CMSPreviewable) || $record->has_extension(CMSPreviewable::class))) {
             $navigator = new SilverStripeNavigator($record);
@@ -1396,11 +1400,11 @@ public function getSilverStripeNavigator(?DataObject $record = null)
      * sources (in this order):
      * - GET/POST parameter named 'ID'
      * - URL parameter named 'ID'
-     * - Session value namespaced by classname, e.g. "CMSMain.currentPage"
+     * - Session value namespaced by classname, e.g. "CMSMain.currentRecord"
      *
      * @return int
      */
-    public function currentPageID()
+    public function currentRecordID()
     {
         if ($this->pageID) {
             return $this->pageID;
@@ -1409,9 +1413,9 @@ public function currentPageID()
             return $this->getRequest()->requestVar('ID');
         }
 
-        if ($this->getRequest()->requestVar('CMSMainCurrentPageID') && is_numeric($this->getRequest()->requestVar('CMSMainCurrentPageID'))) {
+        if ($this->getRequest()->requestVar('CMSMainCurrentRecordID') && is_numeric($this->getRequest()->requestVar('CMSMainCurrentRecordID'))) {
             // see GridFieldDetailForm::ItemEditForm
-            return $this->getRequest()->requestVar('CMSMainCurrentPageID');
+            return $this->getRequest()->requestVar('CMSMainCurrentRecordID');
         }
 
         if (isset($this->urlParams['ID']) && is_numeric($this->urlParams['ID'])) {
@@ -1424,34 +1428,34 @@ public function currentPageID()
 
         /** @deprecated */
         $session = $this->getRequest()->getSession();
-        return $session->get($this->sessionNamespace() . ".currentPage") ?: null;
+        return $session->get($this->sessionNamespace() . ".currentRecord") ?: null;
     }
 
     /**
      * Forces the current page to be set in session,
-     * which can be retrieved later through {@link currentPageID()}.
+     * which can be retrieved later through {@link currentRecordID()}.
      * Keep in mind that setting an ID through GET/POST or
      * as a URL parameter will overrule this value.
      *
      * @param int $id
      */
-    public function setCurrentPageID($id)
+    public function setCurrentRecordID($id)
     {
         $this->pageID = $id;
         $id = (int)$id;
         /** @deprecated */
-        $this->getRequest()->getSession()->set($this->sessionNamespace() . ".currentPage", $id);
+        $this->getRequest()->getSession()->set($this->sessionNamespace() . ".currentRecord", $id);
     }
 
     /**
-     * Uses {@link getRecord()} and {@link currentPageID()}
+     * Uses {@link getRecord()} and {@link currentRecordID()}
      * to get the currently selected record.
      *
      * @return DataObject
      */
-    public function currentPage()
+    public function currentRecord()
     {
-        return $this->getRecord($this->currentPageID());
+        return $this->getRecord($this->currentRecordID());
     }
 
     /**
@@ -1461,9 +1465,9 @@ public function currentPage()
      * @param DataObject $record
      * @return bool
      */
-    public function isCurrentPage(DataObject $record)
+    public function isCurrentRecord(DataObject $record)
     {
-        return ($record->ID == $this->currentPageID());
+        return ($record->ID == $this->currentRecordID());
     }
 
     /**
@@ -1522,7 +1526,7 @@ public function CMSVersionNumber()
      */
     public function SwitchView()
     {
-        $page = $this->currentPage();
+        $page = $this->currentRecord();
         if (!$page) {
             return null;
         }

diff --git a/code/LeftAndMain_SearchFilter.php b/code/LeftAndMain_SearchFilter.php
@@ -19,27 +19,27 @@ interface LeftAndMain_SearchFilter
     public function getChildrenMethod();
 
     /**
-     * Method on {@link Hierarchy} objects which is used find the number of children for a parent page
+     * Method on {@link Hierarchy} objects which is used find the number of children for a parent record
      *
      * @return string
      */
     public function getNumChildrenMethod();
 
 
     /**
-     * Returns TRUE if the given page should be included in the tree.
-     * Caution: Does NOT check view permissions on the page.
+     * Returns TRUE if the given record should be included in the tree.
+     * Caution: Does NOT check view permissions on the record.
      *
-     * @param DataObject $page
+     * @param DataObject $record
      * @return bool
      */
-    public function isPageIncluded($page);
+    public function isRecordIncluded($page);
 
     /**
-     * Given a page, determine any additional CSS classes to apply to the tree node
+     * Given a record, determine any additional CSS classes to apply to the tree node
      *
-     * @param DataObject $page
+     * @param DataObject $record
      * @return array|string
      */
-    public function getPageClasses($page);
+    public function getRecordClasses($record);
 }