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>。要改变该值,请保证插入的代码被正确编码,如用<代替<。
- 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
以下代码输出最热门下载列表
01
02
03
04
05
06
07
08
09
10
11
12
|
<?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插件使用教程基础篇》。
|