I parametri e segnaposti più usati in Giotto

Quello che segue è l'elenco non esaustivo dei parametri e segnaposti più usati nel linguaggio Giotto.

Un parametro può essere definito aggiungendo l'attributo <mn:param> in un tag HTML e specificandone l'ID usando <mn:name>

<meta mn:param mn:name="myparam"/>.

Per stampare un parametro o una variabile scrivi: [param:name{defaultValue}].

Contact

Contactstats

Messaggi

Link

Formattazione del testo

È possibile formattare il valore di ogni placeholder in diversi modi.

Scelta multipla

Variabili di workflow

È possibile stampare il valore di una variabile di workflow.

Codifica

È possibile definire una codifica specifica basata sulle esigenze degli utenti.

• encode="encodejs": sostituisce i caratteri javascript
• encode="urlencode": codifica il valore come parametro dell'URL.

Esempio:

        <meta mn:param mn:name="text" mn:type="text" mn:default="; à é & '" />

        [param:text]

        [param:text encode='encodehtml']

        [param:text encode='encodejs']

        [param:text encode='urlencode']
    

Usare placeholders in blocchi CSS

All'interno del codice CSS (Cascading Style Sheets) non si può usare direttamente la sintassi con le parentesi quadre tipica dei placeholders come [param:backgroundcolor].

Per ovviare a questo problema sono disponibili due sintassi:

• Commenti per sostituire l'intero valore di un attributo:
  color: blue /*[param:color]*/
• Commenti per sostituire una parte (token) di un valore di un attributo:
  border: 1px solid /**[param:bordertype]*/ blue /**[param:color]*/

Se usi il commento normale, ovvero '/* ... */' allora Giotto sostituisce il commento con il valore dell'attributo.
Se usi il commento con due stelline '/** ... */' Giotto sostituisce solo la parte precedente al commento.

Attualmente non esiste una sintassi per gestire il qualificatore '!important'

Fai attenzione e considera che per l'invio di messaggi Email normalmente si applica la tecnica dei "CSS Inline", ossia Giotto riporterà negli attributi 'style' tutte le regole definite all'interno dei tag <style> per migliorare la compatibilità con i diversi client di posta.

Esempio completo:

        <style>

        .myClass {

                /* Sostituzione di tutto il valore */

                color: blue /*[param:color]*/;

                /* Sostituzione di 'solid' e di 'blue' indipendentemente */

                border: 1px solid /**[param:bordertype]*/  blue /**[param:color]*/; 

        }

        </style>