Unbenanntes Dokument

Spezifikation DEDI:tags
Stand: 29.02.2004

Achtung: Einige Textbeschreibungen weichen noch von den darüber abgebildeten tags ab. Es gilt im Zweifel immer der Wert, welcher direkt nach dem Kapitelanfang in der Tagbeschreibung steht.

--------------------------------------
| Allgemein |
--------------------------------------

<DEDIPHP>echo 'foo';</DEDIPHP>

Normales PHP. Wird bei jedem Seitenaufruf ausgeführt.

<DEDIPHP:CACHE>echo 'bar';</DEDIPHP:CACHE>

Gecachtes PHP. Die Ausgabe des Skriptes wird zwischengespeichert um Ressourcen zu sparen. Der Cache bleibt so lange erhalten, bis die betreffende Seite geändert wird (z.B. wenn ein Redakteur einen Text ändert) oder der Cache per "DEDI:tag cache" gelöscht wird.

Wichtig: Ein normaler <?PHP ... ?> - Aufruf in DEDI wird als zu cachendes PHP angesehen. Um wirklich ein "dynamisches" Skript zu erstellen, müssen die Tags <DEDIPHP>...</DEDIPHP> benutzt werden.

--------------------------------------
| Layout |
--------------------------------------

Folgende DEDI- Tags können nur im Layout verwendet werden

<dedi:lay type="head" />
<dedi:lay type="container" />
<dedi:lay type="config" />

head
--------------------------------

<dedi:lay type = "head"
/>

Beschreibung:
Wird im HTML- Layout zwischen <head>...</head> geschrieben. Enthält die im Layout ausgewählten
css-/ js- Dateien sowie Metaangaben wie keywords, description, welche für jede Seite einzeln
eingestellt werden können.

Beispiel:
<dedi:lay type = "head" />

container
--------------------------------

<dedi:lay type = "container"
id = "[containerid]"
title = "Titel des Containers, wird z.B. bei Templates konfigurieren angezeigt"
/>

Beschreibung:
Ein Container kann später unter "Design -> Templates" mit Modulen bestückt werden.

type = "container"
Bezeichnung für einen Container (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Containers. Wertebereich von 1 - 999999. (Pflichtfeld)

title = "Allgemeine Bezeichnung"
Wird bei der Templateauswahl als Name des Containers angezeigt. Wird kein Titel vergeben, wird
standardmässig die Id als Titel des Containers angegeben.
Der title wird auch bei der Bearbeitung des Seitencontents angegeben.

Beispiel:
<dedi:lay type = "container" id = "10" title = "Inhalt rechts" />

config
--------------------------------

<dedi:lay type = "config"
/>

Beschreibung:
Stellt für den Redakteur des Seitencontents das Hauptbearbeitungsmenu dar. Dieses Menu enthält
folgende Einträge: Ordner anlegen, Ordner konfigurieren, Seite anlegen, Seite konfigurieren,
Wechseln: Vorschaumodus|Bearbeitungsmodus

Beispiel:
<dedi:lay type = "config" />

--------------------------------------
| Module |
--------------------------------------

<dedi:mod type="wysiwyg" />
<dedi:mod type="wysiwyg2" />
<dedi:mod type="text" />
<dedi:mod type="textarea"/>
<dedi:mod type="sourcecode" />
<dedi:mod type="image" />
<dedi:mod type="link" />
<dedi:mod type="file" />

<dedi:mod type="typegroup" />
<dedi:mod type="cache" />
<dedi:mod type="dependency" />
<dedi:mod constant="tagmode" />

wysiwyg
--------------------------------

<dedi:mod type = "wysiwyg"
id = "[id]"
title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift"
features = "true|font,fontsize,fontcolor,bold,italic,underline,align,list,striptag,table,link,image,file,source"
styleclass="cssclassname"
styleid="cssstyleid"
styledb="[idcssupl]"
selectablestyles = "[idcssupl]|false"
imagefolders = "true|[iddirectorys]"
imagesubfolders ="true|false"
imagefiletypes = "true|[filetypes]"
filefolders = "true|[iddirectorys]"
filesubfolders ="true|false"
filefiletypes = "true|[filetypes]"
striptags = "false|true|styletags,styleclasses,styleids,fontfaces,fontsizes,events";
tidyhtml = "true|false";
menuoptions = "true|false|advanced"
editable = "true|false|[groupids]"
addslashes = "false|true"
/>

type = "wysiwyg"
Bezeichnung für einen wysiwyg Editor (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Feldes. Wertebereich von 1 - 999999. Muß angegeben werden

title = "Überschrift des Textbearbeitungsfeldes"
Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.

features
Es können Schaltflächen des WYSIWYG- Editors ein bzw. ausgeschaltet werden. Standardmässig sind alle Schaltflächen
aktiviert (true). Sollen nur einzelen Features freigeschaltet werden, können kommasepariert angegeben werden.
stylesheet-> Auswahlbox mit verfügbaren Styles
font -> Fontart, Fontgröße
fontcolor -> Fontfarbe/ Hintergundfarbe
bold -> fett
italic -> kursiv
underline -> unterstrichen
align -> links, rechts, zentriert, blocksatz

styles
Styles, welche als Auswahl zur Verfügung stehen. Werden kommasepariert als idcss (Tabelle dedi_css) angegeben [1,2,3,4....]. Es können nur CSS-Klassen ausgewählt werden, oder deaktiviert alle Styles mit "false".

striptags
Tags können beim Abspeichern, egal welche Formatierungen der Redakteur beim erstellen des Textes benutzt hat,
entfernt werden. Standardmässig wird kein Tag entfernt (false)
true -> alle Tags werden entfernt
styletags -> alle Style tags werden entfernt ( style="xy")
styleclasses -> alle Styleclasses werden entfernt ( class="xy")
styleids -> alle Styleids werden entfernt ( id="xy")
fontfaces -> alle Fonts werden entfernt
fontsizes -> alle Fontgrößen werden entfernt
events -> alle Javascript- Events werden entfernt

tidyhtml
Filtert sinnlose Tags, die bei copy/ paste Aktionen aus dem Textverarbeitungsprogramm Microsoft Word
entstehen können. Standardmässig an (true), abschalten mit false

menuoptions
Das Bearbeitungsmenu ist standardmässig aktiviert und zeigt die Option 'bearbeiten' (true)
Das Bearbeitungsmenü kann deaktiviert werden (false)
Das Menu kann um die zusätzlichen Optionen 'neu, löschen, eins hoch, eins runter' erweitert werden (advanced)

editable
Standardmässig darf das Textfeld von jedem Backendbenutzer bearbeitet werden. (true)
Das Textfeld darf von niemanden bearbeitet werden (false)
Kommasepariert können alle Gruppen angegeben werden, welche Bearbeitungsrecht besitzen. Die Ids
werden aus der Tabelle dedi_groups entnommen ([group_id],[group_id],...)

addslashes
Standardmässig ausgeschaltet (false)
Soll das Contentfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen. (true)

wysiwyg2
--------------------------------

<dedi:mod type = "wysiwyg2"
id = "[id]"
title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift"
features = "true|font, fontsize, fontcolor, styles, reset, preview, print, clipboardtools, striptag, undo, search, changecase, changemode, popupeditor, table, bold, italic, underline, strikethrough, subscript, superscript, align, backgroundcolor, list, indent, link, image, file, liveresize, multipleselect, hr, specialchars, date, marquee"
styleclass="cssclassname"
styleid="cssstyleid"
styledb="[idcssupl]"
selectablestyles = "[idcssupl]"
imagefolders = "true|[iddirectorys]"
imagesubfolders ="false|true"
imagefiletypes = "true|[filetypes]"
filefolders = "true|[iddirectorys]"
filesubfolders ="false|true"
filefiletypes = "true|[filetypes]"
height="[höhe des Eingabefeldes in px]"
striptags = "false|true|styletags,styleclasses,styleids,fontfaces,fontsizes,events";
tidyhtml = "true|false";
menuoptions = "true|false|advanced"
editable = "true|false|[groupids]"
addslashes = "false|true"
/>

text
--------------------------------

Beschreibung:

type = "text"
Bezeichnung für ein einzeiliges Textfeld (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Feldes. Wertebereich von 1 - 999999. Muß angegeben werden

title = "Überschrift des Textbearbeitungsfeldes"
Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.

bbcode
Bbcode kann zur Formatierung des Textes benutzt werden. Bbcode ist standardmässig deaktiviert (false).
Wird bbcode = "true" gesetzt, sind alle verfügbaren bbcodetags aktiviert. Darüberhinaus können
kommasepariert einzelne Features freigeschaltet werden
font -> [font="arial"]foo[/font]
fontsize -> [fontsize="12"]foo[/size]
fontcolor -> [color="blue"]foo[/color]
bold -> [b]fett[/b]
italic -> [i]kursiv[/i]
underline -> [u]unterstrichen[/u]
align -> [align="left|center|right|justify"]foo[/align]

htmltags
Standardmässig werden alle HTML- tags anhand der ASCII- Tabelle maskiert und als normaler
Text ausgegeben (convert).
HTML- Tags können komplett enfernt werden (strip)
HTML- Tags können erlaubt werden (allow)

styleclass
Hier kann eine Style-Klasse für einen Link im Klartext angegeben werden (z.B. styleclass="mein-style"). Findet für die Ausgabe Verwendung, wenn mode="textlink" gesetzt ist. Vorsicht: Ist auch styleid oder styledb im Tag gesetzt, wird styleide oder styledb verwendet, da diese Attribute vom System eine höhere Wertigkeit haben als styleclass. Die Hierachiereihenfolge ist styleclass, styleid, styledb, wobei styledb die höchste Priorität hat.

styleid
Übergebene CSS-Id im klartext. Höherwertiger als styleclass, minderwertiger als styleid

styledb
Hier kann eine Id aus der Tabelle dedi_css_upl (idcss) übergeben werden. Findet für die Ausgabe Verwendung, wenn mode="textlink" gesetzt ist.

addslashes
Standardmässig ausgeschaltet (false)
Soll das Textfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen. (true)
Beispiel: <?PHP echo <dedi type="text" id="1" addslashes="true" \> .'<br><br>'; ?>

textarea
--------------------------------

type = "textarea"
Bezeichnung für eine Textarea (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Feldes. Wertebereich von 1 - 999999. Muß angegeben werden

title = "Überschrift des Textbearbeitungsfeldes"
Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.

bbcode
wie bei type="text"

nl2br
Zeilenumbrüche werden standardmässig in '<br>'- Tags umgewandelt (true)

styleid
Hier kann eine Id aus der Tabelle dedi_css (idcss) übergeben werden. Findet für die Ausgabe Verwendung, wenn mode="textlink" gesetzt ist.

addslashes
Standardmässig ausgeschaltet (false)
Soll das Contentfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen. (true)

sourcecode
--------------------------------

type = "sourcecode"
Bezeichnung für Contentfeld (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Feldes. Wertebereich von 1 - 999999. Muß angegeben werden

title = "Überschrift des Feldes"
Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.

nl2br
Zeilenumbrüche können in '<br>'- Tags umgewandelt werden. Diese Option ist standardmässig deaktiviert (false)

addslashes
Standardmässig ausgeschaltet (false)
Soll das Contentfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen. (true)

image
--------------------------------

type = "image"
Bezeichnung für Contentfeld (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Feldes. Wertebereich von 1 - 999999. Muß angegeben werden

mode
image (default) -> Gibt an, ob ein komplett in HTML-tags formatiertes Bild ausgegeben werden soll
url -> Nur der Pfad zur Datei, relativ vom http Frontendrootvereichnis (url - z.B. 'meine_bilder/bild.jpg')
desc -> Nur Bildbeschreibung
editbutton -> Nur Bearbeitungsbutton

title = "Überschrift des Feldes"
Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.

defaultimage
Platzhalterbild. Standardmässig ein transparentes gif. Es kann auch ein eigenes Bild angegeben werden. Dies
geschiet anhand der idupload aus der Tabelle dedi_upl

defaultwidth
Optional kann die Weite des Standardbildes angegeben werden. Standardmässig nicht gesetzt

defaultheight
Optional kann die Breite des Standardbildes angegeben werden. Standardmässig nicht gesetzt

width
Die Breite des Bildes. Wird defaultmässig von PHP ermittelt (true oder leer)
Kann abgeschatet werden (false)
Kann manuell eingegeben werden ([digit])

height
Die Höhe des Bildes. Wird defaultmässig von PHP ermittelt (true oder leer)
Kann abgeschatet werden (false)
Kann manuell eingegeben werden ([digit])

imagefolder
Verzeichnisse, aus dem Bilder angezeigt werden können. Standardmässig sind alle Verzeichnisse sichtbar (true).
Es können auch einzelne Ordner, anhand Ihrer Id (bezogen aus dedi_directory) kommasepariert angegeben werden.

addslashes
Standardmässig ausgeschaltet (false)
Soll das Contentfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen. (true)

link
--------------------------------

Beschreibung:
Erzeugt url, Beschreibung oder target eines Linkcontentfeldes

type = "link"
Bezeichnung für Contentfeld (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Feldes. Wertebereich von 1 - 999999. Muß angegeben werden

mode
textlink -> erstellt einen einfachen textlink (default)
url -> Url des Links (defaulteinstellung)
path -> vollständiger Pfad zum Link
desc -> Beschreibung des Links
target -> Ziel des Links
style -> css-stylename
styletype -> Typ des Styles (class oder id)
fullstyle -> vorformatierter Style (z.B. class="foo" , id="foo")

title = "Überschrift des Feldes"
Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.

addslashes
Standardmässig ausgeschaltet (false)
Soll das Contentfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen. (true)

file
--------------------------------

Beschreibung:
Erzeugt url, Beschreibung oder target einer Datei aus dem DEDI: Dateisystem (Dateimanager).
Eignet sich hevorragend um Module für eigene Typen zu schreiben (powerpoint, music, pdf, zip, video...)

type = "file"
Bezeichnung für Contentfeld (Pflichtfeld)

id = "[id]" (Pflichtfeld)
Eindeutige Bezeichnung eines Feldes. Wertebereich von 1 - 999999. Muß angegeben werden

mode
textlink -> komplett generierter Link auf die Datei (defaulteinstellung)
url -> Url zur datei
path -> kompletter Pfad zur Datei
desc -> Beschreibung der Datei
target -> Ziel der Datei
id -> id der Datei (bezogen aus dedi_upl)
style -> Gibt das angegebende Styleshheet aus styleid oder styleclass im klartext aus
styletype -> Typ des Styles (class oder id)
fullstyle -> vorformatierter Style (z.B. class="foo" , id="foo")
editbutton -> nur der editierbutton für den link

title = "Überschrift des Feldes"
Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.

folders
true -> Alle verzeichnisse des Dateisystems werden angezeigt (standard)
[iddirectorys] -> Nur bestimmte Ordner werden angezeigt. Anzuzeigende Ordner werden kommasepariert anhand ihrer Id (aus Tabelle dedi_directorys) eingetragen.

subfolders
Gibt an, ob alle Unterordner eines AUsgewählten Ordners automatisch mitangezeigt werden sollen. Standardmässig true

filetypes
Welche Dateietypen sollen angezeigt werden. Standarmässig alle. Ansonsten kommasepariert anzugeben (z.B.: pdf, gif, jpeg, doc)

hidetarget
Gibt an, ob im Bearbeitungsformular das Targetfenster (Link in einem neuen Fensster/ diesem Fenster öffnen, etc) angezeigt werden soll. Standardmässig auf true

styleid
Hier kann eine Id aus der Tabelle dedi_css (idcss) übergeben werden. Findet für die Ausgabe Verwendung, wenn mode="textlink" gesetzt ist.

addslashes
Standardmässig ausgeschaltet (false)
Soll das Contentfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen. (true)

typegroup
--------------------------------

Beschreibung:
Erzeugt für den Redakteur ein Menüfeld, welches ermöglicht mehrere Contentelemente eines Moduls auf Einmal zu bearbeiten.

type = "typegroup"
Bezeichnung des Typs

elements
Die Elemente, die in einer Gruppe zusammengefasst werden sollen. Diese Elemente werden im Bearbeitungsformular zusammenhängend angezeigt. Es muß immer ein Elementname und die dazugehörige ID (Aufbau: typname[typid]) angegeben werden. Unterstützte Typen sind zur Zeit: text, textarea, wysiwyg, spaw, image, link, file
Beispiel:
<dedi:mod type = "typegroup" elements= "text[1], textarea[1], wysiwyg[1], wysiwyg[2]" />

cache
--------------------------------
<dedi:mod type = "cache"
expires = "[seconds]"
/>

Beschreibung:
Gibt den Zeitpunkt an, wann eine Seite aus dem cache gelöscht und neu generiert wird.

type="cache"
Bezeichnung (Pflicht)

expires
Zeit in Sekunden, wann der Cache neu generiert werden soll. (Pflicht)

Beispiel:
<dedi:mod type="cache" expires="86400">

Die Seite würde hier alle 24 Stunden neu generiert werden.

dependency
--------------------------------
<dedi:mod type = "dependency"
idcatside = "1,2,3"
/>

Stellt eine Abhängigkeit zu einer oder mehrer Seiten her. Ändert sich Content auf der Seite, in welcher sich dieses Tag befindet, wird der Seitencache aller Seiten gelöscht, die unter idcatside="1,2,3" kommaseperiert angegeben sind.

Konstante: tagmode
--------------------------------
<dedi:mod constant="tagmode" />

Wird diese Konstante gesetzt, können über die MOD_VALUES[X] -> Dedi:tags, <DEDIPHP></DEDIPHP> und <?PHP ?> in Konfigurationsdialogen genutzt werden. Allerdings hat das setzen der Konstante den Nachteil, dass das Ausführen von PHP-Code in der Modulfrontendausgabe zu Fehlern führt. Wichtig bei der Verwendung dieser Konstante ist, dass diese exakt genau so in die Frontendausgabe gesetzt wird, wie oben beschrieben (der Grund ist, das die Konstante intern mit einer normalen str_replace(...)- Funktion behandelt wird).