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.
| Optionen | Möglicher Inhalt |
| file | Datei-ID (integer) |
| zip | Archiv-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.
| Optionen | Möglicher Inhalt |
| file | Datei-ID (integer) |
| zip | Archiv-ID (integer) |
| type | count 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.
| Optionen | Möglicher Inhalt |
| zip | Archiv-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.
| Optionen | Möglicher Inhalt |
| file | Datei-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.
| Optionen | Möglicher Inhalt |
| file | Datei-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>