TablePress 文档:模板标记函数

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

雁过留声,人过留名

您的电子邮箱地址不会被公开。 必填项已用 * 标注

特别提示:与当前文章主题无关的讨论相关但需要较多讨论求助信息请发布到水景一页讨论区的相应版块,谢谢您的理解与合作!请参考本站互助指南
您可以在评论中使用如下的 HTML 标记来辅助表达: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>