Este guia explica como personalizar emojis no seu site Discourse por meio de conjuntos de emojis selecionáveis, carregamento de novos emojis, configuração de ajustes do site e ajuste dos tamanhos dos emojis.
Nível de usuário necessário: Administrador
Selecionando um conjunto de emojis
O Discourse atualmente suporta cinco conjuntos de emojis:
- Fluent UI
- Noto
- OpenMoji
- Twemoji
- Padrão (Unicode)
Para uma visão geral de como os diferentes conjuntos são exibidos, você pode consultar esta comparação de conjuntos de emojis. Você pode configurar o ajuste de site emoji_set em /admin/config/emoji/settings juntamente com outras configurações relacionadas a emojis.
Adicionando emoji personalizado
Para adicionar emoji personalizado:
-
Navegue até Admin → Aparência → Emoji em
/admin/config/emoji -
Clique no botão Adicionar emoji para nomear, classificar e carregar sua imagem de emoji
Se você tiver vários arquivos de emoji para carregar, poderá selecionar até 10 arquivos de imagem no seletor de arquivos para carregamento em lote. Os nomes dos arquivos de imagem serão usados como nomes de emoji neste caso.
Configurações de Emoji
Você pode acessar as configurações de emoji em /admin/config/emoji/settings para personalizar como os emojis se comportam no seu site.
enable_emoji- Habilita a exibição e o uso de emojis na sua instância Discourse. Se desabilitado, os emojis não serão renderizados e os usuários não poderão acessá-los ou usá-los em campos de texto.emoji_set- Selecione seu estilo de emoji preferido. Diferentes conjuntos de emojis podem fornecer aparências exclusivas para os emojis exibidos no site.max_emojis_in_title- Número máximo de emojis permitidos no título do tópico (padrão: 1). Se o valor definido for zero, impede o uso de quaisquer emojis nos títulos dos tópicos.enable_emoji_shortcuts- Textos de smiley comuns como:):p:(serão convertidos em emojis.emoji_autocomplete_min_chars- Número mínimo de caracteres necessários para acionar o pop-up de autocompletar emoji (padrão: 0).enable_inline_emoji_translation- Habilita a tradução para emojis em linha (sem espaço ou pontuação anterior).emoji_deny_list- Estes emojis não estarão disponíveis para uso em menus ou códigos curtos.external_emoji_url- URL de um serviço externo para imagens de emoji. Deixe em branco para usar o padrão.discourse_reactions_enabled_reactions- Define uma lista de reações habilitadas, qualquer emoji é permitido aqui. Reações padrão: +1, rindo, boca aberta, aplauso, bola de confete e abraços.discourse_reactions_excluded_from_like- Reações que não contam como um Like. Quaisquer reações que não estejam nesta lista contarão como um Like para emblemas, relatórios e outras finalidades.discourse_reactions_allow_any_emoji- Se isso estiver habilitado, adicionará um botão permitindo que os usuários selecionem qualquer emoji no seletor de reações. Os membros terão permissão para escolher qualquer emoji, incluindo emoji personalizado, para reações. Para limitar as reações disponíveis, use o ajuste de siteemoji_deny_list.
Redimensionamento de emoji personalizado
Por padrão, todos os emojis são redimensionados via CSS para 20x20, mas isso pode ser substituído com CSS personalizado. Para manter a proporção correta e o tamanho nativo nas postagens, adicione o seguinte CSS:
/* Torna o emoji de tamanho normal (não força o quadrado) */
div.topic-post img.emoji[src*="uploads"],
div.d-editor-preview img.emoji[src*="uploads"],
div.emoji-modal img.emoji[src*="uploads"],
div.d-editor-textarea-wrapper img.emoji[src*="uploads"],
div.title-wrapper img.emoji[src*="uploads"],
td.main-link img.emoji[src*="uploads"] {
width: auto;
height: auto;
}
Para personalizar o tamanho de um emoji específico, use:
img.emoji[title=":youremoji:"] {
height: XXpx;
width: YYpx;
}
Para redimensionar emojis em mensagens de chat e status do usuário em chats:
div.chat-message-text img.emoji[src*="uploads"],
span.user-status-message img.emoji[src*="uploads"] {
width: auto;
height: auto;
}