Расширение свойств товаров minishop2

Эмоциональное вступление

Вы уже почувствовали боль?...
Мне кажется именно так нужно начинать все статьи про расширение таблиц в MODX, а не "Удобно и очень просто". (Хотя этот вариант еще более-менее). Это п@#$ц как неудобно и вообще нихрена не просто. По крайней мере, когда тебе нужен результат не в точности такой, как описан в инструкции. Потому что много всяких нюансов, отчетов об ошибках нет никаких, и нет понимание логики системы. Кхм.. итак, приступим:)

В общем есть на данный момент 2 статьи, которые дают более-менее понятное описание — winrecovery.ru и docs.modx.pro. Одну из них я беру за основу.

Тут я постараюсь резюмировать хоть что-то, чтобы в следующий раз не рвать на себе волосы, пытаясь в течение часа "быстро, легко и удобно" добавить поле в minishop2.

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

По сути

работы ведутся в контексте minishop2 2.4.11

Вероятно, вы уже знаете, что для того чтобы добавить новые поля, или изменить существующие, нужно создать плагин для MiniShop2. (Не имеет отношения к стандартным плагинам MODX). Этот плагин будет состоять из трех файлов, которые будут расположены:

  1. core/components/minishop2/plugins/ms2extend1/index.php
  2. core/components/minishop2/plugins/ms2extend1/msproductdata.troy.map.inc.php
  3. assets/components/minishop2/plugins/ms2extend1/msproductdata.troy.js

ms2extend1 — это мое название плагина. Оно может быть произвольным

Сперва нужно вручную расширить таблицу MYSQL. То есть ручками через phpMyAdmin создаем нужную колонку в таблице [префикс]ms2_products.

ms2extend1/index.php

Расположение: core/components/minishop2/plugins/ms2extend1/index.php

Это не особо интересный файл с конфигурацией. Тут важно только чтобы пути до двух других файлов были указаны верно.
    return array(
    	'xpdo_meta_map' => array(
    		'msProductData' => require_once dirname(__FILE__) .'/msproductdata.troy.map.inc.php'
    	)
    	,'manager' => array(
    		'msProductData' => MODX_ASSETS_URL . 'components/minishop2/plugins/ms2extend1/msproductdata.troy.js'
    	)
    );

ms2extend1/msproductdata.troy.map.inc.php

Расположение: core/components/minishop2/plugins/ms2extend1/msproductdata.troy.map.inc.php

Расширенную версию этого файла можно посмотреть по ссылке. Там представлены поля разных типов данных. Также можете ориентироваться на файл core/components/minishop2/model/minishop2/mysql/msproductdata.map.inc.php — родной файл настроек minishop2. Он так же по ссылке.

  1. fields — значение по-умолчанию для поля
  2. fieldMeta — Meta-описание поля. Тут надо все четко заполнить:)
  3. indexes — Индексы. На сколько я понимаю - если вы создали индекс в таблице MySQL, то тут его тоже следует указать, а иначе можно не указывать.
return array(
	'fields' => array(
		'currency' => NULL
	)
	,'fieldMeta' => array(
		'currency' => array(
			'dbtype' => 'varchar'
			,'precision' => '5'
			,'phptype' => 'string'
			,'null' => true
			,'default' => NULL
		)
	)
	,'indexes' => array(
		'currency' => array (
			'alias' => 'currency'
			,'primary' => false
			,'unique' => false
			,'type' => 'BTREE'
			,'columns' => array (
				'action' => array (
					'length' => ''
					,'collation' => 'A'
					,'null' => false
				)
			)
		)
	)
);

ms2extend1/msproductdata.troy.js

Расположение: assets/components/minishop2/plugins/ms2extend1/msproductdata.troy.js

Этот файл отвечает за представление полей в админке, и соответственно тут вы можете указать какой будет тип инпута. Этих типов хренова туча, и вот в этом файле тоже есть примеры нескольких вариантов. Стандартные поля MiniShop2 можно посмотреть тут - это файлик минишопа (assets/components/minishop2/js/mgr/product/product.common.js).

Прочитайте еще комментарии в самом файле, там написано про заголовок поля:

miniShop2.plugin.pluginname = { //pluginname менять не надо.
	getFields: function(config) {
		return {
		    // То, что тут написано [[+currency]] - это просто выводится как есть, то есть это не плейсхолдер.
		    // А вот ms2_product_currency_help - это уже ключ словаря, и его нужно создать в разделе "Управление словарями -> minishop2 -> ru" или можно просто текстом прописать и не париться
			currency: {xtype: 'minishop2-combo-autocomplete', description: '[[+currency]]
'+_('ms2_product_currency_help')} } } ,getColumns: function() { return { currency: {width:50, sortable:false, editor: {xtype:'minishop2-combo-autocomplete', name: 'currency'}} } } };

Отображение заголовков у полей

Для того чтобы появились подписи у полей нужно добавить записи в разделе "Управление словарями -> minishop2 -> ru". Алгоритм формирования ключа такой — ms2_product_FIELDNAME

"And.. One more thing" (Почему не работает)

Нужно еще явно указать в настройках, что вы хотите отображать это новое поле.

Переходим в Настройки -> minisop2 -> Товар -> Дополнительные поля товара (ms2_product_extra_fields), и дописываем туда название вашего поля.

Если на данном этапе не отображается заголовок, прочитайте комментарии для файла JS настроек. Там про это написано.

И еще, у меня почему-то не отображались изменения, пока я не нажал Ctrl+F5 (В хроме — перезагрузка стрницы с очисткой кэша).

Форматирование нового поля цены при выводе

Для таких полей как цена, потребуется еще одна правка. В данном случае я решил ее костылем, хотя стоило бы реализовать все правильно, с расширением объекта.

В общем, открываем файлик core/components/minishop2/model/minishop2/msproduct.class.php, находим там public function process(), и дальше все станет понятно.

P.S.

Если я, так же, как и другие авторы, упустил какой-то важный нюанс, или посчитал что-то очевидным и не разъяснил, и от этого у вас ничего не работает, то излейте свою ненависть в комментариях. Спасибо. И простите меня..

Способ поблагодарить автора сайта:

Комментарии (1)

  1. Евгений 10 июля 2019, 16:32 # 0
    Пипец квест. Автор, вы молодец! К несчастью, судьба свела с modx minishop2 — печаль и боль… Главное, где бы ни натыкался на описания — часто встречается словосочетания «из коробки». И еще поражает отсутствие комментариев в большинстве русских солюшенов и мануалов.
    *Комментарий будет опубликован после проверки модератором

    Комментарии easyComm

    Дмитрий 25 октября 2018, 17:55

    Здравствуйте! Все сделал, получилось. А как можно в этот плагин добавить не одно, а два, три, четыре новых свойства? Я дописал, в файл php новые поля, добавил в БД, в словарь, на страничке они вышли, а в админке так и нет. Чего не так, интересно?


    miniShop2.plugin.pluginname = {
    // Изменение полей для панели товара
    getFields: function (config) {
    return {
    contract: {
    xtype: 'minishop2-combo-autocomplete',
    description: '<b>[[+contract]]</b><br />' + _('ms2_product_contract')
    },
    technics: {
    xtype: 'minishop2-combo-autocomplete',
    description: '<b>[[+technics]]</b><br />' + _('ms2_product_technics')
    },
    }
    },
    // Изменение колонок таблицы товаров в категории
    getColumns: function () {
    return {
    contract: {
    width: 50,
    sortable: false,
    editor: {
    xtype: 'minishop2-combo-autocomplete',
    name: 'contract'
    }
    },
    technics: {
    width: 50,
    sortable: false,
    editor: {
    xtype: 'minishop2-combo-autocomplete',
    name: 'technics'
    }
    },
    }
    },
    };

    Администратор

    Здравствуйте, в системной настройки (ms2_product_extra_fields) добавили поля?

    sdgjapdog 25 марта 2018, 15:46

    Спасибо огромное, автор. Я уже начала подбираться к грани отчаяния, но вы меня спасли)

    Александр 17 марта 2018, 22:37

    Наконец-то хоть что-то внятное про добавление новых свойств товаров в minishop2! Спасибо!

    [MODx] Подсказки по API

    [MODx] minishop2 tips

    [Code helper] Заготовки для работы

    Вложенные условия в xPDO MODX

    Контролировать кэширование файлов CSS и JS MiniShop2

    Экспорт паролей из WinSCP

    [MODX] Если getParentIds не работает в плагине

    [MODX, miniShop2] Сделать поле размер обязательным

    [MODX, MiniShop2] Примеры выборки where, optionFilters, innerJoin

    Отключить автозаполнение input

    Преобразовать кодировку в utf8 для базы MySQL

    Преобразовать JSON в HTML

    [MODX] Загрузка сниппета после загрузки страницы через AjaxSnippet

    [MODX, MiniShop2] Отредактировать письмо о заказе - добавить ТВ поле, или что-то еще

    [MODX, pdoCrumbs] Вывести список всех родителей в ТВ поле ресурса

    [JS] Связать значения инпутов через jQuery (биндинг)

    [MODX] Массово обновить ТВ, или другое поле через базу

    [miniShop2] Разместить корзину внутри блока с оформлением заказа

    [OpenCart 1.5.1] Массово изменить адреса картинок у товаров

    Вывести список всех файлов на сервере (и размер файла)

    [PHP] Фиксированная сортировка массива на основе хэша

    Курсы валют с cbr.ru на PHP, с запасным вариантом и кэшированием

    [MODX] pThumb - ресайз изображений. Примеры использования.

    Изменить цену на товар, если в корзине лежит товар из особой категории minishop2

    Скрыть информацию о том, что сайт работает на MODX

    [MODX] Сообщение о том, что сайт использует Cookie

    Не работает подгрузка товаров ajax mfilter2 на мобильном

    Постраничная навигация — набор параметров и CSS PdoPage

    Разбить вывод pdoResources на несколько колонок (блоков)

    [MODX] Добавить скрипт перед тегом body

    [PHP] Узнать скорость выполнения кода. Простой таймер PHP

    Вывести список всех емэйлов miniShop2

    [MODX] Создать редирект через autoRedirector API

    [MODX, MiniShop2] Отредактировать шаблон письма

    [MODX] Кастомный чанк для AdminPanel

    [MODX] Оформление и настройка easyComm. Комментарии и отзывы на сайте.

    [MODX, MiniShop2] Обязательный чекбокс при оформлении заказа

    [JS] Маска для ввода телефона +7(___)___-__-__

    [MODX, MiniShop2] Добавить в письмо контактную информацию

    [MODX, MiniShop2] Email сделать не обязательным полем

    [MODX] Импорт и экспорт в MiniShop2. Реализация 1

    [MODX, MiniShop2] Изменить формат номера заказа

    Изменить цену на товар в зависимости от количества при добавлении в корзину minishop2

    Общая сумма по каждому товару в корзине Minishop2

    reCaptcha не через форму (без тега <form>)

    Расширение свойств товаров minishop2

    pdoPage и getImageList - Постраничная навигация MIGX

    [MODX] Соответствие названия классов с названиями таблиц в MySQL

    Вывести 404 ошибку по настройки TV MODX

    Расширить таблицу site_content (объект modResource) за 5 минут

    Передать файл с одного на другой сервер

    Создать ресурс процессором $modx->runProcessor('resource/create', $props)

    Как включить HTTPS (SSL) в MODX - Подробная инструкция

    [MODX, MIGX] Простейшая авторизация

    [MIGX] Простая и симпатичная галерея fancybox

    [MODX] Узнать размер файла

    Красивое адаптивное меню под pdoMenu

    pdoResources Заготовки для работы

    FontAwesome - часто используемые иконки для шаблонов MODX

    [MODX, MIGX] Тип поля "Список ресурсов" (resourcelist) с ограничением по родителю (parents)

    [MODX, MIGX] Вывести getImageList только если он не пустой

    Bxslider отображение картинок после полной загрузки слайдера

    [MODX] Вывести список всех опций MiniShop2

    [MODX] Курсы валют с cbr.ru на PHP

    [MODX, MIGX] Простой аудио-плеер HTML5

    Как контролировать кэш CSS и скриптов

    [OpenCart] Вывести на главную все категории с картинками

    [PHP] Получить древовидный массив за один запрос к базе

    Вырезать кавычки - фильтр MODx

    Регулярное выражение

    [MODx] Генератор настроек MIGX

    [MODx, MIGx] Документация на русском по MIGx

    [MODx] Динамическое поле emailSubject в FormIt

    [MODx] Установить шаблон по-умолчанию для новых, создаваемых ресурсов

    [MODx,MiniShop2] Не приходит почта администратору

    [MODx] Баннеры с использованием BannerY

    [Opencart] Вернуть английский язык, если вы его удалили

    Универсальная форма обратной связи — feedBackForm

    [MODx, miniShop2] Генерация YML для выгрузки в маркет

    Редиректы

    [MODx] pdoPage pagination css

    [MODx] Вывести время загрузки (формирования) страницы

    [MODx] Создать источник файлов

    [MODx, minishop] Фильтрация по TV параметрам в msProducts

    Регулярные выражения notepad++ примеры

    [MODx] Создать свою страницу в админке

    [JS] Заготовочки

    [MODx] Поиск на сайте с пакетом SimpleSearch

    [MODx, XML] Ответ для сервиса moneta.ru

    [MODx] Подключить MODx в стороннем PHP файле

    [MODx] Создать пакет с пользовательской таблицей

    [PHP] Простое логирование

    [OpenCart] Вывести модуль напрямую через контроллер

    [MODx, Gallery] Галерея. Вывести обложки альбомов и фотографии

    [MODx, MIGX] Примеры использования

    [MODx] Сайт на обслуживании (выключить сайт)

    [Opencart, FilterPro] Не работает пагинация

    [OpenCart] Заготовки для автоматического заполнения товарами магазина 1.5.5.1.2

    [PHP] Разные фишки, заготовки

    [PHP, JSON] Пример перевода с помощью Yandex Translate API

    [MySQL] Примеры запросов

    [MODx] Вывод tv-параметров в формате [название TV] - [значение TV]

    [MODx] Дата на русском

    [MODx] Ускорить установку MODx revo до пары кликов

    [Opencart] API tips

    [MODx, Quip] Отсортировать ресурсы по количеству комментариев Quip MODx

    [PHP] Загрузить файл для постобработки

    [Opencart 2] Показывать в категориях

    [MODx, Quip] Более рабочий вариант.

    [MODx] Получить grandparent. Вывести родитель родителя

    [MODx] Вывести все доступные плейсхолдеры.

    [MODx] getResources заготовки

    [MODx] Счетчик посещений и скачиваний для сортировки ресурсов

    [MODx] Как разместить исходный код сниппета на сайте, в документации

    Удалить HTML-теги span, и стили из тега br

    Полезные ссылки

    Все записи