区域管理模块相关调用数据及技巧(v5.0)
    2021-12-16
  
描述

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

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

相关参数

  共有 8 个可选参数,依次为:
   1、排序:0按地区等级升序优先,其次按自定义排序降序,最后按ID升序、1发布日期降序、2发布日期升序。缺省值为 0
   2、调用记录数,分页时为每页要显示的数量,不分页时为调用的总记录数。缺省值为 10
   3、调用几级区域,0或1为全部,2为省级,3为市级,4为镇区。缺省值为 0
   4、调用的内容ID,为0时没有限制,其它数字为要调用的ID。调用单个时转成一维数组。缺省值为 0
   5、从第几条记录开始调用,分页时该参数无效,分页会根据 $_GET['page'] 来判定起始数。缺省值为 0
   6、是否分页,0不分页,1分页,缺省值为 0
   7、数字页码范围,数码分页时当前页前后显示多少页码。缺省值为 5
   8、是否调用上一篇、下一篇数据,0不调用、1调用,为1时将返回一个三个元素的多维数组:['prev']、['current'] 和 ['next']。对于调用指定ID单条数据时有效[即:$args[2] > 0]。缺省值为 0

调用实例

  1、调用所有省级区域并循环:   
{:foreach region::data(0,10,2) as $a:}
    
{:$a['name']:} {:/foreach:}

  2、调用区域列表,并获得分页数据实现分页(v5.0):   
{:region::data(0,10,0,0,0,1):}
{:assign var="page_data" value=region::$page_data:}
首页
上一页
下一页
尾页

列表分页及内容分页数据调用

  如果使用了分页(第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']:}