Иконки для товара

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

Пример использования - через модуль, на странице товара выведено две дополнительные иконки, обозначают объем памяти 32 Гб и скидку:

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

На момент написания статьи, модуль является платным. Стоимость модуля составляет 20$ и предусматривает бесплатную установку модуля в системе. Однако, в некоторых случаях, вывод модуля в шаблоне (с учетом версии шаблона, дизайна и пожеланий к месту вывода и виду иконок), может потребовать отдельной оплаты - данный момент вам необходимо обсудить с вашим менеджером.

Внимание!

Модуль предоставляет только возможность вывода дополнительных иконок, но не содержит никаких образцов и/или базового демо-набора иконок.

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

По умолчанию модуль не выведен в шаблоне. Требуется отдельный вывод модуля вне зависимости от шаблона.

1. Начало работы с модулем

Для приобретения данного модуля вам необходимо связаться с вашим менеджером или приобрести его на странице модуля в нашем магазине дополнений

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

Внимание!

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

Установка модуля подразумевает только установку модуля в системе и при этом не содержит точных настроек функционала:

  • создания самих иконок (услуга предоставляется и оценивается отдельно)
  • вывода модуля в старых версиях шаблонов/системы.

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

После оплаты заказа, модуль будет доступен для скачивания в вашем личном кабинете на imagecms.net

1.1. Установка модуля

Внимание!
Установка модуля в системе не предусматривает вывода в шаблоне. Модуль в шаблоне необходимо выводить отдельно.

Рекомендуем заказать установку модуля нашими специалистами - эта услуга является бесплатной при условии покупки модуля. Для этого свяжитесь с вашим менеджером. Однако, если вы желаете самостоятельно установить модуль, руководствуйтесь следующей инструкцией:

Шаг 1: Скачайте архив модуля из вашего личного кабинета на imagecms.net в разделе “Мои дополнения”:


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

Шаг 2: Разархивируйте загруженный архив и содержимую в нем папку mod_pic через FTP в директорию \application\modules на сервере


Примечание:
После загрузки папки модуля на сервер, проставьте права на папку модуля 755 (или 777 - полный доступ) рекурсивно, на все вложенные файлы и папки.

Шаг 3: Перейдите в админ профиль к списку модулей

Осуществите переход в админ профиле "Модули" → "Все модули" → вкладка "Установить модули":



Шаг 4: Клик по ссылке "Установить"

В открывшемся списке модулей должен отображаться модуль "Модуль пиктограмм" - необходимо осуществить клик по ссылке "Установка" напротив данного модуля:

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

Так же, в папке uploads будет создана папка \uploads\mod_pic, в которой будут содержаться загруженные иконки.

Примечание:
После установки, проверьте права (CHMOD) на папку модуля \uploads\mod_pic - права должны быть 777 (полный доступ) рекурсивно.

Шаг 5: После завершения установки - очистите кеш из админ панели

1.2. Модуль в админ-профиле

Изначально, модуль находится в списке модулей: "Модули" - "Все модули" - "Модуль пиктограмм"


Чтобы вывести модуль в список меню, нужно перевести графические переключатели в строке данного модуля в положение: "Активно" (колонка: "Показывать в меню").

После этого, модуль Модуль пиктограмм будет доступен по более короткому пути в админ-профиле: "Модули" - "Модуль пиктограмм".

1.3. Модуль на сервере

Все файлы модуля физически находятся на сервере в папке mod_pic, которая должна находится в директории \application\modules:

В корневой папке модуля находится файл README.md ,с содержание которого мы рекомендуем ознакомится, если вы планируете самостоятельно осуществлять работы по модулю.

Примечание:
Проверьте права на папку модуля - права должны быть 755 (или 777 - полный доступ) рекурсивно, на все вложенные файлы и папки.

1.4. Модуль в базе данных

После установки, модуль создает необходимую для загружаемых иконок папку на сервере uploads\mod_pic, и таблицы в базе данных, необходимые для его работы. Это таблицы:

  • Таблица mod_pic - содержит данные о самих созданных в системе пиктограммах и состоит из колонок:
    • id - колонка, которая содержит уникальный идентификатор пиктограммы в системе. id присваивается как порядковый номер созданной пиктограммы (например id со значением "3" - это третья созданная в системе пиктограмма)
    • name - название пиктограммы, указанное администратором при создании. Содержит текстовое значение в некодированном виде.
    • about - содержит описание пиктограммы, указанное администратором при создании. Содержит текстовое значение в некодированном виде.
    • url - содержит название самой картинки пиктограммы в папке uploads\mod_pic, которое кодируется системой, после загрузки графического файла в систему (перекодировка названия файла, осуществляется для избежания дублей и перезаписи изображений в папке).
    • sort - содержит данные о порядковом местоположении иконки, в общем списке созданных пиктограмм, в админ профиле (например, первая в списке пиктограмма - будет иметь значение "1", вторая - "2" и т.д.)


  • Таблица mod_product_pic - Содержит основные данные о связках товаров и использованных для иллюстрации их страниц пиктограммах
    • id - колонка, которая содержит уникальный идентификатор связки иконка/товар в системе
    • product_id - содержит идентификатор товара в системе, к которому подвязана иконка.
    • pic_id - содержит идентификатор пиктогорамми, которая использована в связке иконка/товар

1.5. Гарантии разработчиков

Пользователям ImageCMS, которые приобрели Модуль пиктограмм, мы, как разработчики данного продукта, предоставляем гарантию на данный функционал сроком на месяц в следующем порядке:

  • При приобретении модуля через менеджера и установке модуля нашими специалистами - гарантия предоставляется на 30 дней с момента окончания и принятия клиентом работ.
  • При приобретении модуля через маркетплейс и самостоятельной установке - гарантия предоставляется на 30 дней с момента покупки модуля.
Внимание!

Гарантия не распространяется и не покрывает следующего:

  • Исправления ошибок, допущенных администратором при самостоятельной установке модуля.
  • Проблем и ошибок в работе модуля, которые возникли из-за правки модуля сторонними специалистами.
  • Проблем, возникающих из-за несоответствия хостинга
  • Исправление ошибок и конфликтов, которые вызваны:
    • Сторонними сервисами и дополнениями, установленными на сайте.
    • Индивидуальными доработками стандартного функционала и/или шаблона
    • Некорректным выводом модуля в шаблоне.

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

2. Настройки и работа с модулем

Настройки модуля предусматривают как некоторые настройки в админ-профиле (создание и порядок пиктограмм, а также атрибут alt), так и настройку отображения модуля в исходном коде шаблона (размер отображаемых пиктограмм и место вывода модуля).

2.1. Создание Иконок товаров (Настройки в админ профиле)

Для создания пиктограммы в системе следуйте следующей инструкции:

Шаг 1: Клик по кнопке "Добавить пиктограмму"

Откройте "Модуль пиктограмм" и осуществите клик по кнопке в правом верхнем углу:

Шаг 2: Укажите название пиктограммы в поле "Название"

Поле является обязательным.

Примечание:
В последующем, название пиктограммы, указанное в данном поле, будет использовано в качесвтве атрибута alt для пиктограммы

Шаг 3: Укажите название пиктограммы в поле "Название"

Поле не является обязательным.

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

Шаг 4: Выберите файл иконки

В строке "Изображение" при помощи кнопки "Выбрать файл" выберите изображение на вашем локальном ПК:

Примечание:

В качестве иконки может быть использовано изображение в формате .png и .jpg. Файлы в форматах .ісо, .icns и .svg - не поддерживаются.

По умолчанию, настройка модуля предусматривает использование картинки размером 32х32 пикселя. Однако, вы можете использовать картинки с большим размером файла оригинала (рекомендуем использовать 64Х64 или 128Х128 - такие размеры позволят сохранить качество картинки, но не повлияют на скорость загрузки страницы и структуру шаблона. Использование больших исходных изображений не целесообразно).

Шаг 5: Сохраните созданную пиктограмму

Сохраните изменения при помощи клика по кнопке "Сохранить":

Шаг 6: После создания всех необходимых пиктограмм - очистите кеш из админ панели

2.1.1. Вывод пиктограммы в товаре (Настройка в админ профиле)

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

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

Шаг 1: Откройте товар, к которому необходимо подвязать пиктограмму.

Выберите необходимый товар из списка товаров и откройте форму его редактирования

Шаг 2: Перейдите на вкладку "Дополнение модулей"


Шаг 3: В блоке "Пиктограмма" отметьте из общего списка пиктограммы, которые следует подвязать к товару.


Шаг 4: Сохраните изменения и очистите кеш

2.2. Вывод в шаблоне (Настройки в исходном коде шаблона)

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

Для вывода в шаблоне модуля, необходимо установить в соответствующий tpl-файл участок кода

{$pictograms = $CI->load->module('mod_pic')->gifp($model->getId())}
{if $pictograms}
  {foreach $pictograms as $pic}
    <img src="{media_url()}uploads/mod_pic/{echo $pic->url}" alt="{echo $pic->name}" width="55" />
  {/foreach}
{/if}
Внимание!

При этом, следует учесть что:

  • Может потребоваться дополнительное оформление элементов модуля стилями
  • Следует учесть положение элементов модуля, относительно других элементов шаблона.

Для вывода кода в шаблоне используйте FTP клиент или встроенный редактор шаблонов

В качестве примеров, можем привести:

Вывод на странице товара, в шаблоне unishop - код вставлен, примерно на 99-100 строке в файл product_intro.tpl в папке \templates\unishop\shop\includes\product


Вывод на странице категории товаров, в шаблоне unishop - код вставлен, примерно на 16 строке, в файле product_rating.tpl в папке templates/unishop/shop/includes/product/


2.2.1 Настройка размера отображаемой иконки

По умолчанию, настройка модуля предусматривает использование картинки размером 32х32 пикселя. Однако, вы можете использовать картинки с большим размером файла оригинала (рекомендуем использовать 64Х64 или 128Х128 - такие размеры позволят сохранить качество картинки, но не повлияют на скорость загрузки страницы. Использование больших исходных изображений не целесообразно).

Для изменения размера выводимой пиктограммы, вам необходимо указать желаемое значение размера в пикселях, в параметре width="32" , где 32 - значение размера (ширины) пиктограммы в пикселях, по умолчанию:

После правки - очистите кеш.

В качестве иконки может быть использовано изображение в формате .png и .jpg. Файлы в форматах .ісо, .icns и .svg - не поддерживаются.

3. Частые вопросы