Zum Inhalt springen

Shortcodes

Hier werden alle Shortcodes aufgelistet die Z-Downloads mitbringt.

Download-Button


// Beispiele:

[zdownload file="123"]
[zdownload zip="123"]

Um einen Download-Button anzuzeigen verwendest du diesen Shortcode.

OptionenMöglicher Inhalt
fileDatei-ID (integer)
zipArchiv-ID (integer)
align (optional)center

file & zip

Die Option file gibt die ID einer Datei und zip die ID eines Archives an das als Download-Button ausgegeben werden soll.

align

Die Option align mit der Angabe center wird der Downloadbutton zentriert.

Metadaten ausgeben


// Beispiele:

[zdownload_meta file="123" type="count"]
[zdownload_meta zip="123" type="size"]
[zdownload_meta file="123" type="name"]
[zdownload_meta zip="123" type="filename"]
[zdownload_meta file="123" type="hash-md5"]
[zdownload_meta zip="123" type="hash-sha1"]

Mit diesem Shortcode kannst du Metadaten wie Downloadanzahl, Dateigröße, Dateiname oder den Hashwert einer Datei oder ZIP-Datei ausgeben.

OptionenMöglicher Inhalt
fileDatei-ID (integer)
zipArchiv-ID (integer)
typecount
size
name
filename
hash-md5
hash-sha1

file & zip

Die Option file gibt die ID einer Datei und zip die ID eines Archives an.

type

Die Option type gibt an was für Daten ausgegeben werden sollen.

  • count gibt die aktuelle Download Anzahl als Text aus.
  • size gibt die Dateigröße als Text aus.
  • name gibt den von dir vergebenen Namen als Text aus.
  • filename gibt den Dateinamen als Text aus.
  • hash-md5 gibt den MD5 Hashwert der Datei als Text aus.
  • hash-sha1 gibt den SHA1 Hashwert der Datei als Text aus.

Listen


// Beispiel:

[zdownload_list zip="123"]
[zdownload_list zip="123" style="ul"]
[zdownload_list zip="123" bold="on"]
[zdownload_list zip="123" links="on"]

Mit diesem Shortcode kannst du alle Dateien die zu einem Archiv verknüpft sind als Liste ausgeben.

OptionenMöglicher Inhalt
zipArchiv-ID (integer)
style (optional)rows (Standardwert)
ul
ol
bold (optional)off (Standardwert)
on
links (optional)off (Standardwert)
on

In den Plugin-Einstellungen können die Standardwerte für die Optionen geändert werden.

Folgende Standardwerte sind vordefiniert:

  • style: rows
  • bold: off
  • links: off

Die Standardwerte werden bei der Ausgabe überschrieben wenn im Shortcode eine oder mehrere Optionen definiert ist.

zip

Die Option zip gibt das Archiv an von dem die Dateiliste erstellt werden soll.

style

Mit der Option style legst du den Stil der Liste fest.

  • rows gibt die Listenelemente Zeile für Zeile aus
  • ul gibt eine ungeordnete Liste aus
  • ol gibt eine geordnete Liste aus

bold

Mit dieser Option kann der Text fett ausgegeben werden.

links

Wenn diese Option mit „on“ definiert ist, wird jedes Listenelement als Textlink ausgegeben und ermöglicht den direkten Download der Datei.

Audioplayer


// Beispiel:

[zdownload_audio file="123"]
[zdownload_audio file="123" autoplay="on"]
[zdownload_audio file="123" autoplay="on" loop="on"]
[zdownload_audio file="123" autoplay="on" loop="on" controls="off"]

Gibt eine Audiodatei wie MP3, WAV oder OGG als HTML5 Audioplayer aus.

Diese Browser unterstützen das HTML <audio> Element.

OptionenMöglicher Inhalt
fileDatei-ID (integer)
autoplay (optional)off (Standardwert)
on
loop (optional)off (Standardwert)
on
controls (optional)off
on (Standardwert)
nodownload (optional)off (Standardwert)
on
align (optional)center

file

Die Option file gibt die ID einer Datei an die als Audioplayer ausgegeben werden soll.

autoplay

Die Option autoplay gibt an ob der Audioplayer beim Aufruf der Seite automatisch starten soll oder nicht. Standardmäßig ist diese Funktion deaktiviert wenn die Option autoplay nicht angegeben wird.

loop

Wenn die Option loop auf on gestellt wird, dann läuft die Audiodatei in einer Dauerschleife ab. Standardmäßig ist diese Option deaktiviert.

controls

Die Option controls ist standardmäßig aktiviert, wenn diese Option auf off gestellt wird, dann wird kein Player angezeigt. In Verbindung mit der Option autoplay kann so eine Audiodatei automatisch abgespielt werden ohne einen sichtbaren Player, das ist aber für die Benutzerfreundlichkeit nicht zu empfehlen.

nodownload

Wenn die Option nodownload auf on gestellt wird, dann wird im Frontend der Download-Button im Audioplayer nicht angezeigt.

align

Die Option align mit der Angabe center wird der Audioplayer zentriert.

Unterstützte MIME-Types für die Ausgabe

  • audio/aac
  • audio/aacp
  • audio/flac
  • audio/mp3
  • audio/mp4
  • audio/mpeg
  • audio/ogg
  • audio/wav
  • audio/wave
  • audio/webm
  • audio/x-pn-wav
  • audio/x-wav

Um den Audioplayer mit Hilfe von JavaScript zu steuern besitzt jedes HTML Audio-Element eine individuelle id wie zum Beispiel id=“zdmAudio123″, id=“zdmAudio9″ oder id=“zdmAudio52″, diese setzt sich aus zdmAudio und der ID der Datei zusammen.


// HTML-Tag:

<audio preload="none" id="zdmAudio123" controls>
  <source src="https://audio.mp3" type="audio/mp3">
</audio>

Videoplayer


// Beispiele:

[zdownload_video file="123"]
[zdownload_video file="123" w="50%"]
[zdownload_video file="123" w="720px"]
[zdownload_video file="123" w="720px" autoplay="on"]
[zdownload_video file="123" w="720px" autoplay="on" loop="on"]
[zdownload_video file="123" w="720px" autoplay="on" loop="on" controls="off"]

Gibt einen HTML5 Videoplayer aus.

Diese Browser unterstützen das HTML <video> Element.

OptionenMöglicher Inhalt
fileDatei-ID (integer)
w (optional)100% (Standardwert)
400px
autoplay (optional)off (Standardwert)
on
loop (optional)off (Standardwert)
on
controls (optional)off
on (Standardwert)
nodownload (optional)off (Standardwert)
on
align (optional)center

file

Die Option file gibt die ID einer Datei an die als Video ausgegeben werden soll.

w

Die Option w ist optional mit der du die Breite des Videos in Form von % oder px angeben kannst. Standardmäßig ist eine Breite von 100% eingestellt wenn die Option w nicht angegeben wird.

autoplay

Die Option autoplay gibt an ob das Video beim Aufruf der Seite automatisch starten soll oder nicht. Standardmäßig ist diese Funktion deaktiviert wenn die Option autoplay nicht angegeben wird.

loop

Wenn die Option loop auf on gestellt wird, dann läuft das Video in einer Dauerschleife ab. Standardmäßig ist diese Option deaktiviert.

controls

Die Option controls ist standardmäßig aktiviert, wenn diese Option auf off gestellt wird, dann werden keine Kontrollelemente wie Play, Pause, Lautstärke, Vollbild, Zeitleiste oder weitere Optionen beim Video angezeigt. In Verbindung mit der Option autoplay kann so eine Videodatei automatisch abgespielt werden ohne eine Möglichkeit das Video zu stoppen, das ist aber für die Benutzerfreundlichkeit nicht zu empfehlen.

nodownload

Wenn die Option nodownload auf on gestellt wird, dann wird im Frontend der Download-Button im Videoplayer nicht angezeigt.

align

Die Option align mit der Angabe center wird der Videoplayer zentriert.

Unterstützte MIME-Types für die Ausgabe

  • video/mp4
  • video/ogg
  • video/webm

Um den Videoplayer mit Hilfe von JavaScript zu steuern besitzt jedes HTML Video-Element eine individuelle id wie zum Beispiel id=“zdmAudio123″, id=“zdmAudio9″ oder id=“zdmAudio52″, diese setzt sich aus zdmVideo und der ID der Datei zusammen.


// HTML-Tag:

<video id="zdmVideo123" width="100%" controls>
  <source src="https://video.mp4" type="video/mp4">
</video>