在 TablePress 中,我们可以用简码将表格显示在很多地方(比如文章、静态页面、页脚或者边栏的文本小工具),但是如果你想将它嵌到 WordPress 主题的某个地方,就需要用到模板标记函数。
模板标记函数: tablepress_print_table( $query );
可以放在你的主题的任何地方(在 PHP 标记里:<?php
和 ?>
之间)。
参数 $query
的形式可以是 URL 中的请求字符串(下面有例子);还可以将请求参数和值以数组的形式传递给它。这一点与 WordPress 中的内置函数,如 wp_list_pages()
,所采用的方法一样。
如果你不想立即显示出该表格,而只是要得到它的输出,可以使用函数 tablepress_get_table( $query );
,方法同上。
可以使用的参数与 简码 的一样。
下面分别给出使用请求字符串和数组两种方式传递参数的例子。
使用请求字符串做为 $query
:
<?php tablepress_print_table( 'id=1&use_datatables=true&print_name=false' ); ?>
使用数组做为 $query
(推荐,因为这种形式简洁明了):
<?php tablepress_print_table( array( 'id' => '1', 'use_datatables' => true, 'print_name' => false ) ); ?>
同时,该插件还提供了一个与简码 [table-info id=N field=”<field-name>” /] 同样功能的函数:
<?php tablepress_print_table_info( "id=1&field=name" ); ?>
或者,
<?php tablepress_print_table_info( array( 'id' => '1', 'field' => 'name' ) ); ?>
它与上面提到的模板标记函数的用法一样,使用的参数与简码 [table-info id=N field=”<field-name>” /] 中要求的一样。
这是 WordPress 表格插件 TablePress 的简体中文说明文档的第三篇,介绍了 TablePress 内置模板标记函数以及其各种参数和使用方法。请访问 TablePress 使用及开发文档页面获取其它方面的说明文档。©
本文发表于水景一页。永久链接:<http://cnzhx.net/blog/tablepress-doc_templatetag/>。转载请保留此信息及相应链接。