{get_thumbnail}

Für PDF Dokumente und Animationen (z.B. GIF) kann automatisch ein Vorschaubild (Thumbnail) generiert werden. Damit ermittelt das CMS standardmäßig das erste Frame und erzeugt davon das Thumbnail in einer angegebenen Breite/Größe.

{get_thumbnail page=$media var="thumbnail" width=150} <img src="{$thumbnail}">

Das gezeigte Smarty Beispiel erzeugt eine Thumbnail URL und speichert diese in die Variable $thumbnail, welche dann in einem HTML Bild Element verwendet wird. Das Thumbnail hat dabei eine Breite von 150 Pixel. Die Höhe wird automatisch berechnet, um das Seitenverhältnis zu erhalten.

Parameter-Name Typ Erforderlich Beschreibung
page Page Ja

Page Objekt der Seite, für deren Datei ein Vorschaubild generiert werden soll.

identity String Nein

Anstelle eines Page Objekts in page kann auch eine Identität übergeben werden.

pool String Nein

Falls es sich um eine Mediapool Datei des Page Objekts handelt sollte, wird hier der Mediapool Dateiname übergeben.

dir String Nein

Falls die Mediapool Datei in einem Unterverzeichnis liegt, wird hier der Name des Unterverzeichnisse angegeben.

width Integer Ja

Breite des Thumbnails.

height Integer Nein

Höhe des Thumbnails (optional, es wird nach dem Best-fit Verfahren skaliert).

param.index Integer Nein

Frame des Thumbnails (Standard: 0).

Die Generierung eines Thumbnails ist auch in PHP möglich:

$src = $page->getThumbnail($width, $height = 0, $pool = '', $dir = '', $param = []);
wb_incandescent

Die Generierung eines Thumbnails für Video Dateien ist noch nicht möglich.

warning

Sie müssen das Lesen von PDF Dokumenten für ImageMagick erlauben, damit die Generierung funktionieren kann. Setzen Sie dafür in z.B. /etc/ImageMagick-6/policy.xml folgende Regel nicht: <policy domain="coder" rights="none" pattern="PDF" />