MLECMS/图片集模块相关数据调用方法及技巧
来自站长百科
图片集调用无论是单个图片集还是多个图片集列表均使用 {:photo::data():} 的方法调用。调用指定ID（一条记录）时返回一维数组，其它方法均返回一个二维数组。
调用方法：
{:photo::data():}
相关参数： 共有 14 个可选参数，依次为：
- 排序，对调用的图片集进行排序：0按自定义字段降序优先，其次按发布日期降序、1发布日期降序、2发布日期升序、3图集ID降序、4图集ID升序、5点击次数降序、6点击次数升序、7评论人数降序、8评论人数升序。缺省值为 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
调用实例：
- 调用ID为 12 的图片集：
{:$pic2 = photo::data(0,1,0,0,0,12):}
{:$pic2['content']:}
- 调用最新发布的 5 个图片集：
{:photo::data(1,5):}
- 调用当前频道下的10个图片集并循环：
{:foreach photo::data(0,10,0,$mle['channel_id'],0,0,0,0,0,0,0,0,0,0) as $pic:}
<a href="{:$pic['URL']:}">{:$pic['title']:}</a>
<!--
这里还可以使用的其它的变量，如：
格式化后的图片集标题(被截取字符、添加字体颜色、字体加粗等属性)：{:$pic['title_format']:}
格式化后的短标题(添加字体颜色、字体加粗等属性)：{:$pic['brief_format']:}
转成数组后的图片地址：{:$pic['picture'][n]:}
图片集发布日期：{:$pic['addtime']:}
图片集所属频道ID：{:$pic['channel_id']:}
图片集所属频道名称：{:$pic['channel']:}
图片集所属栏目路径：{:$pic['category_id']:}
图片集所属最底层栏目名称：{:$pic['category']:}
......
其它更多参数见后台"添加图片集"中的调用备注。
-->
{:/foreach:}
列表分页数据调用： 如果使用了分页(第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：{:$pic['category_split']['root_id']:}
- 当前图片集所属最低级类别ID：{:$pic['category_split']['end_id']:}
- 当前图片集所属最低级类别名称：{:$pic['category_split']['end_name']:}
- 当前图片集上一图集数据：{:$pic['data_prev'][]:}
- 当前图片集下一图集数据：{:$pic['data_next'][]:}
- 当前图片集中所有图片地址，一个JS数组字符串：{:$pic['img_jsstring']:}
- 当前图片集中所有图片描述，一个JS数组字符串：{:$pic['des_jssering']:}
其它：图片集内页中的基本字段数据调用见后台"添加图片集"中的备注。
参考来源[ ]
MLECMS使用手册导航 | ||||
|---|---|---|---|---|
|