Referenz DeDi-Tags
Aus DeDi-Help
Referenz DeDi-Tags
[bearbeiten] PHP
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.
[bearbeiten] <DEDIPHP>
Normales PHP. Wird bei jedem Seitenaufruf ausgeführt. Ersetzt <?PHP ... ?>
Beispiel:
<DEDIPHP>echo 'DeDi ist super!';</DEDIPHP>
[bearbeiten] <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.
Beispiel:
<DEDIPHP:CACHE>echo 'DeDi ist super!';</DEDIPHP:CACHE>
[bearbeiten] Layout-Tags
Folgende DEDI- Tags können nur im Layout verwendet werden
[bearbeiten] <dedi:lay type="head" />
Dieser Tag setzt wichtige Elemente in den HTML- Kopfbereich. Das Tag muss im HTML- Kopf zwischen <head>...</head> stehen. Es generiert folgende Informationen automatisch:
- Java Script Dateien, die im Layout ausgewählt wurden
- CSS- Dateien, die im Layout ausgewählt wurden
- Die HTML- Metatags robots, author, keywords und description (author, keywords, description sofern bei der Seitenkonfiguration hier Werte angegeben wurden)
<dedi:lay type = "head" (Pflichtfeld) />
Beispiel:
<html> <head> <dedi:lay type="head" /> </head> <body> DeDi ist Super! </body> </html>
[bearbeiten] <dedi:lay type="container" />
Die Containertags sind Platzhalter für Module. Ein Container kann später unter "Design -> Templates" mit Modulen bestückt werden. Ein Container muß eine eindeutige Id enthalten und optional das Attribut "title".
<dedi:lay type = "container" (Pflichtfeld) id = "[containerid]" (Pflichtfeld) title = "Allgemeine Bezeichnung" />
Beispiel:
<dedi:lay type="container" id="1" title="Erster Container" /> <dedi:lay type="container" id="2" title="Zweiter Container" /> <dedi:lay type="container" id="3" />
Erzeugt drei Container. Da im dritten Container kein title- Attribut gesetzt wurde, wird bei der Auswahl des Layouts im Bereich "Styles-> Templates" als Title nur die Containerid angezeigt.
[bearbeiten] <dedi:lay type="config" />
Stellt für den Redakteur des Seitencontents das Hauptbearbeitungsmenu dar. Dieses Menu enthält folgende Einträge:
- Ordner anlegen
- Ordner konfigurieren
- Ordner löschen
- Seite anlegen
- Seite konfigurieren
- Seite löschen
- Wechseln zwischen Vorschaumodus und Bearbeitungsmodus
- Wechseln in die Backend- Seitenübersicht (Bereich Seiten-> Reaktion)
<dedi:lay type = "config" (Pflichtfeld) />
Beispiel:
<dedi:lay type = "config" />
[bearbeiten] Modul-Tags
Übersicht aller Modul- Tags:
<dedi:mod type="wysiwyg" /> - "kleiner" WYSIWYG- Editor <dedi:mod type="wysiwyg2" /> - "großer" WYSIWYG Editor <dedi:mod type="text" /> - einzeiliges Textfeld <dedi:mod type="textarea" /> - mehrzeiliges Textfeld <dedi:mod type="sourcecode" /> - Quelltexteditor für HTML und PHP <dedi:mod type="image" /> - Bild <dedi:mod type="link" /> - Link <dedi:mod type="file" /> - Link auf eine Datei des Dateimanagers <dedi:mod type="typegroup" /> - Mehrere Elemente auf einmal bearbeiten <dedi:mod type="cache" /> - Caching der Seiten manipulieren
[bearbeiten] <dedi:mod type="wysiwyg" />
Stellt einen einfachen WYSIWYG (What You See Is What You Get) Editor zur Verfügung. Dieser Funktioniert nur im IE ab Version 5.5. In den anderen Browsern wird automatisch ein WYSIWYG-JAVA Editor geladen.
<dedi:mod type = "wysiwyg" (Pflichtfeld) id = "[id]" (Pflichtfeld) title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift" styleclass = "cssclassname" styleid = "cssstyleid" styledb = "[idcssupl]" selectablestyles = "[idcssupl]|false" striptags = "false|true|styletags,styleclasses,styleids,fontfaces,fontsizes,events" tidyhtml = "true|false" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" editall = "true|false" addslashes = "false|true" />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod type="wysiwyg2" />
Stellt einen erweiterten einfachen WYSIWYG (What You See Is What You Get) Editor zur Verfügung. Dieser Funktioniert nur im IE ab Version 5.5. In den anderen Browsern wird automatisch ein WYSIWYG-JAVA Editor geladen.
<dedi:mod type = "wysiwyg2" (Pflichtfeld) 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]" folders = "true|[iddirectorys]" subfolders ="false|true" filetypes = "true|[filetypes]" striptags = "false|true|styletags,styleclasses,styleids,fontfaces,fontsizes,events" tidyhtml = "true|false" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" editall = "true|false" addslashes = "false|true" />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod type="text" />
Einzeiliges Textfeld
<dedi:mod type = "text" (Pflichtfeld) id = "[id]" title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift" htmltags = "convert|strip|allow" styleid = "[id]" styleclass = "[class]" styledb = "[idcssupl]" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" width ="[640px/cm/mm]" maxlength ="Anzahl der Zeichen, die maximal eingegeben werden dürfen" editall = "true|false" addslashes = "false|true" />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod type="textarea"/>
Textarea
<dedi:mod type = "textarea" (Pflichtfeld) id = "[id]" title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift" htmltags = "convert|strip|allow" nl2br = "true|false" styleid = "[id]" styleclass = "[class]" styledb = "[idcssupl]" width = "[640px/cm/mm]" height = "[200px/cm/mm]" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" editall = "true|false" addslashes = "false|true" />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod type="sourcecode" />
BBcode ähnlicher Editor zur direkten HTML-Formatierung.
<dedi:mod type = "sourcecode" (Pflichtfeld) id = "[id]" title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift" nl2br = "false|true" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" editall = "true|false" addslashes = "false|true" />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod type="image" />
Bilddialog zum einbinden von Bildern aus dem DeDi-Dateimanager.
<dedi:mod type = "image" (Pflichtfeld) id = "[id]" mode = "image|url|path|width|height|amplitude|desc|style| styletype|fullstyle|thumb|editbutton" title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift" defaultimage = "[uid]" width = "true|false|[digit]" height = "true|false|[digit]" autoresize = "false|true" aspectratio = "true|false" folders = "true|[iddirectorys]" subfolders ="true|false" filetypes = "true|[filetypes]" styleid = "[id]" styleclass = "[class]" styledb = "[idcssupl]" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" editall = "true|false" addslashes = "false|true" />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod type="link" />
Linkdialog zum einbinden interner, oder externer Links.
<dedi:mod type = "link" (Pflichtfeld) id = "[id]" mode = "textlink|url|path|desc|target|style|styletype|fullstyle|editbutton" title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift" styleid = "[id]" styleclass = "[class]" styledb = "[idcssupl]" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" editall = "true|false" addslashes = "false|true" />
Beispiel <dedi:mod type="image" id="1" mode="image" title="Firmenlogo" styleid="logo-bg" folders="11" subfolders="true" menuoptions="false" editable="true" />
[bearbeiten] <dedi:mod type="file" />
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...)
<dedi:mod type = "file" (Pflichtfeld) id = "[id]" mode = "textlink|url|path|desc|target|id|style|styletype|fullstyle|editbutton" title = "beliebiger titel, erscheint beim Bearbeiten als Überschrift" folders = "true|[iddirectorys]" subfolders = "true|false" filetypes = "true|[filetypes]" hidetarget = "false|true" styleid = "[id]" styleclass = "[class]" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" editall = "true|false" addslashes = "false|true" />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod type="typegroup" />
Erzeugt für den Redakteur ein Menüfeld, welches ermöglicht mehrere Contentelemente eines Moduls auf Einmal zu bearbeiten.
<dedi:mod type = "typegroup" (Pflichtfeld) elements = "type[id], type[id]" title = "der Titel des Menüs" menuoptions = "true|false|advanced" editable = "true|false|[groupids]" addslashes = "false|true" />
Beispiel
<dedi:mod type = "typegroup" elements= "text[1], textarea[1], wysiwyg[1], wysiwyg[2]" />
[bearbeiten] <dedi:mod type="cache" />
Gibt den Zeitpunkt an, wann eine Seite aus dem cache gelöscht und neu generiert wird.
<dedi:mod type = "cache" (Pflichtfeld) expires = "[seconds]" (Pflichtfeld) />
Beispiel
<dedi:mod type="cache" expires="86400">
Die Seite würde hier alle 24 Stunden neu generiert werden.
[bearbeiten] <dedi:mod type="edit_container" />
Mit diesem Tag können alle anderen DeDi-Tags auf einmal bearbeitet werden. DeDi-Tags, die davon ausgeschlossen werden sollen, müssen mit editall="false" versehen werden.
<dedi:mod type = "edit_container" (Pflichtfeld) />
Beispiel
<dedi:mod type="edit_container">
Hiermit werden alle DeDi-Tags bearbeitet, die im Quellcode vor diesem stehen.
[bearbeiten] Experimentelle Modul-Tags
Achtung: Dies sind experimentelle Tags, die zur Zeit in DeDi eingebaut sind. Diese können sich kommentarlos ändern oder wegfallen. Diese Tags werden offiziell nicht unterstützt. Sie wurden gewarnt.
[bearbeiten] <dedi:mod type="dependency" />
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.
<dedi:mod type = "dependency" (Pflichtfeld) idcatside = "1,2,3" (Pflichtfeld) />
Beispiel
fehlt noch...
[bearbeiten] <dedi:mod constant="tagmode" />
Macht es möglich, das DeDi:tags im Modulkonfigurationsbereich benutzt werden können. Das Modul "DeDitag Eingabefeld" nutzt zB. diese Möglichkeit. Allerdings hat das setzen dieses Tags den Nachteil, dass das Ausführen von PHP-Code in der Modulfrontendausgabe zu Fehlern führt.
<dedi:mod constant = "tagmode" />
Beispiel
<dedi:mod constant="tagmode" />
[bearbeiten] Parameter
Hier sind alle Parameter aufgelistet, die in den einzelnen DeDi-Tags Verwendung finden.
[bearbeiten] addslashes
Standardmässig ausgeschaltet (false). Soll das Contentfeld in PHP weiterverarbeitet werden, ist dieser Parameter zu setzen (true).
[bearbeiten] editall
Standardmässig eingschaltet (true). Soll das Contentfeld nicht über das DeDi-Tag edit_container bearbeitet werden dürfen, ist dieser Parameter auszuschalten (false).
[bearbeiten] constant
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).
[bearbeiten] defaultimage
Platzhalterbild. Standardmäßig ein transparentes gif. Es kann auch ein eigenes Bild angegeben werden. Dies geschieht anhand des Pfades Ihrer DeDi- Installation. Z.B. "media/img/bild.jpg"
[bearbeiten] editable
Standardmässig darf das Element von jedem Backendbenutzer bearbeitet werden (true). Wenn es von niemandem bearbeitet werden soll, kann es deaktiviert 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],...).
[bearbeiten] 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
- image
- link
- file
[bearbeiten] expires
Zeit in Sekunden, wann der Cache neu generiert werden soll.
[bearbeiten] 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 diese 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
[bearbeiten] filetypes
Welche Dateietypen sollen angezeigt werden. Standarmässig alle. Ansonsten kommasepariert anzugeben (z.B.: pdf, gif, jpeg, doc).
[bearbeiten] 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.
[bearbeiten] height
Die Höhe des Bildes. Wird defaultmässig von PHP ermittelt (true oder leer) Kann abgeschatet werden (false), oder manuell eingegeben werden ([digit]).
[bearbeiten] hidetarget
Gibt an, ob im Bearbeitungsformular das Targetfenster (Link in einem neuen Fensster/ diesem Fenster öffnen, etc) angezeigt werden soll. Standardmässig auf true
[bearbeiten] 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)
[bearbeiten] id
Eindeutige Bezeichnung des Elements. Wertebereich von 1 - 999999.
[bearbeiten] 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.
[bearbeiten] menuoptions
Das Bearbeitungsmenu ist standardmässig aktiviert und zeigt die Option 'bearbeiten' (true). Das Bearbeitungsmenü kann deaktiviert (false), sowie um die zusätzlichen Optionen 'neu, löschen, eins hoch, eins runter' erweitert werden (advanced).
[bearbeiten] mode
- beim image-TAG
- 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
- beim link-TAG
- 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")
- beim file-TAG
- 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")
[bearbeiten] nl2br
Zeilenumbrüche werden standardmässig in '<br>'- Tags umgewandelt (true).
[bearbeiten] 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
[bearbeiten] styleclass
Hier kann eine Style-Klasse für den Gesamttext im Klartext angegeben werden (z.B. styleclass="mein-style"). Vorsicht: Ist auch styleid oder styledb im Tag gesetzt, wird styleid 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.
[bearbeiten] selectablestyles
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".
[bearbeiten] styledb
Hier kann eine Id aus der Tabelle dedi_css_upl (idcss) für den Gesamttext angegeben werden. Höherwertiger als styleid & styleclass.
[bearbeiten] styleid
Hier kann eine Style-Ide für den Gesamttext im Klartext angegeben werden (z.B. styleid="mein-style"). Höherwertiger als styleclass, minderwertiger als styledb.
[bearbeiten] subfolders
Gibt an, ob alle Unterordner eines AUsgewählten Ordners automatisch mitangezeigt werden sollen. Standardmässig true.
[bearbeiten] type
Typ-Bezeichnung für den jeweiligen DeDi-TAG.
[bearbeiten] tidyhtml
Filtert sinnlose Tags, die bei copy/ paste Aktionen aus dem Textverarbeitungsprogramm Microsoft Word entstehen können. Standardmässig an (true), abschalten mit false.
[bearbeiten] title
- bei Layout-Tags
- 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.
- bei Modul-Tags
- Der Titel wird bei der Bearbeitung des Contents als Überschrift des betroffenen Contentfeldes ausgegeben.
[bearbeiten] width
Die Breite des Bildes. Wird defaultmässig von PHP ermittelt (true oder leer). Kann abgeschatet werden (false), oder manuell eingegeben werden ([digit]).
