Это простой способ глобально изменить иконку в Discourse.
-
Щелкните правой кнопкой мыши на иконку, которую хотите изменить, и выберите «Посмотреть код» или «Исследовать» (в зависимости от браузера).
-
Найдите имя иконки
-
Найдите новую иконку здесь Find Icons with the Perfect Look & Feel | Font Awesome, например, external-link-alt
-
Настройте и добавьте код на вкладке
администрирование > настройка > темы > редактирование кода -> JS
// {theme}/javascripts/discourse/api-initializers/init-theme.gjs
import { apiInitializer } from "discourse/lib/api";
export default apiInitializer((api) => {
api.replaceIcon("link", "external-link-tab");
});
- Иконки, которые не используются в Discourse по умолчанию, необходимо добавить в настройку сайта
svg icon subset, а затем принудительно обновить браузер, чтобы изменения вступили в силу.
Результат:

Все иконки «link» будут заменены на «external-link-tab».
Если иконка используется для нескольких элементов на других страницах, например, для значков достижений (бейджей), она также будет заменена там.
Исключения
Обратите внимание, что уже существует компонент темы, позволяющий изменить иконку «Нравится». Я использую этот случай в качестве примера.
Иконка «heart» (сердечко), используемая для функции «Нравится», жестко запрограммирована с другими именами ('d-liked' и 'd-unliked') и должна обрабатываться иначе, чем другие иконки. Поэтому, чтобы заменить иконку
на иконку
:
api.replaceIcon("d-liked", "thumbs-up");
api.replaceIcon("d-unliked", "thumbs-o-up");
![]()
![]()
но на странице бейджей иконка остается «heart»:
поэтому, чтобы изменить ее на этой странице, добавьте:
api.replaceIcon("heart", "thumbs-up");
Другой пример:
api.replaceIcon("d-watching", "eye");
изменяет иконку «Отслеживание»:
Смотрите здесь другие исключения, покрывающие статус отслеживания, развертывание/сворачивание, уведомления и, конечно, лайки.
const REPLACEMENTS = {
"d-tracking": "bell",
"d-muted": "discourse-bell-slash",
"d-regular": "far-bell",
"d-watching": "discourse-bell-exclamation",
"d-watching-first": "discourse-bell-one",
"d-drop-expanded": "caret-down",
"d-drop-collapsed": "caret-right",
"d-unliked": "far-heart",
"d-liked": "heart",
"d-post-share": "link",
"d-topic-share": "link",
"notification.mentioned": "at",
"notification.group_mentioned": "users",
"notification.quoted": "quote-right",
"notification.replied": "reply",
"notification.posted": "reply",
"notification.edited": "pencil-alt",
"notification.bookmark_reminder": "discourse-bookmark-clock",
"notification.liked": "heart",
"notification.liked_2": "heart",
"notification.liked_many": "heart",
"notification.liked_consolidated": "heart",
"notification.private_message": "far-envelope",
"notification.invited_to_private_message": "far-envelope",
"notification.invited_to_topic": "hand-point-right",
"notification.invitee_accepted": "user",
"notification.moved_post": "sign-out-alt",
"notification.linked": "link",
"notification.granted_badge": "certificate",
"notification.topic_reminder": "far-clock",
"notification.watching_first_post": "discourse-bell-one",
"notification.group_message_summary": "users",
"notification.post_approved": "check",
"notification.membership_request_accepted": "user-plus",
"notification.membership_request_consolidated": "users",
"notification.reaction": "bell",
"notification.votes_released": "plus",
"notification.chat_quoted": "quote-right",
};
Ссылка: discourse/icon-library.ts at main · discourse/discourse (github.com)
Не стесняйтесь создавать другие компоненты тем и делиться ими в нашей категории Theme component!
Этот документ имеет контроль версий — предлагайте изменения на github.








