Dokumentation ContentFlex

Aus DeDi-Help

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

[bearbeiten] Titel: ContentFlex

Version: 0.9.0-dev

Dies ist eine Entwicklerversion. Sie ist nicht für den produktiven Einsatz geeignet!

Letzte Änderung: 13.03.2005

DeDi-Version: 01.00.01

Autor: Mistral

[bearbeiten] Beschreibung:

Mit dem Modul ContentFlex ist es möglich, flexibel Inhalte zu verwalten und zu konfigurieren. Hierzu können die weiter unten aufgeführten Elemente genutzt werden, die einzeln und zu Gruppen zusammengestellt werden können. Durch die Einbindung der Elemente in (X)HTML und CSS-Styles können die Elemente vollständig in das Layout eingebunden werden.

Dies ist ein vollkommen neues Modul, es hat bis auf die Idee, nichts mit dem DeDi-Flex-Modul zutun. Der Inhalt vom DeDi-Flex kann nur durch manuelles kopieren in dieses Modul übernommen werden.


[bearbeiten] Features:

  • Element an jeder Stelle einfügen
  • Elementbeschreibung wird ausgeben
  • Config normal/ erweitert/ alles/ versteckt
  • Allgemeine Elemente: Username, Name, Vorname, Benutzername, die Emailadresse des Autors und das Datum
  • Elemente: Text,Textarea, image, wysiwyg, wysiwyg2, Link, File, Fileurl, Filedesc, Filesize
  • Es sind maximal 3 Elemente pro Typ verwendbar
  • Elemente erscheinen beim Bearbeiten in derselben Reihenfolge wie sie im Template vorkommen (Ausnahme File)
  • Für die einzelnen Elemente kann ein Titel definiert werden, der beim bearbeiten als Überschrift dargestellt wird
  • Dem Element image kann das Verzeichnis und die Imagetypen konfiguriert werden
  • Dem Element file kann das Verzeichnis und die Filetypen konfiguriert werden
  • Der WYSIWYG2 ist konfigurierbar
  • Die Anzahl der maximal darzustellenden Einträge kann definiert werden
  • Einzelne Elemente können ein und ausgeschaltet werden
  • Element-Templates können in der Reihenfolge verschoben werden ohne Verlust des Inhaltes
  • Default-Template, wenn das dazugehörende Element-Template gelöscht wurde (verhindert den Verlust von Inhalt)
  • Elemente: linkurl, linkdesc, linktarget, imageurl, imagewidth, imageheight, imagedesc, imagethumb
  • Spezielle Elemente: popup
  • bbcode konfigurierbar machen pro textarea, soweit die Funktionalität für den bbcode vorhanden ist
  • Default-Template nur im backend Sichtbar (konfigurierbar)
  • Bearbeitungsbereich konfigurierbar machen
  • Template zum Bearbeiten hinzugefügt
  • Feld für styleclass beim wysiwyg2 hinzugefügt

[bearbeiten] Bekannte Bugs:

Elemente ohne editierbare Elemente können trotzdem bearbeitet werden

Im Backend wird bei allen Bildelementen ein Bild zuviel ausgegeben


[bearbeiten] Elemente:

Es können die nachfolgend aufgeführten Elemente verwendet werden:

Bei den Elementen mit einem ":x" in der Bezeichnung muss zwingend eine Laufnummer mitgegeben werden. Bei diesen Elementen handelt es sich überwiegend um bereits vorhandene Module für DeDi, für die auch spezielle Dokumentationen zur Verfügung stehen.

Die Elemente können innerhalb einer Elementgruppe beliebig zusammengestellt werden. Zu beachten ist bei diesen Elementen, dass für das x eine Nummerierung zwischen 1 und 3 angegeben werden muss, da gleiche Elemente max. 3 Mal innerhalb einer Elementgruppe eingefügt werden können. Die Elemente können aber beliebig oft in den verschiedenen Elementgruppen Verwendung finden.

{text:x} = einzeiliges Textfeld

{textarea:x} = mehrzeilige Textarea

{wysiwyg:x} = Wysiwyg-Editor 1

{wysiwyg2:x} = Wysiwyg-Editor 2, Konfigurierbar


{file:x} = Verknüpfung zu einer Datei, die mit dem Dateimanager verwaltet wird.

{fileurl:x} = URL-Pfad der Datei

{filedesc:x} = Dateibeschreibung aus dem Dateimanager

{filesize:x} = Dateigröße


{link:x} = Verknüpfung zu einer Seite

{linkurl:x} = URL-Pfad des Link anzeigen lassen

{linkdesc:x} = Linkname, eingetragene Bezeichnung anzeigen lassen

{linktarget:x} = Ziel des Link anzeigen lassen (neues Browserfenster etc.)


{image:x} = verweist auf ein Bild, das mit dem Dateimanager verwaltet wird

{imageurl:x} = URL-Pfad des Bildes

{imagewidth:x} = Breite des Bildes wird angezeigt

{imageheight:x} = Höhe des Bildes wird angezeigt

{imagedesc:x} = Die alternative Bildbeschreibung wird hier angezeigt

{imagethumb:x} = Der von DeDi erzeugte Thumb des Bildes wird angezeigt

{popup} = Ein Thumb wird angezeigt welches bei einem Klick das Originalbild in einem neunen Fenster anzeigt. Das PopUp wird mit einem JS erzeugt und funktiniert also nicht bei allen Besuchern der Seite.


Die nachfolgenden Elemente beziehen sich auf die Seite, in der ContentFlex eingebunden ist. Also wann die Seite erstellt oder bearbeitet wurde, auch wenn die Bearbeitung nicht mit ContenFlex gemacht wurde.

{author} = Autor (Vorname Nachname)

{date} = Datum der letzten Bearbeitung

{created_date} = Erstellungsdatum

{username} = Loginname resp. Benutzername

{name} = Vorname

{surname} = Nachname

{email} = E-Mail Addresse des Autor


Zum Schluss noch ein Style Element.

{font1-2} = Layoutvariablen, die auf Stylesheet-Klassen verweisen

[bearbeiten] Konfigurationsmodus:

Um einen ersten Eindruck zu erhalten ist es sinnvoll, den Konfigurationsmodus zu ContentFlex aufzurufen. Dies geschieht wie immer in dem man unter Design -> Module auf den Schraubenschlüssel des Moduls klickt. (Kenntnisse, wie Module eingebunden werden, werden hier vorausgesetzt.)

Um eine vollständige Übersicht der Möglichkeiten zu erhalten, sollte zunächst der Konfigurationsmodus auf "Alles" gestellt werden.

Bild:ContentFlex_090_konfigurationsmodus.png

[bearbeiten] Template:

Template-Beschriftung ausgeben

= Bezeichnung für das Element wird im Editiermodus angezeigt.


Default Template nur im Backend

=" Mit" dieser Einstellung kann Inhalt aus gelöschten Elementgruppen nur im Backend angezeigt werden.

Default-Template

Das Default-Template verhindert den Verlust von Daten, wenn eine Elementgruppe gelöscht wird.

[bearbeiten] Elementgruppe

Hier können die Elementgruppe zusammengestellt werden. Erlaubt sind die oben aufgeführten Elemente, die in (X)HTML und CSS-Styles eingebunden werden können.

Mit der Einstellung Gruppe sichtbar bzw. unsichtbar kann die Elementgruppe für die Bearbeitung freigeschaltet bzw. verborgen werden.

über die Links [Up] [Down] kann die Reihenfolge ohne Datenverlust verändert werden.

Spalte hinzufügen / löschen

über dieses Drop-Down-Feld können Elementgruppen hinzugefügt und gelöscht werden. Zu beachten ist, dass beim Löschen von Elementgruppen das unterste Element gelöscht wird. Also bitte darauf achten, dass man zuerst die zu löschende Elementgruppe an die unterste Position bringt.

[bearbeiten] Titel

Hier kann für jedes Element ein Titel eingegeben werden, der bei der Bearbeitung das Element bzw. den Verwendungszweck näher beschreibt. Die Option für den bbcode ist nur für die User welche im Moment die Erweiterung für den bbcode auch besitzen.


[bearbeiten] Navigation

Hier kann die Anzahl der maximal darzustellenden Einträge auf der Seite definiert werden.

Einträge pro Seite (0 = Alle)

= Mit der 0 werden alle Elementgruppe auf der Seite dargestellt. Ändert man den Eintrag z.B. auf 1, so wird der erste Eintrag auf der aktuellen Seite angezeigt, der zweite Eintrag wird dann auf einer weiterführenden Seite angezeigt. Das Template Navigation und die Texte kommen zum Einsatz, wenn der Wert nicht auf 0 gesetzt ist.


[bearbeiten] Einschränkungen

Eine der wichtigsten Funktionen in ContentFlex findet man am Schluss des Konfigurationsmodus. Es ist die Möglichkeit, die Auswahlmöglichkeiten für die Redakteure zu beschränken.

- WYSIWYG2 Konfiguration

- Dateitypen, auf die eine Zugriffsmöglichkeit besteht

- Ordner, auf die eine Zugriffsmöglichkeit besteht


Wichtig! Am Ende der Konfigurationseinstellungen sollte das Auswahlfeld "bei Einstellungen in allen Templates/ Ordnern/ Seiten übernehmen, welche dieses Modul verwenden" ausgewählt sein, damit die Einstellungen auch auf den Seiten übernommen werden.


[bearbeiten] Inhalte einfügen und bearbeiten

ContentFlex zeichnet sich - genau wie DeDi-Flex - dadurch aus, dass verschiedene Elemente, die über Elementgruppen definiert werden, frei über ein Menü auf einer Seite eingefügt und in der Reihenfolge verändert werden können.


Einfügen von Elementen/Inhalten

Im Bearbeitungsmodus erscheint das Modul zunächst als "+"-Zeichen. Klickt man auf das "+"-Zeichen öffnet sich ein Menü. Dieses Menü enthält die in der Konfiguration erstellten Content-Elemente wie z. B. ein einzeiliges Textfeld, den Wysiwyg-Editor oder eine Kombination der verschiedenen Elemente.

Bild:ContentFlex_hinzufuegen.png

Der Redakteur/Admin hat jetzt die Möglichkeit, ein Element auszuwählen. Hat man ein Element ausgewählt, erscheint ein weiteres "+"-Zeichen auf der Seite und man sieht nun auch ein Bearbeitungssymbol, ein Element wurde für die Seite eingefügt.


Bearbeiten von Inhalten

Geht man mit der Maus auf das Bearbeitungssymbol Bild:Icon bearbeiten.png erschein ein Menu für die Bearbeitung der Inhalte.

Bild:contentflex_bearbeiten.gif

bearbeiten = Die Seite für die Eingabe der Inhalte wird geöffnet

löschen = Das ausgewählte Inhaltselement wird unwiderruflich gelöscht

nach oben = das Element wird um eine Position nach oben verschoben

nach unten = das Element wird um eine Position nach untern verschoben


[bearbeiten] ContentFlex und bbCode

BbCode ist seit DeDi Version 1.0.2 Bestandteil der Distribution. Allerdings ist die Version 0.92 von ContentFlex noch nicht darauf vorbereitet, bbCode für Textareas zu konfigurieren. Falls Sie bbCode konfigurieren wollen, müssen Sie deshalb - wie in den Vorversionen - Ergänzungen am Code für die Frontend-Ausgabe von ContentFlex vornehmen.

Als Minimalkonfiguration sollten Sie Einstellungen zur Absatzbehandlung ggf. eine Auswahl der angezeigten Button vornehmen. Schauen Sie sich dazu im zweiten Beispiel in der Moduldokumentation zu BbCode Erweiterung 2 v1.0 die Parameter features und paragraphs an.

Suchen Sie im Code für die Frontend-Ausgabe von ContentFlex die drei Zeilen, die die Ausgabe der Textareas (textarea:x) behandeln und ergänzen Sie die Parameter.

Nach einem ContentFlex Modul-Update kann es passieren, dass Ihnen diese Änderungen wieder verlorengehen. Sie merken das daran, dass Sie plötzlich [br]-Tags im Seitentext vorfinden und beim Editieren alle verfügbaren Buttons angezeigt werden. Tragen Sie die Ergänzungen dann einfach erneut ein.


[bearbeiten] Themen hierzu im Forum

[http://forum.der-dirigent.de/index.php?act=Search&CODE=show&searchid=06b9320e89fda5d7f8c11f2b9682cd26&search_in=posts&result_type=topics&highlite=contentflex Suche "ContentFlex"]

ContentFlex mit Lightbox: http://forum.der-dirigent.de/index.php?act=ST&f=12&t=6315

Persönliche Werkzeuge