Tinymce (SPT-Tag)
Name
<spt:tinymce> - Integriert einen Editor
Syntax
<spt:tinymce name="variable" theme="simple"/>
Beschreibung
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "What You See Is What You Get" steht für eine Übernahme des geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. So kann der Redakteur z.B. Tabellen ohne HTML-Kenntnisse in seine Artikel einfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und auch von installierten Systemschriften ab.
Der Editor tinymce ist ein Open-Source Produkt der Firma Moxiecode. Der Editor kann im Rahmen des CMS "so wie er ist" genutzt werden. Der Editor ist kein Produkt der Sitepark GmbH und kann daher auch nicht direkt supported werden. Bug-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.
Konfiguration erweitern (ab Version 2.0.3)
Der tinymce wird im Standardfall mit einer Konfiguration des IES gestartet. Diese Konfiguration kann geändert oder ergänzt werden. Hierfür gibt es zwei Möglichkeiten.
- Konfiguration in separatem Templates
- Mit dem Attribute
configextension
kann ein Anchor eines Templates angegeben werden, das Konfigurationsparameter enthält. Diese Parameter werden mit JSON ohne umgebene geschweifte Klammern {} angegeben werden.
param1 : "a",
param2 : false
Es muß beachtet werden, das hinter dem letzten Parameter kein Komma stehen darf.
- Konfiguration in Tag-Attribut
- Mit dem Attribut
configvalues
können Konfigurationsparameter direkt angegeben werden. werden mit JSON ohne umgebene geschweifte Klammern {} angegeben werden.
<sp:set name="_tinyconfig">
param1 : "a",
param2 : false
</sp:set>
<spt:tinymce ... configvalues="${_tinyconfig}" ... />
Eigene Plugins (ab Version 2.0.3)
Attribute
Name | Type | Required | Default | ab IES Version |
---|---|---|---|---|
name
|
Variable | Ja | None | 1 |
value
|
Text | Nein | None | 1 |
fixvalue
|
Text | Nein | None | 1 |
type
|
Content-Type | Nein | text | 1 |
disabled
|
Condition | Nein | None | 1 |
readonly
|
Condition | Nein | None | 1 |
rows
|
Number | Nein | 15 | 1 |
cols
|
Number | Nein | 80 | 1 |
theme
|
Text | Nein | default | 1 |
pools (experimentell)
|
Anchor-List oder ID-List | Nein | aktueller Informationspool | 1 |
buttons
|
Text | Nein | default | 1 |
configextension
|
Anchor | Nein | 2.0.3 | |
configvalues
|
Text | Nein | 2.0.3 | |
Dynamische Attribute | Text | Nein | None | 1 |
name
- Bestimmt den Namen des Feldes.
value
- Setzt einen Default-Wert für die mit
name
angegebenen Variable, wenn sie leer ist.
fixvalue
- Überschreibt jeden vorhandenen Inhalt der mit
name
bestimmten Variablen mit dem durchfixvalue
angegebenen Wert.
locale
- Dieses Attribut bestimmt die Mehrsprachigkeit der Variablen.
type
- Der Typ des Eingabefeldes.
disabled
- HTML-Attribut (true, false).
readonly
- HTML-Attribut (true, false).
rows
- Höhe des Eingabefeldes in Zeilen.
cols
- Breite des Eingabefeldes in Spalten.
theme
- Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
- simple
- default
- advanced
buttons
- Konfigurationseinstellung, die den Funktionsumfang für den Editor beschreibt. Mögliche Werte sind:
- minimum
pools
- Kommaseparierte Liste von Anchors von Artikelpools oder von IDs von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Diese Funktion ist derzeit noch im Versuchsstadium und wird daher nicht offiziell unterstützt.
configextension
- Mit diesem Attribut kann ein Anchor eines Templates angegeben werden, das TinyMCE Konfigurationen enthält. Die in diesem Template angegebenen Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter TinyMCE:Configuration aufgelistet.
configvalues
- Mit diesem Attribut kann können TinyMCE Konfigurationen angegeben werden. Die Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter TinyMCE:Configuration aufgelistet.
- Dynamische Attribute
- Dynamische Attribute sind beliebige HTML-Attribute, die evaluiert und bis zum HTML-Tag durchgereicht werden.
Beispiele
WYSIWYG-Editor nutzen und Inhalt ausgeben
Template Quelltext
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>
<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>