Impex — компонент импорта/экспорта ресурсов MODX и товаров miniShop

Конфигурирование

<?php
$impex_config['content_row'] = array(
    array('Категории',5,'categories'),
    array('Наименование','pagetitle','resource'),
    array('Артикул','article','ms'),
    array('Расширенный заголовок','longtitle','resource'),
    array('Краткое описание','introtext','resource'),
    array('Содержимое','content','resource'),
    array('Цена','price','ms'),
    array('Производитель','vendor','ms'),
    array('Новинка','new','ms'),
    array('Теги','tags','ms'),
    array('Цвет','color','ms'),
    array('Материал','material','msoption'),
    array('На складе',1,'tv'),
    array('Галерея','images/import/','msgallery'),
    array('Дополнительные категории','','mscats'),
);

//значения по умолчанию при импорте или проверка при экспорте
$impex_config['content_default'] = array(
    array('template',2),
);

// класс товаров (msProduct / modResource)
$impex_config['resource_class'] = 'msProduct';

// класс категорий (msCategory / modResource / CollectionContainer)
$impex_config['category_class'] = 'msCategory';

// по какому полю проверять соответствие товара при обновлении. 
$impex_config['chk_field'] = array('article','ms');

// первая строка - названия полей
$impex_config['include_captions'] = true;

// разделители для MIGX-полей в файле array('между элементами', 'между полями внутри элемента')
$impex_config['migx_separators'] = array('||','--');

// количество ресурсов, импортируемых за один проход. 0 - не ограничивать.
$impex_config['batch_import'] = 100;

//автоматически генерировать псевдоним (alias) при импорте
$impex_config['alias_field'] = 'pagetitle';

?>

content_row

array('Название колонки', 'ID или имя поля в базе', 'Тип данных', array('поля MIGX')),

$impex_config['content_row'] = array(
    array('Категории',5,'categories'),
    array('Наименование','pagetitle','resource'),
    array('Артикул','article','ms'),
    array('Расширенный заголовок','longtitle','resource'),
    array('Краткое описание','introtext','resource'),
    array('Содержимое','content','resource'),
    array('Цена','price','ms'),
    array('Производитель','vendor','ms'),
    array('Новинка','new','ms'),
    array('Теги','tags','ms'),
    array('Цвет','color','ms'),
    array('Материал','material','msoption'),
    array('На складе',5,'tv'),
    array('Характеристики','chars','migx', array('title','value')),
    array('Галерея','images/import/','msgallery'),
    array('Дополнительные категории','','mscats'),
);

Поддерживаемые типы данных

• categories — цепочка категорий ресурса
• resource — стандартные поля ресурса MODX — pagetitle, longtitle, published и т. д.
• tv — TV-поле
• migx — TV-параметр типа MIGX
• ms — поля товара miniShop (таблица modx_ms2_products): article, price, old_price, weight, vendor, tags, new и т. д.
• msoption — Опция товара (опции категорий)
• msgallery — галерея товара miniShop
• mscats — дополнительные категории товаров miniShop (вкладка «Категории» редактора товара в админке)

Другие настройки

• content_default — значения по умолчанию при импорте и экспорте
• resource_class — класс ресурса (msProduct / modResource)
• category_class — Класс категории (msCategory / modResource / CollectionContainer)
• chk_field — поле, по которому ищется ресурс при импорте
• include_captions — первая строка в файле = названия полей
• migx_separators — разделители для MIGX-полей (настройка форматирования в файле)
• batch_import — количество ресурсов, обрабатываемых при импорте за один проход
• alias_field — какое поле использовать для генерации псевдонима при создании нового ресурса

Экспорт ресурсов

Импорт ресурсов

• Не обрабатывать — скрипт не будет учитывать изображения в файле.
• Загружать только новые — для новых товаров будут загружены новые изображения, для существующих товаров оставлены старые и добавлены новые, если они есть в файле и директории-источнике.
• Обновить все — для новых товаров будут загружены новые изображения, у существующих галерея сперва будет очищена, а потом загружены новые, указанные в файле, изображения.

• Тестирование. Если выбрано, после импорта откроется окно со ссылкой на системный журнал, где данные будут представлены в виде массива.
• Индексировать ли ресурс после импорта для компонента mSearch2, если он установлен в системе.
• Сохранять ли перед импортом резервную копию.

Восстановление из резервной копии

Системные события (события плагинов)

• OnImpexBeforeResourceExport — вызывается перед экспортом ресурса. Доступные переменные: $id — ID ресурса, $field — имя поля, $type — тип поля, $value — значение
• OnImpexBeforeResourceImport — вызывается перед импортом ресурса. Доступные переменные такие же как при экспорте
• OnImpexAfterResourceImport — вызывается после импорта ресурса. Доступен $id — ID импортированного ресурса
• OnImpexAterAllImport — вызывается после импорта всех ресурсов. Доступен массив $ids — ID всех импортированных ресурсов