Виджеты

 

1. Обзор

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

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

В целом, виджеты можно распредилить по типу:

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

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

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

Если вы создаете новый виджет типа HTML, учытывайте его местоположение относительно других элементов на странице и адаптивность верстки, при создании стилей под него.

К началу

1.1. Список виджетов в админ профиле (на основе шаблона UniShop и производных)

Что бы открыть список виджетов, вам необходимо осуществить переход в админпанели в пункт "Настройки" - "Виджеты":

К началу

1.2. Файлы виджетов на сервере

На сервере, файлы, отвечающие за вывод виджетов, находятся в папке \templates\ваш_шаблон\widgets и доступны так же через модуль "Редактор шаблонов"

В папке содержатся файлы (для новых шаблонов 4.11):

  • brands.tpl - шаблон виджета брендов
  • breadcrumbs.tpl - виджет "Хлебных крошек"
  • features.tpl - шаблон виджета преимуществ сайта
  • languages.tpl - виджет переключатель языка
  • latest_news.tpl - шаблон виджета "Последние новости"
  • mobile_langs.tpl - шаблон виджета переключения языков в адаптивных версиях (на мобильных устройствах)
  • popular_products_category.tpl - шаблон виджета "Популярные категории"
  • products_hits.tpl - шаблон виджета "Популярные товары"
  • products_similar_sidebar.tpl - шаблон виджета "Похожие товары"
  • products_viewed.tpl - шаблон виджета "Просмотренные товары"
  • special_products.tpl - шаблон виджета "Спецпредложения"
Примечание:
Шаблоны имеют только виджеты типа "Модуль". Виджеты типа "HTML" не имеют своих шаблонов и выводятся непосредственно html-кодом.

К началу

2. Виджеты по типу "Модуль":

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

Например:

  • "Новости" - выводит список статических страниц согласно настройкам.
  • "Хиты и новинки" - выводит товары, отмеченные в админке как "Хит" и/или "Новинка"

и т.д.

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

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

К началу

2.1 Выбор языка- languages

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

Данный виджет имеет смысл только в случаях если:

  • Вы используете ImageCMS Shop в редакции Premium (в редакции Pro не предусмотрена мультиязычность) облачное решение Premmerce (тарифы Business и Premium) или сборку Corporate.
  • Ваш сайт уже имеет полноценную версию перевода на другой язык.

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

Виджет рекомендуем выводить примерно следующим участком кода:

<div class="стиль__виджета">
{widget('languages')}
</div>

или просто {widget('languages')} - в зависимости от местоположения виджета, относительно других элементов страницы и места вывода в шаблоне.

Для вывода виджета в примере, использован код

<div class="page__user-bar">
{widget('languages')}
</div>

Код был размещен в файле header.tpl в папке \templates\шаблон\includes (актуально для новых шаблонов) перед {view('includes/header_toolbar.tpl')}

Примечание:
В виджет автоматически подтягиваются все созданные, при помощи раздела "Языки" локализации. Выборочно отключить из админпанели некоторые из них возможности нет.

Допустимы настройки в колонке "Ключ" (подробнее в пункте "7. Общие настройки виджетов")

После правки/установки виджета очистите кеш из админ панели.

К началу

2.2 Новости- latest_news

Виджет, выводящий на страницу краткий список статических страниц, по умолчанию принадлежащих к категории "Новости":

Виджет рекомендуем выводить следующим участком кода:

<div class="стиль__виджета">
{widget('latest_news')}
</div>

или просто {widget('latest_news')} - в зависимости от местоположения виджета, относительно других элементов страницы и места вывода в шаблоне.

Для вывода виджета в примере (шаблон unishop), использован код

<div class="col-sm-7">{widget('latest_news')}</div>

который выведен в файле start_page.tpl ,в папке \templates\unishop\shop

После правки/установки виджета - очистите кеш из админ панели.

Допустимы настройки в колонках "Ключ" и "Настройки" (подробнее в пункте "7. Общие настройки виджетов")

В разделе настроек виджета вы можете указать:

  • Сортировать по - поле, в котором можно указать способ сортировки (вывода) статей в виджете, выбрав значение:
    • "Последним" - Сортировка статей по дате добавления (с начала новые)
    • "Популярным" - Сортировка статей по количеству просмотров (с начала более популярные)
  • Категория - поле, в котором необходимо указать категории, страницы которых будут отображатся в виджете. Что бы выбрать несколько категорий, зажмите и удерживайте кнопку Ctrl при выборе.
  • Количество новостей для отображения - поле, в котором можно указать число статей, выводимых в виджете.
  • Максимальное количество символов - поле, в котором следует указать количество символов с пробелами, которое будет использовано для формирования краткого описания статьи на фронтенде (если вывод описания предусмотрен в шаблоне виджета вашего шаблона).

Примечание:

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

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

Добавить дополнительное поле подобного типа можно через функционал Страницы → Конструктор полей → добавить новое поле с переменной list_image .

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

Важно:
Для смены (кастомизации) URL, на который осуществляется переход при клике на "Смотреть все" в заглавии вижета , можно непосредственно в файле \templates\шаблон\widgets\latest_news.tpl в строке , содержащей "site_url...".

К началу

2.3 Лучшие производители- brands

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

Примечание:
Виджет по умолчания выводится не на всех шаблонах.

Виджет выводится следующим участком кода:

<div class="стиль__виджета">
{widget('brands')}
</div>

или просто {widget('brands)} - в зависимости от местоположения виджета относительно других элементов страницы и места вывода в шаблоне.

Для вывода виджета в примере (шаблон unishop), использован код

<div class="col-sm-5 col--spacer-sm">{widget('brands')}</div>

который выведен в файле start_page.tpl в папке \templates\unishop\shop

Допустимы настройки в колонках "Ключ" и "Настройки" (подробнее в пункте "7. Общие настройки виджетов")

В разделе настроек виджета вы можете указать:

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

После правки/установки виджета - очистите кеш из админ панели.

К началу

2.4 Хлебные крошки- breadcrumbs

Виджет навигации, выводящий на всех страницах магазина путь к странице, на которой находится пользователь:

Виджет, по умолчанию выводится участком кода:

{widget('breadcrumbs')}

который выведен в файле main.tpl в корневой папке шаблона.

Допустимы настройки в колонке "Ключ" (подробнее в пункте "7. Общие настройки виджетов")

После правки/установки виджета очистите кеш из админ панели.

К началу

2.5 Преимущества- features

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

По сути, виджет features является альтернативой виджета benefits, который использовался в более ранних версиях системы, но в отличии от benefits, виджет features относится к типу "Модуль" (виджет benefits относится к типу HTML)

Виджет, по умолчанию выводится участком кода:

{widget('features')}

или (в зависимости от шаблона)

<div class="стиль__виджета">
{widget('features')}
</div>

Для вывода виджета в примере (шаблон Multishop), использован код {widget('features')} в файле footer.tpl в папке \templates\multishop\includes

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

При этом:

  • Заголовок пункта виджета - это название страницы (в примере это "Качественный сервис")
  • Текст пункта - это содержимое поля "Предварительное содержание" (в примере это "Быстрая обработка заказа")
  • Иконка пункта - указывается на вкладке "Дополнительные поля"

Внимание!
Просим учесть правило: одна страница - один пункт в вижете.

После правки/установки виджета очистите кеш из админ панели.

К началу

2.6 Просмотренные товары- products_viewed

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

Для вывода виджета в примере (шаблон unishop) использован код:

<!-- Viewed products widget. Hidden on order page -->
{if $CI->core->core_data['data_type'] != 'cart'}
{widget('products_viewed')}
{/if}

в файле main.tpl ( по умолчанию 88 строка )

В разделе настроек виджета вы можете указать:

  • "Количество товаров для отображения" - поле, в котором можно указать количество выводимых товаров в виджете

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

Рекомендуемое количество - 4. Максимальное значение - 20.

После правки/установки виджета - очистите кеш из админ панели.

К началу

2.7 Виджеты "Спецпредложения" и "Хиты и новинки" - products_hits и special_products

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

Для вывода виджета в примере (шаблон unishop) использован код:

{widget('products_hits')}

в файле start_page.tpl ( по умолчанию - 5-я строка )

В разделе настроек виджета вы можете указать:

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

Примечание:

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

По умолчанию, за отображение страниц данного типа отвечает файл bestseller.tpl в папке \templates\ваш_шаблон\shop

Предусмотрена возможность вывести как отдельную страницу под каждый статус товаров ("Хит", "Новинка", "Акция" в списке товаров) так и общую страницу, на которой будут выведены все отмеченные товары.

Для вывода подобной страницы вам необходимо создать пункт в меню (в Header, Footer и/или в Mobile info menu - подробнее) пункт по типу "Ссылка" при этом указав прямую ссылку:

  • shop/action_type/show/all - для вывода общей страницы, для всех отмеченых товаров, вне зависимости от статуса товара.
  • shop/action_type/show/hot - для вывода страницы товаров, отмеченых как "Хит".
  • shop/action_type/show/action - для вывода страницы товаров, отмеченых как "Акция".
  • shop/action_type/show/hit - для вывода страницы товаров, отмеченых как "Новинка".

После правки/установки виджета - очистите кеш из админ панели.

К началу

2.8 Похожие товары- products_similar_sidebar

Виджет, с помощью которого можно вывести на страницы магазина (в зависимости от шаблона, все или некоторые) список ранее просмотреных пользователем товаров:

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

В разделе настроек виджета вы можете указать:

  • Количество товаров для отображения - Поле, в котором можно указать количество товаров для отображения.

После правки/установки виджета - очистите кеш из админ панели.

К началу

2.9 Выбор языка на мобильной панели- mobile_langs

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

Для вывода виджета необходимо в файле mobile_frame.tpl в папке \templates\ваш_сайт\includes добавить строку кода:

{widget('mobile_langs')}

Вывод виджета, как в примере, осуществлен вставкой кода в 3-ю строку по умолчанию:

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

Допустимы настройки только в колонке "Ключ" (подробнее в пункте "7. Общие настройки виджетов")

После правки/установки виджета - очистите кеш из админ панели.

К началу

2.10 Популярные товары- popular_products_category

Виджет выводит на страницах товарных категорий товары, отмеченные как "Хит" "Новинка" "Акция" в списке товаров. По сути, данный виджет аналогичен виджетам Виджеты "Спецпредложения" и "Хиты и новинки" (products_hits и special_products) с настройками по умолчанию:

  • ячейка "Хит" - выбрано
  • ячейка "Учитывать категорию" - выбрано

Допустимы настройки в колонке "Ключ" (подробнее в пункте "7. Общие настройки виджетов")

Примечание:
По умолчанию виджет отображается только в категории , шаблон вывода которой - section.tpl


 

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

{widget('popular_products_category')}

в файле section.tpl в папке \templates\unishop\shop по умолчанию на 26-й строке:

В разделе настроек виджета вы можете указать:

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

После правки/установки виджета - очистите кеш из админ панели.

К началу

3. Виджеты по типу HTML

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

К началу

3.1 SEO-текст на главной странице- start_page_seo_text

Виджет, содержащий общий сео-текст. Чаще всего виджет располагается в низу главной страницы:

Отредактированить содержимое виджета можно, осуществив клик по названию виджета start_page_seo_text в списке виджетов, а затем отредактировав текст в поле HTML код:

После правки/установки виджета - очистите кеш из админ панели.

Важно!

Необходимо вносить изменения в HTML-виджеты, содержащие картинки , форматирование и т.п., в открывающейся форме редактирования с помощью кнопки "инструменты → исходный код"

При осуществлении изменений обратите внимание на код HTML - его нарушение может привести к некорректному отображению информации в виджете.

К началу

4. Создание виджета

Кроме уже созданных по умолчанию виджетов, вы можете создать или добавить виджеты по своему усмотрению. Это могут быть виджеты как по типу "Модуль", так и по типу HTML.

К началу

4.1 Создание виджета по типу Модуль

В этом примере предоставлено краткое руководство по созданию виджета типа "Модуль", на основе уже существующего в системе функционала.

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

Для создания виджета по типу "Модуль" вам необходимо:

Шаг 1: Клик по кнопке "Создать виджет"

В общем списке виджетов осуществите клик по кнопке "Создать виджет" в правом верхнем углу.

Шаг 2: Укажите название создаваемого модуля

В форме создание виджета, в разделе "Свойства" в верху формы, необходимо:

В поле "Название" - укажите название виджета, которое будет отображатся в общем списке виджетов, на пример - "Мой виджет 1":

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

Поле обязательно для заполнения

Шаг 3: Укажите ключ для виджета

В поле "Ключ" - укажите ключ, например - my_widget

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

{widget('ключ_виджета')}

Примечание:

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

Ключ должен быть уникальным для каждого виджета и не должен повторятся.

Поле обязательно для заполнения

Шаг 4: Укажите описание виджета

В поле "Описание" вы можете создать краткое описание создаваемого виджета. Содержимое поля не отображается на фронтенде и используется только в качестве внутреней метки для администратора (например "Мой дополнительный виджет для товарной категории")

Поле не обязательно для заполнения. Поле может содержать любые символы.

Шаг 5: Выберите тип

Выберите значение "Модуль" в поле "Тип":

Действие обязательно для создания виджета данного типа

Шаг 6: Выбор функции

Необходимо осуществить выбор функции для создаваемого виджета из списка предусмотреных (созданных в системе по умолчанию или доработаных) в системе виджетов при помощи чекбокса:

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

Шаг 7: Сохранение виджета

Сохраните созданный виджет при помощи кнопки "Создать" или "Создать и выйти" в правом верхнем углу экрана.

Внимание!

После создания виджета по типу "Модуль" в папке \templates\ваш_шаблон\widgets автоматически будет создан файл .tpl с ключем созданого виджета в качестве названия (например, my_widget.tpl ). В данном файле буде содержатся основная функция виджета и базовые стили (по умолчанию)

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

После правки/установки виджета - очистите кеш из админ панели.

К началу

4.2. Создание виджета по типу HTML

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

Шаг 1: Клик по кнопке "Создать виджет"

В общем списке виджетов осуществите клик по кнопке "Создать виджет" в правом верхнем углу.

Шаг 2: Укажите название создаваемого модуля

В форме создание виджета, в разделе "Свойства" вверху формы, необходимо:

В поле "Название" - укажите название виджета, которое будет отображатся в общем списке виджетов, например - "Мой виджет 1":

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

Поле обязательно для заполнения

Шаг 3: Укажите ключ для виджета

В поле "Ключ" - укажите ключ, например - my_widget

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

{widget('ключ_виджета')}
Примечание:

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

Ключ должен быть уникальным для каждого виджета и не должен повторятся.

Поле обязательно для заполнения

Шаг 4: Укажите описание виджета

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

Поле не обязательно для заполнения. Поле может содержать любые символы.

Шаг 5: Выберите тип

Выберите значение "HTML" в поле "Тип":

Действие обязательно для создания виджета данного типа

Шаг 6: Укажите HTML код

Укажите необходимый HTML код в соответствующем поле, выбрав в разделе "Инструменты" пункт "Исходный код":

Шаг 7: Сохранение виджета

Сохраните созданный виджет при помощи кнопки "Создать" или "Создать и выйти" в правом верхнем углу экрана.

После правки/установки виджета - очистите кеш из админ панели.

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

Как разработчики системы ImageCMS, при интеграции сторонных сервисов в нашу систему (кроме продуктов Google и Яндекс, а также продуктов наших партнеров), мы не можем гарантировать их коррекную работу (как и вашего сайта в целом, так и отдельных его скриптов).

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

К началу

5. Вывод виджета в шаблоне

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

К началу

5.1 Работа с файлами шаблона

Что бы вывести виджет на страницу сайта вам необходимо вставить код вида

{widget('ключ_виджета')}

или

<div class="стиль__виджета">
{widget('ключ_виджета')}
</div>

В зависимости от шаблона и желаемого отображения виджета.

в .tpl файл - файл шаблона определенного типа страниц, а именно для вывода виджета на:

  • Всех страницах - файл main.tpl в корневой папке шаблона
  • Главной странице - файл start_page.tpl в папке \templates\ваш_шаблон\shop
  • Товарной категории - файл category.tpl и/или section.tpl в папке \templates\ваш_шаблон\shop
  • Отдельного товара - файл product.tpl в папке \templates\ваш_шаблон\shop
  • Бренда - файл brand.tpl в папке \templates\ваш_шаблон\shop
  • Статической страницы специальных товарных предложений - файл bestseller.tpl в папке\templates\ваш_шаблон\shop
  • Для вывода виджета в футере (в "подвале", на всех страницах) - файл footer.tpl в папке \templates\ваш_шаблон\includes
  • Для вывода виджета в хедере ( в "шапке", на всех страницах) - файл header.tpl в папке \templates\ваш_шаблон\includes
Примечание:

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

Некоторые виджеты с типом "Модуль" не имеют необходмого оформления стилями.

К началу

5.2. Работа с файлами стилей

Если вам необходимо создать или поправить существующий стиль для оформления виджета, вам необходимо работать только с файлом custom.css в папке \templates\ваш_шаблон\_css

По умолчанию файл custom.css - пуст.

Примечание:

Файли стилей в актуальных шаблонах ImageCMS Shop минимизированы. Если вы не обладаете знаниями и навыками работы с подобными файлами, не рекомендуем осуществлять какие-либо правки в данных файлах.

Файл custom.css имеет приоритет высше, чем другие файлы стилей - внесенные в нем правки будут отображатся как актуальные.

Если у вас нет файла custom.css в \templates\unishop\_css, то вы можете просто создать его.

Если в процессе работы вам необходимо указать стиль для формления виджета (используемый для обрамления кода виджета), используйте файлы шаблонов страниц (например main.tpl или category.tpl и т.п.).

Если вам необходимо задать/поправить стиль используемый "внутри" самого виджета, осуществляйте правки непосредственно в шаблоне редактируемого виджета в папке \templates\ваш_шаблон\widgets (например в my_widget.tpl ).

Подробнее

К началу

6. Виджеты в мультиязычном магазине

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

Примечание:
При переводе ни в коем случае не изменяйте значение в поле "Ключ" - его значение должно оставатся неизменно для всех языковых версий.

К началу

6.1 Перевод виджета по типу Модуль

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

Если же в виджете есть какая-либо другая фраза/слово кроме заголовка (например добавлена ссылка "Смотреть все" в созданном виджете), в таком случае ее необходимо оформить кодом:

<a class="стиль_ссылки" href="ссылка">{tlang('Смотреть все')}</a>

в файле my_widget.tpl. При использовании тега tlang, текст будет подлежать автоматическому переводу через модуль "Переводчик".

Документация

Шаг 1: Откройте форму редактирования виджета

Осуществите клик по содержимому в колонке ключ, в строке виджета подлежащего настройке.

Шаг 2: Выберите языковую версию

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

Шаг 3: Внесите перевод в поле "Название"

Шаг 4: Сохраните перевод

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

После изменений очистите кеш.

К началу

6.2 Перевод по типу HTML

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

Для перевода HTML виджета необходимо:

Шаг 1: Откройте форму редактирования виджета

Осуществите клик по содержимому в колонке ключ, в строке виджета подлежащего настройке.

Шаг 2: Выберите языковую версию

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

Шаг 3: Откройте исходный код виджета

Выбрав в разделе "Инструменты" пункт "Исходный код"

и в открывшейся форме укажите HTML-код с переведенными (в ручную) фразами.

Шаг 4: Сохраните перевод

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

После изменений очистите кеш.

К началу

7. Общие настройки виджетов

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

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

Примечание:

Раздел настроект имеют только виджеты созданные в системе по умолчанию или же созданные с использованием предусмотренных функций.

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

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

  • Дате - способ, выводящий элементы по дате их создания
  • Популярным - способ, выводящий элементы по количеству просмотров
  • Последним - способ, который выводит последние созданные элементы.

Поле присутствует в настройках виджетов:Новости, Преимущества, Спецпредложения, Популярные/Новые/Акционные товары.

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

Поле присутствует в настройках виджетов: Новости, Преимущества, Похожие страницы.

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

Поле присутствует в настройках виджетов: Новости, Преимущества.

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

Не рекомендуем использовать меньше чем 50 и больше 100-140 символов.

Поле присутствует в настройках виджетов: Новости, Преимущества, Последние комментарии, Последние отзывы о товарах.

Показать - поле позволяет настроить выводимые в виджете бренды производителей, при помощи значений:

  • Только c фото - в виджете будут выведены только бренды, для оформления которых использован логотип или другая картинка.
  • Все, в том числе без фото - в виджете будут выводится все бренды, вне зависимости от того есть ли у бренда логотип

Поле присутствует в настройках виджетов: Бренды (Лучшие производители).

Количество брендов для отображения - поле, в котором можно указать количество брендов для отображения в виджете. Поле должно содержать только числовое значение

Поле присутствует в настройках виджетов: Бренды (Лучшие производители).

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

Поле присутствует в настройках виджетов: Спецпредложения, Просмотренные товары, Похожие товары (Похожие продукты), Популярные/Новые/Акционные товары.

Ячейки "Новинки", "Акции", "Хиты" и "Старая цена" - при помощи данных ячеек можно настроить вывод в виджете товаров, имеющих определенную метку в общем списке товаров и/или прописанную старую цену в форме редактирования.

Поле присутствует в настройках виджетов: Спецпредложения, Популярные/Новые/Акционные товары.

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

Поле присутствует в настройках виджетов: Спецпредложения, Просмотренные товары, Похожие товары (Похожие продукты), Популярные/Новые/Акционные товары.

Количество комментариев для отображения - поле, в котором можно указать количество комментариев для отображения в виджете. Поле должно содержать только числовое значение.

Поле присутствует в настройках виджетов: Последние комментарии, Последние отзывы о товарах.

К началу

8. Удаление виджета

Не зависимо от того, какого типа виджет, порядок его удаления следующий:

Шаг 1: Открыть список виджетов:

Осуществите переход по админпанели "Настройки" - "Виджеты":

Шаг 2: Отметить виджет подлежащий удалению

Отметьте виджет, который необходимо удалить, при помощи колонки выбора, в списке виджетов:

Шаг 3: Клик по кнопке "Удалить"

После вибора виджета, на панели списка появится кнопка "Удалить".

Шаг 4: Очистите кеш.

Для того, что бы изменения вступили в силу немедленно, вам необходимо очистить кеш из админ профиля: "Настройки" - "Очистить кеш"

Примечание:

Если вы удаляете виджет типа "Модуль", то после его удаления через админ профиль, автоматически будет удален соответствующий файл .tpl в папке \templates\ваш_шаблон\widgets.

Возможности восстановить удаленный виджет (вне зависимости от его типа) - нет.

К началу

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

Как убрать виджет "Просмотренные товары"?

В файле main.tpl по умолчанию 88 строка 

{if $CI->core->core_data['data_type'] != 'cart'} - земените ее на: 

Что бы убрать виджет с главной страницы - {if $CI->core->core_data['data_type'] != 'cart' && $CI->core->core_data['data_type'] != 'main'}

Что бы убрать виджет с страницы категории - {if $CI->core->core_data['data_type'] != 'cart' && $CI->core->core_data['data_type'] != 'shop_category'}

Что бы убрать виджет с страницы товара - {if $CI->core->core_data['data_type'] != 'cart' && $CI->core->core_data['data_type'] != 'product'}


В виджете "Спецпредложения" или "Хиты и новинки" не отображается товары со старой ценой.

Если некоторые товары в виджете (при настройках виджета в поле “Старая цена” - значение выбрано) не отображают старую цену, то, скорее всего, старая цена конкретного товара ниже текущей актуальной цены. В таком случае система не отображает старую цену..

Ошибка \system/cache/templates_c/44.....8.php does not exists! при переходе к акциям (пункт меню)

Проверьте файл bestseller.tpl в папке \templates\ваш_шаблон\shop - скорее всего, файл поврежден или удален.

Хлебные крошки выводятся в неверном порядке:

В файле /application/modules/shop/models2/generated-classes/SCategory.php в функции buildCategoryPath , строку 144 (return $result;) заменить на:

$goodArrayTemp = array();
foreach ($result as $value) {
$goodArrayTemp[$value->getId()] = $value;
}
$goodArray = array();
foreach ($ids as $key => $value) {
$goodArray[$key] = $goodArrayTemp[$value];
}
return $goodArray;

Как изменить текст на главной странице?

Виджет, содержащий общий сео-текст. Чаще всего виджет располагается в низу главной страницы:

Отредактированить содержимое виджета можно, осуществив клик по названию виджета start_page_seo_text в списке виджетов, а затем отредактировав текст в поле HTML код:

После правки/установки виджета - очистите кеш из админ панели.

Важно!

Необходимо вносить изменения в HTML-виджеты, содержащие картинки , форматирование и т.п., в открывающейся форме редактирования с помощью кнопки "инструменты → исходный код"

При осуществлении изменений обратите внимание на код HTML - его нарушение может привести к некорректному отображению информации в виджете.

К началу

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

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

1. Виджеты, установленные по умолчанию, в ImageCMS Shop - это основные и наиболее полезные для покупателя элементы, которые являются уже созданными и встроенными. А также которые по умолчанию, отображаются на соответственных страницах (в файлах .tpl).

Это такие виджеты как:

1.1 Виджеты на главной странице магазина:

1.1.1 Виджет "Преимущества" - предназначен для краткого перечня преимуществ, которые получит покупатель, приобретя товар именно в вашем интернет-магазине. (относится к типу виджетов - HTML)

Находится в папке templates\newLevel\widgets

<div class="frame-benefits">
{widget('benefits')} 
</div>



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

Находится в папке templates\newLevel\widgets

<div id="popular_products">
{widget('popular_products', TRUE)}
</div>

Находится в папке templates\newLevel\widgets

<div id="action_products">
{widget('action_products', TRUE)}
</div>


1.1.4 Виджет "Новинки" - предназначен для представления в интерфейсе покупателя товаров, которые недавно появились на рынке или начали продаваться с площадки вашего интернет-магазина. Данный виджет состоит из товарных позиций, которым присвоено, через список товаров, значение "Новинка".

Находится в папке templates\newLevel\widgets

<div id="new_products">
{widget('new_products', TRUE)}
</div>


1.1.5 Виджет "Бренды" - предназначен для группового представления в интерфейсе покупателя список производителей товаров, которые продаются с площадки вашего интернет-магазина. Данный виджет состоит списке производителей товаров, который создан самим администратором интернет-магазина через пункт меню управления "Бренды".

Находится в папке templates\newLevel\widgets

<div>
{widget('brands')}
</div>



1.1.6 Виджет "SEO - текст" - предназначен для позмищення текстового краткого описания интернет-магазина, созданного с целью СЕО оптимизации индексации в поисковых системах интернет магазина. (относится к типу виджетов - HTML).
Находится в папке templates\newLevel\widgets

<div class="text seo-text">
{widget('start_page_seo_text')}
</div>



1.1.7 Виджет "Новости" - предназначен для размещения текстового контента, который должен отражать последние события интернет-магазина или освещать определенный информационный аспект, интересный аудитории покупателей магазина. (относится к типу виджетов - HTML).
Находится в папке templates\newLevel\widgets

<div>
{widget('latest_news', TRUE)}
</div>



1.2 Виджеты на страницах товаров:

1.2.1 Виджет "Похожие товары" - предназначен для генерирования на странице товара, в интерфейсе покупателя, списка товаров аналогичных тому продукту, который заинтересовал покупателя и мотивировал ознакомиться с ним подробнее.
Находится в папке templates\newLevel\widgets

<!-- Start. Similar Products-->
{widget('similar')}
<!-- End. Similar Products-->

1.2.2 Виджет "Новости" (тоже что и 1.1.7)
Находится в папке templates\newLevel\widgets

<!-- Start. News-->
{widget('latest_news')}
<!-- End. News-->



2. Просмотреть Виджеты - можно, выбрав пункт главного меню пользователя "Настройки", а в нем подпункт "Виджеты":



После чего перед вами откроется окно "Cписок виджетов" следующего вида:




3. Элементы окна "Список виджетов"
следующие:

  • Столбец выбора - позволяет осуществить выбор виджета, подлежащего удалению;
  • Столбец "ID" - столбец, содержащий уникальный идентификационный номер созданного виджета;
  • Столбец "Имя" - содержит имя файла, который содержится в templates \ newLevel \ widgets и отвечает за функционирование определенного виджета;
  • Столбец «Тип» - указывает на то, тип к которому относится определенный виджет;
  • Столбец "Описание" - содержит краткое текстовое описание виджета, созданного умолчанию, или администратором. Содержание этого столбца используется в качестве подсказки, о роли виджета , для пользователей с правами администратора;
  • Столбец "Настройки" - содержит функциональную клавишу напротив тех виджетов, которые обладают возможностью опциональной настройки.В основном - это виджеты типа "модульные";


4. Типи виджетов
- в разных версиях дистрибутивов ImageCMS Shop предусмотрены виджеты двух типов:

4.1 Модульные виджеты - разработаны для динамических данных, которые часто обновляются. Виджеты этого типа в основном предназначены для повышения удобства пользования интернет-магазином. Так как кроме функций удобной для покупателя подачи информации об актуальных акциях и скидках, существенно упрощают ему поиск и навигацию на странницах сайта. Эти виджеты являются интерактивными, которые соответственно реагируют на поведение покупателей на страницах сайта. Как пример, можно рассматривать виджет "Недавно просмотренные товары", "Популярные товары" или, например, виджет "Похожие товары". Все эти виджеты генерируют свою выдачу соответственно действий осуществленных покупателем.

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

5. Создать виджет - можно кликом по клавише "Создать виджет" в правом верхнем углу окна "Список виджетов". После чего появится функциональное окно "Создание виджета".

В открывшемся окне следует заполнить строки "Имя" и "Описание" - в будущем, содержимое этих строк, будет отображаться в соответствующих столбцах окна "Список виджетов".

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



Тип виджета "Модуль" - Если администратор в процессе создания виджета присваивает ему тип "Модуль", то в этом случае генерируется таблица, из содержимого которой следует осуществить выбор графических элементов, предусмотренных системой. (А)

Тип виджета "HTML" - Если администратор в процессе создания виджета присваивает ему тип "HTML", то в этом случае открывается окно текстового редактора, поддерживающего HTML форматирование. (В)


6 Вставить виджет на страницы магазина - в ImageCMS Shop можно, открыв соответствующий tpl файл нужных вам страниц, который содержится в папке templates\newLevel\shop. Далее следует, учитывая будущее местоположение виджета на странице относительно других элементов в общей разметке файла .tpl страницы, вставить в код следующее:

<div class="class-name">
{widget('widget_name')}
</div>

Где class-name - следует зaменить на соответствующее оформление виджета, а widget_name - заменить на имя соответствующего файла tpl виджета.

6.1 Корректировка местоположения виджета на странице относительно других элементов в интерфейсе покупателя осуществляется при помощи вставки в код .tpl файла страниц строки следующего вида:

<div style="margin-top: ...px; margin-left: ...px; margin-right: ...px;" margin-bottom: ...px;">

Где:
margin-top - значение отступа верхнего края виджета
margin-bottom - значение отступа нижнего края виджета
margin-left - значение отступа левого края виджета
margin-right - значение отступа правого края виджета
...px; - троеточие следует заменить на цифровое значение отступа в пикселях ( например - 10px; 100px; 999px;)



7. Интеграция сторонних виджетов, не предусмотренных системой ImageCMS Shop, осуществляется довольно просто. Для этого следует просто скопировать код нужного вам виджета прямo в код файла tpl страницы (все файлы страниц находятся по адресу templates\newLevel\shop)

Примичание:

в случае интеграции виджета, не предусмотренного системой ImageCMS Shop, создавать файл tpl в папке templates\newLevel\widgets - не имеет смысла.

8. Редактировать виджет - можно при помощи окна "Список виджетов" при помощи клика по содержимому столбцов "Имя" и/или "Настройки".

Содержимое столбца "Имя" - позволяет осуществить редактирование имени файла tpl в папке templates\newLevel\widgets отвечающего за функционирование редактируемого виджета, а также изменить краткое описание виджета.

Примичание:

изменения в имени файла tpl, осуществленные через данное окно редактирования, не переносятся автоматически на сам файл. Поэтому, изменяя имена файлов, вам также необходимо последовать в папку templates\newLevel\widgets и повторить изменения непосредственно над самим файлом.

Содержимое столбца "Настройки" - многие виджеты имеют пустое значение в этом столбце. Так как кнопки "Настройки" доступные содержимые в в данном столбце, в ImageCMS Shop, присваиваются только для виджетов где уместна точная, опциональная настройка.

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




9. Удалить виджет - можно при помощи клавиши с изображением корзины справа окна "Список виджетов" , при помощи кнопки "Удалить" (2) с изображением корзины, предварительно осуществив выбор виджетов, подлежащих удалению (1).


Внимание!

При удалении виджета типа "Модуль", созданного по умолчанию, и/или другого виджета, предусмотренного системой, также удаляется файл .tpl, содержимый в папке templates\newLevel\widgets. В будущем, если вы захотите восстановить удаленный виджет, сможете это осуществить при помощи окна создания виджета, однако новый, сгенерированный системой файл .tpl виджета для дальнейшего корректного отображения виджета будет требовать правки содержимого кода в ручном режиме.

Как пример, рассмотрим код tpl файла, и ображение на страницах магазина виджета "Последние новости" из templates\newLevel\widgets:

  1. до удаления (код файла latest_news.tpl),
  2. после его восстановления, код файла tpl, того же виджета, (сгенерированного автоматически, при создании виджета файл recovered_widget_latest_news.tpl)