Mucho ha cambiado desde la locura que fue http://drupal.org/node/1092444 . Afortunadamente, el tema y la configuración de los formateadores de visualización para las entidades de archivo ahora es mucho más fácil y directo.
La siguiente documentación es para Media 2.xy Entidad de archivo , aunque gran parte funciona con Media 1.x con ligeras alteraciones (por ejemplo, en Media 1.x, el enlace a la página "Tipos de archivo" está en Configuración en lugar de Estructura )
Mostrar medios
Los módulos de Entidad de archivo y Medios trabajan juntos para proporcionar un método unificado para almacenar, administrar y mostrar Medios en Drupal. Permiten al usuario crear campos de archivo que se pueden configurar para almacenar y mostrar muchos tipos diferentes de medios, incluidas imágenes, video y audio. entre otros. Para mostrar estos diferentes tipos de medios, los campos de archivo necesitan formateadores, a menudo proporcionados por el módulo que proporciona el tipo de medios, y una pequeña configuración adicional.
Definiciones
Explicaré primero un par de partes móviles y luego comenzaré a personalizar la visualización de archivos en un sitio.
Tipos de archivo
Los archivos se agrupan en tipos de archivo . Cada tipo de archivo está definido por una lista de tipos MIME , una forma universal de especificar formatos de archivo en Internet. Los tipos de archivo predeterminados son Aplicación, Audio, Imagen, Texto, Video y Otros. Actualmente no hay forma de definir nuevos tipos de archivos en la interfaz de usuario.
Ver modos
Los modos de visualización se utilizan para decirle a Drupal 7 (y pronto 8) que un contenido se encuentra en un determinado contexto. El contenido se puede modificar o mostrar de la manera que mejor se adapte a ese contexto. Dos modos de vista con los que la mayoría de la gente probablemente esté familiarizada son el avance predeterminado y los modos completos . Los modos de vista personalizados se pueden definir con módulos como Entity View Mode , Display Suite o en un módulo personalizado con hook_entity_info_alter()
.
The Good Stuff, o: Administrar la visualización de su campo de archivo
La visualización de un campo de archivo se gestiona por tipo de archivo . Navegue a Estructura -> Tipos de archivo. Verá una lista de tipos de archivos disponibles con enlaces a "Administrar campos", "Administrar visualización" y "Administrar visualización de archivos" para cada uno.
Administrar campos
El módulo de entidad de archivo hace que todos los archivos sean entidades de campo completo, lo mismo que los nodos y los términos de taxonomía. Al igual que en la sección "Tipos de contenido", puede agregar campos personalizados a cada tipo de archivo.
Gestionar pantalla
Nuevamente, como en "Tipos de contenido", puede administrar la visualización de campos personalizados en cada tipo de archivo. Esta sección no controla el formato de los archivos en sí , solo la visualización de los campos adjuntos a la entidad del archivo.
En esta sección también verá una opción para "Configuración de pantalla personalizada". Cuando se expande, puede habilitar y deshabilitar los modos de vista disponibles para esta entidad. Aquí se debe marcar un modo de visualización para que esté disponible en "Administrar visualización de archivos". En este momento, se recomienda usar solo modos de vista personalizados definidos por el usuario y los siguientes modos de vista predeterminados; el resto se deja de la integración del módulo de estilos y finalmente se eliminará :
- "Teaser" (Actualmente no está incluido de manera predeterminada. Puede agregarlo con el parche en el problema anterior o definirlo como un modo de vista personalizada)
- "Lleno"
- "Vista previa" (utilizado en contextos de administración, por ejemplo, para marcadores de posición en campos WYSIWYG, en el navegador de medios y en el widget de campo de medios)
Administrar visualización de archivos
En "Gestionar visualización de archivos" puede configurar formateadores para sus tipos de archivos (¡sí!). Muchos módulos de proveedores de medios agregan sus propios formateadores aquí; por ejemplo, Media: Youtube y Media: Vimeo proporcionan una "Vista previa de imagen" y un formateador de "Video".
Los formateadores se pueden habilitar y configurar para cada modo de vista habilitado en la sección "Administrar pantalla" de su tipo de archivo. Por ejemplo, un usuario puede querer mostrar una imagen de vista previa de Medios: Vimeo cuando un nodo se ve como un avance, el video de Vimeo cuando se ve el nodo completo y un video con diferentes configuraciones de formateador de ancho y alto cuando se ve el nodo con un modo de visualización personalizado llamado "galería de videos". Muchos formateadores (especialmente "Imagen") permiten al usuario seleccionar los estilos de imagen que han definido en Configuración -> Estilos de imagen.
Debido a que múltiples proveedores de medios pueden usar el mismo campo, los formateadores se organizan en una cascada de arriba a abajo. Drupal utilizará el primer formateador que se puede aplicar a la salida de un campo. Si un campo de video habilita los formateadores "Medios: Video de Youtube", "Medios: Video de Vimeo" e "Icono de tipo de archivo grande" para el modo de vista "Completo", Drupal usará el formateador de Youtube si el tipo de archivo MIME es video/youtube
, el Vimeo formateador si el tipo mime es video/vimeo
, y recurrir al icono de tipo de archivo grande si el tipo mime es video/{anything else}
.
Configurar el campo de archivo para mostrar usando la configuración "Administrar visualización de archivo"
Para que el campo de archivo se muestre utilizando los formateadores definidos en "Administrar visualización de archivo", debe configurarse para mostrar el "archivo renderizado". Vaya a la página "Administrar pantalla" para ver el tipo de contenido que contiene su campo de archivo. Elija "Archivo representado" como el formato del campo de archivo para todos los modos de visualización en los que desea utilizar los formateadores definidos en "Administrar visualización de archivos".
Tematización adicional
Puede crear funciones de tema personalizadas y archivos de plantilla para un mayor control con las anulaciones de enlace de tema . Las sugerencias de temas proporcionadas por el módulo de entidad de archivo son:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
Reemplace todos '/' y '__' en tipos MIME con '_' para funciones de tema y '-' para archivos de plantilla.
Algunos módulos de proveedores de medios los reemplazan con sus propias plantillas y sugerencias de enlace de temas. Puede ver todas las sugerencias de ganchos de temas disponibles con el módulo Desarrollador de temas de Devel , Mothership's Poor Themer's Helper , o con suerte consultar los documentos del proveedor para obtener más información.
Outro
Espero que esto ayude. Planeo agregar esto a la documentación de los medios, por lo que si me perdí algo, escribí mal en alguna parte o una sección necesita aclaración, hágamelo saber.
Y algunas respuestas cortas a las preguntas específicas del OP:
- Media 1.x vs 2.x: aunque 2.x es inestable, es tan confiable como muchos módulos de versión estable en Drupal.org. Creo que vale la pena usarlo para las funciones enormemente mejoradas, pero debido a que hay mucho trabajo en marcha, el soporte en la cola de problemas es lento, y como con cualquier rama de desarrollo, las nuevas actualizaciones pueden interrumpir su implementación. Aún así, lo uso en producción.
- Los medios están en desarrollo. Algunas cosas no funcionan como es de esperar (por ejemplo, integración WYSIWYG sin imagen). Pero aún funciona mejor en lo que hace que la combinación de módulos que tiene que instalar para hacer lo que hace sin él. Y está mejorando.