Optimierung der Readme

[Olli]

Ich komme gerade nicht weiter, wie ich eine Galerie ausgeben soll. Ich denke, dass es ähnlich wie mit den Bildern geht. Das Twig Template habe ich auch gefunden aber wenn ich das aufrufe mit der Twig Variable, die eigentlich die Bilder enthält dann wird gesagt, dass sie leer ist.
Ich schätze mal, dass die Ausgabe einer Dateiliste (für Downloads) ähnlich ist.
Wenn z.B. ein Beispiel mit einer Bildersammlung noch in die Readme könnte wäre das mMn nicht schlecht.

[Defcon0]

Bei der Bildergallerie stecke ich nicht so drin. @koertho Kannst du dir das bitte mal anschauen?

Eine Datei-Liste kannst du einfacher ausgeben. In Contao sind das ja immer serialisierte Listen von UUIDs, die du mit dem fileTree im Backend auswählst. Wir liefern für sowas eine Menge von Twig-Filtern schon im utils-bundle mit, sodass du das ganze folgendermaßen machen könntest (ein eigenes Config-Element gibt es dafür nicht):

{% for download in raw.downloads|deserialize(true) %}
  {{ download|file_path }}
{% endfor %}

Wenn das ganze als Download-Element ausgegeben werden soll (weil bspw. der Ordner nicht public sein darf), kannst du auch den download-Inserttag nutzen (https://github.com/heimrichhannot/contao-inserttagcollection-bundle):

{% for download in raw.downloads|deserialize(true) %}
  {{ '{{download::' ~ download ~ '}}' }}
{% endfor %}

[Olli]

Ja die Filter habe ich schon gefunden. Das ist ja ziemlich analog wie die Ausgabe des Bildes (siehe README - ist ja auch ein TWIG Filter)
Aber ich habe Probleme den Gallerie Filter aufzurufen weil in dem Filter eine Variable benutzt wird die beim Aufruf irgendwie da rein übergeben werden muss bzw gemappt werdne muss.
z.B.

    {% if gallery_images|default  %}
     Gallery
      <div class="images">
        {{ include('@HeimrichHannotContaoUtils/image_gallery.html.twig',  { gallery_images:  'imageGallery' } ) }}
      </div>
    {% endif %}

Da habe ich sicher die Übergabe falsch gemacht bzw muss die gallery_images irgendwie noch "vorbereitet" werden oder?

[Defcon0]

OK, da würde ich dich an @koertho verweisen, da er den Type gebaut hat.

[Olli]

{% for download in raw.downloads|deserialize(true) %}
  {{ '{{download::' ~ download ~ '}}' }}
{% endfor %}

Das funktioniert übrigens so nicht. Ich schätze mal, dass die UUID nicht richtig an den Inserttag übergeben wird. Wenn ich {{download}} mache wird das raw ausgegeben und nicht als UUID.

[Defcon0]

Stimmt, es ist

{% for download in raw.downloads|deserialize(true) %}
  {{ '{{download::' ~ download|file_path ~ '}}' }}
{% endfor %}

[koertho]

Also, wenn das Config Element korrekt eingestellt ist, musst du nur die Variable durchlaufen. Zusammen mit dem ImageGallery-Template des Utils-Bundle habe ich es nicht getestet.

Eigentlich so in der Art (code ist nicht getestet, aber in etwa):

{% if gallery_images|default  %}
   Gallery
   <div class="images">
      {% for image in gallery_images %}
         {{ include('@HeimrichHannotContaoUtils/image.html.twig',  { image:  'image' } ) }}
      {% endfor %}
   </div>
{% endif %}

[Olli]

Das Beispiel will nicht - die Übergabe der Variable an das Template geht nicht weil da wieder ein Array erwartet wird.

Ich habe es jetzt mit {{gallery_images | image_gallery | raw }} versucht. Das geht aber da werden keine im Configurationselement festelegten Bildgrößen beachtet. Das ist aber glaube ich ein weiteres Issue für das Utils Paket.

Ich habe mich geirrt - das funktioniert gar nicht.
Ich habe es jetzt so gemacht:

  {% if gallery_images | default and gallery_images %}
    Gallery

    <div class="images">
       {% for image in raw.gallery_images  | deserialize(true) %}
          {{image|image([0,0,1])|raw}}
          {# include('@HeimrichHannotContaoUtils/image.html.twig',  { image:  'picture' } ) }}
       {% endfor %}
    </div>
  {% endif %}

So komme ich jetzt erst mal weiter. Nichts desto trotz glaube ich, dass die Dokumentation an dieser Stelle detailierter sein sollte.

[Olli]

Stimmt, es ist

{% for download in raw.downloads|deserialize(true) %}
  {{ '{{download::' ~ download|file_path ~ '}}' }}
{% endfor %}

Ich glaube das ist zielführender (für Referenzzwecke falls jemand ähnliche Probleme hat wie ich ) - mit den Utils zumal es den "download" Inserttag im offiziellen Contao nicht gibt.

{{ document | download(true) | raw }}

[koertho]

@Olli Deswegen schrieb ich ja, das der Code nicht getestet ist, ein wenig schauen, wie die Variablen heißen und so musst du schon ;) ich habe es so ähnlich schon erfolgreich in einem Projekt genutzt, da lief es. Du brauchst da kein raw oder sowas, wahrscheinlich ist einfach das 'image' bei der Variablenübergabe falsch.

{% if gallery_images|default  %}
   Gallery
   <div class="images">
      {% for image in gallery_images %}
         {{ include('@HeimrichHannotContaoUtils/image.html.twig',  { image:  image } ) }}
      {% endfor %}
   </div>
{% endif %}

Aber wie gesagt, bin zuhause, da kann ich nicht so gut schauen.

[koertho]

@Olli Ich öffne mal das Ticket wieder, damit ich es noch auf dem Schirm habe, das Element zu dokumentieren :)

[Olli]

Ach ok ich hatte vermutet, dass das Thema eher nicht so von Interesse war.