留言模块相关调用数据及技巧(v5.0)
    2021-12-16
  
描述

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

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

相关参数

  共有 9 个可选参数,依次为:
   1、排序:0发布日期降序、1发布日期升序、2审核状态降序,发布日期降序、3审核状态降序,发布日期升序、4回复时间降序,发布日期降序。缺省值为 0
   2、调用记录数,分页时为每页要显示的数量,不分页时为调用的总记录数。缺省值为 10
   3、是否审核:0调用全部、1只调用审核通过、2调用非通过。缺省值为 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[5] > 0]。缺省值为 0
   9、是否所有人可看,0所有人,1管理员。缺省值为 0

调用实例

  1、调用ID为 12 的留言:   
{:$g = guestbook::data(0,1,0,1):}
{:$g['content']:}

  2、调用最新发布的 5 条留言并循环留言内容:   
{:foreach guestbook::data(0,5) as $item:}
    
留言人:{:$item['nickname']:}
留言内容:{:$item['content']:}
留言时间:{:date('Y-m-d H:i:s',$item['content']):}
{:/foreach:}

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

可调用变量

  留言ID:{:$item['id']:}
  昵称:{:$item['nickname']:}
  Email:{:$item['email']:}
  联系电话:{:$item['phone']:}
  传真号码:{:$item['fax']:}
  公司名称:{:$item['company']:}
  公司地址:{:$item['address']:}
  QQ号码:{:$item['qq']:}
  性别:{:$item['sex']:} 0女 1男 2保密
  主题/标题:{:$item['title']:}
  留言内容:{:$item['content']:}
  只允许管理员查看:{:$item['visible']:} 0所有人 1管理员
  用户名:{:$item['username']:}
  IP:{:$item['ip']:}
  IP位置描述:{:$item['ipaddress']:}
  留言时间:{:$item['addtime']:} 时间戳,请使用{:date():}函数转化你要的时间格式
  审核状态:{:$item['audit']:} 0未审 1已审
  管理员回复内容:{:$item['reply']:}
  回复管理员账号:{:$item['replyadmin']:}
  回复时间:{:$item['replytime']:} 时间戳,请使用{:date():}函数转化你要的时间格式

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

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