编辑“MLECMS/资源下载模块相关数据调用方法及技巧”

{{MLECMS导航}}
软件下载调用无论是单个数据还是多个数据列表均使用 {:download::data():} 的方法调用。调用指定ID（一条记录）时返回一维数组，其它方法均返回一个二维数组。

'''调用方法：'''
 {:download::data():}

'''相关参数：'''
共有 15 个可选参数，依次为：
#排序，对调用的数据进行排序：0按自定义字段降序优先，其次按发布日期降序、1发布日期降序、2发布日期升序、3资源ID降序、4资源ID升序、5点击次数降序、6点击次数升序、7评论人数降序、8评论人数升序、9下载次数降序、10下载次数升序。缺省值为 0
#调用记录数，分页时为每页要显示的数量，不分页时为调用的总记录数。缺省值为 10
#是否推荐：0调用全部、1只调用推荐、2调用非推荐。缺省值为 0
#频道ID，0为所有频道下的数据。缺省值为 0
#栏目ID，含指定ID下的子分类，0为所有栏目下的数据。缺省值为 0
#调用的资源ID，为0时没有限制，其它数字为要调用的ID。调用单个资源时只有标题截取（第7、8个）参数有效，将忽略其它参数。指定ID时返回一维数组。缺省值为 0
#对完整标题字段截取长度，0不截取，显示完整标题。其它数字为标题截取长度。截取后的标题使用 array['title_format'] 调用，title 始终为未格式化的完整标题。缺省值为 0
#当标题被截取时显示的省略符号。缺省值为 "..."
#从第几条记录开始调用，分页时该参数无效，分页会根据 $_GET['page'] 来判定起始数。缺省值为 0
#是否分页，0不分页，1分页，缺省值为 0
#下载权限：0调用全部、1调用有下载限制的资源、2调用没有下载限制的资源。缺省值为 0
#购买下载：0调用全部、1调用购买下载的资源(需要使用积分或金钱购买后下载的资源)、2调用非出售的资源。缺省值为 0
#数字页码范围，数码分页时当前页前后显示多少页码。缺省值为 5
#是否调用上一篇、下一篇数据，0不调用、1调用，为1时将返回一个三个元素的多维数组：['prev']、['current'] 和 ['next']。对于调用指定ID单条数据时有效(即第6个参数大于0)。缺省值为 0
#是否只调用带有图片的资源，0调用全部、1只调用含有图片的资源。缺省值为 0 

'''调用实例：'''
*'''调用ID为 12 的下载资源：'''
<pre>
{:$d2 = download::data(0,1,0,0,0,12):}
{:$d2['content']:}
</pre>

*'''调用最新发布的 5 个下载资源：'''
 {:download::data(1,5):}

*'''调用当前频道下的10个下载资源并循环：'''
<pre>
{:foreach download::data(0,10,0,$mle['channel_id'],0,0,0,0,0,0,0,0,0,0) as $d:}
    <a href="{:$d['URL']:}">{:$d['title']:}</a>

    <!--
    这里还可以使用的其它的变量，如：
    格式化后的下载资源标题(被截取字符、添加字体颜色、字体加粗等属性)：{:$d['title_format']:}
    转成数组后的图片地址：{:$d['picture'][n]:}
    下载资源发布日期：{:$d['addtime']:}
    下载资源所属频道ID：{:$d['channel_id']:}
    下载资源所属频道名称：{:$d['channel']:}
    下载资源所属栏目路径：{:$d['category_id']:}
    下载资源所属最底层栏目名称：{:$d['category']:}

    ......

    其它更多参数见后台"添加下载资源"中的调用备注。
    -->
{:/foreach:}
</pre>

'''列表分页数据调用：'''

如果使用了分页(第10个参数为1时)，将在模板中可以使用以下变量调用分页数据：
#数据总记录数：{:$page_data['total']:}
#当前页码：{:$page_data['page']:}
#每页要显示的记录数：{:$page_data['limit']:}
#总页数：{:$page_data['total_page']:}
#第一页链接URL：{:$page_data['start_url']:}
#上一页链接URL：{:$page_data['first_url']:}
#下一页链接URL：{:$page_data['next_url']:}
#尾页链接URL：{:$page_data['end_url']:}
#已计算好的页码数组(一个以页码为键名的数组，值为链接URL)：{:$page_data['number']:}

'''其它相关参数调用：'''
#当前下载资源所属频道ID(频道首页、栏目列表页、下载资源内页模板中均有效)：{:$mle['channel_id']:}
#当前下载资源所属频道名称(频道首页、栏目列表页、下载资源内页模板中均有效)：{:$mle['channel_title']:}

'''在下载资源内页模板中有增加以下变量可以调用：'''
#当前下载资源所属一级类别ID：{:$d['category_split']['root_id']:}
#当前下载资源所属最低级类别ID：{:$d['category_split']['end_id']:}
#当前下载资源所属最低级类别名称：{:$d['category_split']['end_name']:}
#当前下载资源上一资源数据：{:$d['data_prev'][]:}
#当前下载资源下一资源数据：{:$d['data_next'][]:}

'''下载内页(down.tpl)资源下载地址的调用：'''
 {:$d['format_url']:} 被合并本地下载和镜像下载地址和名称的一个多维数组
该数组中返回当前资源中所有下载地址和名称，如：
<pre>
{:$d['format_url'][n][0]:}：下载名称 (新浪下载)
{:$d['format_url'][n][1]:}：文件URL (http://www.sina.com.cn/aaa.rar)
{:$d['format_url'][n][2]:}：下载链接URL (down.php?id=1&do=0)
</pre>

'''实例：'''循环调用当前资源下载地址：
<pre>
{:foreach $d['format_url'] as $dd:}
<a href="{:$dd[2]:}" target="_blank">{:$dd[0]:}</a> 
{:/foreach:}
</pre>

'''其它：'''下载资源内页中的基本字段数据调用见后台"添加下载资源"中的备注。


==参考来源==
*http://www.mlecms.com/tech/61.html


[[category:MLECMS|Z]]
{{MLECMS使用手册}}