Горящие акции

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

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

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

Внимание!

Модуль поддерживается системой от версии 4.12 и выше.

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

Если вы используете более ранний (предыдущего поколения) шаблон или версию шаблонов Unishop, Megashop, Multishop, Good Look, Unishop Vertical до 1.3, то необходим дополнительный вывод модуля в шаблоне.

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

1.1 Покупка модуля

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

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

Внимание!

Установка модуля подразумевает только установку модуля в системе и при этом не подразумевает:

  • точных настроек функционала;
  • вывода модуля в шаблоне (в случае, если требуется вывод в шаблоне. Подробнее в пункте 4.2. Вывод в шаблоне)

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

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

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

Рекомендуем заказать установку модуля нашим специалистам.

Эта услуга является бесплатной при условии использования актуальных шаблонов Unishop, Megashop, Multishop, Good Look, Sport Line, Unishop Vertical от версии шаблонов 1.5 и выше.

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

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


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

Шаг 2: Распакуйте содержимую в архиве папку mod_link посредством FTP-клиента на сервер, в директорию \application\modules


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

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

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

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

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

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

Примечание:

Если после загрузки папки в директорию \application\modules модуль не отображается в списке, то:

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

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

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

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


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

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

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

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

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

После инсталляции, модуль создает необходимые для работы таблицы в базе данных. Это таблицы:

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

Состоит из колонок:

  • link_id - колонка, в которой содержится id ссылки в модуле.
  • product_id - колонка, в которой прописывается id товаров, добавленных в горячую акцию (из колонки id в списке товаров)

page_link - таблица, которая содержит информацию о настройках акции. Состоит из колонок:

  • id - колонка, в которой содержится id акции в модуле.
  • page_id - содержится id статической страницы в системе (из колонки id в списке страниц)
  • active_from и active_to - колонки, которые содержат данные о начале и окончании действия акции соотвественно. Допустимые данные о датах кодируются десятизначным числовым кодом (не находятся в открытом виде), если акция временная, и "NULL", если акция постоянная.
  • show_on - колонка, которая содержит данные о том, является ли акция временной. Допустимые значения "1" (да) или "0" (нет)
  • permanent - колонка, которая содержит данные о том, является ли акция постоянной. Допустимые значения "1" (да) или "0" (нет)
Примечание:
Колонки show_on и permanent логически взаимосвязаны - если одна из них содержит значение "1" (да), то другая обязательно будет содержать значение "0" (нет), так как акция не может быть временной и постоянной одновременно.

Так же, создается строка mod_link в таблице components, но никаких, относящихся к работе модуля данных, строка не содержит.

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

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

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

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

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

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

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

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

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

Однако, требуются некоторые предварительные настройки:

Шаг 1: Создайте отдельную категорию статических страниц, например "Акции"

Для модуля необходима отдельная категория статических страниц. Создайте ее при помощи раздела админ панели: "Страницы" - "Создать категорию":

Подробнее о создании категорий статических страниц

Шаг 2: Укажите в настройках для категори необходимые шаблоны

Для групп полей оставьте значение "Без группы" и выберите опцию "Применить для подкатегории":

В блоке настроек "Просмотр страницы" выберите шаблон category_sales как шаблон для этой категории и шаблон page_sales как шаблон страниц этой категории:

При необходимости, можете внести описание и другие настройки категории, по аналогии с обычной категорией статических страниц.

Внимание!
Если вы используете раннюю версию шаблонов UniShop, MultiShop или их производные (до 1.5.), прежде всего установите нужные папки вывода модуля в папку шаблона. Подробнее в пункте "2.3. Вывод в шаблоне"

Шаг 3: Сохраните правки и очистите кеш.

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

Подробнее о работе с меню

2.1. Создание Горячей акции

Внимание!
Перед созданием горящей акции обязательно выполните настройки, описанные выше в пункте 2 "Настройки и работа с модулем".

Для создания горячей акции необходимо:

Шаг 1: Создайте статическую страницу для акции

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

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

Подробнее о работе со страницами

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

После создания и сохранения страницы, к создаваемой странице будут подвязаны поля, которые указаны при создании категории страниц "Акции". В том числе, на вкладке "Дополнительные поля", в форме редактирования страницы, будет добавлено поле "Изображение".

Заполнение данного поля не обязательно, но желательно для более качественного оформления.

Внимание!
Как изображение используйте картинку размером 336х336 (рекомендуемые параметры). Формат - .png (желательно без прозрачного фона) или .jpg. Не рекомендуем использовать картинку с кириллическим названием и/или с пробелом в названии.

В будущем, после завершения создания акции, данная картинка будет отображаться следующим образом:

На странице категории "Акция":

На статической странице горячей акции:

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

В блоке настроек "Перелинковка" осуществите следующие настройки:

  • Показывать ссылки на странице товара - ячейка, значение которой определяет, будет ли показано уведомление об участии товара в создаваемой акции на странице самого акционного товара. Если значение определено как "Выбрано", на странице товара появится элемент вида:

  • Показывать постоянно - ячейка, значение которой определяет время действия акции. Допустимо два значения:
  • Выбрано - акция определяется как постоянная без ограничения во временных рамках. При такой настройке нет возможности указать дату начала и конца акции и не отображается таймер
  • Не выбрано - акция определяется как временная. При такой настройке ниже появляются поля, в которых следует указать дату начала и окончания действия акции при помощи встроенного календаря (календарь открывается при клике на поле "Дата", которое, в свою очередь, появляется при значении "не выбрано", поля "Показывать постоянно"). Так же, если акция определена как временная, отображается таймер, данные в который подтягиваются автоматически из настроек в календаре.

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

В таймере отображается только оставшееся время, без привязки к началу акции.

Товар - поле, при помощи которого следует выбрать связанные с акцией товары. Поиск может осуществлятся по ID, названию и артикулу товара. Выбрать несколько товаров вы можете, зажав и удерживая клавишу CTRL.

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

Внимание!
Блок настроек "Новости для категории продуктов" не имеет отношения к функционалу. Настройки в данном блоке не распостраняются на страницы модуля.

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

2.2. Удаление Горячей акции

Примечание:
Удаление модуля, в целом, не подразумевает удаления страниц. Однако, при удалении модуля, будут удалены таблицы в базе данных - т.е. при повторной установке модуля необходимо будет или создавать привязки повторно, или перед удалением модуля создать копию таблиц модуля page_link и page_link_product с последующим их восстановлением.

2.3. Вывод в шаблоне

Если вы используете раннюю версию шаблона Unishop, Megashop, Multishop, Good Look, Sport Line, Unishop Vertical (версии до 1.5), можете установить модуль самостоятельно руководствуясь данным мануалом. Однако, рекомендуем заказать бесплатную установку у наших специалистов через вашего менеджера.

Установите файлы вывода category_sales.tpl и page_sales.tpl в корневую папку шаблона \templates\ваш_шаблон, скачав актуальную версию вашего шаблона из личного кабинета на imagecms.net - нужно извлечь данные файлы из загруженного архива шаблона.

В файле product_intro.tpl в папке templates/ваш_шаблон/shop/includes/product по умолчанию на 16-той строке (под блоком <!-- SCU Number -- > ) необходимо добавить код:

 <!-- Related post -->
  {if array_key_exists('mod_link', $modules)}
    {$related_posts = module('mod_link')->getLinksByProduct($model->getId())}
    {if $related_posts}
      <div class="product-intro__sales">
        {view('shop/includes/product/product_sales.tpl', [
        'posts' => $related_posts
        ])}
      </div>
    {/if}
  {/if}

 

Внимание!
При этом у вас должен быть файл product_sales.tpl в папке \templates\unishop\shop\includes\product

Получить актуальную копию файла product_sales.tpl вы можете, скачав актуальную версию вашего шаблона из личного кабинета на imagecms.net - нужно извлечь данный файл из загруженного архива шаблона.

2.4 Вывод в виджете "Новости".

Созданные статические страницы горячих акций могут быть выведены в виджете "Новости":

Для этого укажите категорию акционных статических страниц, в настройках виджета "Новости", сохраните и очистите кеш:

Внимание!
Виджет новости (по умолчанию latest_news) должен быть предварительно создан и выведен в шаблоне. Подробнее о работе с виджетами

2.5 Вывод страниц горячих акций в блоге.

Созданные статические страницы горячих акций могут быть выведены в блоге магазина, если таковой есть. Для этого необходимо в настройках главной категории блога указать отображение статических страниц и категории "Акции":

Сохраните и очистите кеш:

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

Как вывести акции в информационном меню в шапке и/или подвале сайта?

Для того, что бы раздел "Акции" отображались в желаемом меню, их необходимо вывести в этих меню отдельным пунктом, по аналогии с разделами "Новости" или "Блог". Переход по админ-профилю "Модули" → "Меню" → выбор необходимого меню из списка (Header/Footer/Mobile info menu) и клик по названию.

Далее необходимо добавить пункт - клик по кнопке "Создать пункт меню" и переход на вкладку "Категории" (если хотите вывести всю категорию) или "Страницы" (если желаете вывести отдельную статическую страницу акции из общей категории) и последующий выбор нужной категории/страницы:

После добавления - сохраните изменения и очистите кеш.

Подробнее о работе с информационным меню

Как вывести таймер в акцию?

Для того, что бы таймер отображался, акция, прежде всего, должна быть временной (иметь дату начала и окончания) - проверьте эту настройку в форме редактирования акции ( подробнее в пункте "2.1. Создание Горячей акции"), а также важна корректность указания даты начала.