Flexible Downloads als WordPress Content

Die Aufgabe

Wenn du für einen Inhaltstyp deiner Website wie Immobilien, technische Produkte oder ähnliches Downloads (zB. PDF-Files, XLS-Files oder auch zip-Archive) anbieten willst kannst du diese natürlich einfach in die Mediathek hochladen und dann die URLs dieser Dateien mit Buttons oder Textlinks aufrufen lassen. Für einige wenige Dateien ist das auch eine gute Lösung. Wenn du eine große Anzahl an Datenblättern o.Ä. anbietest oder Einschränkungen für Benutzergruppen benötigst wirst du vmtl. eine Lösung wählen die genau dieses Funktionen in einem Plugin vereint. Hier beschreibe ich einen Weg der zwischen den beiden Anforderungen liegt. Wir wollen:

1. Keine oder beliebig viele Downloads zu einem Beitrag (oder einem anderen Inhaltstyp) anbieten.
2. Die Anzeige der Downloads soll automatisch über ein Template erfolgen.
3. Informationen wie Fileart und ein frei einzugebender Name sollen angezeigt werden.

Neben einer aktuellen WordPress-Umgebung verwenden wir folgende Tools:

1. Elementor Pro - damit können wir das Single Post Template für die Ausgabe des Beitrages gestalten.
2. Advancedcustomfields Pro - die Pro-Version benötigen wir, weil wir ein Repeater-Feld (Wiederholungsfeld) einsetzen wollen.
3. Dynamic Content for Elementor benötigen wir u.a. für die Ausgabe des Repeater-Feldes.
4. Dynamic Shortcodes (Teil der Lizenz von Dynamic Content) benötigen wir um in das Template für den Download die korrekten Fileinformationen zu laden.

Klingt vielleicht alles auf den ersten Blick ein wenig kompliziert. Aber eine komplexere Dateiverwaltung wie Wiederholfelder (Repeater) brauchen eben auf der Fronstseite auch eine entsprechende Umsetzung.

Die Filestruktur mit ACF

Ein Feld Downloads wird nun mit dem Feldtyp Repeater (Wiederholungsfeld) angelegt. Ein Repeaterfeld ist genau genommen kein Feld sondern wiederum eine Feldgruppe. Innerhalb dieser Feldgruppe Downloads legt man nun jene Felder an, die für jeden einzelnen Downloadeintrag gewünscht sind.

Das Repeater Widget

Zuerst muss sichergestellt sein, dass unter

Dashboard > Dynamic Content for Elementor > Features | Widgets | Advanced Custom Fields

die für die Anzeige notwendigen Widgets aktiviert sind. In unserem Fall werden wird ACF Fields und ACF Repeater verwendet.

Elementor-typisch obliegt es dem Designer wo und wie das Repeater-Feld eingebunden wird. Oft wird man eine eigene Sektion oder Spalte vorsehen damit auch genug Raum für flexibel viele Zeilen bleibt.

Nun muss man dem ACF-Repeater-Widget sagen, welches Feld es anzeigen soll: in diesem Fall das Feld Downloads und zwar die Daten aus dem Current Post. (Weil wir das Konstrukt ja in einem Single-Post-Template einbauen).

Das Widget hat 3 Anzeige-Modi (Display mode): Subfields (eine Listendarstellung), Dynamic HTML (eine Auflistung die in etwa wie hier beschrieben funktioniert) und Templates.

Wir verwenden die Template-Option und erstellen dafür ein kleines Template, das alle Elemente einer einzelnen Downloadzeile anzeigen lässt.

Dynamic hat hier noch eine Reihe weiterer Optionen wie alternierende Templates etc. vorgesehen, lässt ausser einer Grid- auch Caroussel-, Table-, List-Darstellungen etc. zu. Es gibt auch Filtermöglichkeiten nach Feldinhalten. Es kann also schon noch tiefer gehen...

Jede einzelne Downloadzeile ist aus einem Container mit 3 Subcontaineren aufgebaut. Durch diese auf den ersten Blick ein wenig komplizierte Struktur kann man sehr genau die Spaltenbreiten und Ausrichtungen kontrollieren - schliesslich will man die Elemente ordentlich untereinander ausgerichtet darstellen - unabhängig von der Länder des Anzeigenamens.

Während Icon und Button mit dem File verlinkt sind verwenden wir für Titel und Fileart das ACF Fields Widget. Alternativ dazu kann man die Inhalte auch in anderen Widgets dynamisch anzeigen lassen, zB. dem Text-Editor oder Titel-Widget. Geschmackssache und ev. bei Kleinigkeiten im Design wichtig.

Der File Link

Der Link, den wir beim Button als Ziel angeben, wird über die Dynamischen Attribute als Dynamic Shortcode gesetzt. Der Code lautet:

{media:url @id={acf:downloadfile}}

Das ist ein verschachtelter Code. In der Mitte steht das auszulesende Feld, hier {acf_downloadfile}, von diesem benötigen wir die (WordPress) ID, daher @id=, und weil es sich um ein Media-File handelt ist eben der Shortcode {media:url …} gefragt.

Neben URL kann man mit dem Media-Shortcode auch Titel, Alt-Text, Filepfad und bei Bildern auch Breite und Höhe auslesen. Leider aber nicht die Filesize, was recht praktisch wäre.

Will man das Icon oder den Anzeigenamen mit dem File verlinken ist der selbe Shortcode eben dort im Link-Bereich anzugeben.

Das war's auch schon. Sollte klappen.

Fazit

Mit den richtigen Tools ist es nicht so kompliziert mehrere Downloads zu einem Post zu organisieren. Herausforderungen sind die Variablen bei der Anzahl, die man durch ein Wiederholungsfeld löst, und die File-Url, die aus der Attachment-Logik von WordPress zu ziehen ist.