martin-kozianka/contao-metafields

Additional metafields for contao

2.0.1 2017-08-11 19:53 UTC

Requires

• contao-community-alliance/composer-plugin: ~2.4 || ~3.0
• contao/core-bundle: ~3.5 || ~4.4

LGPL-3.0+

• Martin Kozianka

• contao
• metafields

README

Mit dieser Erweiterung kann man Dateien weitere Metadatenfelder hinzufügen. Die Felder können einfach über einen Menüpunkt im Backend definiert werden. Die zusätzlichen Metadaten können dann in folgenden Inhaltselementen ausgegeben und verwendet werden:

• Bild [ce_image]
• Galerie [gallery_default bzw. ein eigenes Galerie-Template]
• Text [ce_text]
• Akkordeon (Einzelelement) [ce_accordion]

Zusätzlich dazu werden die Metadaten auch für die Teaserbilder im Nachrichtenmodul in die jeweiligen Templates integriert. Die Nutzung der Metadaten erfolgt analog zum dem Beispiel des Inhaltelementes Bild.

Galerie Inhaltselement

Entweder man greift wie in dem Template zu sehen auf das Metadaten-Array zu, wobei der Schlüsselwert für die Daten das Attribut singleSRC des Bildelementes ist oder man verwendet die Hilfsfunktion MetafieldsHelper::embedData() indem man am Anfang des Templates folgenden Aufruf macht:

<?php Metafields\MetafieldsHelper::embedData($this->body, $this->metadata); ?>

Danach kann man in der Schleife die Metadaten einfach direkt aus der Schleifenvariablen $col auslesen:

<?php var_dump($col->metadata); ?>

Template mit erweiterten Metadaten

<ul>
  <?php foreach ($this->body as $class=>$row): ?>
    <?php foreach ($row as $col): ?>
      <?php if ($col->addImage): ?>
        <li class="<?php echo $class; ?> <?php echo $col->class; ?>">
          <figure class="image_container" ...>
            <?php if ($col->href): ?>
              <a href="<?php echo $col->href; ?>" ...><img src="<?php echo $col->src; ?>" ...></a>
            <?php else: ?>
              <img src="<?php echo $col->src; ?>" ...>
            <?php endif; ?>
              <figcaption class="src"><?php echo 'src: '.$col->src; ?></figcaption>
              <figcaption class="singleSRC"><?php echo 'singleSRC: '.$col->singleSRC; ?></figcaption>
              
              <div class="metaData">
                <figcaption class="author"><?php echo $this->metadata[$col->singleSRC][author]; ?></figcaption>
                <figcaption class="city"><?php echo $this->metadata[$col->singleSRC][city]; ?></figcaption>
                <figcaption class="quote"><?php echo $this->metadata[$col->singleSRC][quote]; ?></figcaption>
                <figcaption class="isbn"><?php echo $this->metadata[$col->singleSRC]['isbn']; ?></figcaption>
              </div>
	      
            <?php if ($col->caption): ?>
              <figcaption class="caption" ...><?php echo $col->caption; ?></figcaption>
            <?php endif; ?>
          </figure>
        </li>
      <?php endif; ?>
    <?php endforeach; ?>
  <?php endforeach; ?>
</ul>

Bild Inhaltselement

Für die Inhaltselemente Text und Akkordeon (Einzelelement) funktioniert die Ausgabe der Metadaten ebenfalls.

Template mit erweiterten Metadaten

<div ...>
  <figure class="image_container" ...>
    ...
  </figure>
  <?php var_dump($this->metadata); ?>
</div>