Drupal jQuery Media(jQuery)模块

jQuery Media(jQuery)

它对jQuery Media插件做了简单的包装.jQuery Media插件能够自动的将链接转换为对应的多媒体,比如视频,音频等.这个模块最好和File field模块结合使用,但是也可以应用于其它情况.

基本配置

安装后,你需要访问模块的设置页面,并输入一些条目,来让模块正常工作.告诉它为哪些节点类型加载jquery media插件.如果这些节点类型里面包含了文件字段,那么它将自动正常工作.如果你的模块是从以前的老版本升级过来的,并且已经访问了设置页面,那么你可能需要返回,并向Classes部分添加.filefield-item a。

对于那些不适文件字段的链接，或者想只影响特定的文件字段，或者为了删除特定文件字段的自动转换，那么你需要手工的为对应的链接添加合适的CSS类。默认情况下，Classes部分使用.filefield-item a，有效节点类型中的所有文件字段都将被自动转换。如果你想更好的进行控制，那么你需要输入更具体的CSS标识符，这里使用逗号分隔，比如.field-video-file a, .field-audio-file a。

你还需要安装一个多媒体播放器，比如JW FLV Player或者Wimpy Rave。你还需要在Default players section（默认播放器部分）输入该播放器的路径。

这里还有更多的设置，比如播放器的宽/高和颜色，以及一些高级设置，比如特定的参数和flash变量（这对于加载屏幕，logo会有用处）。另外，你还可以在主题模板里面，来覆写这些全局设置，如下所示。在你启用了这个模块以后，一定要看看这个模块的帮助页面，这里面有最新的文档。

注意，Drupal 6 版本不再支持MediaBox的弹出效果了。因为有了更好的插件，支持这一点，比如Thickbox，lightbox。Drupal5版本的模块仍然支持MediaBox，更多信息可参看该版本的帮助页面。

强烈推荐联合使用jQ模块，当然这个模块是可选的。如果你想使用MediaBox功能的话，那么你需要下载jQuery BlockUI模块（你还需要将你的jquery升级到1.2.3）

高级定制

主题化超出了这个帮助页面的范围。更多信息可参看zhupou.cn上的Drupal主题制作指南。当你准备好对元素定制主题时，你只需要为其添加一个css类，并触发这个插件就可以了。例如，如果你有一个视频文件字段（file field），简单的使用下面的代码就可以了：

<?php

jq_add('jquery_media'); print l($node->title, $node->field_file_field[0]['filepath'], array('class' => 'media'));

在配置的时候，你可以覆写这个插件的全局默认值。另外，你还可以在一个可选的数组中实现覆写，当触发这个插件时，会根据具体的情况进行判断。例如，你可能会在一个特定的页面覆写播放器的背景颜色，这样就可以了jq_add('jquery_media', array('bgcolor' => '#33FF00'));。对于这个页面的所有多媒体链接，这段代码将会覆写插件的默认值。

全局覆写的完整数组如下：

'flvplayer' => 所用的Flash视频播放器的路径，比如JW FLV Player 或者Wimpy Rave。

'mp3player' => 所用的MP3音频播放器的路径，比如JW FLV播放器或者 Wimpy MP3 播放器。

'media width' =>多媒体显示的宽度。

'media height' =>多媒体显示的高度。

'autoplay' =>如果为真，加载时就会立即播放。

'bgcolor' =>这是多媒体播放器的背景洋色，采用16进制代码(#RRGGBB)。

'invoke media' =>如果为真，当触发插件时，所有带有'media class' 的链接都会自动地转换为对应的多媒体。

'media class' =>对应的CSS类，它们将被转换为对应的多媒体。

最后，你可以对全局设置进行覆写。这里的定制变化很多，这里就不多讲了，更多的信息你可以参看jQuery Media的主页。作为一个例子，你可以使用下面的代码设置特定文件的大小，而对于该页面的其他jquery media链接，则使用它们的默认设置：

<?php

print l($node->title, $node->field_audio_file, array('class' => 'media-audio')); drupal_add_js("$('a.media-audio').media( { width: 200, height: 15, autoplay: true } )", 'inline');

模块的下载地址: http://drupal.org/project/jquery_media