Антирутин: массовая обработка товаров и разделов по произвольным сценариям

Если Вы установили демо-версию модуля и демонстрационный режим истек, но Вы не успели попробовать модуль в работе, сообщите об этом нам, мы можем повторно включить демо-режим. В общем случае, для сброса демо-режима нужно выполнить следующие указания:

1. создать рез. копию сайта, хотя бы базы данных,

2. деинсталлировать модуль (все данные будут удалены!),

3. стереть данный модуль с сайта (соотв. опция доступна в списке модулей),

4. выполнить SQL-запрос (в админке на соотв. странице в разделе "Инструменты": Административный раздел - Настройки - Инструменты - SQL-запрос):
   

   DELETE FROM `b_option` WHERE `MODULE_ID`='webdebug.antirutin';
   

5. сбросить весь кеш на сайте,

6. сообщить нам адрес сайта и владельца лицензии для проверки и сброса срока демо-версии на Вашем сайте,

7. после нашего ответа повторно установить модуль из Маркетплейс .

Ни один из наших модулей не имеет никаких ограничений или изменения условий работы в демо-режиме (за исключением механизма сохранения профилей в Антирутине).

Другими словами, никакие проблемы не могут быть связаны с демо-режимом.

Данная проблема возникает обычно в тех случаях, когда модуль ранее уже устанавливался на данном сайте (либо на копии сайта с той же лицензией), повторно установить не позволяет Битрикс.

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

В таком случае выполните все шаги, описанные в пункте «Как продлить DEMO» (если модуля на сайте нет, пункты 2 и 3 пропустить), либо напишите нам, мы поможем установить.

Скачать PDF-файл с документацией можно здесь.

Также не пренебрегайте подсказками в модуле (знаки вопросов в маленьких квадратиках, на них нужно наводить курсор мыши) - мы много работали над тем, чтобы эти подсказки были для Вас полезными.

Алгоритм работы с модулем очень простой:

1. выбрать инфоблок, на котором нужно проводить операции, затем (при необходимости) выбрать нужные разделы,
2. далее, при необходимости выбора только части товаров, укажите условия фильтра для отбора элементов инфоблока, над фильтром будет показано число найденных элементов,
3. затем, выберите нужное действие (напр., «Генерация символьного кода») и укажите все необходимые параметры,
4. нажмите кнопку «Запустить».

Создать свой плагин достаточно просто: каждый плагин это папка с файлами в подпапке element или section модуля (/bitrix/modules/webdebug.antirutin/plugins/ - 

Плагин, который Вы создаёте, можно наделить самыми разными функциональными возможностями по обработке элементов и разделов, вплоть до генерации PDF-карточек для товаров и экспорта товаров на торговые площадки.

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

Информация о создании собственного плагина находится в документации.

Кроме того, в модуле есть готовый плагин «Произвольный PHP-код», в котором можно реализовать всю логику плагина, но в этом варианте не нужно создавать свой плагин и подключать его.

В данном модуле термин «плагин» обозначает отдельное действие, которое можно выбрать для обработки товаров/разделов.

Значение термина «плагин» в данном случае полностью соответствует общепринятому, т.к. каждое действие в данном модуле реализовано отдельным функционалом. Более того, любой программист может добавить свой плагин, выполняются любые уникальные действия, абсолютно любые, например:

1. для каждого товара переводить описания на другой язык,
2. каждый товар выгружать на Яндекс.Маркет, Беру, Авито или любую другую площадку,
3. для каждого товара генерировать красивую карточку товара в формата PDF чтобы позволить скачивать ее со страницы товара,
4. для каждого товара загружать цены из сторонних источников,
5. для каждого товара наносить уникальные ватермарки и т.д.

1. «пересохранение элементов» - плагин поможет массово пересохранить товары чтобы активировать специальные обработчики (напр., OnBeforeIBlockElementUpdate, OnAfterIBlockElementUpdate, OnProductUpdate),
2. «произвольный PHP-код» - плагин позволяет вместо создания собственных плагинов быстро написать на PHP необходимые действия.

Профиль (с точки зрения данного модуля) - это сохраненная совокупность настроек формы для выполнения какого-либо конкретного действия модуля.

Профиль создается просто: выберите инфоблок (и при необходимости - разделы), укажите данные для фильтрации, выберите нужное действие (или несколько действий), укажите настройки выбранный действия, и в нижней правой части формы нажмите «Сохранить профиль», введите название профиля. Все! Профиль сохранен.

Профили обычно используются для двух целей:

1. для частой работы с ним, чтобы каждый раз не заполнять форму,
2. чтобы запускать профиль автоматически в заданное время.

Информация по автоматическому запуску размещена в ответе на вопрос «Как выполнять задание автоматически (по крону)?».

Проблема вызывается модуем проактивной защиты. Но, т.к. запрос выполняется через AJAX, предупреждения не видно.

Все логи модуля (как общий, так и логи по каждому из профилей) хранятся в папке /upload/webdebug.antirutin/log/ и имеют вид log_022.d2f06d322d40b85d445178bbe21074ca.log, где log_022 означает что это лог 22го профиля. Общий лог модуля не содержит индекса.

Для того, чтобы протестировать работу модуля на одном товаре, в фильтре необходимо добавить фильтрацию так, чтобы был найден только один товар. Лучший способ это сделать - фильтр по ID (если настроены другие фильтры, нужно все их отменить, кликнув на каждом из них). В форме редактирования товара посмотрите его ID, а затем на странице модуля «Антирутин» добавьте фильтр по ID в секции «Фильтр»:

1. в фильтре нажмите «Добавить условие»,
   
2. в появившемся блоке нажмите «поле/свойство» - откроется окно где необходимо выбрать поле «Идентификатор (ID)»,
3. нажмите на ссылку «логика» - откроется окно, где необходимо выбрать «равно»,
4. нажмите на ссылку «значение» - откроется окно, в котором необходимо выбрать товар по его ID,
5. все! на этом настройка фильтра закончена.

После настройки Вы увидите что найден один товар:

Новая версия модуля «Антирутин» (начиная с версии 20) поддерживает автоматическую настройку задачи для выполнения планировщиком.

Алгоритм следующий:

1. выбираем инфоблок, выбираем разделы (если необходимо), заполняем фильтр (если необходимо),
2. настраиваем необходимые действия (можно добавлять любое число действий),
3. нажимаем кнопку «Сохранить профиль» в нижней правой части страницы,
4. в открывшемся окне указываем название профиля (остальные поля необязательны, но мы рекомендуем всегда заполнять описание, чтобы через некоторое время, в т.ч. другим пользователям, знать для чего создавался данный профиль), и нажимаем «Сохранить»,
5. теперь, когда профиль сохранен, нажимаем кнопку «Управления профилями» в верхней правой части страницы, появляется окно со списком профилей,
6. нужно найти необходимый профиль, и нажать для него кнопку с подсказкой «Настроить автозапуск» (вторая справа иконка), откроется новое окно,
7. в открывшемся окне появляется список настроенных ранее задач планировщика (если профиль уже настраивался на автозапуск), здесь можно добавить любое число новых заданий, нажимая кнопку «Добавить еще». Правила для указания времени здесь стандартные для планировщика Cron, например:
   • * * * * * - каждую минуту
   • */5 * * * * - каждые 5 минут
   • 0 * * * * - в 0 минут каждый час
   • 0 10 7 * * - в каждое воскресенье в 10 часов утра
   • 0 10,17 * * * - два раза в день (в 10:00 и 17:00)
8. нажать «Сохранить».

Такая задача встречается довольно часто. Например, в некоторых готовых решениях вместо привычных свойств «Новинка», «Спецпредложение», «Лидер продаж» и т.п. имеется одно свойство, содержащее все подобные переключатели, и можно выбрать любые из них - например, сразу «Новинка» и «Лидер продаж». При этом часто у многих товаров нужно массово снять выделение одного из пунктов, например, «Спецпредложение». В решении данной задачи очень сильно поможет данный модуль.

Порядок работы примерно следующий:

1. выбираем плагин «Удаление значений из множественных свойств»,
2. в выпадающем списке «Поле/свойство» выбираем необходимое свойство (показываются только множественные свойства типа «Список»),
3. в появившемся списке выбираем ненужные элементы списка (выбранные здесь пункты будут удалены у товаров),
4. нажимаем кнопку «Запустить»,
5. всё! Теперь у всех отобранных товаров выбранные значения списка удалены.

Все просто: после добавления каждого нового действия, Вы можете его закрепить (кнопка «Закрепить» в верхнем правом углу каждого действия), тогда оно перейдет в список группы действий.

При сохранении профиля незакрепленное действие (если такое имеется) автоматически закрепляется.

Запуск профиля через API выполняется одной командой:

if(\Bitrix\Main\Loader::includeModule('webdebug.antirutin')){
	\WD\Antirutin\Worker::executeProfile(47);
}

Таким образом можно, например, запускать обработку профилей после завершения обмена с 1С:

addEventHandler('catalog', 'OnSuccessCatalogImport1C', function(){
	if(\Bitrix\Main\Loader::includeModule('webdebug.antirutin')){
		\WD\Antirutin\Worker::executeProfile(47);
	}
});

if(\Bitrix\Main\Loader::includeModule('webdebug.antirutin')){
	\WD\Antirutin\Worker::executeInBackground([123, 124, 125]);
}

Таким образом, чтобы после окончания выгрузки из 1С автоматически запустились, например, два профиля с идентификаторами 1000 и 1001, нужно написать на сайте такой обработчик:

addEventHandler('catalog', 'OnSuccessCatalogImport1C', function(){
	if(\Bitrix\Main\Loader::includeModule('webdebug.antirutin')){
		\WD\Antirutin\Worker::executeInBackground([1000, 1001]);
	}
});

Да, модуль корректно работает на версиях PHP 8.0 и 8.1.

Данная задача легко решается плагином «Замены в тексте».

Алгоритм следующий:

1. выбираем поле/свойство, в котором нужно дописать текст в конце (поддерживаются любые текстовые поля, в т.ч. краткое и подробное описания, а также любые текстовые свойства),
2. выбираем режим замены - «Дописать в конце»,
3. указываем текст, который необходимо дописать в конце,
4. запускаем процесс.

Удаление картинок (как и очистка других типов свойств) выполняется плагином «Заполнение значений».

Алгоритм простой:

1. выбираем действие «Заполнение значений»,
2. выбираем поле/свойство (картинка для анонса, детальная картинка либо любое свойство типа «Файл»),
3. отмечаем галочку «Очистить поле/свойство от всех файлов в случае, если в форме не выбран ни один файл»,
4. запускаем обработку.

Для выполнения данного действия используйте плагин «Заполнение по шаблону». Он позволяет заполнить текстовые поля и свойства (описания и прочее), подставляя в нужные места данные из других полей и свойств, например, свойство «Заголовок окна браузера» можно заполнять так:

Купить {=this.Name} по выгодной цене {=this.catalog.price.BASE} в нашем магазине на Цветном бульваре.

Деактивация товара это снятие флажка активности, или, другими словами, установка значения «Нет» в поле активности. Соответственно, для данной цели используется плагин «Заполнение значений». Порядок действий (не включая выбор инфоблока, раздела и фильтра) следующий:

1. В выпадающем списке «Поле/свойство» выберите поле «Активность»,
2. в появившемся ниже выпадающем списке выберите «Нет»,
3. нажмите кнопку «Запустить»,
4. всё! Теперь все отобранные товары будут деактивированы.

Для массовой генерации символьного кода используется плагин «Генерация символьного кода». Работа с ним проста:

1. выбираем свойство, из которого будет браться значение для использования в символьном коде, в большинстве случаев это название,
2. выбираем режим использования настроек: либо те, которые указаны в инфоблоке, либо собственные (указанные в форме, которую Вы настраиваете),
3. если Вы выбрали использование собственных настроек - их необходимо заполнить здесь же,
4. если необходимо - укажите доп. текст в начале и конце символьного кода (обычно, это не требуется),
5. нажмите «Запустить»,
6. всё! Теперь для всех отобранных элементов сгенерирован и сохранен новый символьный код.

Такая задача встречается достаточно редко, но при этом реализация данной задачи, при большом количестве элементов, затруднительна. Модуль предлагает простое решение:

1. выберите плагин «Копирование значений»,
2. в выпадающем списке «Откуда взять значение» выберите поле или свойство, из которого нужно взять значение для копирование в другое поле/свойство,
3. в поле «Куда сохранить» выберите поле или свойство, в которое необходимо записать скопированное значение,
4. нажмите зеленую кнопку «Сохранить»,
5. всё! Задача выполнена.

• при копировании значения из множественного свойства в немножественное есть возможность указать как обработать множественное: перечислить через запятую, взять большее или меньшее, взять первое или последнее,
• при копировании значений свойств, которые содержат доп. данные (списки, привязки, файлы, и др) есть возможность выбрать что копировать - значение, код значения, id значения, для файла - путь к файлу (относительный или абсолютный), ссылка на файл, id файла или описание файла,
• при копирование во множественное свойство имеется возможность добавить новые значения к текущим, а также удалить дубликаты значений.

Данную задачу можно решить двумя легкими способами. Если Вам нужно только посмотреть примеры найденных товаров, то используйте первый (простой способ) - нажать на ссылку с количеством найденных товаров.

Если Вам нужен подробный отчет (напр., с получение дополнительных полей и свойств найденных товаров и разделов), то используйте плагин «Логирование»: он специально создан для этой задачи.

Плагин «Логирование» поддерживает выгрузку как в текстовый формат (только ID и названий найденных товаров/разделов), так и в формат CSV (значения, разделенные запятыми) - этот формат подходит для удобного просмотра программой MS Excel (или подобными программами), при этом модуль поддерживает возможность оптимизации экспорта в файл таким образом (параметр «Оптимизировать для MS Excel»), чтобы он лучшим образом выглядел в MS Excel.

При настройке логирования нужно выбрать, какие поля/свойства будут выгружаться в файл - доступны все поля и свойства товаров, включая цены, остатки на складах, SEO-поля и др.

Данная задача - одна из наиболее часто встречаемых. Одним из подвариантов задачи является случай, когда нужно, например, перенести все товары одного бренда в отдельный раздел. Или, например, товары с ценой ниже 1000руб дополнительно привязать в разделу «недорогие товары». Или, например, все товары перенести в корень сайта чтобы удалить все разделы и создать новую структуру.

Алгоритм следующий:

1. выберите действие «Привязки к разделам» (для разделов плагин немного иной - «Перемещение разделов»),
2. в поле «Тип операции» выберите, что конкретно необходимо сделать (перенести в раздел, сменить основной раздел, добавить привязку к разделу, удалить привязку к разделу),
3. в списке «Раздел» укажите нужный раздел,
4. нажмите зеленую кнопку «Запустить»,
5. всё! Модуль сделал все то, что Вы настроили.

Да, модуль может массово удалить товары, для этого используйте плагин «Удаление элементов» - этот плагин не имеет настроек, после запуска он просто удаляет все отобранные элементы.

Будьте осторожны, удаляя элементы - это действие необратимо (кстати, у нас есть модуль, который позволяет восстанавливать удаленные элементы, разделы, заказы и др - но он работает только если его установить заранее).

Эта задача - одна из наиболее часто встречающихся: на многих сайтах имеются изображения, которые загружены на сайт в излишне большом разрешении.

Для данной задачи уменьшения разрешения изображений создан плагин «Изменение размера изображений». Порядок работы с ним следующий:

1. выбираем поле или свойство, в котором нужно изменить размер изображений,
2. выбираем режим обработки - вписать или заполнить,
3. указываем максимальную ширину и высоту,
4. если нужно - отмечаем галочку для применения фильтра «Резкость»,
5. нажимаем кнопку «Запустить»,
6. всё! После окончания процесса все картинки приведены в соответствие с настройками.

Копирование картинки из одного свойства в другое - простейшая задача для данного модуля. Используйте плагин «Копирование значений». Все, что нужно указать в настройках этого плагина - откуда копировать и куда копировать. Больше ничего не требуется настраивать.

Дополнительный параметр «Какое значение копировать?» можно выбирать любым (поддерживаются все кроме «Описание файла»), но с точки зрения производительности лучше «Путь к файлу (абсолютный)».

В модуле имеется плагин «Поиск битых картинок», который позволяет для каждого файла найти файловые поля и свойства, и проверить, доступен ли каждый из файлов. Если не доступен - тогда товар будет логироваться (сохраняться) в файл для дальнейшего анализа.

Данный плагин основан на плагине «Логирование», и имеет точно такие же настройки, плюс он имеет собственную настройку «Удалить битые картинки из полей и свойств». В списке доступных для логирования полей, помимо прочего, доступно специальное поле «Битые изображения [PICTURES_BROKEN]» - в него будет сохраняться недоступная ссылка на файл.

В модуле имеется плагин «Пересчет цен (скидки, наценки, изменение валюты)», который позволяет производить различные операции с ценами:

1. копировать цены из одного поля/свойства в другое,
2. увеличивать или уменьшать цены по заданным правилам,
3. изменять валюту цен,
4. округлять цену.

1. выбираем поле с ценой (доступны также свойства типа «Число» и «Строка» - это актуально для простых магазинов на редакции Битрикс без интернет-магазина),
2. выбираем поле, куда сохранить цену - иногда выбирают то же самое поле что и в первом пункте, но это приведет к потере оригинального значения цены, поэтому часто пересчет ведут от закупочной цены (или некоторой другой, специально созданной цены), и сохраняют значение уже в необходимый тип цены,
3. заполните параметры (смена валюты, ограничение минимальное стоимости, округление и др),
4. нажмите кнопку «Запустить»,
5. всё! Цены скопированы.

Используйте действие (плагин) «Замены в тексте». Алгоритм настройки:

• Выберите поле, в котором нужно заменить (напр., «Подробное описание [DETAIL_TEXT]»),
• Режим замены - укажите «Замена с использованием регулярного выражения»,
  
• Регулярное выражение - укажите «#<a[^>]+>(.*?)</a>#is» (без кавычек!),
  
• Замена - укажите «$1» (без кавычек!),
• Запустите обработку.

Произвольный код предполагает выполнение любого PHP-кода на сайте. Для достижения результата необходимо учитывать некоторые нюансы:

• ID текущего элемента хранится в $intElementId,
• ID текущего инфоблока хранится в $this->intIBlockId,
• ID инфоблока предложений можно получить методом $this->getOffersIBlockId(),
• PHP-код выполняется в пространстве имён WD\Antirutin, соотственно, все классы необходимо указывать с пространством имён, например, не "CIBlockElement::getList()", а "\CIBlockElement::getList()",
• код должен вернуть true (в случае успеха) или false (в случае ошибки),
• для отладки доступен метод $this->debug() - он выводит всё переданное содержимое на экран во всплывающем окне.

$intLinkIBlockId = 2;
$strPropName = 'LINK_NAME';
$strPropValue = 'LINK_VALUE';
$arSelect = ['PROPERTY_'.$strPropName, 'PROPERTY_'.$strPropValue];
$arFilter = ['IBLOCK_ID' => $this->intIBlockId, 'ID' => $intElementId];
if($arOffer = \CIBlockElement::getList([], $arFilter, false, false, $arSelect)->fetch()){
  if(strlen($arOffer['PROPERTY_'.$strPropName.'_VALUE'])){
    $arFilter = ['IBLOCK_ID' => $intLinkIBlockId, '=NAME' => $arOffer['PROPERTY_'.$strPropName.'_VALUE']];
    if($arLink = \CIBlockElement::getList([], $arFilter, false, false, ['ID', 'NAME'])->fetch()){
      \CIBlockElement::setPropertyValuesEx($intElementId, $this->intIBlockId, [
        $strPropValue => $arLink['ID'],
      ]);
    }
  }
}
return true;