Multivendor построен на Ka Extensions и kamod: переопределяйте его контроллеры и модели, добавляйте пункты меню продавца и вкладки формы товара. Эта страница - для разработчиков, которые пишут собственные модули или адаптируют тему.
Как устроен модуль
- Модуль находится в папках
extension/ka_extensions/ka_multivendorвнутриadmin,catalogиsystem/library. - Он изменяет OpenCart с помощью переопределений kamod из Ka Extensions: классы в
.../ka_multivendor/controller/...и.../ka_multivendor/model/...расширяют классы OpenCart с тем же путём (например,catalog/controller/extension/ka_extensions/ka_multivendor/controller/checkout/cart.php), а файлы*.php.xml/*.twig.xmlвносят изменения в PHP-файлы и шаблоны. - Несколько шаблонов темы по умолчанию и файлов ядра изменяются OCMOD-модификацией из пакета (
install.xml). - Модуль не использует события OpenCart. Чтобы изменить его поведение, переопределяйте его классы тем же способом.
- Общий код находится в
system/library/extension/ka_extensions/ka_multivendor/(абстрактные модели, такие какamodelorder.php,amodelvendor.php,amodelvendorreview.php,amodelvendortransaction.php, модели продавца вvendor/).
Точки расширения
Наши другие модули расширяют Multivendor через эти точки; например, модуль Licenses добавляет свою вкладку в форму товара продавца. Модуль на Ka Extensions может переопределять классы и шаблоны Multivendor через kamod; укажите install_after = ka_extensions/ka_multivendor в его kamod.ini.
| Точка | Как |
|---|---|
| Меню продавца | account.twig подключает extension/ka_extensions/ka_multivendor/account/extra.twig, если он существует. Предоставьте этот шаблон из своего модуля, чтобы добавить пункты в «Мой аккаунт продавца». |
| Вкладки формы товара продавца | vendor/product_form.twig подключает vendor/product_form/tab_extra_header.twig (заголовки вкладок) и vendor/product_form/tab_extra_content.twig (содержимое вкладок), если они существуют. |
| Поля товара продавца | Переопределите getProductFields() контроллера товара продавца (catalog/controller/.../ka_multivendor/vendor/product.php, класс extension\ka_extensions\ka_multivendor\vendor\ControllerProduct) и сохранение в модели товара продавца (getVendorProductFields(), saveProduct()). |
| Поля, сохраняющие одобрение | Переопределите getApprovalFreeFields() модели товара продавца. |
| Данные API | Переопределите collectProductData($product, &$data) контроллера API (.../ka_multivendor/api/product.php), чтобы читать собственные POST-поля. |
| Вкладки страницы заказа продавца | Страница заказа продавца выводит дополнительные вкладки из массива данных tabs (code, title, content). |
Делайте переопределения небольшими: вызывайте родительский метод и изменяйте его результат.
Модель данных
| Таблица / поле | Содержимое |
|---|---|
ka_vendor |
Одна строка на продавца: customer_id (= ID продавца), vendor_status, product_limit, store_commission, vendor_custom_field (JSON), vendor_logo, apikey, кэш рейтинга. |
ka_vendor_description |
Публичное название и описание для каждого языка. |
ka_vendor_order |
Заказы продавцов: vendor_order_id, main_order_id, vendor_id, delivery_status_id, способ, код и стоимость доставки, store_commission (ставка), commission_total, total. |
ka_vendor_review |
Отзывы о продавцах: статус (P, A, R), признак устаревшего отзыва, ответ продавца. |
ka_category_attribute_groups |
Группы атрибутов, предлагаемые для категории. |
product.vendor_id |
Владелец товара; 0 = товар магазина. |
product.vendor_approval, product.vendor_decline_reason |
Статус одобрения ('' - черновик, W - ожидает, A - одобрен) и причина отклонения. |
category.allow_for_vendor |
Флаг «Разрешить для продавцов». |
order_product.vendor_id, order_history.vendor_order_id |
Продавец строки заказа; записи истории заказа продавца (статусы доставки). |
customer_transaction |
Начисления, списания и выплаты продавцам (стандартная таблица OpenCart). |
customer_approval (тип vendor) |
Заявки продавцов, ожидающие одобрения. |
С Custom Shipping Methods способы доставки продавцов - это его способы с владельцем-продавцом; их коды доставки - ka_smethods_.
Адаптация темы
Шаблоны витрины модуля находятся в catalog/view/theme/default/template/extension/ka_extensions/ka_multivendor/ (раздел продавца, список и страница продавцов, корзина, доставка при оформлении заказа, блоки заказа покупателя, письма). OpenCart использует их и для других тем, если в вашей теме нет собственных копий.
Модификация изменяет следующие шаблоны темы по умолчанию. Повторите изменения в своей теме, если у неё есть собственные версии этих шаблонов:
| Шаблон | Изменение |
|---|---|
account/account.twig |
Подключает блок «Мой аккаунт продавца». |
account/order_info.twig |
Показывает заказы продавцов со статусами доставки и «Подтвердить доставку». |
product/product.twig |
Показывает «Продавец: название» с рейтингом. |
common/header.twig |
Добавляет ссылку «Регистрация продавца». |
extension/total/shipping.twig |
Показывает расчёт доставки по продавцам в корзине. |
Точный код смотрите в блоках //karapuz (Multivendor) в install.xml пакета. После изменений обновите Расширения > Модификации и очистите кэш темы.