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 icone de media (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

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":

  1. ajout champs de type file, widget media file sel
  2. cocher "upload", "view library" et "web" (library est ko) ; choix .ext
  3. 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")
  4. création style d'image à admin/config/media/image-styles - attention au nommage  (voir aussi )
  5. 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)
  6. 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)
  7. 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...

Liste des champs de type fichier
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)

contenu de la liste Format dans l'affichage des types de contenu
(admin/structure/types/manage/book/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)

Image (file bookimg): 

media-persostyle.jpg

assigner un style et un lien à une image (module media, Field File avec widget Media File Selector)
assigner un style et un lien à une image (module media 2)