Eine aktuelle (englischsprachige) Version dieses Dokuments liegt [[de:otml|hier]]. Diese ist in promio.connect im Hilfebereich einsehbar. ====== E-Mail Editor Templates ====== Hier geht es darum dem Designer die Möglichkeit zu geben, von Redakteuren veränderbare Bereiche seines Designs (Templates) zu definieren. Der Designer kann dafür beim Entwurf seines Templates auf die von uns zur Verfügung gestellten Tags in den Namensräumen **''pme:''** und **''pm:''** zugreifen. Das so entwickelte Template kann dann mit dem in promio-mail integrierten E-Mail Editor von Redakteuren verwendet und angepasst werden. Dabei kann der Redakteur nur noch die vorher definierten Bereiche bearbeiten. Example template

Editierbarer Text im Template. Redakteur kann nur reinen Text eingeben.

Statischer, nicht editierbarer, Text des Templates.

Text mit HTML Auszeichnung

Der Redakteur hat die Möglichkeit der Text-Formatierung per HTML.

Layoutvorlage 1 für Repeater

Beliebiges HTML

Layoutvorlage 2 für Repeater

Beliebiges, editierbares, HTML

Listeninhalt

tolles singleline

===== HTML Erweiterung ===== Templates für den promio-mail E-Mail Editor entsprechen standard HTML-Dokumenten, die um promio-mail spezifische Tags und Attribute erweitert werden können: ==== Übersicht ==== ^HTML Erweiterung ^Typ ^ ^ ^Tags ^^^ |[[#pme:singleline|]] |Tag, editierbar |Nur-Text (kein HTML) Eingabe | |[[#pme:multiline|]] |Tag, editierbar |HTML-Text Eingabe | |[[#pme:repeater|]] |Tag, editierbar |Struktur für Listendarstellung | |[[#pme:layout|]] |Tag, editierbar |Vorlage für Listeneinträge | |[[#pm:repeatercontent|]] |Tag |Struktur für Listendarstellung | ^Attribute ^^^ |[[#pmedit|pmedit]] |Attribut |Nur für Tags. Legt die Editierbarkeit bei Bildern fest. | |[[#pmscale|pmscale]] |Attribut |Nur für Tags. Legt die Abmessung bei änderbaren Bildern fest. | ===== Tags ===== ==== pme:singleline ==== Dieses Element legt Bereiche fest, die von Redakteuren editieren werden können. Es kann dabei nur **reiner Text**, ohne HTML Auszeichnung, eingegeben werden. Das Tag kann sowohl alleine stehen als auch innerhalb anderer Elemente eingefügt werden. === Beispiel === Veränderbarer Text === Attribute === ^Erlaubte Attribute^^ |Standard HTML Attribute (s. [[http://www.w3schools.com/tags/ref_standardattributes.asp|Standard HTML Attributes]])|| |label |Beschriftung für den Editor | ==== pme:multiline ==== Dieses Element legt Bereiche fest, die von Redakteuren editiert werden können. Es dürfen dabei HTML Auszeichnungen verwendet werden. Das Tag kann sowohl alleine stehen als auch innerhalb anderer Elemente eingefügt werden. === Beispiel ===

Beispiel

Veränderbarer HTML Text

=== Attribute === ^Erlaubte Attribute^^ |Standard HTML Attribute (s. [[http://www.w3schools.com/tags/ref_standardattributes.asp|Standard HTML Attributes]])|| |label |Beschriftung für den Editor | ==== pme:repeater ==== Das Element '''' definiert einen Bereich mit sich wiederholenden Blöcken. Ein '''' Bereich enthält eine beliebige Anzahl (jedoch mindestens einen) von [[#pme:layout|]] Blöcken, die dem Redakteur zum auffüllen des Bereiches zur Auswahl gestellt werden. Es wird mindestens ein [[#pme:layout|]] Block erwartet. === Beispiel ===

Layoutvorlage 1 für Repeater

Beliebiges HTML

Layoutvorlage 2 für Repeater

Beliebiges, editierbares, HTML

=== Benötigt === ^Benötigte Tags^ || ==== pme:layout ==== Das Element '''' definiert einen Block eines [[#pme:repeater|]] Bereiches. Es darf nur innerhalb von '''' vorkommen. Es können beliebig viele '''' Blöcke innerhalb eines '''' definiert werden. Der Redakteur hat die Möglichkeit, einen oder mehrere '''' Blöcke in einem '''' hinzuzufügen, zu verschieben oder zu löschen. Auch das mehrmalige hinzufügen ein und desselben Blocks ist möglich. Die Angabe des Attribut ''name'' ist erforderlich. Es definiert die Anzeige in der Auswahl der möglichen Blöcke, die einem '''' hinzugefügt werden können. '''' darf nur innerhalb von [[#pme:repeater|]] verwendet werden. === Beispiel ===

Layoutvorlage 1 für Repeater

Beliebiges HTML

Layoutvorlage 2 für Repeater

Beliebiges, editierbares, HTML

=== Attribute === ^Erlaubte Attribute^^ |Standard HTML Attribute (s. [[http://www.w3schools.com/tags/ref_standardattributes.asp|Standard HTML Attributes]])|| |name | **Erforderlich**. Gibt den Namen des Layouts an, der dem Redakteur zur Auswahl gestellt wird.| ==== pm:repeatercontent ==== Ermöglicht es vordefinierte Blöcke in einen [[#pme:repeater|]] einzubinden. Das Verhalten von '''' ist ähnlich wie von [[#pme:layout|]] Blöcke mit dem Unterschied, das '''' Blöcke standardmäßig angezeigt werden, wohingegen '''' Blöcke zuvor von einem Redakteur manuell dem '''' hinzugefügt werden müssen. Der Redakteur hat die Möglichkeit, '''' Blöcke zu verschieben oder zu löschen. '''' darf nur innerhalb von [[#pme:repeater|]] verwendet werden. === Beispiel ===

Layoutvorlage 1 für Repeater

Beliebiges HTML

Layoutvorlage 2 für Repeater

Beliebiges, editierbares, HTML

Blockvorgabe

Freier Text....

===== Attribute ===== ==== pmedit ==== Das Attribute ''pmedit'' legt fest, ob die Quelle (das ''src'' Attribute) eines Bildes vom Redakteur bearbeitet werden kann. Wird das Attribut weggelassen, kann die Bildquelle auch nicht bearbeitet werden. === Beispiel === === Werte === ^Mögliche Werte des Attributes^^ ^Wert ^Erklärung ^ |"**true**" |Erlaubt das editieren der Bildquelle im Attribute ''src'' | === Nutzbarkeit === ^Erlaubt in Tag^ || ==== pmscale ==== Mit Attribut ''pmscale'' kann angegeben werden, das ein Bild auf eine bestimmte Abmessung skaliert wird. Es wird dabei ein neues Bild mit den gewünschten Abmessung erstellt und eingebunden; das original Bild bleibt davon unberührt und kann jederzeit wieder verwendet werden. Das Attribut kommt vor allem im Zusammenhang mit dem Attribut [[#pmedit|''pmedit'']] zum Tragen und stellt sicher, das unabhängig von der gewählten Bildquellen, die passenden Größe angezeigt wird. === Beispiel === === Werte === ^Mögliche Werte des Attributes^^ ^Wert ^Erklärung ^ |"**width**" |Skaliert das Bild auf die im Attribute ''width'' angegebene Breite. | |"**height**" |Skaliert das Bild auf die im Attribute ''height'' angegebene Höhe. | |"**crop**" |Schneidet das Bild am linken bzw. unteren Rand ab, um die im Attribut ''height'' und/oder ''width'' angegebene Größe zu erhalten. | Bilder deren original Abmessung kleiner als die angegebene ist, werden unter **Qualitätsverlust** vergrößert. === Nutzbarkeit === ^Nutzbar für Tag^ | |