简码是指用于控制插件行为的简短代码段。

简码 [table id=N /] 用于在文章、页面或者文字小工具中显示一个表格。可以在编辑文章或页面的时候手工输入，也可以通过编辑栏上的“表格”按钮自动输入。

简码中可以包含以下参数。所有参数可以简单地（无所谓顺序）添加到简码中，例如：

[table id=1 alternating_row_colors= false column_widths="40px|50px|80px|40px" /]

如果你使用了参数，那么它会对应地覆盖你在“编辑表格”页面对 表格属性 所作的设置！（例如：如果在“编辑表格”页面将使用JS库 前面的方框选中，那么使用参数 use_tablesorter=false 将会覆盖这个设置（结果就是将无法对表格进行排序等操作）。）

普通用户多半用不上这些参数，如果需要更改显示设置，推荐从“编辑表格”页面进行相应的设置。

id (整数) (必须)

其中“整数”表示需要显示的表格的 ID（可以在“表格列表”中查看）。（使用这个参数时最好不要使用引号，就像所有示例中展示的那样，这样能够避免WordPress搜索功能出错。）

column_widths (字符串) (可选)

表示列宽的字符串，用 | 符号（管道符）隔开例如：

column_widths="40px|50px|30px|40px"

or

column_widths="20%|60%|20%"

alternating_row_colors (布尔值) (可选)

决定表格在显示的时候是否根据单双行改变行的背景颜色（参考CSS类 “odd” 和 “even”）

row_hover (布尔值) (可选)

当鼠标在表格的行上悬停时是否使用不同的背景颜色来高亮显示该行

first_row_th (布尔值) (可选)

在HTML标记 <thead> 中是否用 <th> 来标记表格的第一行

first_column_th (布尔值) (可选)

在HTML标记 <thead> 中是否用 <th> 来标记表格的第一列（在管理后台中没有该参数的对应选项！）

table_footer (布尔值) (可选)

在HTML标记 <tfoot> 中是否用 <th> 来标记表格的最后一行

print_name (布尔值) (可选)

是否在表格的上房/下方显示表格名称

print_name_position (字符串) (可选)

显示表格名称的位置：可以是 “above” 或者 “below”

print_description (布尔值) (可选)

是否在表格的上房/下方显示表格描述

print_description_position (字符串) (可选)

显示表格描述的位置：可以是 “above” 或者 “below”

use_tablesorter (布尔值) (可选)

是否在该表格中启用选定的 JavaScript 库（一种 jQuery 插件）（只有当第一行使用了 <th> HTML 标签（可以是通过“编辑表格”页面设定的，也可以是利用简码的参数设定的）才起作用，并且其中的一个 JavaScript 库（数据表格、数据表格+表格工具、表格排序、表格排序扩展）必须在“插件选项”页面启用）

datatables_sort, datatables_paginate, datatables_lengthchange, datatables_filter, datatables_info (布尔值) (可选)

whether the corresponding feature of the 是否为该表格启用对应的数据表格 JS 库（只有当启用了数据表格 JS 库才有效，更多信息请访问数据表格 部分，或者访问其网站 DataTables website）

datatables_tabletools (布尔值) (可选)

whether是否为该表格启用数据表格的表格工具功能（只有当启用了数据表格+表格工具 JS 库才有效，更多信息请访问数据表格部分，或者访问其网站 DataTables/TableTools website）

datatables_customcommands (字符串) (可选)

custom JS parameters to be added to the 向数据表格 JS 调用中加入自定义JS参数（只有当启用了数据表格 JS 库才有效，更多信息请访问数据表格 部分，或者访问其网站 DataTables website）

row_offset (整数) (可选)

从第几行（默认是1）开始显示该表格（这样你就能够让表格中的数据在管理面板中显示却不显示在文章/页面中）

row_count (整数) (可选)

要显示的行数（默认显示全部行）（如果 row_count 被设置，那么表格显示的行数就由这里的所设置的行数决定（而不是直到表格的最后一行）。如果 row_count 没有设置，那么最后显示的行将是表格的最后一行。如果该参数被忽略，那么显示的表格将会从 row_offset（默认是 1 ）直到最后一行。

show_rows, hide_rows, show_columns, hide_columns (字符串) (可选)

这些参数可以用于覆盖在后台设定的显示设置（只对该指令覆盖的范围有效）。例如：

[table id=2 hide_columns="1,2,3" show_rows="4,5,6" /]

将会隐藏前面的三行而显示第4、5和6行，而不管后台是怎么设置的。除了可以手动输入每个行或列的编号，还有一个参数值 “all” 能够用于影响所有的行/列。如果需要的话，这些参数也可以同时使用：

hide_columns="3,4,5" show_columns="8,9"

cellspacing, cellpadding, border (整数) (可选)

对应于下面代码中的参数

<table cellspacing="0" cellpadding="0" border="0">
<tr>
<td>...</td>
</tr>
</table>

默认情况下没有设置这些参数，以便这些设置能够更好的由 CSS 来控制。是的。不过某些特殊情况下它们可能有用。

如果你在某些老版本的IE（Internet Explorer）中碰到表格显示问题的话，请尝试将代码 cellspacing="0" 或者 cellspacing="1" t加入到你的简码中，例如

[table id=N cellspacing="0" /]

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

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

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

该简码有 3 个参数：

id (整数) (必须)

存有自定义数据域的表格的 ID

field (字符串) (必须)

自定义数据域的名称（从表格ID为 id 的表格的“编辑表格”页面创建）或者默认域中的一个（见下面）

format

其值只能是： “raw”。只能用于默认域 “last_modified” （最后修改），以取代预定义字符串而返回原始日期时间格式

field 可以使用的值有：

<custom-data-field>

自定义数据域的名称

name

ID为 id 的表格的名称

description

ID为 id 的表格的描述

last_modified

对ID为 id 的表格的最后修改时间，如果参数 format 设置为 "raw"，将返回一个日期时间字符串，否则就返回一个预定义的字串

last_editor

The author who last modified the table with最后编辑 ID为 id 的表格的作者名称

三个简码的使用实例（以某篇文章或页面中的表格为例）：

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

将会生成如下文字

表格 “演示表格” 经作者 TobiasBg 最后修改于 2009-12-30 15:20:21。

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

<?php wp_table_reloaded_print_table_info( "id=1&field=name" ); ?>;

该模板标记函数的作用如下所述，参数参考上面的章节。

我们可以用简码将表格显示在很多地方（比如页脚或者边栏），但是如果你想将它嵌到WordPress主题的某个地方，可以用下面的模板标记函数： wp_table_reloaded_print_table( $query_string );。它可以放在你的主题的任何地方（在 PHP 标记里：<?php 和 ?>之间）。

参数 $query_string的形式可以是URL中的请求字符串或者类似于WordPress中的其它函数所要求的形式，如 wp_list_pages()那样。只需要将该参数和所需要的值用字符 “&” 组合起来作为一个关键字对就行了。如果你不想立即显示出表格，而只是要得到它的输出，可以使用函数 wp_table_reloaded_get_table( $query_string ) ，方法同上。可能用到的参数与 简码 的一样。

例如：

<?php wp_table_reloaded_print_table( "id=1&use_tablesorter=true&print_name=false" ); ?>;

同时，该插件还提供了一个与简码 [table-info id=N field=”<field-name>” /] 同样功能的函数：

<?php wp_table_reloaded_print_table_info( "id=1&field=name" ); ?>;

它与上面提到的模板标签函数的功能一样，使用的参数如前面 简码 部分所示。

每个表格都有它自己的选项设置，只对该表格起作用。可以在“编辑表格”页面对它们进行设定。它们都可以被前面 简码部分介绍的对应参数所覆盖。（注意：如果一个选项由简码参数来设定，则它的优先级高于“编辑表格”页面的对应选项！）

该插件提供了以下选项：

变换奇偶行背景色

如果该选项启用，每个奇数行将被赋予 CSS 类 “odd”，而每个偶数行将被赋予类 “even”。（默认的CSS对它们预定义了不同的背景颜色。你可以通过 FAQ 中的例子来了解如何更改该颜色设定。）

高亮（选择）行

如果该选项启用，鼠标所在行的所有单元格都将变为高亮（根据预设情况改变为对应的背景色）。同样，你可以通过 FAQ 中的例子来了解如何更改该颜色设定。）

表头

如果激活该选项，在显示的表格的第一行中的所有单元格将被分别包含在<th>标记而不是<td>标记中，而这一行也将会被置于HTML标记<thead>之中。对于使用JS库函数的表格来说，这一选项是强制激活的！

表尾

如果激活该选项，在显示的表格的最后一行中的所有单元格将被分别包含在<th>标记而不是<td>标记中，而这一行也将 会被置于HTML标记<tfoot>之中。

表格名称

如果该选项被激活，表格名称会被显示在表格的上/下方，并用HTML标记<h2>标记，并且 CSS 类 为wp-table-reloaded-table-name。位置可选，有“上方” 或 “下方”两种选择。

表格描述

如果激活该选项，将会在表格的上方/下方显示该表格的描述，并用HTML语言 <span> 来标记，拥有 CSS 类 wp-table-reloaded-table-description。位置可选，有“上方” 或 “下方”两种选择。

使用JavaScript库

只有当 “表头” 和 插件选项 “JavaScript 库” 同时被启用时，该选项才可用。如果该选项被激活，相应的JavaScript库函数将自动应用于该表格（如表格排序库中的排序功能），或者由用户分别选择（DataTables特性）。更多内容请参考 DataTables 和 Tablesorter 部分。

该插件拥有以下“插件选项”。它们在不同方面影响着插件的全局行为。你可以在管理选项“插件选项权限”中设定用户访问这些选项的权限，这样的话，只有那些拥有相应权限的用户组才能够更改这些选项。

前端选项影响表格在页面、文章或者文本小工具中的输出效果和使用的特性。

JavaScript 库

这将会在全局范围内启用选定的JavaScript库（一种jQuery插件）。你可以从 “DataTables” (推荐)， “DataTables+TableTools”， “Tablesorter”，和 “Tablesorter Extended”中选择。

默认 CSS

如果该选项被启用（推荐），插件将会加载默认的CSS样式表以指导浏览器用正确的样式来显示表格。如果选择了某个JavaScript库，该选项还会同时作用于该库的相关显示样式。

自定义 CSS

如果你希望改变表格的显示样式，你可以在“自定义 CSS” 文本区域输入相应的附加命令。关于如何改变某些样式，可以参考 FAQ 中的例子。

在新窗口打开链接

在使用“编辑表格”页面的“插入链接”向导为链接插入相应的HTML代码使得该链接将在一个新的浏览器窗口被打开，请启用该选项。如果启用，必需的HTML代码将被插入到所有在此之后插入的链接之中，但却不会插入到在激活该选项之前插入的链接之中（你需要手动添加或者重新插入这些链接）。以我（插件原作者，博主注）的个人观点来看，并不建议使用该特性，因为在点击一个链接时是否要在新的窗口中打开该链接取决于你网站/表格的访问者。大多数人喜欢在浏览器中设定是否在新窗口中打开一个新链接。

后台选项控制插件的管理区域，例如“编辑表格”页面。

退出时警告

如果启用该选项（推荐启用），那么在你还没有保存最近所做的更改时离开“编辑表格”页面（任何原因），你将会收到一条警告信息。然后你可以选择继续留在该页面并立即点击“保存更改”或者“保存并返回”按钮来保存你的更改。你也可以直接离开该页面，那么因为没有保存，你将丢失所做的更改。

自适应文字区域

如果启用该选项，在编辑表格页面向单元格中输入内容时，该单元格将随着输入内容的增加而自动增大，以方便浏览和输入更多内容。

管理员拥有更多的管理选项的访问权限。没有管理权限（也就是“管理选项”的设定权限）的用户将无法更改这些选项：

插件访问权限（Plugin Access）

您可以在这里选择访问该插件所需要的最低用户级别。拥有访问权限的用户可以查看、添加、编辑、复制、删除、导入和导出表格！如果将该用户同时包含在下面的设置里，他们将只能访问“插件选项”。

插件选项权限（Plugin Options Access）

您可以选择访问“插件选项”所需要的最低用户级别。能够访问“插件选项”的用户能够更改前台或后台设置。但是只有管理员才能够更改“管理选项”（包括该选项）。

插件语言（Plugin Language）

您可以通过该选项来设定WP-Table Reload的显示语言，而保持WordPress其它显示语言为WordPress的设定值。如果你想使用该插件的某一特定语言界面，该选项就显得非常有用，因为这样设置更完整，也更容易理解。

管理菜单入口（Admin menu entry）

使用该设置可以将“WP-Table Reloaded”管理菜单 （默认在“工具（Tools）”）移动到WordPress管理菜单上的其它位置。

前台编辑链接（Frontend Edit Link）

如果启用该选项，拥有插件访问权限的登录用户（例如，该用户的级别拥有前面提到的“插件访问权限”）会在前台页面上表格的旁边看到一个“编辑（Edit）”链接。单击该链接，能够直接进入“编辑表格”页面对该表格进行编辑。

WordPress搜索（WordPress Search）

开启该选项将允许WordPress内建搜索查询表格和其内容。该选项工作方式为：插件在搜索过程中添加钩子（hook）来获取搜索词，然后所有所有的表格以获取包含搜索词的相关表格的ID并存储起来，之后将搜索结果添加到WordPress搜索结果中，形式为 “&table id=N” 其中N对应于相应的表格ID。也就是说，WordPress搜索功能被扩展来搜索包含相应搜索词的表格简码。

禁用时删除（Remove upon Deactivation）

如果你想删除该插件，可以通过启用该选项来使得当你从WordPress插件页面禁用该插件时可以同时删除所有的表格数据。包括所有的相关设置、选项和所有的表格，以及与插件相关的数据！在进行该操作前，您最好将所有的表格导出或者创建一个备份文件。请记住：只有在您禁用该插件前才应该考虑启用该选项，以防止非故意或者偶然的数据丢失。在您卸载该插件或者通过WordPress插件管理页面单击“删除（Delete）”链接来删除该插件之后，您还需要手动删除该插件的文件夹（“wp-table-reloaded”）。该选项对 “卸载WP-Table Reloaded插件” 按钮没有影响（见后面）。

在“插件选项”中还有一些功能仅提供给管理员使用：

导出一个备份文件（Export a dump file）

WP-Table Reloaded 能够导出和导入一个包含所有表格、表格设置和插件设置的备份文件。该文件能够用于备份或者将所有数据转移到另一个WordPress安装中。要导出备份文件，您只需要单击对应的按钮即可。

导入一个备份文件（Import a dump file）

WP-Table Reloaded 能够导出和导入一个包含所有表格、表格设置和插件设置的备份文件。该文件能够用于备份或者将所有数据转移到另一个WordPress安 装中。要导入一个备份文件，单击相应的按钮以上传并导入即可。注意：所有当前 WP-Table Reloaded 安装里的数据（表格，选项，设置）都将被覆盖（而丢失）！强烈推荐您在导入一个备份文件之前先将当前数据进行备份（见前面）！

手动卸载WP-Table Reloaded（Manually Uninstall WP-Table Reloaded） (按钮)

该按钮会调用插件卸载/禁用过程。该插件的所有数据、设置和选项将会被清空，然后该插件会被删除。只有当你确实要删除该插件的时候才能点击该按钮。您最好先将所有表格导出作为备份。在卸载该插件之后您需要手动删除该插件的文件夹（“wp-table-reloaded”），或者使用WordPress插件页面的“删除”链接。

表格在 WordPress 页面上表现出来的样子由该页面的样式表（style.css）中关于表格的定义来决定。所以，你想让它表现出什么样子，就需要给它相应的样式表定义。可以参考这篇文章：https://cnzhx.net/blog/create-table-in-wordpress-manually/#css

每个表格都通过某些CSS类来设定显示样式，同时也可以使用 HTML-ID 来设定。可以将您的样式写入“插件选项”页面的“自定义CSS”文本区域。

在FAQ页面有一些常见任务的示例。

CSS 类将以<element>...</element> 的形式附加到一个<element>上，ID将添加为<element id="html-id">...</element>。

CSS 类（参照如下格式使用）：

.class /* . 后面是类的名称，替换为如下面的黑体字 */ {
/* 你的自定义 CSS */
};

wp-table-reloaded (<table>的类)

每个表格都拥有这个类（全局，所有使用 WP Table Reloaded 创建的表格都会应用到该样式。

wp-table-reloaded-id-<ID> (<table>的类)

每个表格都拥有这个类（使用其ID作为<ID>）。定义 CSS 时指定了 ID，就可以将该样式只应用于该 ID 的表格。

row-<number> (<tr>的类)

每一表格行将得到这个类。<number> 是显示行的序号，不管是表头的行还是数据的行。始终从1算起，不考虑 row_offset （行偏移量）参数。

column-<number> (每个 <th> 或者 <td>的类)

<number>是该单元格所属的列号。如果表头选项被激活，它将作为每个<th>的类，否则就作为每个<td>的类。使用下面的样式来设定列宽！（例如，

.wp-table-reloaded .column-2 {
width: 55px;
}

在FAQ页面还有另一个例子。重要提示：如果您同时使用 .column-X 和 .row-X 选择器， .row-X 必须置于 .column-X 的前面（因为它是赋给<tr>标记的，而<td>标记包含在<tr>标记之内）。

odd 和 even (每个 <tr>的类)

如果“表格选项”中“变换奇偶行背景色”（或“简码”参数）被启用，每一行都会得到其中一个类，根据该行是奇数行还是偶数行而定。使用这两个类来设定变化的行背景色。

在FAQ中有一个示例说明了该标记的用法。

wp-table-reloaded-table-name (<h2>的类)

如果“表格选项”中“显示表格名称”被启用，表格的名称将会显示在表格上方，并用<h2>标记，它的类由这个参数设定。

wp-table-reloaded-table-description (<span>的类)

如果“表格选项”中“显示表格描述”被启用，表格的描述将会被显示在表格的下方，并用<span>来标记，它的类由该参数设定。

CSS/HTML IDs （参照如下格式使用）：

#html-id {
/* 你的自定义 CSS */
};

wp-table-reloaded-id-<ID>-no-<number> (<table>的 ID)

每个表格都有一个类似于这种格式的样式 ID。<ID> 即是用于 WP-Table Reloaded里“表格列表”中的 ID。<number> 页面中到该位置为止的表格的计数/显示。（例如，如果你在网站上将同一个表格（具有相同<ID>）显示两次（例如一次在文章里，第二次在侧边栏里），第一次显示的表格其 <number> = 1 而第二次显示的表格其 <number> = 2。（这就意味着，这些HTML ID用于样式时不是很可靠，因为它们会随着表格在网页上显示的顺序不同而发生变化，比如如果侧边栏从右侧改为左侧并第一个显示出来，上面的<number>就变了。）使用这些ID是为了调用 JavaScript 库（如果对当前的表格启用了该功能）。

DataTables JavaScript 库（一个 jQuery 插件）是 WP-Table Reloaded 的一个附加特性（插件）。该插件由 Allan Jardine 编写，需要的话可以参考其文档。

该插件是 WP-Table Reloaded 的默认 JavaScript 库，能够提供诸如排序、分页（可改变长度）和过滤/搜索表格。要启用该插件，请在“编辑表格”页面勾选相应选项。 TableTools为网站访问者提供将表格保存为 CSV 或者 Excel（XLS）文件、复制数据到剪切板或者打印表格的功能。

您还可以将 TableTools 库添加到 DataTables 库中，只需在“插件选项”里启用“DataTables+TableTools”库即可。然后你就可以在“编辑表格”页面勾选“使用TableTools”复选框来为每个表格单独启用该功能。

请确保你的主题文件中的“footer.php”包含下面的语句：

<?php wp_footer(); ?>

否则DataTables库将无法工作！

您需要在“插件选项”页面全局启用该功能。然后您才能够为每个表格单独启用/禁用该功能（请参考表格选项）。

库的 JavaScript 文件存放在插件文件夹下的子文件夹“js”中。它需要使用 jQuery 库来工作（该库包含在 WordPress 中，会在您网站的每个页面的头部加载并执行）。

您可以参考 DataTables 文档或者示例，在“自定义命令”中添加您自己的命令或参数。您还可以使用特定的插件钩子（hook）来添加您自己的命令（见下面）。

表格排序特性

Tablesorter（表格排序） JavaScript 库（一个 jQuery 插件）是 WP-Table Reloaded 使用的另一个附加特性（插件）。该插件由 Christian Bach 编写，也有相应的文档。从1.5版开始，该插件成为 WP-Table Reloaded 的一个默认 JavaScript 库。不过好像该库作者已经不再提供支持，所以其功能目前由 DataTables 库替代。

请确保你的主题文件中的“footer.php”包含下面的语句：

<?php wp_footer(); ?>

否则DataTables库将无法工作！

插件作者声明无法继续为Tablesorter插件提供支持！ 有任何问题，请查阅 Tablesorter 文档。

从 WP-Table Reloaded 1.5版开始，在插件的源代码中加入了大量的 WordPress 插件钩子（Actions 和 Filters）。它们为向插件增加更多的功能提供了简单并易于建立的手段。您可以在 WordPress Codex 中找到更加详细的说明。

在扩展页面和相应的声明文章中提供了一些使用钩子（Hook）的示例（以及推荐操作）。

使用这些钩子比修改插件的源代码要方便，因为这样一来即使您升级了插件，那些修改依然能够工作。

下面是所有可用的插件钩子列表，并附有简短的关于使用方法和适用对象的说明。所有过滤器的名字都是以“wp_table_reloaded_”开头的。

格式是 过滤器名称 ( $parameters )(返回值类型)。

影响前台显示的函数（Influence on the Frontend）（例如表格输出）

wp_table_reloaded_frontend_js_priority ( $priority = 10 ) (integer)

wp_table_reloaded_colspan_trigger ( $this->colspan_trigger, $table[‘id’] ) (string)

wp_table_reloaded_rowspan_trigger ( $this->rowspan_trigger, $table[‘id’] ) (string)

wp_table_reloaded_bothspan_trigger ( $this->bothspan_trigger, $table[‘id’] ) (string)

wp_table_reloaded_table_css_class ( $cssclasses, $table[‘id’] ) (array)

wp_table_reloaded_print_name_html_tag ( ‘h2′, $table[‘id’] ) (string)

wp_table_reloaded_print_name_css_class ( ‘wp-table-reloaded-table-name’, $table[‘id’] ) (string)

wp_table_reloaded_print_name_position ( $print_name_position, $table[‘id’] ) (string)

wp_table_reloaded_print_description_html_tag ( ’span’, $table[‘id’] ) (string)

wp_table_reloaded_print_description_css_class ( ‘wp-table-reloaded-table-description’, $table[‘id’] ) (string)

wp_table_reloaded_print_description_position ( $print_description_position, $table[‘id’] ) (string)

wp_table_reloaded_pre_output_table ( $output, $table[‘id’] ) (string)

wp_table_reloaded_pre_output_table_id-{$table[‘id’]} ( $output ) (string)

wp_table_reloaded_print_colgroup_tag ( false, $table[‘id’] ) (boolean)

wp_table_reloaded_colgroup_tag_attributes ( $attributes, $table[‘id’], $col ) (strings)

wp_table_reloaded_post_output_table ( $output, $table[‘id’] ) (string)

wp_table_reloaded_post_output_table_id-{$table[‘id’]} ( $output ) (string)

wp_table_reloaded_output_table ( $output , $table[‘id’] ) (string)

wp_table_reloaded_output_table_id-{$table[‘id’]} ( $output ) (string)

wp_table_reloaded_cell_content ( $cell_content, $table_id, $row_idx + 1, $col_idx + 1 ) (string)

wp_table_reloaded_cell_css_class ( $col_class, $table_id, $row_idx + 1, $col_idx + 1, $this->colspan[ $row_idx ], $this->rowspan[ $col_idx ] ) (string)

wp_table_reloaded_row_css_class ( $row_class, $table_id, $row_idx + 1 ) (string)