Contao Community Documentation - Benutzerbeiträge [de]

Dma elementgenerator

2012-07-03T14:09:04Z

JanoschSkuplik:

[[Kategorie:Extensions]]

{{ExtInfo
| Dev=DMA (Carsten Kollmeier, Janosch Skuplik)
| DevSite=http://www.dma.do/
| ExtVersion=0.0.3 alpha1
| Version=ab 2.9
| TLVersion=2.7.6 - 2.11.4
| ERLink=http://www.contao.org/erweiterungsliste/view/dma_elementgenerator.html
| Forum=http://www.contao-community.de/showthread.php?6119-dma_elementgenerator-Contentelemente-und-Frontendmodule-generieren
}}

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Man klickt also auf die Schaltfläche "Neues Element" und füllt die Maske wie folgt aus:
<br />
Bezeichnung = Buch<br />
Kategorie = Layouts<br />
Template = dma_eg_default (temporär)<br />
''Als Inhaltselement bereitstellen'' auswählen<br />
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lässt man vorübergehend so, bis man später ein eigenes Template für den Datensatz erstellt.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legt man die Felder an, die man ausgeben möchte. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legt man ein Textfeld an und füllt es folgendermaßen aus:
<br />
Textfeld:<br />
Beschriftung = Titel<br />
Feldname = titel<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Titel<br />

Textfeld:<br />
Beschriftung = Autor<br />
Feldname = autor<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Autor<br />

Textfeld:<br />
Beschriftung = Verlag<br />
Feldname = verlag<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Verlag<br />

Textfeld:<br />
Beschriftung = Alter<br />
Feldname = alter<br />
Beschreibung = Bitte nennen Sie, für welches Alter das Buch geeignet ist<br />

Textfeld:<br />
Beschriftung = Form<br />
Feldname = form<br />
Beschreibung = Bitte nennen Sie, welche Form das Buch aufweist<br />

Textarea:<br />
Beschriftung = Beschreibung<br />
Feldname = beschreibung<br />
Beschreibung = Bitte beschreiben Sie das Buch<br />
Zeilen = 5<br />
Spalten = 100<br />

Dateiauswahl:<br />
Beschriftung = Bild<br />
Feldname = bild<br />
Beschreibung = Wählen Sie ein Bild aus<br />
Vorgabe = (hier könnte man ein Default-Bild angeben)<br />
Art der Auswahl = ft_radio<br />
Pfad = Pfad/zum/Bild.jpg<br />

== Template anlegen ==
Nun liegt ein Datensatz vor mit drei Feldern, die man in einem Template abfragen möchte. Unter Layout/Templates leget man ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weist diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der Name geändert werden (z.B. in dma_eg_buchvorstellung.tpl) und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<div class="left">
<table>
<tbody>
<tr><td class="first"><?php if ($this->elements['titel']): ?><?php echo $this->labels['titel']; ?>:</td><td class="last"><?php echo $this->elements['titel']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['autor']): ?><?php echo $this->labels['autor']; ?>:</td><td class="last"><?php echo $this->elements['autor']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['verlag']): ?><?php echo $this->labels['verlag']; ?>:</td><td class="last"><?php echo $this->elements['verlag']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['alter']): ?><?php echo $this->labels['alter']; ?>:</td><td class="last"><?php echo $this->elements['alter']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['form']): ?><?php echo $this->labels['form']; ?>:</td><td class="last"><?php echo $this->elements['form']; ?><?php endif; ?></td></tr>
</tbody>
</table>
</div>

<?php if ($this->elements['bild']): ?>
<div class="right">
<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['name']; ?>" width="150" />

<div class="caption"><?php if ($this->elements['titel']): ?><?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div></div></div>
<?php endif; ?>

<div class="twocol"> <?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?></div>
</div>

</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />

== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeder andere Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

== Bildergalerie darstellen ==

Hier ein Codeschnipsel, wie man im Template auf die Bilddaten im Falle einer Galerie zugreift:

<source lang="php">
<?php foreach(deserialize($this->elements['gallery'], true) as $bild): ?>
<img src="<?php echo $bild; ?>" />
<?php endforeach; ?>
</source>

Hierzu muss das serialisierte Array zunächst deserialisiert werden und kann dann über eine foreach Schleife schließlich ausgegeben werden. Das Beispiel ist absichtlich sehr einfach gehalten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2012-07-03T14:08:32Z

JanoschSkuplik:

[[Kategorie:Extensions]]

{{ExtInfo
| Dev=DMA (Carsten Kollmeier, Janosch Skuplik)
| DevSite=http://www.ckollmeier.de/
| ExtVersion=0.0.1 beta2
| Version=ab 2.9
| TLVersion=2.7.6 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/dma_elementgenerator.html
| Forum=http://www.contao-community.de/showthread.php?6119-dma_elementgenerator-Contentelemente-und-Frontendmodule-generieren
}}

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Man klickt also auf die Schaltfläche "Neues Element" und füllt die Maske wie folgt aus:
<br />
Bezeichnung = Buch<br />
Kategorie = Layouts<br />
Template = dma_eg_default (temporär)<br />
''Als Inhaltselement bereitstellen'' auswählen<br />
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lässt man vorübergehend so, bis man später ein eigenes Template für den Datensatz erstellt.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legt man die Felder an, die man ausgeben möchte. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legt man ein Textfeld an und füllt es folgendermaßen aus:
<br />
Textfeld:<br />
Beschriftung = Titel<br />
Feldname = titel<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Titel<br />

Textfeld:<br />
Beschriftung = Autor<br />
Feldname = autor<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Autor<br />

Textfeld:<br />
Beschriftung = Verlag<br />
Feldname = verlag<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Verlag<br />

Textfeld:<br />
Beschriftung = Alter<br />
Feldname = alter<br />
Beschreibung = Bitte nennen Sie, für welches Alter das Buch geeignet ist<br />

Textfeld:<br />
Beschriftung = Form<br />
Feldname = form<br />
Beschreibung = Bitte nennen Sie, welche Form das Buch aufweist<br />

Textarea:<br />
Beschriftung = Beschreibung<br />
Feldname = beschreibung<br />
Beschreibung = Bitte beschreiben Sie das Buch<br />
Zeilen = 5<br />
Spalten = 100<br />

Dateiauswahl:<br />
Beschriftung = Bild<br />
Feldname = bild<br />
Beschreibung = Wählen Sie ein Bild aus<br />
Vorgabe = (hier könnte man ein Default-Bild angeben)<br />
Art der Auswahl = ft_radio<br />
Pfad = Pfad/zum/Bild.jpg<br />

== Template anlegen ==
Nun liegt ein Datensatz vor mit drei Feldern, die man in einem Template abfragen möchte. Unter Layout/Templates leget man ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weist diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der Name geändert werden (z.B. in dma_eg_buchvorstellung.tpl) und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<div class="left">
<table>
<tbody>
<tr><td class="first"><?php if ($this->elements['titel']): ?><?php echo $this->labels['titel']; ?>:</td><td class="last"><?php echo $this->elements['titel']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['autor']): ?><?php echo $this->labels['autor']; ?>:</td><td class="last"><?php echo $this->elements['autor']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['verlag']): ?><?php echo $this->labels['verlag']; ?>:</td><td class="last"><?php echo $this->elements['verlag']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['alter']): ?><?php echo $this->labels['alter']; ?>:</td><td class="last"><?php echo $this->elements['alter']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['form']): ?><?php echo $this->labels['form']; ?>:</td><td class="last"><?php echo $this->elements['form']; ?><?php endif; ?></td></tr>
</tbody>
</table>
</div>

<?php if ($this->elements['bild']): ?>
<div class="right">
<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['name']; ?>" width="150" />

<div class="caption"><?php if ($this->elements['titel']): ?><?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div></div></div>
<?php endif; ?>

<div class="twocol"> <?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?></div>
</div>

</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />

== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeder andere Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

== Bildergalerie darstellen ==

Hier ein Codeschnipsel, wie man im Template auf die Bilddaten im Falle einer Galerie zugreift:

<source lang="php">
<?php foreach(deserialize($this->elements['gallery'], true) as $bild): ?>
<img src="<?php echo $bild; ?>" />
<?php endforeach; ?>
</source>

Hierzu muss das serialisierte Array zunächst deserialisiert werden und kann dann über eine foreach Schleife schließlich ausgegeben werden. Das Beispiel ist absichtlich sehr einfach gehalten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)