Модуль Feeds - простое и мощное решение для организации импорта данных. Даный модуль имеет возможность работать с разными стандартами данных, в частности с CSV, XML, OPML.
При организации импорта часто появляется необходимость проводить обработку данных перед их подачей на сайт. Для обработки данных в процессе импорта предназначен модуль Feeds Tamper. Этот модуль позволяет определить для каждого поля действие (или совокупность действий) по обработке данных.

Список стандартных операций довольно большой (рис. 1.):

Каждое действие технически реализуется в виде отдельного плагина, который подключается к модулю Feeds Tamper, и после подключения становится доступен в списке "The plugin to add".

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

Иногда возникают задачи, которые не решаются с помощью встроенных плагинов. Использование РНР-сниппетов тоже не совсем решает задачу, поскольку при многократном использовании сниппета в разных импортерах, пропадает возможность централизированой и синхронной правки кода.

В таком случае наиболее подходящим решением будет создание собственного плагина с нужным функционалом. Рассмотрим этот процесс более детально.

Рассмотрим процесс создания плагина на практическом примере:

Исходные данные:

CSV-файл с данными для импорта данных в сущность товара Drupal Commerce. Формат представления поля стоимости - число. Точность - 2 знака после запятой. Разделитель целой и дробной части - точка.

Суть проблемы:

Drupal commerce использует собственный формат хранения поля стоимости. Стоимость сохраняется в минорной единице валюты. Т.е. на примере рубля, стоимость в поле БД должна быть записана в копейках.

Задача:
Необходимо конвертировать сумму из стандартной числовой записи во внутренний стандарт Drupal Сommerce.

Алгоритм:

1. Получаем значение суммы.
2. Проверяем на правильность (является ли значение поля числом)
3. Конвертируем рубли в копейки, умножением на кратность единиц (в случае рубля умножаем на 100).
4. Отдаем результат в импорт.

Реализация:

Поскольку плагины находятся в папке модуля Feeds Tamper: feeds_tamper/plugins/, устанавливать свой плагин в эту же системную папку не рационально, поскольку в процессе обновления модуля вероятна утрата кастомных плагинов.

Правильным подходом будет создать модуль, который позволит зарегистрировать плагин в системе, не размещая его в системной папке. Для этого воспользуемся хуком hook_ctools_plugin_directory(), поскольку Feeds Tamper использует ctools.

Согласно http://drupalcontrib.org/api/drupal/contributions!ctools!ctools.api.php/... АРІ эта функция имеет следующие аргументы: hook_ctools_plugin_directory($owner, $plugin_type)

Реализация хука будет иметь вид:

Этот хук задаст размещение кастомного плагина в папке MYMODULE/plugins

Далее создадим собственно, сам плагин. Назовем его MYMODULE_dc_price_converter.inc

Всего в тексте плагина будет находится объявление одной конфигурационной переменной, и двух функций.

Прежде всего объявим конфигурационную переменную, в которой зададим форму настройки плагина, и реализацию метода обработки данных.

Значения параметров:
'form' - название функции, в которой мы объявляем конфигурационную форму. Форма создается стандартными средствами FormAPI http://api.drupal.org/api/drupal/includes--form.inc/group/form_api/7
'callback' - название функции, в которой находится реализация обработчика данных
'name' - название плагина в списке "The plugin to add"
'category' - категория плагина в этом же списке

Рассмотрим реализацию конфигурационной формы плагина:

В результате конфигурационная форма будет иметь вид (рис. 2.):

Рассмотрим обработчик данных:

Итоги:

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

Исходники примера