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