vectorserver

[[!pdoResources?&parents=`2773`
 &tpl=`media_item`
 &prepareTVs=`1`
 &includeTVs=`instruments`
 &groupby=`TVinstruments.value`
]]

## Описание

Импорт/экспорт товаров (документов MODX) в/из CSV, XLS, XLSX.

## Возможности

- Импорт и экспорт товаров (документов MODX).
- Импорт и экспорт данных для любых лаблиц БД (в т.ч. созданных с помощью MIGXDB).
- Поддерживаются форматы файлов для импорта и экспорта: CSV, XML (только импорт), XLS, XLSX.
- Простая конфигурация. Можно настроить какой столбец куда (контент/TV-параметр) импортировать.
- Возможность создания конфигурационных файлов для разных задач. Конфигурацию можно выбрать перед импортом и экспортом.
- Удобная загрузка файлов.
- Режимы обновления (очистка до импорта) и добавления.
- Архивирование файлов. Все импортированные и экспортированные файлы хранятся на диске. Их можно удалить в любой момент.
- Поддержка категорий. Неограниченная вложенность.
- Возможность обновления данных товаров без их удаления (проверка соответствия по полю или значению TV).
- Возможность загрузки товаров по группам (можно подстроить под ресурсы сервера).
- Импорт и обновление товаров по Cron-у.

## Требования

- MODX Revolution 2.1 или выше
- кодировка сайта UTF-8
- PHP версии 5.2.0 или выше
- PHP расширение php_zip
- PHP расширение php_xml
- PHP расширение php_xmlwriter
- PHP расширение php_gd2

## Установка

1. Загрузите архив "catalogfill-2.x-pl.transport.zip" в папку core/packages/ вашего сайта. В панеле управления перейти "Система" -> "Управление пакетами" -> "Загрузить дополнения" -> "Искать пакеты локально" -> "Да".

2. В таблице пакетов появится пакет "catalogfill". Нажать кнопку "Установить".

3. Закончить установку.

4. Установить права 0777 на папку ``/assets/components/catalogfill/files/``.

5. В Настройках системы вашего сайта включите загрузку csv файлов ("Файловая система" -> "Разрешённые к загрузке файлы" (setting_upload_files)).

## Инструкция по использованию

1. Открыть компонент "Импорт/экспорт".
2. Нажать на поле "Родительский ресурс" и в дереве документов кликнуть документ-категорию, в/из которого нужно импортировать/экспортировать товары.

### Импорт
3. В списке "Файл для импорта" выбрать файл, которые находятся в папке ``/assets/components/catalogfill/files/`` на сервере. Нажав кнопку "Загрузить файлы", можно загрузить новый файл.
4. Выбрать конфигурацию для импорта в списке и нажать кнопку "Импортировать". В браузере появится индикация выполнения загрузки, нужно подождать завершения операции.

### Экспорт
5. В дереве документов выберите родительский ресурс (категорию), из которой нужно экспортировать товары.
6. Выбрать конфигурацию экспорта в списке "Конфигурация". Выбрать тип (формат) файла и нажать кнопку "Экспортировать".
7. Можно сразу скачать файл на жесткий диск вашего компьютера. Также экспортированные файлы хранятся в папке ``/assets/components/catalogfill/files/``.

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

Для импорта и экспорта значений полей (таблица "site_content" в БД) товаров (документов) в конфигурационном файле в массиве ``$cf_config['content_row']`` нужно указать название столбца в файле, имя поля и тип содержимого.
Пример:
~~~
1 => array('Наименование',array('pagetitle','content')),
~~~

Для импорта и экспорта TV-параметров (таблица "site_tmplvar_contentvalues" в БД) нужно указать название столбца в файле, ID TV-параметра и тип содержимого.
Пример:
~~~
2 => array('Цена',array(7,'tv'))
~~~

Для импорта и экспорта категорий нужно указать название столбца в файле, ID шаблона категории и тип содержимого.
Пример:
~~~
0 => array('Категория',array(7,'category')),
~~~
7 - ID шаблона для категории.
Категории в файле должны идти последовательно от верхнего уровня к нижнему.

---

Предусмотрена возможность обновления данных товаров без их удаления (сохраняются ID).
Проверку на соответствие существующего товара и импортируемого можно осуществлять по полям (в БД) товара или значениям его TV-параметров.

Примеры:
~~~
$cf_config['imp_chk_field'] = 'pagetitle'; //Если найден товар с названием соответствующим названию импортируемого товара, его данные будут обновлены.
~~~
~~~
$cf_config['imp_chk_tvid_val'] = 10; //Проверка соответствия происходит по значению TV-парамтера с ID 10. Например это может быть артикул.
~~~

---

Для программистов есть возможность сделать обработку значений перед импортом или экспортом. Смотреть пример в конфигурационном файле.

---

Имена всех полей таблицы "site_content" (ресурсы) можно посмотреть, например, здесь: [http://bobsguides.com/modx-object-full-reference.html#modResource](http://bobsguides.com/modx-object-full-reference.html#modResource).

### Отмена публикации или изменение значения TV для товаров, которых нет в новом прайс-листе

Пример:
~~~
$cf_config['imp_before_change'] = '[{"published":0},{}]';
~~~
В данном случае перед импортом будет отменена публикация всех вложенных товаров и при импорте товары, которые есть в прайс-листе будут обновлены и опубликованы (использовать параметр "imp_content_default").
Таким образов старые товары будут сняты с публикации (можно также поместить в корзину - "deleted").
~~~
$cf_config['imp_before_change'] = '[{"tv.inventory":0},{}]';
~~~
В данном случае для всех вложенных товаров будет изменено значение TV-параметра "Кол-во на складе" (inventory) на "0".
При импорте если старых товаров нет в новом прайс-листе, они так и останутся с нулевым значением.

## Импорт товаров из XML

Для импорта товаров из XML-файла в конфигурационный файл нужно скопировать кусок XML (один товар) со структурой и указать названия полей. Для TV параметров (доп.полей) указывать ID TV с префиксом "tv".

Пример:
~~~
$cf_config['imp_xml_structure'] = <<<EOF
<Good>
    <Kod>tv8</Kod>
    <Name>pagetitle</Name>
    <Options>
        <Stock>tv5</Stock>
        <Image>tv2</Image>
    </Options>
    <Prices>
        <RegularPrice>tv1</RegularPrice>
        <OldPrice>tv20</OldPrice>
    </Prices>
</Good>
EOF;
~~~
Здесь "pagetitle" - это наименование товара. Остальные поля это TV-параметры.

Если товары находятся дальше первого уровня вложенности, можно указать вложенность в параметре ``$cf_config['imp_xml_itemsparent_path']``.
Пример:
~~~
$cf_config['imp_xml_itemsparent_path'] = '/catalog/shop/offers';
~~~

## Импорт и обновление товаров по Cron-у

Для импорта товаров по Cron-у использовать скрипт ``core/components/catalogfill/cron.php``.
Можно использовать, например, для обновления цен и т.п. с определенной периодичностью.

Аргументы:
1 - ID документа-контейнера или название контекста.
2 - название конфигурации без ".php"
3 - название файла в папке ``assets/components/catalogfill/files/``

Пример использования:
~~~
[путь папки сайта]core/components/catalogfill/cron.php 2 default example1.xls
~~~

Пример настройки Cron-а в текстовом формате. Запускать импорт каждый день в 00:00:
~~~
0 0 * * * [путь папки сайта]core/components/catalogfill/cron.php 2 default example1.xls
~~~

~~~
* * * * * выполняемая команда
- - - - -
| | | | |
| | | | ----- День недели (0 - 6) (Воскресенье =0 или =7)
| | | ------- Месяц (1 - 12)
| | --------- День (1 - 31)
| ----------- Час (0 - 23)
------------- Минута (0 - 59)
~~~

---

При необходимости добавить в файл ``.htaccess`` (сервер Apache) строки, чтобы снять ограничения:

php_value memory_limit 128M
php_value upload_max_filesize 15M
php_value post_max_size 15M
php_value max_input_time 1200
php_value max_execution_time 1200

<?php
function ruDate($format, $date = false) {
    setlocale(LC_ALL, 'ru_RU.cp1251');
    if ($date === false) {
        $date = time();
    }
    if ($format === '') {
        $format = '%e %bg %Y г.';
    }
    $months = explode("|", '|января|февраля|марта|апреля|мая|июня|июля|августа|сентября|октября|ноября|декабря');
    $format = preg_replace(/** @lang text */ "~\%bg~", $months[date('n', $date)], $format);
    $res = strftime($format, $date);
    return $res;
}

echo ruDate('%e %bg %Y г.', strtotime('+1 day'));

23 июня 2022 г.

<?php
setlocale(LC_ALL, 'ru_RU.utf8');
$offset = strtotime('+1 day');
echo strftime("%A %e %B %Y", $offset);

<?php
if ($_SERVER['HTTP_X_REQUESTED_WITH'] != 'XMLHttpRequest' || empty($_REQUEST['action'])) {exit();}

$action = $_REQUEST['action'];

/* @global $modx*/
define('MODX_API_MODE', true);
require_once dirname(dirname(__FILE__)).'/index.php';
$modx->getService('error','error.modError');
$modx->setLogLevel(modX::LOG_LEVEL_FATAL);

$output = array();

switch ($action) {
    case 'getContent':
        $id = isset($_POST['id']) ? (int) $_POST['id'] : 0;
        if (empty($id)) {
            exit();
        };
        $object = $modx->getObject('modResource',$id);
        $output['content'] = $object->get('content');
        $output['pagetitle'] = $object->get('pagetitle');

        $output['MIGX_TV'] = json_encode($object->getTVValue('MIGX_TV'),true);

        $output = json_encode($output);
        break;
    default:
        $output = array("st"=>"error");
}

header('Content-Type: application/json; charset=utf-8');
echo json_encode($output);

<?php 
 /* Выбор цены товара при добавлении в корзину. $price, $id, $purchaseArray */
    case "OnSHKgetProductPrice":
        // Конструктор 
        $price = $myprice;/// тут принимаем новое значение

        $modx->event->output($price);
        break;