Fait avec Chinaski

Médiathèque

La médiathèque contient chaque image que vous utilisez sur le site. Téléchargez une fois, puis insérez dans pages, posts et blocks depuis le même sélecteur partout. Cette page couvre le téléchargement, les variantes de taille automatiques, les détails par image que vous pouvez éditer, et le comportement de la suppression quand le contenu référence un fichier.

Téléchargement

  • Dans la zone Media de l'admin, choisissez Upload et sélectionnez un ou plusieurs fichiers d'un coup (chacun jusqu'à 10 Mo).
  • Types d'images acceptés : JPEG, PNG, GIF, et WebP. Tout le reste est rejeté (les documents comme les PDF et fichiers Office relèvent du module Documents ; les champs de téléchargement de fichiers de formulaires ont leur propre jeu d'acceptation).
  • Quelques vérifications de sécurité s'exécutent sur chaque téléchargement avant que le fichier ne soit visible nulle part :
    • Le fichier doit être ce que son type prétend : le contenu est inspecté, pas seulement l'extension déclarée. Un fichier renommé aux contenus incompatibles est refusé.
    • Un fichier identique déjà dans la médiathèque est refusé avec un pointeur vers l'élément existant (« déjà stocké sous … »), ce qui évite les doublons accidentels.
  • Le nom de fichier stocké est randomisé sur le serveur ; le nom que vous voyez dans la médiathèque est le nom de fichier original téléchargé, que vous pouvez modifier plus tard.

Ce qui se passe après le téléchargement

Le traitement s'exécute en arrière-plan dès que votre téléchargement se termine :

  • Les images sont optimisées. Les JPEG sont recomprimés à une qualité web correcte ; les PNG sont recomprimés à compression maximale. Cela se fait une fois, côté serveur.
  • Les tailles responsives sont créées. Pour les images JPEG et PNG plus larges que 320 px, la médiathèque génère des versions 320, 640 et 1280 pixels : chacune au format original et en plus en WebP. Les thèmes les utilisent pour servir automatiquement des images de taille adaptée aux téléphones et aux ordinateurs de bureau.
  • Les dimensions sont enregistrées (largeur/hauteur en pixels), affichées dans les détails de l'élément.
  • Si une image est excessive en dimensions (plus de 10 000 pixels dans une direction), elle est refusée comme possible attaque de décompression plutôt que de mettre le serveur à bas.
  • Les GIF et WebP sont stockés tels quels : aucune recompression ni variante dimensionnelle n'est créée pour eux.

La vue de la médiathèque

  • Les dossiers permettent l'organisation : attribuez un nom de dossier à n'importe quelle image, et la barre latérale liste tous vos dossiers pour un filtrage rapide.
  • La recherche porte sur le nom de fichier original, le texte alternatif et le nom de fichier stocké. Trier par plus récent, nom, ou taille de fichier.
  • Le nombre par page est grand (100 éléments ; 50 quand la médiathèque est ouverte comme sélecteur depuis l'éditeur).
  • Ouverte comme sélecteur à l'intérieur de l'éditeur de page/post, la médiathèque se comporte comme un sélecteur : choisir une image l'insère dans le contenu à l'emplacement du curseur.

Détails éditables par image

Ouvrez un élément pour l'éditer :

  • Nom de fichier (nom affiché) et texte alternatif : le texte alternatif décrit l'image pour les lecteurs d'écran et le SEO ; il vaut par défaut le nom de fichier original au téléchargement et mérite d'être renseigné délibérément.
  • Dossier, légende et crédit : la légende et le crédit sont exposés aux thèmes à des fins d'affichage.
  • Remplacer le fichier : télécharger une nouvelle version de l'image sur place. Le nom de fichier reste le même, donc chaque page et block qui référence déjà l'image continue de fonctionner, et le pipeline d'optimisation/variantes s'exécute à nouveau sur le nouveau fichier. Le remplacement est limité aux admins ou à la personne qui a téléchargé l'image.
  • Rapport d'utilisation : la page de l'élément montre partout où il est référencé dans votre contenu, avec des liens vers chaque élément.
  • Révisions : les modifications de métadonnées sont enregistrées en instantanés, donc des noms/textes alt antérieurs peuvent être restaurés à distance comme les autres révisions de contenu.

Suppression

  • La suppression déplace les éléments à la corbeille, avec un lien d'annulation immédiat et une restauration depuis la corbeille ensuite.
  • Un fichier référencé par des pages, posts ou blocks en ligne ne peut pas être supprimé : les erreurs nomment les pages qui le référencent pour que vous puissiez d'abord retirer ces usages. Seuls les fichiers réellement non utilisés peuvent être mis à la corbeille, puis supprimés définitivement.
  • Exportez les métadonnées de la médiathèque comme fichier JSON (pratique pour un inventaire ou comme point de départ d'une migration), et les admins peuvent importer des métadonnées depuis ce même format.

Conseils pratiques

  • Renseignez le texte alternatif au moment du téléchargement : il vaut par défaut le nom du fichier, ce qui est rarement convivial pour le lecteur.
  • Préférez télécharger l'image de la plus haute résolution que vous avez (jusqu'à 10 Mo) : la médiathèque dérive elle-même les tailles plus petites, donc garder le fichier original grand comme maître maintient l'ensemble responsive cohérent.
  • Les dossiers ne servent qu'à l'organisation : déplacer un élément dans un dossier ne change ni son URL ni aucune référence existante.
Lisez ce site en