Questa guida fornisce una panoramica dettagliata delle chiavi di interpolazione utilizzate per personalizzare testi e modelli di email di sistema in Discourse.
Livello utente richiesto: Amministratore
Mentre personalizzi il testo in Discourse o modelli di email specifici, potresti aver notato che in alcuni modelli sono disponibili variabili segnaposto.
In Discourse, queste vengono chiamate Chiavi di interpolazione.
Comprendere le chiavi di interpolazione
Le chiavi di interpolazione sono segnaposto disponibili in determinati modelli di Discourse. Consentono di inserire contenuti dinamici nei tuoi testi e modelli di email.
Esempio di Chiavi di interpolazione per il modello di email Account Created:
Queste chiavi, come %{username} o %{site_name}, verranno sostituite con i dati effettivi quando l’email viene inviata.
In generale, questi segnaposto possono essere spostati all’interno del modello a cui appartengono, ma sono disponibili solo in quel modello e non possono essere spostati in modelli diversi, poiché sono tutti supportati da codice server legato al modello corrispondente.
Tuttavia, alcuni gruppi di modelli consentono l’aggiunta di chiavi di interpolazione aggiuntive oltre a quelle già presenti nel modello predefinito.
Chiavi di interpolazione aggiuntive
Messaggio di sistema di benvenuto all’utente
Per i modelli system_messages.welcome_user, è possibile aggiungere queste chiavi aggiuntive:
username: Il nome utente dell’utentename: Il nome completo dell’utentename_or_username: Il nome completo dell’utente o il nome utente
Questi valori sono forniti dalla classe SystemMessage in fase di esecuzione (consulta system_message.rb per il relativo codice di Discourse).
Email di notifica all’utente
Per i modelli di email user_notifications e relativi (inclusi unsubscribe_mailing_list e unsubscribe_link), sono disponibili molte chiavi aggiuntive, tra cui topic_title, username, site_name, url, unsubscribe_url e altre.
Per l’elenco completo e aggiornato di tutte le chiavi di interpolazione personalizzate consentite e ai gruppi di modelli a cui si applicano, fai riferimento a ALLOWED_CUSTOM_INTERPOLATION_KEYS nel codice sorgente di Discourse per translation_override.rb.
