发布日期：2019-02-28     点击：

　　留言调用无论是单个留言还是多个留言列表均使用 {: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 的留言：

2、调用最新发布的 5 条留言并循环留言内容：

2、调用图集列表，并获得分页数据实现分页（v5.0）：

可调用变量：
留言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']:}