Génération des miniatures / prévisualisation des images et documents

Paheko peut générer des miniatures ("thumbnails" en anglais) des images et documents bureautique stockés.

Cette fonctionnalité dépend de logiciels et librairies tierces.

  • Images : nécessite d'avoir l'extension PHP Imagick (de préférence) ou GD. Il n'y a rien à configurer du côté de Paheko, dès que la librairie est installée ça doit marcher.
  • Documents OpenDocument (LibreOffice : ODT, ODS, ODP, etc.) : ils contiennent normalement en leur sein une image miniature, qui est donc extraite par Paheko si elle existe, sinon voir documents bureautique ci-dessous.
  • Documents bureautique (LibreOffice, Microsoft Office, etc.) : nécessite d'avoir soit une instance Collabora ou OnlyOffice à disposition, soit d'avoir installé unoserver sur le serveur (pour son outil unoconvert)
  • Fichiers PDF, SVG, EPUB : nécessite d'avoir installé mupdf-tools sur le serveur
  • Vidéos : nécessite d'avoir installé ffmpeg sur le serveur

Configurer l'utilisation de logiciels tiers pour l'extraction de miniatures

Il faut modifier la constante CONVERSION_TOOLS (DOCUMENT_THUMBNAIL_COMMANDS jusqu'à la version 1.3.11) dans le fichier config.local.php. Voir le fichier config.dist.php pour les détails.

Par exemple si on utilise Collabora, MuPDF et ffmpeg on utilisera cette configuration :

const CONVERSION_TOOLS = ['mupdf', 'collabora', 'ffmpeg'];

L'ordre des outils dans la liste n'a pas d'importance, Paheko utilisera toujours l'outil le plus performant en priorité (mupdf, puis Collabora ou unoconvert, puis OnlyOffice).

OnlyOffice

Pour OnlyOffice, c'est légèrement différent, il faut aussi indiquer le jeton JWT secret dans la configuration, comme ceci :

const CONVERSION_TOOLS = [
	'mupdf',
	'onlyoffice' => ['jwt_token' => 'XXXX'],
	'ffmpeg'
];

Ce jeton est normalement créé à l'installation. Voir la document de OnlyOffice pour les détails.

Autres fonctions de conversion

Recherche dans les documents

Par défaut, Paheko peut indexer et rechercher dans les documents texte, MarkDown, OpenDocument et OOXML (LibreOffice / Microsoft Office). Si on active aussi l'outil mupdf, alors le contenu des documents PDF, SVG et EPUB sera également indexé dans la recherche de documents.

Conversion des fichiers tableur LibreOffice et MS Office à l'import

Dans l'import de membres, d'écritures, etc. Paheko accepte par défaut uniquement le CSV. Si on ajoute Collabora, OnlyOffice, unoconvert ou ssconvert (outil de Gnumeric) dans la liste des outils, alors Paheko acceptera aussi les fichiers ODS, XLSX et XLS à l'import (ils seront convertis en CSV avant import en fait).