В новой версии добавлена функция load_model() для работы с кастомными таблицами. MODX не умеет работать с таблицами базы данных пока вы не познакомите его с ними. Для этого нужно создать модель таблицы и загрузить её. После этого вам будут доступны методы MODX для работы с ней. Для разработчиков компонентов пока этот вариант не подойдёт. Может в будущем что придумается. А вот для расширения своего сайта поможет самое оно.

Последовательность такая.

Шаг 1. Как обычно создаём таблицу для объектов (для примера modx_objects) через phpMyAdmin.

Шаг 2. Создаём файл для загрузки модели. Например, файл объектов и разместим его в папке core/models/objects.php.

<?php 
// Класс у нашей модели будет называться 'Object'
if (!class_exists('Object')) {
    class Object extends xPDOObject{}
    class Object_mysql extends Object{}
    // Указываем класс и имя таблицы без префикса
    load_model('Object', 'objects', function ($model) {
        /** @var modHelperModelBuilder $model */
        $model->id('id')->pk(); // тип поля unsigned integer и указываем, что это первичный ключ.
        $model->varchar('name', 100)->setDefault('string')->rulePregMatch('invalid','/^[a-zA-Z\s]+$/','Нельзя использовать цифры в названии!');
        $model->text('description')->null()->alias('desc');
        $model->arr('properties')->null(); // array phptype
        $model->int('rid',true)->aggregate('Resource',array('class'=>'modResource','foreign'=>'id','cardinality'=>'one', 'owner'=>'foreign'))->index();
        $model->int('createdby')->unsigned()->aggOneForeign('CreateUser','modUser','id')->index(); 
        $model->int('createdby', true)->aggOneForeign('EditUser','modUser','id')->index(); 
        $model->datetime('createdon'); // Если дата храниться в БД с типом datetime
        $model->bigint('editedon',true)->phpType('datetime');// Если дата храниться в базе в UNIX формате.
    });
}

В этом же файле можно расширить и базовые классы, например, ресурсов и пользователей.

Шаг 3. В плагине загружаем файл.

switch ($modx->event->name) {
	case 'OnMODXInit':
		include_once MODX_CORE_PATH . 'models/objects.php';
		break;
}

Теперь можно спокойно пользоваться xPDO.

$object = $modx->getObject('Object', 1);
$Creater = $object->CreateUser->username;
// Валидация
$obj->set('name', 'Супер 777'); // В модели мы указали правило, запрещающее вводить цифры в название
if (!$obj->validate()) {
    $validator = $obj->getValidator();
    return $validator->getMessages()[0]['message'];
}
$obj->save();

Можно добавлять индексы, связи aggregate и composite, rule для валидации. Всего несколько строчек и дверь xPDO открыта.

В целях оптимизации модель кэшируется. Так что, если вы поменяли модель в файле, нужно удалить файл с кэшированной версией в core/cache/default/название_модели_map.php.

Ещё в этой версии библиотеки добавлены несколько методов в класс коллекции

  • joinGroup — добавление в группу. Для ресурсов и пользователей.
  • // Добавим первых 10 пользователей в группу Manager
    users()->whereIn('id',range(1,10))->joinGroup('Manager');
    
  • leaveGroup — удаление из группы. Для ресурсов и пользователей.
  • whereIn — для условия WHERE field IN (value1,value2,...).
  • whereNotIn — для условия WHERE field NOT IN (value1,value2,...).
  • whereLike — для условия WHERE field LIKE 'value%'.
  • resources()->whereLike('pagetitle', '%продукт%')->get();
    
  • whereNotLike — для условия WHERE field NOT LIKE 'value%'.
  • whereIsNull — для условия WHERE field IS NULL.
  • whereIsNotNull — для условия WHERE field IS NOT NULL.

А также добавлен класс modHelperMailer для функции email(). Позволяет использовать цепочки методов. Его можно использовать и отдельно от функции.

email()
	->to('user1@mail.ru')
	->toUser(5)
	->cc('user2@mail.ru') 
	->subject('Тема письма')
	->content('тело сообщения')
	->from('Администратор')
	->replyTo('admin@gmail.com')
	->attach('/path/to/file1.jpg')
	->attach('/path/to/file2.png')
	->send();

Вроде ничего не забыл. В ближайшее время обновлю документацию.

24 января 2017, 07:22   787     4

Комментарии ()

  1. Павел Устюгофф 09 февраля 2017, 10:57 # 0
    Нахожу ваш сайт полезным ресурсом по modx. Как же я раньше мог упустить его из виду.

    Скажите пожалуйста, а у вас не планируется написание статьи о пошаговом создании дополнения под MODx? Уж больно доходчиво вы умеете объяснять.
    1. Сергей Шлоков 09 февраля 2017, 11:10 # 0
      Спасибо!
      Есть хороший курс на эту тему, по которому многие их нас учились.
      1. Павел Устюгофф 09 февраля 2017, 11:19 # 0
        проходил его. Хочется еще. Свежих мыслей, примеров! от мастера по созданию дополнений.
        1. Сергей Шлоков 09 февраля 2017, 11:32 # +1
          Добавить к нему мне нечего. Кроме того, я всё своё свободное время трачу на изучение Laravel. Это следующая ступень развития разработчика. Позволяет держаться в тренде современных технологий. MODX сильно отстает в этом направлении.
          В планах, для модыксеров, желающих попробовать Laravel, подготовить серию статей. Пару я уже написал.

    Вы должны авторизоваться, чтобы оставлять комментарии.

    Выделите опечатку и нажмите Ctrl + Enter, чтобы отправить сообщение об ошибке.