Часть 3. Методы set и save

Продолжим серию статей об xPDO для начинающих. В предыдущих частях мы узнали, как можно получить значение полей того или иного объекта или даже нескольких объектов. Теперь посмотрим, как мы можем изменять эти значения.

Помимо метода get(), который получает значение, есть еще и метод set(), который это значение устанавливает. Мы можем поменять подряд сразу несколько значений, но после всех вызовов set() нужно объект сохранить. Сохраняет объект метод save().

set() — устанавливает значение одного из полей объекта.
save() — сохраняет все изменения в объекте.

Мы можем изменить ресурс прямо из консоли, вот так:

$res = $modx->getObject('modResource',22);
$res->set('pagetitle', 'Новости сайта');
$res->save();

После выполнения этого кода, заголовок ресурса будет «Новости сайта». Как видите, чтобы что-то делать с объектом, нам нужно его сначала получить. Если нам нужно внести изменения в несколько объектов, мы можем воспользоваться методом getCollection():

$titles = array(
        '1' => 'Главная'
      , '6' => 'О нас'
      , '8' => 'Галерея'
      , '11' => 'Контактная информация'
      , '22' => 'Новости компании'
    );
$resources = $modx->getCollection('modResource',array('parent' => 0));
foreach ($resources as $id => $res) {
    if (!$titles[$id]) continue;
    $res->set('pagetitle', $titles[$id]);
    $res->set('longtitle', $titles[$id]);
    $res->set('menutitle', $titles[$id]);
    $res->set('hidemenu', 0);
    $res->save();
}

Как видите, save() вызывается после всех set(), однако для каждого объекта. Ведь нам надо каждый объект сохранить.

Порой неудобно перечислять все поля, которые мы хотим изменить, да и код у нас становится нечитаемым. Можно, конечно, сделать так:

$titles = array(
    '1' => 'Главная'
  , '6' => 'О нас'
  , '8' => 'Галерея'
  , '11' => 'Контактная информация'
  , '22' => 'Новости компании'
);
$resources = $modx->getCollection('modResource',array('parent' => 0));
foreach ($resources as $id => $res) {
    if (!$titles[$id]) continue;
    $fields = array(
        'pagetitle' => $titles[$id]
      , 'longtitle' => $titles[$id]
      , 'menutitle' => $titles[$id]
      , 'hidemenu'  => 0
    );
    foreach ($fields as $field => $val) {
        $res->set($field, $val);
    }
    $res->save();
}

Но это необязательно — разработчики xPDO о нас позаботились и добавили метод fromArray(), который выполняет вышеприведенный код.

fromArray() — по анологии с методом toArray() (который получает все значения в виде массива) устанавливает значения, перечисленные в массиве

$titles = array(
    '1' => 'Главная'
  , '6' => 'О нас'
  , '8' => 'Галерея'
  , '11' => 'Контактная информация'
  , '22' => 'Новости компании'
);
$resources = $modx->getCollection('modResource',array('parent' => 0));
foreach ($resources as $id => $res) {
    if (!$titles[$id]) continue;
    $fields = array(
        'pagetitle' => $titles[$id]
      , 'longtitle' => $titles[$id]
      , 'menutitle' => $titles[$id]
      , 'hidemenu'  => 0
    );
    $res->fromArray($fields);
    $res->save();
}

Как видите, ничего сложного нет. Теперь небольшое практическое задание по пройденной теме:

Задание. Представьте, что вы сделали клиенту сайт, он его заполнил, в раздел «Статьи» уже выложил около 50 статей, после чего звонит вам и просит, чтобы в разделе статьи URL были такими:

/articles/23/

то есть, чтобы псевдонимом у статей был id ресурса. Напишите код, который надо выполнить в консоли, чтобы у всех существующих статей исправить псевдонимы.

Для более продвинутых пользователей — напишите плагин, который будет устанавливать нужное значение для всех создаваемых документов в разделе «Статьи»

Подсказка для тех, кто еще ни разу не писал своих плагинов
Решение задания

Оригинал статьи: community.modx-cms.ru/blog/modx-xpdo/10264.html G+