Расширить таблицу site_content за 5 минут

Обычно расширять таблицу site_content следует если сайт относительно большой, или есть какие-то операции с TV-параметрами, которые начинают потреблять больше ресурсов, чем вы того хотели бы.

Я, честно говоря, заморочнулся прежде чем нашел у одного из гуру MODX нижеследующие решение. К сожалению уже не помню кто имено был автор, но я пытался искать по-разному: "Добавить столбцы в таблицу site_content", "Собственные свои поля в таблицу site_content", "Расширить объект modResource". Надеюсь эта статья будет полезной шпаргалкой не только мне.

Последовательность действий:

1. Создаем в phpMyAdmin дополнительные колонки. Для примера это будет st_unpublished, st_city_id.
   Внимательно пропишите все настройки. Советую смотреть в файл core/model/modx/mysql/modresource.map.inc.php. Тут найдите похожее поле, и посмотрите какие настройки прописаны тут, и что указано в таблице в phpMyAdmin
2. Создаем TV-параметры, которые будeт зеркалом нашей новой настроки. То есть данные будут храниться и в TV, но при этом дублироваться в таблицу modx_site_content

3. Создаем плагин и вставляем туда код, в системных событиях отмечаем OnMODXInit и OnDocFormSave.

   switch ($modx->event->name) {
     case 'OnMODXInit':
       // $modx->loadClass('msOrder');
       $modx->map['modResource']['fields']['st_city_id'] = 0;
       $modx->map['modResource']['fieldMeta']['st_city_id'] = array(
         // Какие настройки указывать тут вы поймете, найдя похожее поле в core/model/modx/mysql/modresource.map.inc.php
         'dbtype' => 'int',
         'precision' => 10,
         'attributes' => 'unsigned',
         'phptype' => 'integer',
         'null' => true,
         'default' => 0
       );
       $modx->map['modResource']['fields']['st_unpublished'] = 0;
       $modx->map['modResource']['fieldMeta']['st_unpublished'] = array(
         'dbtype' => 'tinyint',
         'precision' => '1',
         'attributes' => 'unsigned',
         'phptype' => 'boolean',
         'null' => false,
         'default' => 0
       );
       break;
     case 'OnDocFormSave':
       // Сохраняем ТВ в поле таблицы ресурса
       $resource->set('st_city_id', $resource->getTVValue('city_id'));
       $resource->set('st_unpublished', $resource->getTVValue('st_unpublished'));
       $resource->save();
         break;
   }
   

Соотвественно редактировать эти поля мы будем редактируя TV-поля. Конечно, если речь идет об использовании API, то нужно редактировать напрямую. Но учтите как работает плагин. То есть если вы через API меняете поле в modx_site_content, то следует поменять и значение TV-парамментра, иначе может быть жесть и ужас.