issue #274 - %preheader% improvements

Added support for clipboard and *selection* (in fragments)
Added documentation
Moved  gMsgCompose.editor.rootElement to wrapper object ST4.composer

_locales/ca/messages.json

@@ -1123,6 +1123,28 @@
   "pref_variables.tab": {
     "message": "Variablas"
   },
+  "preheader": {
+    "message": "Un text de visualització prèvia només visible pels clients de correu electrònic mòbils, que s'inserirà al principi del cos del correu electrònic."
+  },
+  "preheader.className": {
+    "message": "[opcional] Podeu afegir una classe CSS per canviar la disposició."
+  },
+  "preheader.inlineStyles": {
+    "message": "[opcional] Afegiu els vostres propis atributs d'estil, separats per punt i coma. Sense aquest paràmetre, SmartTemplates inserirà 'display:none' per fer automàticament la secció invisible."
+  },  
+  "preheader.text": {
+    "message": "El text previ ha d'estar contingut dins de cometes dobles, que també poden contenir la paraula clau *clipboard*. Alternativament, podeu utilitzar $clipboardLiteral$ o $selectionLiteral$ (aquest últim només funciona quan s'utilitza des d'una Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },
   "premiumConfig": {
     "message": "Funcions premium"
   },

_locales/cs/messages.json

@@ -1117,6 +1117,28 @@
   "pref_variables.tab": {
     "message": "Proměnné"
   },
+  "preheader": {
+    "message": "Un text de visualització prèvia només visible pels clients de correu electrònic mòbils, que s'inserirà al principi del cos del correu electrònic."
+  },
+  "preheader.className": {
+    "message": "[opcional] Podeu afegir una classe CSS per canviar la disposició."
+  },
+  "preheader.inlineStyles": {
+    "message": "[opcional] Afegiu els vostres propis atributs d'estil, separats per punt i coma. Sense aquest paràmetre, SmartTemplates inserirà 'display:none' per fer automàticament la secció invisible."
+  },  
+  "preheader.text": {
+    "message": "Náhledový text musí být obsažen v uvozovkách, které mohou také obsahovat klíčové slovo *clipboard*. Alternativně můžete použít $clipboardLiteral$ nebo $selectionLiteral$ (poslední funguje pouze při použití ze Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "Šifrovaná e-mailová adresa neodpovídá čitelné adrese."
   },

_locales/de/messages.json

@@ -1069,6 +1069,28 @@
   "pref_variables.tab": {
     "message": "Variablen"
   },
+  "preheader": {
+    "message": "Ein Vorschautext, der nur für mobile E-Mail-Clients sichtbar ist und am Anfang des E-Mail-Körpers eingefügt wird."
+  },
+  "preheader.className": {
+    "message": "[optional] Sie können eine CSS-Klasse hinzufügen, um das Layout zu ändern."
+  },
+  "preheader.inlineStyles": {
+    "message": "[optional] Fügen Sie Ihre eigenen Style-Attribute hinzu, getrennt durch Semikolon. Ohne diesen Parameter fügt SmartTemplates 'display:none' ein, um den Abschnitt automatisch unsichtbar zu machen."
+  },  
+  "preheader.text": {
+    "message": "Der Vorschautext muss in doppelten Anführungszeichen enthalten sein, die auch das Schlüsselwort *clipboard* enthalten können. Alternativ können Sie auch $clipboardLiteral$ oder $selectionLiteral$ verwenden (das letztere funktioniert nur, wenn es in einem Smart Snippet verwendet wird)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },
   "premiumConfig": {
     "message": "Premium Funktionen"
   },

_locales/el/messages.json

@@ -1126,6 +1126,28 @@
   "pref_variables.tab": {
     "message": "Μεταβλητές"
   },
+  "preheader": {
+    "message": "Ένα προεπισκοπήσιμο κείμενο που είναι ορατό μόνο στους φορητούς πελάτες email, το οποίο θα εισαχθεί στην αρχή του σώματος του email."
+  },
+  "preheader.className": {
+    "message": "[προαιρετικό] Μπορείτε να προσθέσετε ένα CSS class για να αλλάξετε τη διάταξη."
+  },
+  "preheader.inlineStyles": {
+    "message": "[προαιρετικό] Προσθέστε τα δικά σας χαρακτηριστικά στιλ, χωρισμένα με ερωτηματικό. Χωρίς αυτή την παράμετρο, το SmartTemplates θα εισάγει αυτόματα 'display:none' για να καθιστά αόρατο το τμήμα."
+  },  
+  "preheader.text": {
+    "message": "Ο προεπισκοπήσιμος κείμενος πρέπει να περιέχεται μέσα σε διπλά εισαγωγικά, τα οποία μπορούν επίσης να περιέχουν τη λέξη-κλειδί *clipboard*. Εναλλακτικά, μπορείτε να χρησιμοποιήσετε $clipboardLiteral$ ή $selectionLiteral$ (αυτό το τελευταίο λειτουργεί μόνο όταν χρησιμοποιείται από ένα Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },
   "premiumConfig": {
     "message": "Λειτουργίες Premium"
   },

_locales/en/messages.json

@@ -1157,6 +1157,19 @@
   "preheader.inlineStyles": {
     "message": "[optional] Add your own style attributes, separated by semicolon. Without this parameter, SmartTemplates will insert 'display:none' to automatically make the section invisible."
   },   
+  "preheader.text": {
+    "message": "The preview text must be contained within double quotes, which also may contain the *clipboard* keyword. Alternatively you can use $clipboardLiteral$ directly or $selectionLiteral$ (that last one only works when used from a Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  }, 
   "premiumConfig": {
     "message": "Premium Features"
   },

_locales/es/messages.json

@@ -1084,6 +1084,28 @@
   "pref_template_tip": {
     "message": "Puede cambiar el encabezado de respuesta por 'variables'. Consulte la Ayuda para más detalles."
   },
+  "preheader": {
+    "message": "Un texto de vista previa solo visible para clientes de correo móvil, que se insertará al principio del cuerpo del correo electrónico."
+  },
+  "preheader.className": {
+    "message": "[opcional] Puede agregar una clase CSS para cambiar el diseño."
+  },
+  "preheader.inlineStyles": {
+    "message": "[opcional] Agregue sus propios atributos de estilo, separados por punto y coma. Sin este parámetro, SmartTemplates insertará 'display:none' para hacer automáticamente la sección invisible."
+  },  
+  "preheader.text": {
+    "message": "El texto de vista previa debe estar contenido dentro de comillas dobles, que también pueden contener la palabra clave *clipboard*. Alternativamente, puede utilizar $clipboardLiteral$ o $selectionLiteral$ (este último solo funciona cuando se usa desde un Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },
   "premiumConfig": {
     "message": "Funcionalidades premium"
   },

_locales/fi/messages.json

@@ -1126,6 +1126,28 @@
   "pref_variables.tab": {
     "message": "Muuttujat"
   },
+  "preheader": {
+    "message": "Esikatseluteksti, joka näkyy vain mobiilisähköpostiasiakkaille ja joka lisätään sähköpostin rungon alkuun."
+  },
+  "preheader.className": {
+    "message": "[valinnainen] Voit lisätä CSS-luokan muuttaaksesi ulkoasua."
+  },
+  "preheader.inlineStyles": {
+    "message": "[valinnainen] Lisää omat tyylisi, erotettuina puolipisteellä. Ilman tätä parametria SmartTemplates lisää 'display:none', jotta osa olisi automaattisesti näkymätön."
+  },  
+  "preheader.text": {
+    "message": "Esikatselutekstin on oltava kaksoislainausmerkkien sisällä, jotka voivat myös sisältää avainsanan *leikepöytä*. Vaihtoehtoisesti voit käyttää $clipboardLiteral$ tai $selectionLiteral$ (jälkimmäinen toimii vain, kun sitä käytetään Smart Snippetistä)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },
   "premiumConfig": {
     "message": "Maksulliset lisätoiminnot"
   },

_locales/fr/messages.json

@@ -1123,6 +1123,28 @@
   "pref_variables.tab": {
     "message": "Variables"
   },
+  "preheader": {
+    "message": "Un texte de prévisualisation uniquement visible pour les clients de messagerie mobile, qui sera inséré au début du corps de l'email."
+  },
+  "preheader.className": {
+    "message": "[facultatif] Vous pouvez ajouter une classe CSS pour changer la mise en page."
+  },
+  "preheader.inlineStyles": {
+    "message": "[facultatif] Ajoutez vos propres attributs de style, séparés par un point-virgule. Sans ce paramètre, SmartTemplates insérera 'display:none' pour rendre automatiquement la section invisible."
+  },  
+  "preheader.text": {
+    "message": "Le texte de prévisualisation doit être contenu entre guillemets doubles, qui peuvent également contenir le mot clé *clipboard*. En alternative, vous pouvez utiliser $clipboardLiteral$ ou $selectionLiteral$ (ce dernier ne fonctionne que lorsqu'il est utilisé depuis un Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "Fonctionnalités Premium"
   },

_locales/id_ID/messages.json

@@ -822,6 +822,28 @@
   "pref_variables.tab": {
     "message": "Variabel"
   },
+  "preheader": {
+    "message": "Sebuah teks pratinjau hanya terlihat untuk klien email mobile, yang akan dimasukkan di awal badan email."
+  },
+  "preheader.className": {
+    "message": "[opsional] Anda dapat menambahkan kelas CSS untuk mengubah tata letak."
+  },
+  "preheader.inlineStyles": {
+    "message": "[opsional] Tambahkan gaya atribut Anda sendiri, dipisahkan oleh titik koma. Tanpa parameter ini, SmartTemplates akan memasukkan 'display:none' secara otomatis untuk membuat bagian tersebut tidak terlihat."
+  },  
+  "preheader.text": {
+    "message": "Teks pratinjau harus berada dalam tanda kutip ganda, yang juga dapat berisi kata kunci *clipboard*. Sebagai alternatif, Anda dapat menggunakan $clipboardLiteral$ atau $selectionLiteral$ (yang terakhir hanya berfungsi ketika digunakan dari Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "Fitur Premium"
   },

_locales/it/messages.json

@@ -1036,6 +1036,28 @@
   "pref_variables.tab": {
     "message": "Variabili"
   },
+  "preheader": {
+    "message": "Un testo di anteprima visibile solo ai client di posta elettronica mobile, che verrà inserito all'inizio del corpo dell'email."
+  },
+  "preheader.className": {
+    "message": "[opzionale] È possibile aggiungere una classe CSS per cambiare la formattazione."
+  },
+  "preheader.inlineStyles": {
+    "message": "[opzionale] Aggiungi i tuoi attributi di stile, separati da punto e virgola. Senza questo parametro, SmartTemplates inserirà 'display:none' per rendere automaticamente la sezione invisibile."
+  },  
+  "preheader.text": {
+    "message": "Il testo di anteprima deve essere contenuto tra virgolette doppie, che possono anche contenere la parola chiave *clipboard*. In alternativa, è possibile utilizzare $clipboardLiteral$ o $selectionLiteral$ (quest'ultimo funziona solo quando viene utilizzato da un Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "Caratteristiche Premium"
   },

_locales/ja/messages.json

@@ -1105,6 +1105,28 @@
   "pref_variables.tab": {
     "message": "変数"
   },
+  "preheader": {
+    "message": "モバイルメールクライアントのみに表示されるプレビューテキストで、電子メールの本文の先頭に挿入されます。"
+  },
+  "preheader.className": {
+    "message": "[オプション] レイアウトを変更するための CSS クラスを追加できます。"
+  },
+  "preheader.inlineStyles": {
+    "message": "[オプション] セミコロンで区切られた独自のスタイル属性を追加します。このパラメーターがない場合、SmartTemplates はセクションを自動的に非表示にするために 'display:none' を挿入します。"
+  },  
+  "preheader.text": {
+    "message": "プレビューテキストは二重引用符内に含まれている必要があります。これには *clipboard* キーワードも含まれる場合があります。代替として、$clipboardLiteral$ または $selectionLiteral$ を使用することもできます（後者は Smart Snippet から使用される場合のみ機能します）",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "プレミアム機能"
   },

_locales/nl/messages.json

@@ -1066,6 +1066,28 @@
   "pref_variables.tab": {
     "message": "Variabelen"
   },
+  "preheader": {
+    "message": "Een voorbeeldtekst die alleen zichtbaar is voor mobiele e-mailclients, die aan het begin van het e-maillichaam zal worden ingevoegd."
+  },
+  "preheader.className": {
+    "message": "[optioneel] U kunt een CSS-klasse toevoegen om het lay-out te wijzigen."
+  },
+  "preheader.inlineStyles": {
+    "message": "[optioneel] Voeg uw eigen stijlattributen toe, gescheiden door puntkomma. Zonder deze parameter zal SmartTemplates automatisch 'display:none' invoegen om het gedeelte onzichtbaar te maken."
+  },  
+  "preheader.text": {
+    "message": "De voorbeeldtekst moet tussen dubbele aanhalingstekens staan, die ook het sleutelwoord *clipboard* kunnen bevatten. Als alternatief kunt u $clipboardLiteral$ of $selectionLiteral$ gebruiken (de laatste werkt alleen wanneer deze wordt gebruikt vanuit een Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "Premium-functies"
   },

_locales/pl/messages.json

@@ -1069,6 +1069,28 @@
   "pref_variables.tab": {
     "message": "Zmienne"
   },
+  "preheader": {
+    "message": "Tekst podglądu widoczny tylko dla mobilnych klientów poczty elektronicznej, który zostanie wstawiony na początku treści wiadomości e-mail."
+  },
+  "preheader.className": {
+    "message": "[opcjonalnie] Możesz dodać klasę CSS, aby zmienić układ."
+  },
+  "preheader.inlineStyles": {
+    "message": "[opcjonalnie] Dodaj własne style, oddzielone średnikiem. Bez tego parametru SmartTemplates automatycznie wstawi 'display:none', aby automatycznie ukryć sekcję."
+  },  
+  "preheader.text": {
+    "message": "Tekst podglądu musi być zawarty w podwójnych cudzysłowach, które mogą również zawierać słowo kluczowe *clipboard*. W alternatywie można użyć $clipboardLiteral$ lub $selectionLiteral$ (ten ostatni działa tylko wtedy, gdy jest używany z elementu Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "Funkcje premium"
   },

_locales/pt/messages.json

@@ -1084,6 +1084,28 @@
   "pref_variables.tab": {
     "message": "Variáveis"
   },
+  "preheader": {
+    "message": "Um texto de pré-visualização apenas visível para clientes de correio móvel, que será inserido no início do corpo do e-mail."
+  },
+  "preheader.className": {
+    "message": "[opcional] Você pode adicionar uma classe CSS para alterar o layout."
+  },
+  "preheader.inlineStyles": {
+    "message": "[opcional] Adicione seus próprios atributos de estilo, separados por ponto e vírgula. Sem este parâmetro, o SmartTemplates inserirá 'display:none' para tornar a seção automaticamente invisível."
+  },  
+  "preheader.text": {
+    "message": "O texto de pré-visualização deve estar contido entre aspas duplas, que também podem conter a palavra-chave *clipboard*. Como alternativa, pode usar $clipboardLiteral$ ou $selectionLiteral$ (este último só funciona quando utilizado a partir de um Smart Snippet)",
+    "placeholders": {
+      "clipboardLiteral": {
+        "content": "$1",
+        "example": "clipboard"
+      },
+      "selectionLiteral": {
+        "content": "$2",
+        "example": "\"*selection*\""
+      }
+    }
+  },  
   "premiumConfig": {
     "message": "Recursos Premium"
   },