 |
Краткое описание | Компонент Versatile Banner добавляет на ваш сайт настраиваемый баннер. |
 |
Предпросмотр | Предпросмотр в конструкторе тем Discourse |
 |
Ссылка на репозиторий | https://github.com/discourse/discourse-versatile-banner |
 |
Новичок в темах Discourse? | Руководство для начинающих по использованию тем Discourse |
Установить этот компонент темы
Возможности
Этот компонент темы является развитием предыдущих попыток создания баннеров. Цель — обеспечить большую простоту и гибкость благодаря использованию настроек темы.
Ниже приведены ключевые возможности:
- Ограничение отображения только для авторизованных пользователей или анонимов
- Ограничение отображения исключительно для мобильных устройств или настольных компьютеров
- Ограничение отображения для конкретных страниц
- Варианты: закрываемый, расширяемый и всегда видимый
- Опция на всю ширину браузера
- Управление цветами
- Настройка заголовка и колонок с использованием HTML (см. ниже подробности)
- Опция постоянного состояния (см. ниже подробности)
Настройка содержимого баннера
Содержимое баннера разделено на основной заголовок и колонки. Вы можете использовать до 5 колонок на баннере, однако рекомендуется не более 3 из-за ограничений по ширине. Предоставляются HTML-шаблоны, которые можно настроить в соответствии с вашими индивидуальными потребностями. Вы также можете контролировать ширину каждой колонки и добавлять любое изображение или иконку Font Awesome в верхнюю часть каждой колонки.
Использование опции постоянного состояния
Опция постоянного состояния будет использовать до двух файлов cookie. Эти файлы cookie будут содержать имя баннера и значение true/false, относящееся к состоянию баннера. Если у вас есть опасения по поводу использования файлов cookie на вашем сайте, лучше не использовать эту настройку. Выбор относительного времени для настройки cookie_lifespan гарантирует, что баннер останется закрытым/расширенным/свернутым в течение этого времени после нажатия пользователем соответствующей кнопки. Без этой настройки баннер сбрасывается при каждой полной перезагрузке страницы. Если вы внесли изменения в баннер и хотите, чтобы все пользователи увидели эти изменения, даже те, кто ранее закрыл баннер, обязательно измените «имя файла cookie». Это фактически сбросит любое постоянное состояние, после чего пользователь сможет снова закрыть баннер.
Настройки
| Имя | Описание |
|---|---|
| show for members | Отображать баннер для пользователей, вошедших в форум |
| show for anon | Отображать баннер для анонимных пользователей |
| display on mobile | Отображать баннер на мобильных устройствах |
| display on desktop | Отображать баннер на настольных компьютерах |
| display on homepage | Отображать баннер на главной странице |
| url must contain | Введите пути, на которых должен отображаться баннер. Добавьте * в конец пути как подстановочный знак |
| dismissible | Разрешить пользователям закрывать баннер |
| collapsible | Разрешить пользователям разворачивать и сворачивать баннер |
| default collapsed state | Состояние по умолчанию (свернут) при включении настройки collapsible |
| cookie lifespan | Срок жизни файла cookie, используемого для запоминания, был ли баннер закрыт, развернут или свернут. Если установлено значение «none», файлы cookie не будут использоваться с этим компонентом, и любые ранее созданные файлы cookie, связанные с баннером, будут удалены при следующей полной перезагрузке страницы пользователем. Значения измеряются в единицах времени, поэтому установка «year» означает один год, «week» — одну неделю и т. д. |
| cookie name | При внесении важных изменений в баннер необходимо изменить имя файла cookie, чтобы все пользователи увидели изменения. |
| full width banner | Отображать баннер на всю ширину браузера |
| swap default positioning | Если активен другой компонент, связанный с баннерами, используйте эту настройку для замены его позиции на позицию Versatile Banner |
| plugin outlet | below-site-header размещает его над боковой панелью, above-main-container — над контентом сбоку от боковой панели |
| banner background image | Исходный URL для фонового изображения. Совет: вы можете загрузить изображение в свою основную тему и использовать URL оттуда, но убедитесь, что вы не используете раздел «Uploads» этого компонента. Все загрузки, добавленные в этот компонент, будут удалены при каждом обновлении. |
| banner background image dark | Исходный URL для фонового изображения при обнаружении темной темы системы. |
| background color | Используется вместо фонового изображения |
| background color dark | Используется вместо фонового изображения при обнаружении темной темы системы. |
| primary text color | Основной цвет текста баннера |
| primary text color dark | Основной цвет текста баннера при обнаружении темной темы системы |
| secondary text color | Цвет текста иконок и заголовков, а также цвет фона кнопки. |
| secondary text color dark | Цвет текста иконок и заголовков, а также цвет фона кнопки при обнаружении темной темы системы. |
| link text color | Цвет текста ссылок внутри баннера |
| link text color dark | Цвет текста ссылок внутри баннера при обнаружении темной темы системы. |
| Перевод | По умолчанию |
|---|---|
| close.title | Закрыть баннер |
| close.label | Закрыть |
| toggle.title | Развернуть/свернуть баннер |
| toggle.collapse_label | Свернуть |
| toggle.expand_label | Развернуть |
Размещено нами? Компоненты тем доступны для использования в наших тарифах Pro, Business и Enterprise.
Размещено нами? Компоненты тем доступны для использования в наших тарифах Pro, Business и Enterprise.