Este guia explica como personalizar emojis no seu site Discourse por meio de conjuntos de emojis selecionáveis, upload de novos emojis, configuração de configurações do site e ajuste de tamanhos de emojis.
Nível de usuário necessário: Administrador
Selecionando um conjunto de emojis
Atualmente, o Discourse oferece suporte a cinco conjuntos de emojis:
- Fluent UI
- Noto
- OpenMoji
- Twemoji
- Padrão (Unicode)
Para uma visão geral de como os diferentes conjuntos se parecem, você pode dar uma olhada nesta comparação de conjuntos de emojis. Você pode configurar a configuração do site emoji_set em /admin/config/emoji/settings junto com outras configurações relacionadas a emojis.
Adicionando emojis personalizados
Para adicionar emojis personalizados:
-
Navegue até Admin → Aparência → Emojis em
/admin/config/emoji -
Clique no botão Adicionar emoji para nomear, classificar e fazer upload da imagem do seu emoji
Se você tiver vários arquivos de emoji para fazer upload, poderá selecionar até 10 arquivos de imagem no seletor de arquivos para upload em massa. Os nomes dos arquivos de imagem serão usados como nomes de emojis neste caso.
Importação em massa de emojis personalizados
Você pode importar até 1000 emojis por meio de um único ZIP com um manifesto emojis.csv. O arquivo CSV deve ter as seguintes colunas com cabeçalhos: name, group, filename.
name,group,filename
emoji_a,group_name,image.png
O processo de importação depende inteiramente do manifesto. Se um arquivo ou linha estiver ausente, ele será ignorado. O campo group pode ser deixado vazio, caso em que o emoji personalizado será adicionado ao grupo default.
Para importar:
-
Navegue até Admin → Aparência → Emojis em
/admin/config/emoji -
Clique no botão Importar e selecione o arquivo ZIP contendo seus emojis.
-
Visualize a importação e confirme as alterações. Você pode resolver quaisquer conflitos aqui selecionando quais emojis manter. Conflitos podem ocorrer se já existir um emoji existente com o mesmo nome (e grupo/imagem diferente). Para concluir a importação, clique em Confirmar importação.
Exportação em massa de emojis personalizados
Emojis personalizados podem ser exportados em um único arquivo ZIP. O arquivo ZIP resultante conterá um manifesto emojis.csv, pronto para ser importado em qualquer site Discourse sem modificação. Isso contém a imagem, o nome e o grupo de cada emoji.
Para exportar, clique no botão Selecionar para exportar e selecione todos os emojis que você está exportando. Quando estiver pronto, clique no botão Exportar e um arquivo ZIP será baixado.
Fixando Emojis no topo do seletor
Você pode fixar qualquer grupo de emojis no topo do seletor de emojis. Acesse a configuração emoji_picker_pinned_groups via Admin → Aparência → Emojis → Configurações em /admin/config/emoji/settings. Insira o nome do grupo de emojis a ser fixado no topo do seletor.
Tanto grupos de emojis personalizados quanto regulares podem ser fixados no topo. Por exemplo, inserir flags moverá o grupo de emojis de bandeiras para o topo, acima dos smileys.
Nomes dos grupos de emojis padrão:
smileys_&_emotionpeople_&_bodyanimals_&_naturefood_&_drinktravel_&_placesactivitiesobjectssymbolsflags
Configurações de emojis
Você pode acessar as configurações de emojis em /admin/config/emoji/settings para personalizar como os emojis se comportam em seu site.
enable_emoji- Habilita a exibição e o uso de emojis em sua instância Discourse. Se desativado, 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 preferido de emoji. Diferentes conjuntos de emojis podem fornecer aparências únicas aos 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 qualquer emoji nos títulos dos tópicos.enable_emoji_shortcuts- Textos de smileys comuns como:):p:(serão convertidos em emojis.emoji_autocomplete_min_chars- Número mínimo de caracteres necessários para acionar a popup de autocomplete de emojis (padrão: 0).enable_inline_emoji_translation- Habilita a tradução para emojis inline (sem nenhum espaço ou pontuação antes).emoji_deny_list- Estes emojis não estarão disponíveis para uso em menus ou shortcodes.emoji_picker_pinned_groups- Estes grupos de emojis estão fixados no topo do seletor de emojis.external_emoji_url- URL de um serviço externo para imagens de emojis. 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, laughing, open_mouth, clap, confetti_ball e hugs.discourse_reactions_excluded_from_like- Reações que não contam como um Curtir. Quaisquer reações que não estejam nesta lista contarão como um Curtir para emblemas, relatórios e outros fins.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 poderão escolher qualquer emoji, incluindo emojis personalizados, para reações. Para limitar as reações disponíveis, use a configuração do siteemoji_deny_list.
Redimensionando emojis personalizados
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:
/* Deixa o emoji no tamanho normal (não força 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;
}