Este guia oferece uma visão detalhada das chaves de interpolação usadas para personalizar textos e modelos de e-mail do sistema no Discourse.
Nível de usuário necessário: Administrador
Ao personalizar textos no Discourse ou personalizar modelos específicos de e-mail, você pode ter notado que existem variáveis de espaço reservado disponíveis em alguns modelos.
No Discourse, chamamos esses elementos de Chaves de Interpolação.
Entendendo as chaves de interpolação
As chaves de interpolação são espaços reservados disponíveis em determinados modelos do Discourse. Elas permitem que você insira conteúdo dinâmico em seus textos e modelos de e-mail.
Exemplo de Chaves de Interpolação para o modelo de e-mail Conta Criada:
Essas chaves, como %{username} ou %{site_name}, serão substituídas por dados reais quando o e-mail for enviado.
Em geral, esses espaços reservados podem ser movidos dentro do modelo ao qual pertencem, mas eles estão disponíveis apenas nesse modelo e não podem ser transferidos para modelos diferentes, pois todos são suportados por código do servidor vinculado ao modelo correspondente.
No entanto, certos grupos de modelos permitem a adição de chaves de interpolação adicionais além das já presentes no modelo padrão.
Chaves de Interpolação Adicionais
Mensagem de Boas-vindas do Sistema
Para os modelos system_messages.welcome_user, você pode adicionar as seguintes chaves adicionais:
username: O nome de usuário do usuárioname: O nome completo do usuárioname_or_username: O nome completo do usuário ou o nome de usuário
Esses valores são fornecidos pela classe SystemMessage em tempo de execução (consulte system_message.rb para o código relacionado do Discourse).
E-mails de Notificação do Usuário
Para user_notifications e modelos de e-mail relacionados (incluindo unsubscribe_mailing_list e unsubscribe_link), muitas chaves adicionais estão disponíveis, incluindo topic_title, username, site_name, url, unsubscribe_url e outras.
Para a lista completa e atualizada de todas as chaves de interpolação personalizadas permitidas e os grupos de modelos aos quais elas se aplicam, consulte ALLOWED_CUSTOM_INTERPOLATION_KEYS no código-fonte do Discourse para translation_override.rb.
