Постоянный баннер Discourse

[NateDhaliwal]

	Краткое описание	В верхней части каждой страницы отображается постоянный баннер, который могут скрыть только администраторы.
	Предпросмотр	Theme Creator
	Репозиторий	GitHub - NateDhaliwal/discourse-persistent-banner: A theme component for Discourse that cannot be closed by the user. · GitHub
	Инструкция по установке	Как установить тему или компонент темы
	Новичок в темах Discourse?	Руководство для начинающих по использованию тем Discourse

Установить этот компонент темы

Этот компонент отображает баннер в верхней части каждой страницы. Можно использовать любые допустимые цвета CSS. Если вы планируете использовать переменные тем Discourse, оберните их в var(), чтобы получить что-то вроде var(--tertiary-very-low).

Для управления баннером существует 7 настроек.

1. banner_background_color изменяет цвет фона баннера.
2. banner_text_color изменяет цвет текста баннера.
3. banner_border_color изменяет цвет границы баннера.
4. banner_border_thickness изменяет толщину границы баннера.
5. banner_text_content изменяет текст баннера. Если текст длиннее одной строки, он будет переноситься внутри баннера.
6. banner_visible управляет видимостью баннера. Значение show отображает баннер, hide скрывает его.
7. banner_location размещает баннер в одном из 4 доступных мест: above-site-header, below-site-header, above-main-container и before-topic-list.

Особая благодарность @Lilly за помощь в сортировке файлов!

[hoangphuctran93 (Hoàng Phúc Trần)]

Мне кажется, это довольно похоже на компоненты темы «Уведомительные баннеры», но с более широкими возможностями настройки.

[NateDhaliwal]

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

[Lilly (Lillian)]

Отличная работа, Нейт.
Мне нравится простота.

Кажется, предпросмотр создателя темы не работает.

Несколько предложений на ваше рассмотрение:

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

• Было бы здорово иметь возможность контролировать размер и цвет этой границы.

• Возможно, стоит добавить варианты размещения для разных мест вставки плагинов, например, below-site-header и above-main-containter?

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

• Я предлагаю сделать настройку текста баннера текстовым полем с параметром textarea: true. Тогда у пользователя появится многострочное текстовое поле, которое можно растягивать. Это упростит выполнение таких действий:

[NateDhaliwal]

@Lilly

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

Я поэкспериментирую с расположением баннера и постараюсь решить эту проблему.

@Lilly

Было бы неплохо иметь возможность управлять размером и цветом границы.

Это не должно стать большой проблемой, я добавлю эту возможность.

@Lilly

Возможно, стоит предусмотреть варианты размещения с разными точками подключения плагинов, например below-site-header и above-main-containter?

Понял. У меня уже есть идея, как это реализовать.

@Lilly

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

Думаю, я смогу это реализовать.

@Lilly

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

Понял, я добавлю это.

[NateDhaliwal]

@Lilly

textarea-true

@Lilly Просто уточню: нужно ли добавить это в settings.yml?

[Lilly (Lillian)]

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

settings.yml

результат в настройках компонента:

[NateDhaliwal]

@Lilly

возможно, стоит добавить варианты размещения с разными плагинами, например below-site-header и above-main-containter?

Реализовано.

@Lilly

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

Сделано.

@Lilly

это также ограничивает администраторов в использовании переменных палитры цветов, которые работают в тёмном/светлом режиме, или в более детальной настройке цветовых значений в формате hex.

Теперь можно использовать значения hex (включая символ #), допустимые цвета CSS или переменные темы (var(–var-name)).

@Lilly

я бы предложил сделать поле ввода текста баннера с параметром textarea: true.

Тоже сделано.

@Lilly

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

Думаю, это исправлено. Не могли бы вы проверить это на своей стороне?

[Lilly (Lillian)]

@Nate Dhaliwal

Думаю, это исправлено. Можешь проверить на своей стороне?

Назначено Lilly

Это точно исправлено. Отличная работа.

скриншот с моего широкоформатного рабочего стола

[NateDhaliwal]

ОБНОВЛЕНИЕ:
Я упростил файл .gjs, перенеся проверки if на пустоту текста баннера и его видимость в файл .scss.