TablePress 文档:简码 [table-info id=N /]

简码 [table-info id=N field="<field-name>" /] 可以用于将某些自定义数据域显示到文章、页面或者文字小工具中。自定义数据域可以用于给表格增加一些附加的元数据。例如,关于数据来源的信息或者数据作者等。

你可以利用下面的简码像表格(的行为)一样来显示这些数据

[table-info id=N field="<field-name>" /]

该简码有 3 个参数:

id (整数) (必须)
有自定义数据域的表格的 ID,与简码 [table-info id=N /] 中要求的一样。
field (字符串) (必须)
自定义数据域的名称(从表格ID为 id 的表格的“编辑表格”页面创建)或者默认域(见下面)中的一个
format
其值只能是:raw。只能用于默认域 last_modified(最后修改),以取代预定义字符串而返回原始日期时间格式

field 可以使用的值有:

name
ID 为 id 的表格的名称
description
ID 为 id 的表格的描述
last_modified
对 ID 为 id 的表格的最后修改时间,如果参数 format 设置为 raw,将返回一个日期时间字符串,否则就返回一个美化后的日期时间字串
last_editor
最后编辑 ID 为 id 的表格的作者的名称

三个简码的使用实例(以某篇文章或静态页面中某个表格为例,在表格附近插入下面的信息):

表格 [table-info id=2 field="name" /] 经作者 [table-info id=2 field="last_editor" /] 最后修改于 [table-info id=2 field="last_modified" format="raw" /]。

将会在指定位置生成如下文字:

表格 “演示表格” 经作者 Haoxian Zeng 最后修改于 2013-03-22 18:20:21。

与该简码功能一样的模板标记函数为:

<?php tablepress_table_info( "id=2&field=name" ); ?>;

这两种方法实现的功能是一模一样的。有关模板标记函数的说明请参考 TablePress 文档:模板标记函数,使用的参数与这里描述的一样。

这是 WordPress 表格插件 TablePress 的简体中文说明文档的第二篇,介绍了简码(Shortcode)[table-info id=N /]的各种参数和使用方法。请访问 TablePress 使用及开发文档页面获取其它方面的说明文档。©

本文发表于水景一页。永久链接:<http://cnzhx.net/blog/tablepress-doc_shortcode_tableinfo/>。转载请保留此信息及相应链接。

时间过去太久,评论已关闭。
如果您有话要说,请到讨论区留言并给出此文章链接。
谢谢您的理解 :-)