Управление доп. параметрами

Описание:

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

Где работает плагин?

  1. В продуктах
  2. В категориях
  3. На страницах витрины

Типы полей:

  1. INPUT - Простое текстовое поле
  2. TEXTAREA - Поле для ввода многострочного текста
  3. HTML - Поле с визуальным редактором HTML
  4. SELECT - Поле для выбора из нескольких вариантов значений
  5. IMAGE - Поле для загрузки картинки
  6. FILE - Поле для загрузки любых файлов

Какие частые проблемы решает плагин?

  • Картинка (логотип) категории
  • Дополнительное (второе) описание категории, обычно располагается снизу как статья.
  • Использование разных шаблонов дизайна для категорий, продуктов и страниц.
  • Показ и скрытие определенных категорий или страниц в любом меню, например в главном меню сайта.
  • Принудительное указание заголовка H1 отличного от основного названия страниц, продуктов и категорий.
  • Создание блока "Важно" для страниц с текстом или HTML кодом, обычно он располагается в отдельной колонке дизайна.
  • Примечание к продукту или второе описание.
  • Возможность добавить различные файлы к продукту: инструкции, схемы, софт, драйвера, гарантии, сертификаты и т.д.
  • Создавать красивые меню с картинками и краткими описаниями пунктов.
  • Устанавливать картинку (значок, логотип) или файл сразу для многих категорий, продуктов или страниц.

Указанные здесь возможные применения подробнее описаны в примерах использования.

Области применения плагина очень широки, любые поля, любые значения и вывод в нужном вам месте!


Принцип работы:

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

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


Вывод параметров на витрине:

Вывод доп. параметров через хелпер в любом месте витрины

Получение всех доп. параметров в массив:

Для продукта - {$params = shopAdvancedparamsPlugin::getProductParams($product.id)}
Для категории - {$params = shopAdvancedparamsPlugin::getCategoryParams($category.id)}
Для страницы - {$params = shopAdvancedparamsPlugin::getPageParams($page.id)}

теперь в переменой $params все доп. параметры

Далее получение нужного параметра делается по ключу поля например для поля с ключом opisanie2

{$param = $param['opisamie2']}

Вывод одного определенного параметра по ключу поля

Для продукта - {$param = shopAdvancedparamsPlugin::getProductParam($product.id, 'key')}
Для категории - {$param = shopAdvancedparamsPlugin::getCategoryParam($category.id, 'key')}
Для страницы - {$param = shopAdvancedparamsPlugin::getPageParam($page.id, 'key')}

В переменной $param будет находится объект параметра

В объекте поддерживается вывод следующих значений

  • Значение доп. параметра - {$param->getValue()}
  • Название поля - {$param->getTitle()}
  • Все возможные значения поля (для полей с выбираемым типом) - {$param->getValues()}
  • Значение поля по умолчанию (для полей с выбираемым типом) - {$param->getDefault()}

Установленные значения полей доступны по ключам в переменных:

  • Для продукта - {$product.param.key}
  • Для категории - {$category.param.key}
  • Для страницы - {$page.key}

Где key - ключ дополнительного параметра.

Для правильного вывода параметров на витрине в шаблонах дизайна необходимо добавлять условие проверки существования установленного значения условием:

{if isset( $переменная_параметров.key )}
{ $переменная_параметров.key }
{/if}

Важно: Для полей файловых типов в значениях будет храниться ссылка на файл.

Для поля FILE рекомендуется создавать ссылку на скачивание

<a href="{$product.param.key}">Инструкция товара</a>

Для вывода картинки (поле IMAGE) необходимо заключать значение параметра в тег <img>

<img src="{$product.param.key}" />


Особенности поведения:

Все значения сохраняются независимо от установленных параметров, за счет этого есть возможность отключать и включать вывод определенных параметров на витрину не удаляя реальные значения.

При смене типа поля на тип SELECT (Выбираемое поле) все найденные активные значения будут импортированы как варианты выбора.

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

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