Muita coisa mudou desde a loucura que era http://drupal.org/node/1092444 . Felizmente, a definição de temas e a configuração de formatadores para entidades de arquivo agora é muito mais fácil e direta.
A documentação a seguir é para o Media 2.xe Entidade do arquivo , embora grande parte funcione com o Media 1.x com pequenas alterações (por exemplo, no Media 1.x, o link para a página "Tipos de arquivo" está em Configuração em vez de Estrutura )
Exibição de mídia
Os módulos Entidade de arquivo e Mídia trabalham juntos para fornecer um método unificado para armazenar, gerenciar e exibir Mídia no Drupal. Eles permitem que o usuário crie campos de arquivos que podem ser configurados para armazenar e exibir muitos tipos diferentes de mídia, incluindo imagens, vídeo e áudio. entre outros. Para exibir esses diferentes tipos de mídia, os campos de arquivo precisam de formatadores, geralmente fornecidos pelo módulo que fornece o tipo de mídia, e um pouco de configuração extra.
Definições
Vou explicar algumas das partes móveis primeiro e depois personalizar a exibição dos arquivos em um site.
Tipos de arquivo
Os arquivos são agrupados em Tipos de arquivo . Cada tipo de arquivo é definido por uma lista de tipos MIME , uma maneira universal de especificar formatos de arquivo na Internet. Os tipos de arquivo padrão são Aplicativo, Áudio, Imagem, Texto, Vídeo e Outro. No momento, não há como definir novos tipos de arquivo na interface do usuário.
Modos de exibição
Os modos de exibição são usados para informar ao Drupal 7 (e em breve 8) que um conteúdo está em um determinado contexto. O conteúdo pode ser alterado ou exibido da maneira que melhor se adequar a esse contexto. Dois modos de exibição com os quais a maioria das pessoas provavelmente conhece: o teaser padrão e o modo completo . Os modos de exibição personalizados podem ser definidos com módulos como o Modo de Exibição de Entidade , Suíte de Display ou em um módulo personalizado com hook_entity_info_alter()
.
The Good Stuff, ou: Gerenciando a exibição do seu campo File
A exibição de um campo de arquivo é gerenciada por tipo de arquivo . Navegue para Estrutura -> Tipos de arquivo. Você verá uma lista dos tipos de arquivos disponíveis com links para "Gerenciar campos", "Gerenciar exibição" e "Gerenciar exibição de arquivos" para cada um.
Gerenciar campos
O módulo Entidade do arquivo torna todos os arquivos entidades de campo completas, o mesmo que nós e termos de taxonomia. Assim como na seção "Tipos de conteúdo", você pode adicionar campos personalizados a cada tipo de arquivo.
Gerenciar exibição
Novamente, como em "Tipos de conteúdo", você pode gerenciar a exibição de campos personalizados em cada tipo de arquivo. Esta seção não controla a formatação dos arquivos , apenas a exibição dos campos anexados à entidade do arquivo.
Nesta seção, você também verá uma alternância para "Configurações de exibição personalizadas". Quando expandido, você pode ativar e desativar os modos de exibição disponíveis para esta entidade. Um modo de visualização deve ser verificado aqui para que esteja disponível em "Gerenciar a exibição de arquivos". No momento, é recomendável usar apenas modos de visualização personalizados definidos pelo usuário e os seguintes modos de visualização padrão; o restante é deixado na integração do módulo Styles e, eventualmente, será removido :
- "Teaser" (atualmente não incluído por padrão. Você pode adicioná-lo com o patch na edição acima ou defini-lo como um modo de exibição personalizado)
- "Cheio"
- "Visualização" (usado em contextos de administração, por exemplo, para espaços reservados nos campos WYSIWYG, no navegador de mídia e no widget do campo Mídia)
Gerenciar a exibição do arquivo
Em "Gerenciar exibição de arquivos", você pode configurar formatadores para seus tipos de arquivos (sim!). Muitos módulos de provedor de mídia adicionam seus próprios formatadores aqui; por exemplo, Media: Youtube e Media: Vimeo fornecem um formatador "Preview Image" e "Video".
Os formatadores podem ser ativados e configurados para cada modo de exibição ativado na seção "Gerenciar exibição" do tipo de arquivo. Por exemplo, um usuário pode exibir uma imagem de visualização Media: Vimeo quando um nó é visualizado como provocação, o vídeo do Vimeo quando o nó completo é visualizado e um vídeo com configurações diferentes do formatador de largura e altura quando o nó é visualizado com um modo de visualização personalizado chamado "galeria de vídeos". Muitos formatadores (principalmente "Imagem") permitem ao usuário selecionar os estilos de imagem que eles definiram em Configuração -> Estilos de imagem.
Como vários provedores de mídia podem usar o mesmo campo, os formatadores são organizados em uma cascata de cima para baixo. O Drupal usará o primeiro formatador que pode ser aplicado à saída de um campo. Se um campo de vídeo ativar os formatadores "Mídia: vídeo do Youtube", "Mídia: vídeo do Vimeo" e "Ícone de tipo de arquivo grande" para o modo de exibição "Completo", o Drupal usará o formatador do YouTube se o tipo de mímica do arquivo for video/youtube
o Vimeo formatador se o tipo MIME for video/vimeo
e volte ao ícone do tipo de arquivo grande se o tipo MIME for video/{anything else}
.
Configurando o campo de arquivo para exibição usando as configurações "Gerenciar exibição de arquivo"
Para que o campo de arquivo seja exibido usando os formatadores definidos em "Gerenciar exibição de arquivo", ele deve ser definido para exibir o "arquivo renderizado". Navegue até a página "Gerenciar exibição" do tipo de conteúdo que contém o campo do arquivo. Escolha "Arquivo renderizado" como o formato do campo de arquivo para todos os modos de exibição nos quais você gostaria de usar os formatadores definidos em "Gerenciar exibição de arquivos".
Temas adicionais
Você pode criar funções de tema personalizadas e arquivos de modelo para ter ainda mais controle com substituições de gancho de tema . As sugestões de temas fornecidas pelo módulo File Entity são:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
Substitua todos os '/' e '__' nos tipos MIME por '_' para funções de tema e '-' para arquivos de modelo.
Alguns módulos do provedor de mídia os substituem por seus próprios modelos e sugestões de ganchos de temas. Você pode visualizar todas as sugestões de ganchos de temas disponíveis com o módulo Desenvolvedor de Temas , o Auxiliar de Pobres Temáticos da Mothership ou, esperançosamente, consultar os documentos do fornecedor para obter mais informações.
Outro
Espero que isto ajude. Pretendo adicioná-lo à documentação da Mídia, portanto, se eu perdi alguma coisa, escrevi errado em algum lugar ou uma seção precisa de esclarecimentos, por favor me avise.
E algumas respostas curtas para perguntas específicas do OP:
- Mídia 1.x vs 2.x: embora o 2.x seja instável, é tão confiável quanto muitos módulos de versão estável no Drupal.org. Eu acho que vale a pena usar para os recursos amplamente aprimorados, mas porque há muito trabalho em andamento no suporte na fila de problemas é lento e, como em qualquer filial do desenvolvedor, novas atualizações podem interromper sua implementação. Ainda assim, eu uso na produção.
- A mídia está em desenvolvimento. Algumas coisas ainda não funcionam como você esperaria (por exemplo, integração WYSIWYG sem imagem). Mas ainda funciona melhor no que faz do que na combinação de módulos que você precisa instalar para fazer o que faz sem ele. E está ficando melhor.