自从http://drupal.org/node/1092444的疯狂以来,发生了很多变化。幸运的是,现在为主题和设置文件实体的显示格式设置变得更加容易和直接。
以下文档适用于Media 2.x和File Entity,尽管其中的大部分内容都与Media 1.x一起使用,但稍有改动(例如,在Media 1.x中,指向“文件类型”页面的链接位于配置而非结构中) )。
显示媒体
该文件实体和媒体模块协同工作以提供用于存储,管理,并在Drupal显示媒体一个统一的方法。它们允许用户创建可配置为存储和显示许多不同类型的媒体(包括图像,视频和音频)的文件字段。其中。为了显示这些不同类型的媒体,文件字段需要格式化程序(通常由提供媒体类型的模块提供)以及一些额外的配置。
定义
我将先解释几个移动的部分,然后再自定义网站上文件的显示。
文件类型
文件分组为文件类型。每种文件类型都由mime类型列表定义,mime类型是在Internet上指定文件格式的通用方法。默认文件类型为应用程序,音频,图像,文本,视频和其他。当前无法在UI中定义新文件类型。
查看模式
视图模式用于告诉Drupal 7(以及不久的8)某个内容在特定上下文中。然后可以以最适合该上下文的方式更改或显示内容。大多数人可能会熟悉的两种查看模式是默认预告片和完整模式。定制视图模式可以用相似的模块来定义实体查看模式,显示套件,或在自定义模块用hook_entity_info_alter()
。
好东西,或:管理文件字段的显示
文件字段的显示按文件类型进行管理。导航到结构->文件类型。您将看到可用文件类型的列表,并分别具有指向“管理字段”,“管理显示”和“管理文件显示”的链接。
管理栏位
“文件实体”模块使所有文件都具有完整的可字段实体,与节点和分类法术语相同。就像在“内容类型”部分中一样,您可以向每个文件类型添加自定义字段。
管理显示
同样,就像在“内容类型”中一样,您可以管理每种文件类型上自定义字段的显示。本部分不控制文件本身的格式,仅控制附加到文件实体的字段的显示。
在此部分中,您还将看到“自定义显示设置”的切换。展开后,您可以启用和禁用此实体可用的视图模式。必须在此处检查视图模式,以使其在“管理文件显示”中可用。目前,建议仅使用用户定义的自定义视图模式和以下默认视图模式;其余部分保留在样式模块集成中,最终将被删除:
- “ Teaser”(当前默认情况下不包括在内。您可以在上述问题中将其与补丁一起添加,或将其定义为自定义查看模式)
- “充分”
- “预览”(在管理上下文中使用,例如,用于“所见即所得”字段,“媒体”浏览器和“媒体”字段小部件中的占位符)
管理文件显示
在“管理文件显示”中,您可以为文件类型配置格式化程序(是!)。许多Media provider模块在此处添加了自己的格式化程序。例如,媒体:Youtube和媒体:Vimeo都提供“预览图像”和“视频”格式化程序。
可以在其文件类型的“管理显示”部分为启用的每种查看模式启用和配置格式器。例如,用户可能希望在将节点视为预告片时显示媒体:Vimeo预览图像,在查看完整节点时显示Vimeo视频,以及在使用节点查看时显示具有不同宽度和高度格式设置的视频。自定义查看模式,称为“视频库”。许多格式器(尤其是“图像”)允许用户选择在“配置”->“图像样式”中定义的图像样式。
由于多个媒体提供者可以使用同一字段,因此格式设置器从上到下层叠排列。Drupal将使用第一个可应用于字段输出的格式化程序。如果视频字段启用了“完整”查看模式的“媒体:Youtube视频”,“媒体:Vimeo视频”和“大文件类型图标”格式化程序,则如果文件的mime类型为video/youtube
,则Drupal将使用Youtube格式化程序,即Vimeo如果MIME类型是格式化器,如果MIME类型是则video/vimeo
退回到大文件类型图标video/{anything else}
。
使用“管理文件显示”设置来配置要显示的文件字段
为了使用“管理文件显示”中定义的格式器显示文件字段,必须将其设置为显示“渲染的文件”。导航到“管理显示”页面以查找包含您的文件字段的内容类型。对于要使用在“管理文件显示”中定义的格式程序的所有视图模式,请选择“渲染的文件”作为文件字段的格式。
进一步的主题
您可以创建自定义主题功能和模板文件,以使用主题挂钩替代进行更多控制。文件实体模块提供的主题建议是:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
将哑剧类型中的所有“ /”和“ __”替换为主题功能的“ _”和模板文件的“-”。
某些媒体提供程序模块将其替换为自己的模板和主题挂钩建议。您可以使用Devel Theme Developer模块,Mothership的Poor Themer's Helper来查看所有可用的主题挂钩建议,或者希望查阅提供商的文档以获取更多信息。
奥托罗
希望这可以帮助。我打算将其添加到媒体文档中,因此,如果我错过了一些东西,在某个地方弄错了笔录,或者需要澄清一个部分,请告诉我。
以及针对OP特定问题的一些简短答案:
- 媒体1.x与2.x:即使2.x不稳定,它也与Drupal.org上的许多稳定版本模块一样可靠。我认为有必要使用经过大幅度改进的功能,但是由于问题队列中的支持工作量很大,因此与任何dev分支一样,新更新可能会破坏您的实现。我还是在生产中使用它。
- 媒体正在发展中。有些事情并没有您希望的那样工作(例如,非图像WYSIWYG集成)。但是,它仍然比您必须安装才能完成它的功能而组合的模块更好。而且越来越好。