📁

Les différents formats de fichiers

Quels sont les formats de fichiers compatibles avec Piwigo ? On vous explique tout !

Clients piwigo.com et auto-hébergement : les différences

Pour commencer, les choses sont légèrement différentes selon que vous ayez un compte sur piwigo.com ou que vous hébergiez vous-même votre Piwigo.

‣

J’héberge moi-même mon Piwigo

‣

J’ai un compte Piwigo hébergé sur piwigo.com

Fichiers images

Piwigo vous permet d'importer des fichiers images, qui sont lisibles dans un navigateur web. Les extensions de fichiers images supportés par Piwigo sont les suivants :

.jpg
.jpeg
.png
.gif
.webp
.heic

Tous ces formats sont reconnus par Piwigo, qui générera une vignette pour les images visibles dans l'administration de Piwigo ainsi que dans votre galerie.

Précisions sur le format .gif

Piwigo permet également d'importer des GIF animés (extension de fichier .gif). Si le fichier d’origine est plus grand que la taille des miniatures sur votre galerie (par défaut, 144x144) la galerie affichera uniquement une prévisualisation du fichier GIF, créée à partir de la première image composant l'animation. Il faudra afficher l’original pour “jouer” l’animation.

Précisions sur le format .webp

Depuis la version 14 de Piwigo, vous pouvez également importer des fichiers image au format webp.

Si vous hébergez vous-même votre Piwigo, vous pouvez l’ajouter via le plugin LocalFiles Editor, en ajoutant webp au niveau du paramètre $conf['picture_ext'] comme dans l’exemple ci-dessous.

$conf['picture_ext'] = array('jpg','jpeg','png','gif','webp');

💡

WebP est le type le plus "supporté par les navigateurs web" pour remplacer le JPEG. WebP est supporté à l'import aussi bien qu'à l'affichage, et Piwigo va générer un fichier webp pour chaque taille affichée dans votre galerie. WebP peut remplacer le JPEG avec une meilleure qualité pour un poids équivalent, remplacer les GIF animés pour une fraction du poids et même remplacer les PNG avec une compression non destructive et de la transparence.

⚠️

Pour supporter les WebP animés, vous devrez peut-être mettre à jour le système d’exploitation de votre serveur si vous utilisez un Piwigo auto-hébergé.

Cas particulier du format HEIC

HEIC est un format d’image supporté dans Piwigo depuis la version 14. C’est le format de fichier généré par défaut sur iOS, et sur certains téléphones Android.

Les fichiers HEIC ne sont pas affichables dans un navigateur web : Piwigo génère donc une prévisualisation du fichier.

Pour activer le support du format HEIC si vous hébergez vous-même votre Piwigo, vous devez l’ajouter via le plugin LocalFiles Editor.

Si ce n’est pas déjà le cas, vous devez d’abord activer le paramètre upload_form_all_types comme ci-dessous.

$conf['upload_form_all_types'] = true;

Ensuite, vous devez ajouter heic au niveau du paramètre $conf['file'] comme dans l’exemple ci-dessous.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('jpg','jpeg','png','gif','heic')
  );

⚠️

Pour supporter les fichiers HEIC, vous devrez peut-être mettre à jour le système d’exploitation de votre serveur si vous utilisez un Piwigo auto-hébergé.

Fichiers vidéo et audio

Piwigo permet d'importer des fichiers audiovisuels avec les extensions suivantes :

.mp4
.m4v
.webm
.webmv
.ogg
.ogv
.mp3

ℹ️

Si vous hébergez vous-même votre Piwigo, vous devez installer et activer le plugin VideoJS pour accepter ce type de fichier. Si vous êtes client d’une offre piwigo.com, ce plugin est activé par défaut.

Lorsque vous importez un fichier vidéo dans Piwigo, une vignette de prévisualisation est créée à partir de la première image de votre vidéo. La vidéo est lisible depuis votre galerie, grâce au lecteur vidéo intégré à Piwigo. Vous pouvez lire la vidéo grâce au gros bouton de lecture.

Lorsque vous importez un fichier audio dans Piwigo, il sera représenté sur votre galerie par l'icône ci-dessous. Le fichier audio peut être écouté depuis votre galerie, grâce au lecteur intégré à Piwigo.

Pour activer le support des vidéos, si vous hébergez vous-même votre Piwigo, vous devez d’abord activer le paramètre upload_form_all_types comme ci-dessous (si ce n’est pas déjà fait) via le plugin LocalFiles Editor.

$conf['upload_form_all_types'] = true;

Vous devez ensuite ajouter les extensions souhaitées au niveau du paramètre $conf['file_ext'] comme dans l’exemple ci-dessous.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('mp4','webmv','m4v','webm')
  );

⚠️

Si vous utilisez une galerie auto-hébergée et que vous rencontrez des problèmes avec le téléchargement de vidéos ou la génération de vignettes, consultez cet article.

🎦 Cas particulier des vidéos MOV

Si vous enregistrez des vidéos depuis un iPhone, un iPad ou depuis le logiciel Quicktime pour Apple, les fichiers générés ont une extension .mov. Ce format de fichier n'est pas compatible avec Piwigo, car il ne s’affiche pas correctement dans les navigateurs web.

Mais il existe plusieurs moyens de les transférer quand même sur Piwigo.

Depuis l’application mobile Piwigo pour iOS

Depuis l'application mobile Piwigo pour iOS, vous allez pouvoir envoyer des vidéos MOV vers Piwigo. Les vidéos seront converties pendant le transfert en fichier .mp4. Elles seront donc lisibles depuis votre galerie, comme n'importe quelle autre vidéo.

Depuis l’administration Piwigo (vous hébergez Piwigo vous-même)

Si vous avez besoin de transférer des vidéos MOV depuis l'administration de Piwigo, c’est possible, mais par défaut, les vidéos ne sont pas visibles via le lecteur vidéo de votre galerie : il faudra les télécharger pour les visionner.

Pour que votre Piwigo accepte d’importer des fichiers .mov, vous devez modifier le paramètre $conf['file_ext'] et ajouter le format mov comme dans l’exemple ci-dessous avec LocalFiles Editor.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('mp4','webmv','m4v','webm','mov')
  );

Vous pouvez aussi faire le choix de convertir vos fichiers .mov au format MP4 avant de les importer dans Piwigo, ce qui a deux avantages :

Les vidéos seront lisibles depuis votre galerie Piwigo ;
Leur poids sera fortement réduit.

Pour savoir comment convertir un fichier, lire le chapitre suivant.

Depuis l’administration Piwigo (clients piwigo.com uniquement)

Si vous êtes client d’une offre d’abonnement piwigo.com, vous pouvez demander au support la mise en place de la conversion automatique des fichiers .mov vers .mp4.

Si nous activons cette option, les fichiers .mov importés dans Piwigo depuis l’administration seront automatiquement convertis en .mp4. Au moment du téléchargement, l’utilisateur choisira si il souhaite télécharger la version .mov ou la version .mp4.

⚠️

Attention ! Si vous choisissez d’activer cette option, cela utilise une place plus importante sur votre espace de stockage, car chaque vidéo est stockée en deux versions, et car les fichiers .mov sont très volumineux.

Vous pouvez aussi faire le choix de convertir vos fichiers .mov au format MP4 avant de les importer dans Piwigo, ce qui a deux avantages :

Les vidéos seront lisibles depuis votre galerie Piwigo ;
Leur poids sera fortement réduit.

Pour savoir comment convertir un fichier, lire le chapitre suivant.

🎦 Convertir vos fichiers vidéo

Si vous souhaitez importer un fichier vidéo non supporté par Piwigo (par exemple, un fichier AVI), il vous suffit de convertir vos fichiers vidéo vers le format MP4 : vous pouvez le faire avec de nombreux logiciels de montage vidéo, ou encore avec des outils gratuits en ligne comme celui-ci.

ℹ️

Nous conseillons le format de fichier MP4 avec un codec vidéo H.264 et audio AAC. Cela permet de conserver un haut degré de qualité même quand la vidéo est compressée. Les fichiers MP4 encodés de cette façon pèsent moins lourds : ainsi, ils consomment moins d'espace de stockage, et économisent de la bande passante. Enfin, cela garantit la compatibilité avec les lecteurs vidéo.

⚙️ Configuration du plugin VideoJS

On l’a vu, c’est le plugin VideoJS qui permet de gérer les fichiers vidéo dans Piwigo. Ce plugin utilise le lecteur vidéo open source VideoJS.

La configuration du plugin VideoJS vous donne accès à un certain nombre d’options.

Afficher le nombre de vidéos dans votre galerie
Choisir le comportement du lecteur vidéo (préchargement ou pas de la vidéo, lecture automatique, lecture en boucle, affichage ou non des boutons de lecture/pause, volume, langue du lecteur).
Personnaliser le style du lecteur vidéo en choisissant parmi les styles disponibles ou en ajoutant du code CSS personnalisé
Définir la hauteur maximum de la vidéo
etc.

Vous trouverez une documentation détaillée du plugin VidéoJS sur sa page GitHub.

⭐️ Autres formats de fichiers

Ces formats de fichier sont réservé aux clients d’une offre Équipe, Entreprise ou VIP sur piwigo.com, et aux utilisateurs qui hébergent eux-même leur Piwigo.

Fichiers PDF
Fichiers SVG
Fichiers EPS
Fichiers TIF et TIFF
Fichier PSD (générés par Adobe Photoshop)
Fichiers AI (générés par Adobe Illustrator)

Pour ce type de fichiers, Piwigo génère une prévisualisation qui les rend consultables dans l'administration et dans votre galerie.

Pour activer le support de ces fichiers, si vous hébergez vous-même votre Piwigo, vous devez d’abord activer le paramètre upload_form_all_types comme ci-dessous (si ce n’est pas déjà fait) via le plugin LocalFiles Editor.

$conf['upload_form_all_types'] = true;

Vous devez ensuite ajouter les extensions souhaitées au niveau du paramètre $conf['file_ext'] comme dans l’exemple ci-dessous.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('pdf','ai','psd','eps')
  );

⚠️

Si vous utilisez une galerie auto-hébergée et que vous rencontrez des problèmes avec la génération de vignettes pour les fichiers PDF, ou la visualisation des fichiers AI, PSD, HEIC, TIF ou TIFF, consultez cet article.

Cas particulier des fichiers PDF dans Piwigo

Pour les fichiers PDF, Piwigo génère un aperçu en extrayant la première page et en la convertissant en image. Cette image est affichée dans l'album.

Depuis Piwigo 15, sur la page du fichier, Piwigo embarque un lecteur PDF qui permet de lire le fichier.

Vous pouvez également cliquer sur l’icône « Télécharger ce fichier » : vous téléchargerez le document sur votre ordinateur.

📄 Autres formats de documents

Si vous avez besoin d'importer d'autres formats de fichiers dans un compte hébergé sur piwigo.com (Excel, Word, Open Office...), vous pouvez en faire la demande en contactant le support si vous êtes un client piwigo.com, ou en modifiant votre fichier de configuration si vous hébergez vous-même votre Piwigo.

Ces fichiers ne seront pas lisibles directement sur Piwigo, mais ils pourront être téléchargés pour être ouverts ensuite dans le logiciel qui convient.

Piwigo n’étant pas capable de créer une prévisualisation du document, il affichera une icône générique à la place.

Vous pouvez aussi, grâce au plugin Photo Update, ajouter votre propre prévisualisation.

Formats multiples : proposez plusieurs formats pour une même image

Si vous souhaitez pouvoir proposer différents formats de fichiers pour une même image sur votre galerie (par exemple, un format JPG, un format PNG et un format PSD), c’est possible ! Pour cela, vous devez activer l’option Formats Multiples.

En savoir plus sur les formats multiples

ℹ️

Si vous êtes client d’une offre piwigo.com, cette fonctionnalité n’est accessible qu’à partir de l’offre Entreprise.

Embedded Videos: Embarquez sur votre galerie des fichiers hébergés sur d'autres plateformes (Youtube...)

Vous souhaitez afficher sur votre galerie des contenus déjà hébergés ailleurs, comme par exemple, des vidéos issues de votre chaîne Youtube ?

C'est possible grâce au plugin Embedded Videos.

Avec ce plugin, vous pourrez afficher dans les albums de votre choix des vidéos issues des plateformes externes comme Youtube, Vimeo ou Dailymotion.

Une fois le plugin activé, pour ajouter une vidéo externe à votre galerie, rendez vous dans la configuration du plugin.

Vous pouvez alors choisir dans quel album ajouter une vidéo.

Par défaut, la page permet d’ajouter une vidéo depuis les plateformes d’hébergement Youtube, Dailymotion, Vimeo, Wat et Wideo, en donnant simplement l’URL de la vidéo.

Vous pouvez choisir l’album dans lequel vous souhaitez que la vidéo soit visible, ainsi que d’autres paramètres (taille de la vidéo, récupérer la description et les tags, etc).

L’onglet “Ajouter un code d’intégration” vous permet d’ajouter directement un code “embedded” depuis une autre plateforme. Il ne doit pas être utilisé pour les plateformes Youtube, Dailymotion, Vimeo, Wat et Wideo.

L’onglet Configuration du plugin permet de définir certains paramètres globaux du plugin:

taille par défaut des vidéos
démarrage automatique ou non
récupération automatique de la description et des tags de la vidéo
paramètres du lecteur (pour Vimeo et Dailymotion)

Problème connu avec le plugin Embedded Videos

Si vous hébergez vous-même votre Piwigo et que vous avez un message d’erreur en utilisant ce plugin, ajoutez le code suivant dans votre fichier de configuration via le plugin LocalFiles Editor.

$conf['show_php_errors'] = E_ALL ^ E_DEPRECATED ^ E_WARNING;

Panorama : Gérer les images panoramiques

Les panoramas sont des photos classiques mais dont la largeur est particulièrement importante par rapport à la hauteur. Ce sont souvent des photos prises avec un appareil en mode “panoramique”.

Ces photos sont gérées sans problème par Piwigo, mais leur format particulier n’est pas spécialement mis en valeur.

Une photo panoramique

Si vous souhaitez offrir aux visiteurs de la galerie la possibilité de naviguer au sein d’une photo panoramique, vous pouvez utiliser le plugin Panoramas.

Une fois ce plugin activé, il applique aux photos que vous aurez choisies un mode de visualisation différent, comme vous pouvez le voir ci-dessous.

Les paramètres de configuration du plugin vous donnent de nombreuses possibilités de personnalisation.

Pour définir quelles photos doivent être présentées en mode Panorama (180 ou 360°), Piwigo s’appuie sur leur nom.

Par défaut, les photos doivent intégrer _180 ou _360 dans leur nom pour être affichées en mode Panorama, mais c’est paramétrable.

Sommaire de l’article

Clients piwigo.com et auto-hébergement : les différences
Fichiers images
Précisions sur le format .gif
Précisions sur le format .webp
Cas particulier du format HEIC
Fichiers vidéo et audio
🎦 Cas particulier des vidéos MOV
🎦 Convertir vos fichiers vidéo
⚙️ Configuration du plugin VideoJS
⭐️ Autres formats de fichiers
Cas particulier des fichiers PDF dans Piwigo
📄 Autres formats de documents
Formats multiples : proposez plusieurs formats pour une même image
Embedded Videos: Embarquez sur votre galerie des fichiers hébergés sur d'autres plateformes (Youtube...)
Problème connu avec le plugin Embedded Videos
Panorama : Gérer les images panoramiques

← Précédent

📤Importer des photos dans Piwigo

🖼️Modifier ou supprimer une photo