module media
Le module File définit un type de fichier pour le module Field. On peux y gérer l'emplacement des fichiers (rep publique ou privé). On peux ajouter ces champs aux types de contenus, commentaires, termes de taxonomie, au niveau du site ou des comptes users. Cf admin/reports/fields et https://drupal.org/node/1591498
Le module image fait partie du core de drupal 7 (et non du 6), et manipule les images (cf admin/config/media/image-styles et https://drupal.org/documentation/modules/image)
En mai 2018 : media 7.x-2.19, 8.4 a un module core intégré. Doc officielle.
Media
Deux facon d'utiliser ce module pour gérer des images: soit en ajoutant un champ File à un type de contenu, soit à l'intérieur de la balise body à l'aide de CKEditor (ou autre module WYSIIG) et de l'icone (dans ce cas, à admin/content/file on voit usage à 1 mais on ne peux pas savoir dans quel noeud est l'image).
Media ajoute 4 type de fichiers, modifie le comportement de drupal à l'ajout de champ fichier et surtout, modifie la facon dont c'est affiché.
Pour que le fichier utilise les paramètres de "Manage File Display", il doit être mis en "rendered file" (page "Manage Display" pour le type de contenu qui a ce champ).
Gestion affichage (des champs créés dans un type de contenu)
Voir page officielle (en anglais) à https://drupal.org/node/1793548
pour les images (ici en mode preview) c'est à admin/structure/file-types/manage/image/display/preview mais dans format, il n'y a que caché ou visible. En l'ajoutant dans un champs image/Media file sel, il apparait en bas de la page (book). Et sur ce mode Apercu, drupal affiche une erreur: "Some modules rely on the Preview view mode to function correctly. Changing these settings may break parts of your site."
File entity se configure via admin/config/media/file-settings
v Media 7.x-2.0-unstable7
- quick start v2 à drupal.org/node/1699054
qd on ajoute un chp fichier, Media prend le relais.
Son affichage ? Display Handlers: You select a number of these Displays and Drupal will start at the top and try to use that method. If it fails, it goes to the next one. For ex, if you pick Image for a text file, it can't display an image, so it will try the next option, such as URL to File. Display Handler Settings are further options to configure how each Handler works.
Example (ajout champ fichier avec widget Media file affiché avec un style)
Ajout d'une image dans un node et l'afficher comme une image en 200px by 300px.
Créer un champ File avec le widget Media File Selector (paramétré pour ne selectionner que les images). On crée un style d'image nommé 200by300. Ensuite, on modifie de mode d'affichage par défaut (Default View Mode) pour le type de fichier Image et on y sélectionne Image Handler. On voit alors, sous Image Handler Settings, une liste "Image Style" où se trouve listé notre 200by300 .
dans type "article":
- ajout champs de type file, widget media file sel
- cocher "upload", "view library" et "web" (library est ko) ; choix .ext
- onglet "manage display" de article (admin/structure/types/manage/article/display/full): Format Rendered File (pour que Media en gère l'affichage, et nous permette de choisir le mode d'affichage et le Handler à utiliser. Note: le View Mode est mis à Default -> voir plus bas le titre "La liste format")
- création style d'image à admin/config/media/image-styles - attention au nommage (voir aussi )
- admin/structure/file-types/manage/image/display -> où on gère l'affichage des modes view des images sous "Custom Display Settings" / "Paramètres d'affichage personnalisés": sel les modes dispo (complet, accroche, apercu, token... ou crées avec par ex Entity View Mode module + vider le cache de Drupal)
-
admin/structure/file-types/manage/image/file-display : View Modes en haut à droite, Display Handlers à gauche : pour défault, choisir image
en choisir plusieurs -> drupal les essaie de "haut en bas" ;) puis en bas: choix taille image (crée au point 4) -
Enfin, le Theme prend le relais : récupérer file_entity.tpl.php du module file_entity, et l'appeler avec la syntaxe file--<file-type>--<view-mode>.tpl.php
ex: file--image--preview.tpl.php ; file--video--my-custom-view-mode.tpl.php
CKEditor 7.x-1.13 et lib 3.6.2 (media bug avec la 4). mais la bib est en ckeditor/ckeditor et non en sites/all/libraries
liste des champs de type media et file
Le cas typique: à l'install, on a le module image de base de drupal (et on l'utilise). Puis, on active media, et on change le widget des champs image sans lire la doc...
nom champs | type de contenu | type de champs |
type de champ et de widget |
étiquette | conf |
---|---|---|---|---|---|
field_doc | book | Fichier (module : File) | fichier - Fichier | doc |
3 max avec Throbber |
field_image | book | Image (module : Image) | Image - Media file selector | Image | 5 max dans field/image |
field_image | article | " | Image - Media file selector | Image | " |
field_liimg | livres (projet bib) | Fichier (module : File) | Fichier - Media file sel | ||
field_frmg | sujet de forum | Fichier (module : File) | " | ||
field_ardoctek | article | Fichier (module : File) | * | 1 |
liste des champs à admin/reports/fields
La liste format (admin/structure/types/manage/type-de-contenu/display)
Champs de type Image + Media File Sel | Champs de type file + Media File Sel |
---|---|
fichier générique | |
tableau de fichier | |
url fichier | |
rendered file | rendered file |
dl link | dl link |
image | Audio |
Video | |
Large filetype icon | |
caché | Caché |
En y choisissant "Rendered File" apparait alors "View mode: Par défaut" et un bouton, qui permet d'utiliser les paramètres d'affichage personnalisés (complet, accroche, apercu, rss, token...).
Example (ajout champ fichier bash avec widget Media file) - avril/mai 2014
Dans le type de contenu article, ajout d'un champs file avec widget Media file (et définition chemin). Il faut d'abord ajouter le type mime dans Document (/admin/structure/file-types/manage/document/edit), sinon, on a une erreur.
Suppression
Le bouton "retirer" efface le fichier du srv.
Sur le web
Update dec 2014:
Parcourir https://www.drupal.org/node/627244
Media travaille avec file_entity Insert Field Gestion fichier: IMCE ou webfm (drupal 6)
media-persostyle.jpg
