Этот компонент сканирует полное описание категории на наличие указанных тегов и отображает дополнительные ссылки на категории. См. скриншот.
Скриншот
Репозиторий
О компоненте
Зачем мне это нужно и почему реализовано именно так?
Вы хотите отображать дополнительные ссылки, например, на другие ресурсы, связанные с этим типом категории. Представьте категорию для футбольного клуба, и вы хотите добавить ссылку на сайт клуба. В таких случаях можно использовать GitHub - naidihr/discourse-category-headers: Theme component providing custom settings for the discourse category header · GitHub
Если у вас более одной ссылки, и/или вы не хотите, чтобы ссылка отображалась на странице обзора категорий, и/или вы не хотите видеть огромный баннер, вы можете использовать эту тему.
Она реализована таким образом, чтобы парсить полное описание категории, так как Discourse использует только первый фрагмент «первого поста темы» для создания описания категории, которое отображается на странице обзора категорий. Остальная часть поста не показывается.
Если вы используете много категорий, возможно созданных через API, это дополнение полностью функционально, так как первый пост категории (= полное описание) также можно установить через API.
Установка
Как установить тему или компонент темы?
Настройка
Настройте компонент темы и укажите теги, например:
WIKI, blank
Измените описание категории так, чтобы оно выглядело следующим образом:
Это отображаемое описание категории.
`
{AddCategoryLinks}
{WIKI#Wiki#Наша потрясающая вики#https://awesome-wiki-which-doesnt.exist}
{TAGNAME#Название ссылки#Заголовок ссылки#URL ссылки}
`
Обратите внимание:
- Важно, чтобы
{AddCategoryLinks}присутствовал в описании. - Важно, чтобы он находился внутри блока кода (внутри
...). - Используйте символ # в качестве разделителя.
Примечание: Я рекомендую скрыть пост, в котором записано описание категории, чтобы пользователи не видели добавления вроде AddCategoryLinks и т.п.
Благодарности
- Discourse — отличный инструмент
- GitHub - discourse/discourse-custom-header-links · GitHub
- https://github.com/discourse/discourse-category-headers.git
