Clés d'interpolation pour personnaliser les modèles de texte et d'e-mails système

[Discourse]

Ce guide fournit un aperçu détaillé des clés d’interpolation utilisées pour personnaliser les textes et les modèles d’e-mails système dans Discourse.

Niveau utilisateur requis : Administrateur

Lorsque vous personnalisez le texte dans Discourse ou des modèles d’e-mails spécifiques, vous avez peut-être remarqué la présence de variables de remplacement dans certains modèles.

Dans Discourse, nous appelons ces éléments des clés d’interpolation.

Comprendre les clés d’interpolation

Les clés d’interpolation sont des espaces réservés disponibles dans certains modèles Discourse. Elles vous permettent d’insérer du contenu dynamique dans vos textes et modèles d’e-mails.

Exemple de clés d’interpolation pour le modèle d’e-mail Compte créé :

Ces clés, telles que %{username} ou %{site_name}, seront remplacées par les données réelles lors de l’envoi de l’e-mail.

En général, ces espaces réservés peuvent être déplacés à l’intérieur du modèle auquel ils appartiennent, mais ils sont uniquement disponibles dans ce modèle et ne peuvent pas être déplacés vers d’autres modèles, car ils sont tous pris en charge par du code serveur lié au modèle correspondant.

Cependant, certains groupes de modèles permettent d’ajouter des clés d’interpolation supplémentaires au-delà de celles déjà présentes dans le modèle par défaut.

Clés d’interpolation supplémentaires

Message système de bienvenue à l’utilisateur

Pour les modèles system_messages.welcome_user, vous pouvez ajouter les clés supplémentaires suivantes :

• username : Le nom d’utilisateur de l’utilisateur
• name : Le nom complet de l’utilisateur
• name_or_username : Soit le nom complet de l’utilisateur, soit son nom d’utilisateur

Ces valeurs sont fournies par la classe SystemMessage au moment de l’exécution (voir system_message.rb pour le code Discourse associé).

E-mails de notification utilisateur

Pour les modèles d’e-mails user_notifications et les modèles associés (y compris unsubscribe_mailing_list et unsubscribe_link), de nombreuses clés supplémentaires sont disponibles, notamment topic_title, username, site_name, url, unsubscribe_url, et d’autres.

Pour obtenir la liste complète et à jour de toutes les clés d’interpolation personnalisées autorisées et des groupes de modèles auxquels elles s’appliquent, consultez ALLOWED_CUSTOM_INTERPOLATION_KEYS dans le code source de Discourse pour translation_override.rb.

[gerhard (Gerhard Schlager)]

@SaraDev

Vous pouvez utiliser toutes les clés system_messages.* dans les personnalisations de modèles de texte et d’e-mail tant qu’elles ont des sous-clés subject_template et text_body_template - Parce qu’elles devraient toutes être gérées par la classe SystemMessage qui ajoute username, name, name_or_username comme clés d’interpolation supplémentaires. Voir system_message.rb pour le code Discourse associé.

Ce n’est pas correct. Actuellement, cela ne fonctionne que pour system_messages.welcome_user, mais nous pourrions l’étendre à toutes les autres clés. C’est du matériel pour pr-welcome.

[SaraDev (Sara Devlaeminck)]

Merci de l’avoir signalé, cela a été mis à jour dans le guide.

[gassim (Al-Gassim Sharaf Addin)]

Salut !

Comment puis-je modifier la valeur de certaines de ces clés d’interpolation ? Par exemple, %{search_answer}

Merci !

[gassim (Al-Gassim Sharaf Addin)]

@Discourse

username: Le nom d’utilisateur de l’utilisateur

Salut !
Il est indiqué que cette clé n’est pas valide :

P.S.
Je remplace dans le texte et non dans l’e-mail (est-ce que cela fait une différence) ? Merci !

[Jagster (Jakke Flemming)]

Je ne pense pas que ceux-ci soient mondiaux et gratuits à utiliser partout.

[gassim (Al-Gassim Sharaf Addin)]

@Discourse

Vous pouvez également utiliser toutes les clés system_messages.welcome_user dans les personnalisations de modèles de texte et d’e-mail.

Merci @Jagster ! Je les utilise dans la personnalisation du texte, donc d’après le message du sujet, cela est censé fonctionner ?

[Jagster (Jakke Flemming)]

Le sujet concerne en fait les modèles d’e-mails et ces textes. Ainsi, vous ne pouvez pas utiliser de clés d’interpolation en dehors du bon contexte. C’est pourquoi nous avons d’autres clés pour les e-mails, d’autres pour certaines invites d’IA, etc.

Bien sûr, les plugins peuvent faire beaucoup de choses, mais cette fois, pas immédiatement.

Et avertissement : je ne suis qu’un autre utilisateur final et je peux avoir horriblement tort aussi. Mais je suis à peu près sûr d’avoir raison — et c’est pourquoi votre tentative ne fonctionne pas

[gassim (Al-Gassim Sharaf Addin)]

D’accord, merci beaucoup pour votre aide. Il semble que cela ne fonctionne même pas lorsqu’il est utilisé dans un modèle d’e-mail :

[Jagster (Jakke Flemming)]

Mon pari est que vous pouvez utiliser %{username} dans les modèles « User did… », et que tous les autres modèles ne le prennent pas en charge.

Mais nous verrons demain quand tous les gourous seront réveillés.