枫芸志

Download Monitor是管理文件下载的WordPress插件，可指定文件只允许登陆下载，具有下载统计功能，同时含有一个下载页面（可点击本站顶部导航栏的下载查看效果）。另外单条下载效果如下面的插件下载。

WordPress Download Monitor v3.1.5中文版点击WordPress Download Monitor插件获得。

下面说明常用的两个功能使用方法：

注：请先上传并激活插件，然后做好一定的配置。

1、下载页面的使用

添加一个新页面，自定义好标题和固定链接，然后在内容部分输入[download_page]即可，Download Monitor会将其替换为下载页面。当然还可在此短标记内增加以下可选项：

• base_heading_level (integer) – 分类的标题级别，默认为3（h3）
• pop_count (integer) – 热门下载显示条数，默认为4
• pop_cat_count (integer) – 每个分类下的热门下载显示条数，默认为4
• show_uncategorized (integer) – 设置为1（默认）显示未分类内容，设置为0则不显示
• per_page (integer) – 每页显示的下载条数，默认为20
• format – 使用自定义输出样式的ID
• exclude – 禁止显示的下载，以逗号来分隔多项

例如[download_page pop_count="5"]表示显示5条热门下载。

2、下载链接的使用

在文章内容中输入[download id="1" format="3" autop="true"]，Download Monitor会将其替换为一个下载链接，下载编号为1，显示样式使用编号为3的自定义输出样式，并且生成p标签容器。

以下两种输出单条下载链接的短标记同样有效：

[download id="1"]

[download id="2" format="2"]

以下短标记可输出多条下载链接：

[downloads query="limit=5&orderby=rand" format="1" wrap="ul" before="<li>" after="</li>" autop="false"]

downloads短标记可包括以下可选项，并且都是可选的：

• query – 查询条件字符串，可包括很多可选项（参见下文的get_downloads()函数）。默认为获取5条随机下载。此短标记常用来显示一个分类下的下载，如在query字符后增加 &category=1 (其中1可被替换为分类ID) 来实现。
• format – 自定义输出样式ID，从而可改变下载条目的输出样式。
• wrap – 默认情况下，多条下载的显示容器为未排序列表（ul）；设置为空字符串可则不输出容器ul。
• before/after – 每条下载条目的前导标签和后继标签，默认分别<li>和</li>。要改变该值，请保证插入的代码被正确编码，如用&lt;代替<。
• autop – 可设为true或false; 设为false能阻止输出p标签，默认为false。【编者注：实际效果存在一定偏差，其实只要设置了值便会产生p标签，如不希望产生p标签，不要添加此项 已予以修正】

可用的例子：

[downloads]

[downloads query="limit=5&orderby=hits"]

[downloads query="limit=5&orderby=hits" format="2"]

[download query="limit=5&orderby=hits" wrap="" before="<p>" after="</p>"]

3、在模板中转化短标记

使用do_shortcode()函数即可。例如：

do_shortcode(‘[download id="1"]‘)

4、get_downloads()模板函数

函数返回符合指定查询条件的多条下载，需要一个参数作为查询条件。 默认值如下：

'limit' => '', 'offset' => 0, 'vip' => 0 'category' => '', 'orderby' => 'id', 'order' => 'ASC'

以上多个查询属性间使用符号&连接，如 limit=5&orderby=hits&order=desc。

• limit(integer) - 返回的内容条数。
• offset(integer) – 返回条目的偏移量，如为1则不返回第一条结果。
• vip – 可设为 1 (true) 或 0 (false)；如为true则只有有权限获取的下载条目会被显示（非注册用户会看不到只有注册用户可下载的条目）。
• category - 返回这里指定分类下的下载条目，多个分类ID间用逗号分隔。
• orderby – 结果排序的依据，可用的条件包括 id, hits, title, date, filename, meta, and random。
• meta_name – 定义meta项当orderby为meta时。只有包括指定meta项的下载会被显示。
• order – 结果排序的顺序。’ASC’表示正序，’DESC’表示降序。

get_downloads() 返回数组对象，包含以下数据：

• size
• url
• title
• version
• hits
• image
• desc
• category
• category_id
• id
• date
• memberonly

以下代码输出最热门下载列表

<?php
$dl = get_downloads('limit=5&orderby=hits&order=desc');

if (!empty($dl)) {
    echo '<ul class="downloadList">';
    foreach($dl as $d) {
        $date = date("jS M Y", strtotime($d->date));
        echo '<li><a href="'.$d->url.'" title="'.__('Version',"wp-download_monitor").' '.$d->version.' '.__('downloaded',"wp-download_monitor").' '.$d->hits.' '.__('times',"wp-download_monitor").'" >'.$d->title.' ('.$d->hits.')</a></li>';
    }
    echo '</ul>';
}
?>

注意：如果想要在文章中显示短标记，需使用html为[download_page]，这样能防止字符被转换，如本文文章内容中的短标记显示。

以上大部分内容翻译至Download Monitor官网说明文档，并经整理编辑成文。

另外，如果永久链接是采用404页面来实现的，在支持Download Monitor插件的404.php找到对应的404.php源码。

2009年1月26日更新

阅读本文后如对WordPress Download Monitor插件的使用仍有疑问，推荐阅读《WordPress Download Monitor插件使用教程基础篇》。