Module MédiasFraza Libre

@fraza/module-medias/v0.3.2

Téléversez une fois, utilisez partout.

Une médiathèque partagée dans l’admin : images, documents, audio et vidéo, validés à l’envoi et rangés dans votre stockage objet. Les pages, les articles et les blocs image y puisent sans dépendre du module.

votre-projet.ca/admin/medias
La médiathèque, sa grille de vignettes, sa recherche et son filtre par typeLa médiathèque, sa grille de vignettes, sa recherche et son filtre par type
Formats
Image, document, audio, vidéo
Stockage
Compatible S3 : Backblaze ou R2
Optimisation
Redimensionnement, EXIF retiré
Licence
MIT, Fraza Libre

Fonctionnalités

Ce que Médias apporte à votre admin.

Une médiathèque partagée

Une grille de cent médias par page, une recherche sur le nom et un filtre par type. Le même fonds pour toute l’équipe et tous les contenus.

Branchée sur vos contenus

Le sélecteur d’image du BlockEditor, les champs image des articles et l’image de partage Open Graph s’activent dès l’installation.

Un envoi vérifié

Extension, taille, signature binaire et contenu sont contrôlés avant tout envoi. Le SVG est toujours refusé, parce qu’il peut transporter du script.

Des images allégées

Redimensionnées et recompressées dans leur format d’origine, sans métadonnées EXIF ni position GPS. Le GIF est laissé intact pour garder ses animations.

Renommer et remplacer sans rien casser

Les contenus référencent l’identifiant du média, pas son URL. Un renommage ou un remplacement de fichier garde toutes les références.

Actions groupées

Sélection multiple, copie des URL publiques, téléchargement en archive ZIP jusqu’à cent médias, suppression en lot.

Références

Un média utilisé ne disparaît pas par erreur.

Chaque lien entre un contenu et un média est inscrit en base. Tant qu’une page ou un article l’utilise, le média ne peut pas être supprimé, et le message indique combien de contenus le référencent. Le texte alternatif et la légende vivent sur la fiche du média : corrigés une fois, ils se propagent à chaque rendu.

  • Suppression refusée tant que le média est référencé
  • Texte alternatif et légende relus depuis la fiche à chaque rendu
  • Renommer change l’URL, pas les références
  • Sans le module, les façades du core restent neutres

Comment les références fonctionnent →

Pour les développeurs

Ajouter Médias à un projet.

Le module ajoute deux tables, une section d’admin, quatre permissions et le relais de la route publique /za/media/<nom>. Les fichiers vont dans le stockage objet du core, compatible S3 ; seules leurs métadonnées sont en base. Vos modules et blocs passent par les façades @fraza/core/media-registry, sans jamais importer le package.

Terminal
$ npm i @fraza/module-medias
$ npx fraza-db init
.env
FRAZA_MODULE_MEDIAS=true
FRAZA_MODULE_MEDIAS_OPTIMIZE_MAX_DIMENSION=3840
FRAZA_STORAGE_PROVIDER=r2
FRAZA_STORAGE_BUCKET=mon-projet-medias
Fraza Libre

Gratuit, sous licence MIT.

Médias fait partie de Fraza Libre : usage commercial permis, sans compte ni licence à acheter. Il s’installe depuis npm comme le core.

Questions

Questions fréquentes.

Le module est-il gratuit, même pour un projet commercial ?
Oui. Il est publié sous licence MIT, dans Fraza Libre, sur npmjs, sans compte ni clé de licence.
Où sont stockés les fichiers ?
Dans un stockage objet compatible S3, Backblaze ou Cloudflare R2, configuré au niveau du core. Le bucket n’a pas besoin d’être public : les fichiers passent par la route /za/media de votre projet.
Puis-je y déposer des documents privés ?
Non. La route publique ne vérifie ni session ni permission : tout fichier est lisible par quiconque connaît son nom. La médiathèque sert des contenus destinés à être diffusés.
Le module génère-t-il des vignettes et des tailles responsives ?
Non. Il garde un seul fichier optimisé par média, et laisse next/image redimensionner à la demande depuis l’URL publique.

Autres modules gratuits