Документация InstantCMS - manual:widgets

Настройки виджета

Anonymous (anonymous@undisclosed.example.com) — 2026-09-25T16:32:33+00:00

Настройки виджета

Окно настроек виджета открывается после добавления нового виджета или клику по иконке «Редактировать» у существующего.

Вкладка "Общие"

Заголовок

Будет выводиться на сайте, над виджетом. Внешний вид зависит от темы оформления. В заголовке можно вставлять SVG иконки при помощи выражения {file_name%icon_name}, где:

file_name - имя SVG файла (SVG спрайта) по пути /templates/шаблон/images/icons/;
icon_name - имя иконки SVG спрайта.

Так же, в зависимости от виджета, можно вставлять выражения полей типов контента, например, для виджета «Список контента», в зависимости от того, где он размещён, можно вставлять {title}, {user_nickname} и другие имена поле в фигурных скобках: вместо них выведутся значения полей. В описаниях конкретного виджета написано более подробно.

Показывать заголовок

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

Объединять с предыдущим виджетом

Если над виджетом на данной странице есть другой виджет, то они будут объединяться в один блок. Переключение между виджетами внутри блока будет происходить с помощью вкладок (зависит от шаблона контейнера). Текущий виджет в панели управления будет расположен с отступом слева, тем самым давая понять, что он объединён. Так же, если включено, то вы можете выбирать шаблоны контейнера (о них ниже), начинающиеся на wrapper_tabbed. Шаблон контейнера вывода группы виджетов определяется по последнему (нижнему) виджету группы.

Ссылки в заголовке виджета

Заголовок виджета может иметь одну или несколько ссылок:

Ссылки указываются в этом поле, по одной на строке, в следующем формате:

Заголовок ссылки | URL ссылки

Для внутренних ссылок URL указывается относительно корня сайта, не включая хост и подпапки (если InstantCMS установлена в подпапку).

Если вся строка со ссылкой обернута в фигурные скобки, то эта ссылка будет показыаться только авторизованным пользователям:

{Заголовок ссылки | URL ссылки}

Например, ссылки со скриншота выше были созданы так:

Все новости | news
Обсуждаемые | news-discussed
{Приватные | news/from_friends}

Скриншот сделан из-под авторизованного пользователя, поэтому он видит все три ссылки. Гость видел бы только ссылки «Все новости» и «Обсуждаемые».

Вкладка "Опции"

Содержание этой вкладки зависит от типа виджета. Опции стандартных виджетов (входящих в комплект поставки InstantCMS) рассмотрены здесь.

Вкладка "Дизайн"

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

Шаблон виджета - это HTML файл, который присущ только определенному виджету.

Шаблон контейнера

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

Если в опции выбрано «Без шаблона контейнера», то тело виджета будет выведено без обёрток в какие-либо HTML теги, при этом, если указана опция «Класс CSS для контейнера», то вывод тела виджета будет обёрнут в тег div с указанным классом.

Если в опции выбрано «Свой HTML контейнера», то появится поле с вводом своего HTML кода для контейнера. В нём будут доступны выражения: {title}, {id}, {body}, которые будут заменены на заголовок виджета, ID виджета и тела виджета соответственно.

Стиль

Если шаблон поддерживает стилизацию контейнеров, то появится эта опция. Её изменение повлечёт за собой изменение внешнего вида контейнера виджета (не содержимого).

Шаблон виджета

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

Класс CSS для контейнера

Добавляет класс на весь блок виджета. Позволяет выделить этот конкретный виджет с помощью CSS.

Класс CSS для заголовка

Добавляет класс CSS на блок заголовка виджета. Если шаблон контейнера это поддерживает.

Класс CSS для тела

Добавляет класс CSS на блок вывода тела виджета. Если шаблон контейнера это поддерживает.

Дополнительные переменные в шаблон контейнера

Для InstantCMS выше 2.18.3 версии.

Эта опция для опытных пользователей. Вы можете добавлять переменные в шаблон контейнера и выводить их, отредактировав нужный вам файл. Например, у вас выбран шаблон контейнера wrapper (это файл /templates/modern/widgets/wrapper.tpl.php) и вы указали:

Имя переменной: hint
Значение переменной: Моя подпись к виджету

Теперь в файле /templates/modern/widgets/wrapper.tpl.php доступна для вывода конструкция:

<?php echo $widget['wrap_vars']['hint']; ?>

Которая выведет: Моя подпись к виджету.

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

Имя переменной: hint_en
Значение переменной: My caption for the widget

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

<?php echo get_localized_value('hint', $widget['wrap_vars']); ?>

Т.е. указываете имя переменной без языкового суффикса. InstantCMS выведет на странице значение, учитывая текущий язык сайта.

Вкладка "Доступ"

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

Можно выбрать на каких устройствах показывать виджет: планшеты, телефоны, настольные ПК. Тип устройства определяется по User-Agent браузера.

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

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

Опция «Отрицательные маски» дополняет маски страниц, позволяя более тонко настроить отображение виджета. На страницах, соответствующим этим маскам, виджет не будет показан. Для указания главной страницы используйте косую черту (слэш). Для указания страниц с кодом 404 (не найдено), напишите 404 - актуально, если включена опция «Выводить виджеты на странице 404» в общих настройках сайта. Например, у вас есть виджет, который расположен на всех страницах, но вы не хотите его показывать всего лишь на нескольких страницах: на главной, в профилях и на страницах с 404 ошибкой:

/
users/%*
users/{slug}*
404

Назад к разделу Управление виджетами

Обзор виджетов InstantCMS

Anonymous (anonymous@undisclosed.example.com) — 2020-11-23T07:37:49+00:00

Обзор виджетов InstantCMS

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

Общие

Авторизация и регистрация

Контент

Лента активности

Лента активности

Конструктор форм

Форма

Группы

Список групп

Фотоальбомы

Список фотографий

Подписки

Кнопки подписки

Профили пользователей

Поиск

Поиск

Назад к разделу Управление виджетами

Создание страниц

Anonymous (anonymous@undisclosed.example.com) — 2025-03-13T17:44:07+00:00

Создание страниц

Панель управления ⇒ Виджеты и страницы ⇒ Создать страницу

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

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

Функциональность ограничения доступа доступна с версии InstantCMS 2.7.2.

Название страницы

Выводится в дереве страниц в разделе Виджеты панели управления и на странице вывода сообщения об ограничении доступа.

CSS классы для тега body страницы

Доступно с версии InstantCMS 2.14.3.

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

Применить макет для страницы

Доступно с версии InstantCMS 2.17.2.

Эта опция предназначена скорее для опытных пользователей, в случае, если макетов у шаблона несколько. Например, если вам нужна страница авторизации без основных виджетов и в целом иного вида, чем основной сайт, можете создать макет auth с нужной разметкой. Имена необходимых позиций для виджетов в макете должны быть такими же, как и в основном макете.

Положительные маски

Список шаблонов URL, по которым будут отбираться страницы сайта. Один шаблон в строке. Шаблоны могут содержать символы подстановки:

* - любая последовательность символов
% - любое число
{slug} - латинские символы, цифры, знак дефиса

URL указывается относительно корня сайта, не включая хост и подпапки (если InstantCMS установлена в подпапку).

Пример 1. Статья на сайте имеет адрес http://your-site/articles/my-article.html. Вы хотите привязать к ней виджеты. Положительная маска:

articles/my-article.html

Раздел статей «Астрономия» имеет адрес: http://your-site/articles/astronomija. Чтобы привязать виджеты к его главной странице:

articles/astronomija

или, дополнительно, еще и ко всем его подразделам:

articles/astronomija
articles/astronomija/*

Пример 2. Вы хотите привязать виджеты к профилям трех пользователей. Их ID - 4, 23, 42. Положительные маски:

users/4
users/23
users/42

Или к профилям всех пользователей, чей ID начинается на 6 и заканчивается на 9:

users/6%9

Пример 3. Вы хотите привязать виджеты ко всем страницам содержащим в адресе слово «special». Положительная маска:

*special*

Или только к фотоальбомам, имеющим в адресе такое слово:

albums/*special*

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

*%

Отрицательные маски

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

Пример.

Вы хотите вывести виджет в профилях всех пользователей, кроме администратора (eго ID = 1). Тогда вы указываете положительную маску:

users/%

и отрицательную маску:

users/1

В отрицательных масках, в отличии от положительных, учитываются в том числе и параметрические ссылки. Например, если вы хотите исключить показ виджета на пятой странице списка статей, то достаточно указать отрицательную маску articles?page=5

Быстрый подбор масок

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

Доступ

Показывать группам

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

Не показывать группам

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

Показывать для стран

Указывается, посетителям из каких стран будут показаны данные страницы. Страна определяется по ip адресу посетителя, убедитесь, что ваш сервер верно определяет ip адрес посетителя. Для определения используется сервис, указанный в настройках компонента География. Если компонент «География» не установлен, этих опций не будет.

Не показывать для стран

Указывается, посетителям из каких стран не будут показаны данные страницы.

Назад к разделу Управление виджетами

Документация InstantCMS - manual:widgets

Настройки виджета

Настройки виджета

Вкладка "Общие"

Заголовок

Показывать заголовок

Объединять с предыдущим виджетом

Ссылки в заголовке виджета

Вкладка "Опции"

Вкладка "Дизайн"

Шаблон контейнера

Стиль

Шаблон виджета

Класс CSS для контейнера

Класс CSS для заголовка

Класс CSS для тела

Дополнительные переменные в шаблон контейнера

Вкладка "Доступ"

Обзор виджетов InstantCMS

Обзор виджетов InstantCMS

Общие

Авторизация и регистрация

Контент

Комментарии

Лента активности

Конструктор форм

Группы

Фотоальбомы

Подписки

Профили пользователей

Теги

Поиск

Создание страниц

Создание страниц

Название страницы

CSS классы для тега body страницы

Применить макет для страницы

Положительные маски

Отрицательные маски

Быстрый подбор масок

Доступ

Показывать группам

Не показывать группам

Показывать для стран

Не показывать для стран