Modulprogrammierung Einstieg

Aus DeDi-Help

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

[bearbeiten] Grundlagen

Genauso wie es möglich ist, im Layout mit der DeDi-Taggruppe <dedi:lay ... /> Container und Contentbereiche definieren können, können Sie mit der DeDi-Taggruppe <dedi:mod ... > ganz leicht eigene Module erstellen, in denen die einzelnen Funktionen, wie z. B. WYSIWYG-Editor, Bild und andere, zu einem Modul zusammen geführt werden können.


Diese Funktion können Sie nutzen, um zum Beispiel komplette Seitenvorlagen, mit fest definierten Inhaltsbereichen zu erstellen. So können Sie z.B. eine Artikel-Vorlagenseite mit einem einzigen Modul unter Verwendung von <dedi:mod .... /> erstellen. Solche Vorlagen machen immer dann Sinn, wenn der User oder Redakteur keine Layouteingriffe haben soll, sondern nur Content (Inhalt)verwalten und anlegen soll.


Wir geben Ihnen hier einen Überblick über die Möglichkeiten, die Variablen und eine Anleitung der ersten Schritte. Ihrer Kreativität ist mit <dedi:mod .... /> keine Grenze gesetzt. Wir empfehlen Ihnen mit unseren kleinen Beispielen die grundlegenden Funktionen kennen zu lernen und später, durch ausprobieren, eigene Module zu entwerfen.


[bearbeiten] Eigenes Modul erstellen / Vorbereitung

Um den Grundsatz der Modulverarbeitung mit <dedi:mod .... /> zu verstehen, wollen wir zu Anfang ein sehr kleines, einfaches Modul erstellen. Wir wollen einfach die beiden Funktionen "bild2 und "wysiwyg" zusammenführen und zu einem Modul, nennen wir es mal "Mein erstes Modul", zusammenführen.


[bearbeiten] HTML-Gerüst mit Platzhaltern

Hierzu erstellen wir in unserem HTML-Editor einfache Tabelle mit einer Zeile und zwei Spalten. Die linke Spalte wollen wir 100 Pixel, die rechte Spalte 300 Pixel breit haben. Links in die Zelle schreiben wir "Bild", rechts "Inhalt".

<table border="0" width="450">
   <tr>
     <td width="100">Bild</td>
     <td width="300">Inhalt</td>
   </tr>
 </table>


[bearbeiten] Platzhalter durch <dedi:mod ... > ersetzen

Anstelle von "Bild" und "Inhalt" setzen wir jetzt unsere Funktionen ein, die später im Backend erscheinen sollen. Also für das Bild, z. B. das Modul "image" und für den Inhalt das Modul "wysiwyg" Editor. Das ganze erfolgt nun mit unserem <dedi:mod> Tag, in einer ähnlichen Form wie die <dedi:lay> Tags in unseren Layout-Dateien:


<table border="0" width="450">
   <tr>
     <td width="100"><dedi:mod type="image" id="1" /></td>
     <td width="300"><dedi:mod type="wysiwyg" id="2" /></td>
   </tr>
 </table>


[bearbeiten] Grundsätze

Wie in unseren Layoutdateien müssen wir allerdings wieder einige, wenige Grundsätze beachten:


<dedi:mod (Pflichtfeld)
Leitet die Codezeile für das DEDI:tag ein.


type="image" (Pflichtfeld)
Bezeichnet die Funktion die verwendet werden soll, hier ein Bild


id="1" (Pflichtfeld, Wertbereich von 1 bis 999999)
Fortlaufende, eindeutige Nummer des dedi:mod Tags


/>
Beendet die Codezeile für das DEDI:tag.


[bearbeiten] Modul anlegen

Im Grundsatz ist mit dem oben erstellten Code unser eigenes Modul bereits fertig. Natürlich ist es Ausbaufähig und kann noch mit Zusatzangaben verfeinert werden. Wir wollen hier aber erstmal auf die Grundlagen eingehen, und die weiteren Möglichkeiten später darstellen.


Um das Modul nun in DeDi bereitzustellen, gehen wir im Backend auf "Design > Module > Neues Modul". Hier legen wir nun unser erstes Modul an:

Modulname Freie Bezeichnung, z.B. "Meine Artikel-Vorlage"
Version Freie Versionsangabe für Ihre eigene Entwicklungsübersicht
Kategorie Kategorieangabe, z.B. "Eigene Module"
Beschreibung Freie Beschreibung für das Modul
Konfiguration Moduleinstellungen (keine Eingabe, erfolgt später)
Frontendausgabe Unser HTML Code mit <dedi:mod ... />

Im Bereich Frontendausgabe fügen wir unseren vorbereiteten HTML Code mit <dedi:mod .../> ein, also:


<table border="0" width="450">
   <tr>
     <td width="100"><dedi:mod type="image" id="1" /></td>
     <td width="300"><dedi:mod type="wysiwyg" id="2" /></td>
   </tr>
 </table>


Zum Speichern klicken wir einfach auf den grünen Punkt am Ende der Seite. Unser Modul steht in DeDi unter "Design > Module" nun mit dem Namen "Mein erstes Modul" zur Verfügung. Das Modul kann nun wie gewohnt in ein beliebiges Template eingebunden werden und später in der Seite bearbeitet werden.


Achtung: Um nicht unnötig Verwirrung zu stiften, ist die Darstellung der DEDI:tags noch ein wenig vereinfacht worden. Dies betrifft die Eigenschaft id="X". Die Angabe <dedi:mod type="image" id="1" /> und <dedi:mod type="wysiwyg" id="1" /> würden in unserem kleinen Testmodul auch ohne Probleme funktionieren, obwohl beide Tags mit der id="1" gekennzeichnet sind. Dies liegt daran, dass jeder DEDI:tag-type (also z. B. image, wysiwyg) seinen eigenen id- Zähler besitzt. Diese sind voneinander unabhängig.

Persönliche Werkzeuge