Dokumentation Bild-Modul
Aus DeDi-Help
Inhaltsverzeichnis |
[bearbeiten] DeDi Modul > Bild-Modul Versionsstand 0.92
Das Modul Bild ist ein einfaches Modul zum schnellen Einfügen von Bildern. http://help.der-dirigent.de/index.php?title=Dokumentation_Bild-Modul&action=edit
Mit einem kleinen Menü können Bilder, die im De-Di-Dateimanager vorhanden sind, direkt ausgewählt und eingefügt werden.
[bearbeiten] Übersicht Modulkonfiguration im Backend
[bearbeiten] Formularfeldname
Im Feld "Formularfeldname" wird dem Bild eine Bezeichnung, ein Name zugeordnet. Diese Funktion ist vor allem später nützlich, wenn auf der zu bearbeitenden Seite nur das Bearbeitensymbol angezeigt wird. Beim überfahren dieses Symbols wird dann der vergebene Name angezeigt.
[bearbeiten] Stylesheet für Bildbeschreibung
Hier kann die Schriftformatierung für die Bildbeschreibung gewählt werden. Über das Drop-Down-Menü kann auf Formatierung im Styleshet zurück gegriffen werden. Wenn "keine" gewählt wird, besteht weiter unten im Feld "Template" die Möglichkeit die Formatierung direkt mit HTML-Code zu beeinflussen.
[bearbeiten] Dateitypen
In dieser Auswahl können die Bildformate eingestellt werden, welche beim Bearbeiten des Content zur Auswahl stehen sollen. Es können ein oder mehrere Dateiformate ausgewählt werden. Standardmässig sind alle Webgrafikformate sichtbar.
[bearbeiten] Ordner
Hier wird eingestellt, in welchen Verzeichnissen Bilder abgelegt sind, die später zur Auswahl stehen sollen. Es können entweder ein Ordner, mehrere Ordner oder auch alle Ordner ausgewählt werden. Standardmässig sind alle Verzeichnisse sichtbar.
[bearbeiten] Vorhandene Unterordner automatisch anzeigen
Mit dieser Option können Unterordner der vorhergehenden Auswahl automatisch mit angezeigt werden.
[bearbeiten] Bearbeitungsmenü
Ein normales Menü besteht aus der Schaltfläche "bearbeiten". Das erweiterte Menü bietet zusätzlich die Schaltflächen "neu", "löschen", "nach oben" und "nach unten". Wird kein Menü gewählt, ist der Content nicht editierbar.
Durch den Einsatz des erweiterten Menü können beim Bearbeiten der Seite mehrere Bilder im selben Container eingebaut werden. Diese Bilder können mit den Menüpunkten "nach oben" und "nach unten" in der Reihenfolge vertauscht werden.
[bearbeiten] Template
Die optische Ausgabe wird über das Template gesteuert. Das Template ist normaler HTML-Code, bestückt mit DeDi-Variablen zur Ausgabe. Beim ersten Aufruf des Moduls wird das Standarttemplate geladen. Dieses kann beliebig verändert werden. An dieser Stelle wird das Standarttemplate zur Erklärung und Darstellung der einzelnen Funktionen benutzt.
[bearbeiten] Template (image):
Mit diesem Template kann der Rahmen der Ausgabe gesteuert werden. Dabei Repräsentiert die DeDi-Variable {image} die Ausgabe des Bildes.
[bearbeiten] Layout allgemein
Es können nur bestimmte Variablen innerhalb der Templatekonfiguration verwendet werden, um Informationen abzurufen. DeDi-Variablen werden immer in { } geschrieben. Die verwendeten DeDi-Variablen und deren Bedeutung sind:
[bearbeiten] {image}
Ausgabe des komplett in HTML-Tags formatierten Bildes. (Alt-Tag und Title-Tag werden anhand der Bildbeschreibung ausgegeben. Die Bildbeschreibung wird beim Bearbeiten des Contents gemacht.)
[bearbeiten] {desc}
Zusätzliche Ausgabe der Bildbeschreibung als Text. (z.B. unterhalb des Bildes.)
[bearbeiten] {font}
Ausgabe der CSS Variable wie in der Modulkonfiguration eingestellt. Mögliche HTML Kombination: {name}
Alle Variablen können beliebig verwendet werden.
[bearbeiten] PHP im Template
In den Templates kann ohne weiteres PHP-Code eingebaut werden. PHP-Code kann wie gewohnt mit den Variablen "<?PHP" begonnen werden und mit "?>" beendet werden. Zum schnelleren Seitenaufbau nutzt DEDI für alle Seiten einen internen Cache. Das bedeutet, dass alle generierten Seiten im Cache zwischengespeichert werden und nur bei Änderungen aktualisiert werden. Das gibt auf der einen Seite mehr Geschwindigkeit beim Seitenaufbau, hat aber auch den Nachteil, dass einige PHP-Elemente eventuell nicht aktualisiert werden.
Der Cache kann aufgehoben werden, indem beim Einbinden statt des üblichen PHP-Codes folgender Anfang und Schluss gewählt wird: "<DEDIPHP>" und "</DEDIPHP>"
Grundsätzlich gilt folgendes zum DeDi-Cache zu beachten:
<?PHP echo "Ich bin PHP - Code und werde beim ersten Aufruf generiert und dann gecacht."; ?> <DEDIPHP> echo "Ich bin PHP- Code und werde IMMER neu generiert und NIE gecacht."; </DEDIPHP>
[bearbeiten] Fehlerbehebung
[bearbeiten] Bilder werden nicht angezeigt
Sollte nach einem Wechsel der SubDomain die Bilder in der Tabelle nicht angezeigt werden bitten den Cache unter Redaktion -> Seiten löschen.
