简码 [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/>。转载请保留此信息及相应链接。