{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. Alle möglichen Parameter sind:

  • page: Page Objekt der Seite, für deren Datei ein Vorschaubild generiert werden soll.
  • identity: Anstelle eines Page Objekts in page kann auch eine Identität übergeben werden.
  • pool: Falls es sich um eine Mediapool Datei des Page Objekts handelt sollte, wird hier der Mediapool Dateiname übergeben.
  • dir: Falls die Mediapool Datei in einem Unterverzeichnis liegt, wird hier der Name des Unterverzeichnisse angegeben.
  • width: Breite des Thumbnails.
  • height: Höhe des Thumbnails (optional, es wird nach dem Best-fit Verfahren skaliert).
  • param:
    • index: 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" />