Product Group Editing сохраняет товары группы стандартной функцией OpenCart editProduct() из admin/model/catalog/product.php - той же функцией, которая сохраняет форму товара. Большинство модулей, которые изменяют форму товара или реагируют на сохранение товара, работают с групповым редактированием без изменений. На этой странице описаны подробности для владельцев магазинов и разработчиков.
Быстрая проверка для владельцев магазинов
Если вы используете модули, которые добавляют товарам поля (дополнительные цены, свои вкладки, SEO-поля, метки товаров и т. п.), один раз выполните такую проверку:
- Сделайте резервную копию базы данных.
- Добавьте два товара в группу. Заполните поля другого модуля в обоих товарах разными значениями.
- Откройте один из них, отметьте только «Цену» и сохраните.
- Откройте другой товар и проверьте, что поля другого модуля сохранили свои значения.
Если значения потеряны, попробуйте с выключенным «Включить ускоренное групповое редактирование» (по умолчанию, см. «Установка, настройки и обновление»). Если они всё равно теряются, обратитесь к автору того модуля или свяжитесь с нами: мы можем добавить поддержку его полей.
Как сохраняется товар группы
Для каждого товара группы модуль:
- Загружает данные товара:
getProduct()модели товара;- в режиме по умолчанию (полном) - также данные, которые форма товара (контроллер
catalog/product,getForm()) готовит для этого товара, поэтому поля, которые другие модули добавляют в данные формы, тоже включаются; - данные, которые
copyProduct()собирает для товара (описания, категории, опции, скидки и все остальные связанные данные, а также SEO URL). Модуль патчитcopyProduct(), чтобы он возвращал этот массив, а не создавал копию.
- Заменяет отмеченные значения значениями, отправленными из формы редактируемого товара.
- Вызывает
editProduct($product_id, $data).
Таким образом, массив $data, который получают editProduct() и его обработчики событий для товара группы, - это полные данные этого товара с заменёнными отмеченными значениями, как при отправке его собственной формы товара.
Что должны делать другие модули
| Модуль хранит свои данные в | Результат группового сохранения |
|---|---|
Собственная таблица, которая записывается в собственном обработчике формы или в обработчике editProduct, читающем $data |
Сохраняется, если обработчик получает свои значения в $data: в полном режиме - из данных формы товара, в быстром режиме - только если их возвращает copyProduct(). Обработчик, который удаляет свои строки, когда его ключа нет в $data, теряет данные. |
Пользовательский столбец oc_product |
Сохраняется: editProduct() обновляет только стандартные столбцы. |
Пользовательский столбец oc_product_description, oc_product_option_value или другой таблицы, которую editProduct() удаляет и вставляет заново |
Сбрасывается в значение по умолчанию, если модуль не возвращает этот столбец и из методов чтения (getProductDescriptions(), getProductOptions() и т. д.). Обычное сохранение формы товара в OpenCart имеет ту же проблему, поэтому такой модуль обычно уже это делает. |
Обработчики событий admin/model/catalog/product/editProduct |
Запускаются для каждого товара группы с данными этого товара. |
Например, модуль, добавляющий столбец описания, должен возвращать его в getProductDescriptions(); тогда столбец сохраняется при групповом сохранении, а значение можно скопировать флажком для языка, если у поля формы есть название.
Поддерживаемые модули
| Модуль | Поддержка |
|---|---|
Product Shipping Methods (product_smethods) |
Список способов доставки можно копировать, как категории. |
Product Option Images (po_view, pov_image) |
Вид опции и изображения значений копируются вместе с опциями. |
Paid Customer Groups (is_group_product) |
Признак можно копировать. |
Для разработчиков: API группы
Модель группы могут использовать другие модули:
getProductsInGroup() принимает необязательные части SQL join, where и sort; псевдоним таблицы - kpg. Сначала проверьте, что модуль установлен, например с помощью \KaGlobal::isKaInstalled('ka_group_editing').
Группа хранится в таблице oc_ka_product_groups (token, product_id, added_at). token - это user_token сессии админ-панели, поэтому у каждого входа своя группа.
Список поддерживаемых массивов формы товара возвращает getRegisteredFields() той же модели. Отдельное поле формы (имя без скобок) автоматически получает флажок, если у его названия есть атрибут for. Его значение помещается в $data товара группы, если в загруженных данных этого товара есть такой ключ; поле сохраняется, если его сохраняет editProduct() или обработчик другого модуля.
Что нужно знать об ограничениях
- Транзакции базы данных нет: товары группы сохраняются по одному. Если сохранение остановится на середине, ранее сохранённые товары останутся изменёнными. Таблицы OpenCart 3 обычно MyISAM, а там транзакций всё равно нет.
- Сохранение большой группы требует времени: каждый товар загружается и сохраняется полностью, в полном режиме - ещё и через форму товара. На очень больших группах ограничением может стать
max_execution_timePHP вашего хостинга. - Подробнее см. «Ограничения, решение проблем и FAQ».