[ExtJS] Расширяем компонент Collections

Не оптимизирован==1||Оптимизирован==2||Не требует оптимизации==3

1. Удаляем папки и файлы:
   

   /extCollections/assets/components/extcollections/js/mgr/sections/
   /extCollections/assets/components/extcollections/js/mgr/widgets/
   /extCollections/assets/components/extcollections/js/mgr/misc/
   /extCollections/assets/components/extcollections/css/
   /extCollections/core/components/extcollections/controllers/
   /extCollections/core/components/extcollections/elements/chunks/
   /extCollections/core/components/extcollections/elements/snippets/
   /extCollections/core/components/extcollections/elements/templates/
   /extCollections/core/components/extcollections/model/schema/
   /extCollections/core/components/extcollections/model/extcollections/mysql/
   /extCollections/core/components/extcollections/model/extcollections/extcollectionsitem.class.php
   /extCollections/core/components/extcollections/model/extcollections/metadata.mysql.php
   /extCollections/core/components/extcollections/processors/mgr/item/
   /extCollections/_build/properties/
   /extCollections/_build/resolvers/



2. Заменяем всё содержимое файла /extCollections/_build/data/transport.chunks.php на:
   

   <?php
   $BUILD_CHUNKS = array();
   return array();

   
   
3. Заменяем всё содержимое в файлах:
   

   /extCollections/_build/data/transport.menu.php
   /extCollections/_build/data/transport.settings.php
   /extCollections/_build/data/transport.snippets.php

   на:
   

   <?php
   return array();

   
   
4. В файле /extCollections/_build/build.config.php меняем версию на 1.0.0 (не обязательно), а также в самом низу файла опустошаем массив $BUILD_RESOLVERS:
   

   $BUILD_RESOLVERS = array();

   
   
5. В файле /extCollections/_build/build.transport.php на строках 13-15 комментируем подключение файла build.model.php:
   

   // if (file_exists('build.model.php')) {
   //     require_once 'build.model.php';
   // }

   
   
6. В файле /extCollections/_build/data/transport.plugins.php добавляем плагин на событие OnDocFormPrerender:
   

   $tmp = array(
       'extCollections' => array(
           'file' => 'extcollections',
           'description' => '',
           'events' => array(
               'OnDocFormPrerender' => array(),
           )
       ),
   );

   
   
7. Создаём файл плагина в /extCollections/core/components/extcollections/elements/plugins/plugin.extcollections.php с содержимым:
   

   <?php
   if ($modx->event->name != 'OnDocFormPrerender' || $modx->context->key != 'mgr' || !is_object($resource)) {
       return;
   }
   
   $core_path = $modx->getOption('core_path') . 'components/extcollections/';
   $assets_url = $modx->getOption('assets_url') . 'components/extcollections/';
   $connector_url = $assets_url . 'connector.php';
   
   $modx->controller->addHtml("<script type=\"text/javascript\">
       extCollectionsConfig = {
           connectorUrl: \"{$connector_url}\",
       };
   </script>");
   
   $modx->controller->addJavascript($assets_url .'js/mgr/extcollections.js');
   $modx->controller->addLastJavascript($assets_url .'js/mgr/collections/ext.js');

   Как видно из этого кода, мы вначале подключаем конфиг со свойством connectorUrl равным /assets/components/extcollections/connector.php. После чего подключаем основной файл /assets/components/extcollections/js/mgr/extcollections.js, в котором создаётся и объявляется наш класс extCollections. Далее, подключаем файл /assets/components/extcollections/js/mgr/collections/ext.js, в котором у нас и будет происходить вся основная логика по расширению функционала Collections.
   
   
8. Создаём файл /extCollections/assets/components/extcollections/js/mgr/collections/ext.js и добавляем в него такое содержимое:
   

   // Добавляем свои элементы в меню "Массовые действия"
   Ext.ComponentMgr.onAvailable('collections-grid-container-collections', function () {
       this.on('beforerender', function () {
           // Распечатываем в консоль объект this, чтобы найти в дереве свойств расположение меню
           // console.log('this', this);
           
           // Благодаря коду выше мы узнали, что кнопка "Массовые действия"
           // находится по адресу this.topToolbar.items.items[0].items.items[1]
           // Присваиваем её переменной, чтобы было проще с работать
           var btn = this.topToolbar.items.items[0].items.items[1];
           
           // Добавляем разделитель под оригинальными пунктами пакета Collections
           btn.menu.addMenuItem({
               xtype: 'menuseparator',
           });
           
           // Добавляем наши кастомные пункты меню
           btn.menu.addMenuItem({
               text: 'Изменить статус на "Не оптимизирован"',
               handler: extCollections.utils.setTVValue,
               scope: this,
               tvName: 'status',
               tvValue: 1,
           });
           btn.menu.addMenuItem({
               text: 'Изменить статус на "Оптимизирован"',
               handler: extCollections.utils.setTVValue,
               scope: this,
               tvName: 'status',
               tvValue: 2,
           });
           btn.menu.addMenuItem({
               text: 'Изменить статус на "Не требует оптимизации"',
               handler: extCollections.utils.setTVValue,
               scope: this,
               tvName: 'status',
               tvValue: 3,
           });
       });
   });

   В этом куске кода мы, на событие beforerender гриды #collections-grid-container-collections, повесили добавление своих пунктов меню в выпадающую кнопку «Массовые действия».
   
   В этом же файле пишем обработчик действия по кнопке:
   

   extCollections.utils.setTVValue = function (btn, e) {
       // В объекте btn хранятся свойства, которые мы прописали при добавлении элемента в меню.
       // Отсюда, мы получаем название ТВ поля и значение, которое необходимо установить.
       var tv_name = btn['tvName'];
       var tv_value = btn['tvValue'];
       if (typeof(tv_value) == 'undefined') {
           return;
       }
       
       // Объект this хранит в себе информацию о гриде, т.к. при добавлении элемента в меню, мы прописали свойство scope: this.
       // Отсюда, мы получаем список id у выделенных элементов гриды методом getSelectedAsList().
       var ids = this.getSelectedAsList();
       if (ids === false) {
           return false;
       }
   
       // Отправляем Ajax запрос по адресу /assets/components/extcollections/connector.php, в этом файле произойдёт вызов процессора /core/components/extcollections/processors/mgr/resource/settvvalue.class.php
       MODx.Ajax.request({
           url: extCollectionsConfig['connectorUrl'],
           params: {
               action: 'mgr/resource/settvvalue',
               ids: ids,
               name: tv_name,
               value: tv_value,
           },
           listeners: {
               'success': {fn:
                   function() {
                       this.getSelectionModel().clearSelections(true);
                       this.refresh();
                   },
                   scope:this
               }
           }
       });
       
       return true;
   };

   Думаю, тут дополнительные комментарии будут излишни — хватает комментариев в коде.
   
   И, наконец, добавим функцию рендера, которую позже пропишем в настройки вида коллекции:
   

   extCollections.utils.renderTVStatus = function(value) {
       var color = 'white';
       if (value == 1) {
           color = 'red';
       } else if (value == 2) {
           color = 'green';
       } else if (value == 3) {
           color = 'grey';
       }
       
       return '<div style="width: 12px; height: 12px; line-height: 0; background: ' + color + '; border-radius: 50%;"> </div>';
   };

   
   
9. Создаём файл процессора /core/components/extcollections/processors/mgr/resource/settvvalue.class.php:
   

   <?php
   class extCollectionsResourceSetTvValueProcessor extends modObjectProcessor
   {
       public $objectType = 'modResource';
       public $classKey = 'modResource';
       public $languageTopics = array('extcollections');
       
       /**
        * @return array|string
        */
       public function process()
       {
           if (!$this->checkPermissions()) {
               return $this->failure($this->modx->lexicon('access_denied'));
           }
           
           $name = $this->getProperty('name');
           if (empty($name)) {
               return $this->failure('error');
           }
   
           $ids = array_map('trim', explode(',', $this->getProperty('ids')));
           if (empty($ids)) {
               return $this->failure('error');
           }
   
           foreach ($ids as $id) {
               /** @var modResource $obj */
               if (!$obj = $this->modx->getObject($this->classKey, $id)) {
                   return $this->failure('error');
               }
   
               $obj->setTVValue($name, $this->getProperty('value'));
           }
   
           return $this->success();
       }
   }
   return 'extCollectionsResourceSetTvValueProcessor';