Shortcode nelle notifiche

Introduzione

Gli shortcode sono tag come {{course_name}} o {{first_name}} che si possono includere nel testo di una notifica. Questi tag vengono sostituiti con i dati pertinenti quando viene inviato un messaggio di notifica.

Questo articolo fornisce ulteriori informazioni sull'uso degli shortcode nelle notifiche. Per istruzioni complete su come configurare una notifica, consultare l'articolo principale: Configurazione delle notifiche.

Gli shortcode possono essere inseriti quando si compone il testo del messaggio di una notifica. Gli shortcode disponibili dipendono dal tipo di evento di notifica, e l’articolo Eventi e condizioni di notifica elenca gli shortcode disponibili per ciascun tipo di evento.

Suggerimento: con il passaggio al nuovo servizio di notifica, l'URL di base dei link nelle notifiche corrisponderà sempre al dominio di ciascun destinatario della notifica. Per ulteriori informazioni, consultare il capitolo Link shortcode e domini dell'impresa estesa.

Attenzione: a seconda del tipo di notifica, gli shortcode {{first_name}}, {{last_name}} e {{username}} possono fare riferimento all'utente che ha eseguito l'azione che ha attivato la notifica, anziché all'utente che la riceve. Ad esempio, in alcune notifiche relative ai corsi inviate a un Superadmin, questi shortcode verranno popolati con i dettagli dello studente anziché con quelli del Superadmin. Consultare la descrizione di ciascuno shortcode nelle tabelle di riferimento del capitolo "Guida agli shortcode" per confermare il comportamento previsto per la notifica che si sta configurando.

Shortcode e link cliccabili

Gli shortcode che fanno riferimento ai link, come ad esempio {{course_link}}, non creano link cliccabili nelle notifiche. Inseriscono solo l'URL in formato testo senza tag HTML.

La maggior parte dei client di posta elettronica moderni (desktop, mobile o web) converte automaticamente gli URL in testo semplice in link cliccabili per migliorare l'esperienza utente. Il destinatario riceverà comunque un link cliccabile, anche se è stato inserito solo l'URL.

Tuttavia, per avere la certezza di creare un link attivo, è necessario inserire l’URL nei tag html necessari. È possibile farlo in due modi:

• Utilizzare il pulsante Inserisci/modifica link della barra degli strumenti e incollare lo shortcode (ad esempio, {{course_link}}) nel campo URL.
• Utilizzare il pulsante Codice sorgente nella barra degli strumenti e inserire direttamente il tag HTML, utilizzando lo shortcode come attributo href. Ad esempio, Il mio corso.

Nota per le piattaforme delle imprese estese: consultare il capitolo Link shortcode e domini d'impresa estesa per scoprire come il dominio nell'URL dello shortcode (https:/www.domain.xxx/path_url_platform ) viene abbinato al dominio dell'utente destinatario.

Link shortcode ai corsi o sessioni

Quando si utilizzano shortcode relativi a link a corsi o sessioni specifiche, ricordarsi che non funzionano come i deep link. L’utente riceverà un errore se clicca sul link senza essere iscritto al corso.

Quando si inserisce lo shortcode {{course_link}} nelle notifiche, tutti gli utenti che cliccano sul link vengono reindirizzati alla pagina del corso o della sessione, indipendentemente dal loro livello di accesso. Questo include gli utenti con accesso al corso, i Superadmin e i Power User, che abbiano effettuato l’accesso o meno.

Shortcode con date e orari

Shortcode {{expire_at}}

Quando si include lo shortcode {{expire_at}} in una notifica, l'ora visualizzata nelle notifiche ricevute dagli utenti viene espressa nel loro fuso orario.

Shortcode {{event_date}} e {{session_dates}}

I corsi ILT e VILT sono organizzati in sessioni, e ogni sessione può essere composta da uno o più eventi. Quando un partecipante si iscrive a una sessione di un corso, viene automaticamente iscritto a tutti gli eventi di quella sessione.

{{event_date}}:

Questo shortcode è popolato con:

• Il nome dell'evento in alto

• La data e l'ora di inizio e fine dell'evento. Queste informazioni sono fornite sia nel fuso orario dello studente che in quello dell'evento, se diversi.

  Suggerimento: il formato della data sarà impostato in base alla configurazione della piattaforma.

• I dettagli sulla sede e l'aula dell'evento, se si tratta di un evento in presenza. Oppure virtuale, se si tratta di un webinar.

{{session_dates}}:

Questo shortcode è popolato con informazioni sulla data {{event_date}} di tutti gli eventi della sessione. Sono incluse tutte le date degli eventi, anche se alcuni o tutti gli eventi si sono svolti in passato.

Esempio (per una sessione con tre eventi):

Shortcode con credenziali di accesso

Alcune notifiche, come Utente creato, possono includere un shortcode {{user_password}}. Un caso d'uso tipico è quello di comunicare agli utenti le istruzioni di accesso, ossia il link alla piattaforma e le credenziali da utilizzare (nome utente e password).

Nella notifica, lo shortcode {{user_password}} è sempre sostituito da un link « Esegui il reset della password ». Facendo clic su questo link, all'utente viene richiesto di inserire il proprio indirizzo email, in modo da ricevere un altro link di reset per creare finalmente la propria password.

Questo flusso di lavoro in due fasi consente all'amministratore di creare gli utenti (con o senza password iniziale, a seconda del meccanismo utilizzato per crearli) e poi, tramite la notifica, di fargli creare o modificare le proprie password.

Tag {{#items}} e {{/items}}

Si tratta di tag speciali utilizzati esclusivamente nelle notifiche di riepilogo, per elencare una serie di elementi. Questi tag devono sempre apparire in coppia, racchiudendo gli shortcode degli elementi che si desidera elencare.

Per ulteriori informazioni, consultare il capitolo sulle Notifiche riassuntive.

Nota: i tag {{#items}} e {{/items}} vengono utilizzati in tutte le notifiche riassuntive. Inoltre, la notifica Riassunto: nuovi contenuti nei canali seguiti utilizza anche i tag {{#channels}} e {{/channels}}.

Link shortcode e domini dell’impresa estesa

Per le piattaforme Extended Enterprise , quando si utilizzano shortcode come {{course_link}} in una notifica, l'URL di base del link deve corrispondere al dominio del destinatario. Ad esempio, un utente che accede alla piattaforma all'indirizzo https:/deve ricevere un link al corso con lo stesso URL di base https://path_to_course.

Tuttavia, se l'utente appartiene a più di un client dell'impresa estesa (possibile in piattaforme con rami annidati o in piattaforme che consentono di inserire gli utenti in più di un ramo), le notifiche potrebbero non utilizzare sempre l'URL di base previsto. Consultare il capitolo Link shortcode e rami annidati dell'impresa estesa.

Link shortcode e rami annidati dell'impresa estesa

Se si dispone di un dominio d'impresa estesa associato a un ramo padre e di un altro dominio associato a un ramo figlio, gli utenti del ramo figlio possono ricevere notifiche che utilizzano l'URL di base del dominio padre. Tuttavia, saranno comunque in grado di accedere alla risorsa collegata.

Shortcode del logo dinamico {{extend_enterprise_logo}}

Come indicato nel capitolo precedente sui link shortcode, quando una notifica include tali link, il sistema adatta dinamicamente l'URL di base in modo che corrispondano al dominio di ciascun utente destinatario.

In modo analogo, sulle piattaforme delle imprese estese, è possibile utilizzare l'opzione {{extend_enterprise_logo}} per recuperare dinamicamente l'immagine del logo configurata per la piattaforma (principale o estesa) del destinatario. In questo modo, ogni destinatario riceverà un'email con il logo corretto per la sua piattaforma.

Suggerimento: le notifiche che includono modelli preconfigurati con un logo ora utilizzano automaticamente questo shortcode per visualizzare un'immagine del logo dinamica. Tuttavia, se si dispone di alcune notifiche create con una versione precedente del modello, queste potrebbero ancora includere un percorso fisso per l'immagine del logo. In questo caso, si ha la possibilità di ricreare la notifica utilizzando il modello attuale, oppure modificare manualmente il corpo del messaggio per utilizzare lo shortcode {{extend_enterprise_logo}}.

Inserire un'immagine dinamica per il logo

A tal fine, nel sorgente html del corpo del messaggio, inserire un tag immagine che contenga lo shortcode invece di un percorso fisso verso l'immagine:

<img src={{extend_enterprise_logo}}” ...>

Suggerimento: si noti che lo shortcode inserisce solo il percorso dell'immagine del logo in testo semplice, e non visualizza l'immagine da solo. È necessario incorporare lo shortcode all'interno di un tag affinché funzioni.

Rendere dinamica l'immagine del logo del modello

Alcune notifiche forniscono modelli di messaggio preconfigurati che includono anche un'immagine di logo. Si noti che questi modelli, per impostazione predefinita, fanno riferimento a un percorso immagine fisso, come ad esempio:

<img src="/public/images/core/docebo_logo.png" ...>

In questo modo tutti i destinatari riceveranno messaggi con la stessa immagine di logo fissa.

Se invece si vuole che i destinatari vedano un logo corrispondente a quello della loro piattaforma nell'impresa estesa, modificare il corpo del messaggio in modalità sorgente per sostituire il percorso dell'immagine fissa con lo shortcode:

<img src={{extend_enterprise_logo}}” ...>

Guida agli shortcode

Le tabelle riportate di seguito elencano gli shortcode disponibili nelle notifiche di Docebo, organizzati per categoria di notifica. Non tutti gli shortcode sono disponibili in tutti i tipi di notifica. L'articolo Eventi e condizioni delle notifiche elenca gli shortcode disponibili per ogni specifico tipo di evento.

Notifiche agli utenti

Shortcode per manager e subordinati

Notifiche legate ai corsi

Notifiche relative ai corsi e sessioni ILT

Notifiche relative ai materiali didattici di tipo esercizio

Notifiche relative ai materiali didattici

Notifiche relative ai materiali didattici di tipo test

Notifiche e-commerce

Notifiche legate alle certificazioni

Notifiche legate alla gamification

Notifiche relative all’informativa sulla privacy e ai termini e condizioni

Notifiche relative all'impersonazione d’identità

Notifiche relative alla formazione informale

Notifiche relative al forum

Notifiche legate ai piani formativi

Notifiche relative alle checklist di osservazione

Notifiche relative ai pachetti di abbonamento

Attenzione: gli shortcode {{transaction_code}} e {{note}} sono campi personalizzati a cui non viene assegnato automaticamente alcun valore al momento dell'acquisto. Si consiglia di non utilizzare questi shortcode nella notifica "Il piano di abbonamento è stato acquistato" a meno che non si sia certi che sia stato assegnato un valore.

Notifiche relative ai tag dei contenuti

Notifiche legate alle competenze