热门文章
      Popular Articles
          图片集模块相关数据调用方法及技巧(v5.0)

          发布日期:2019-03-05     点击:

            图片集调用无论是单个图片集还是多个图片集列表均使用 {:photo::data():} 的方法调用。调用指定ID(一条记录)时返回一维数组,其它方法均返回一个二维数组。

          调用方法:
          {:photo::data():}

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

          调用实例:
          1、调用当前频道下的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:}

          2、调用图集列表,并获得分页数据实现分页(v5.0):
          {:photo::data(0,10,0,$mle['channel_id'],0,0,0,0,0,1):}
          {:assign var="page_data" value=photo::$page_data:}
          <a href="{:$page_data['start_url']:}">首页</a>
          <a href="{:$page_data['first']:}">上一页</a>
          <a href="{:$page_data['next']:}">下一页</a>
          <a href="{:$page_data['end']:}">尾页</a>
            1
            2
            下一页
            尾 页
              页次: 1/2