Documentation

WP-Table Reloaded is outdated!

WP-Table Reloaded has been replaced by TablePress. For more information, please see the announcement post and the official TablePress website.

This page is designed to document the functions, options and usage of WP-Table Reloaded and is more of a technical nature to suite the needs of developers and programmers.
It’s always a work in progress and will be updated, revised, and extended regularly.

For more general information about the plugin, please go to the plugin page. There is also a page with Frequently Asked Questions that should also be interesting.

The Shortcode [table id=N /]

The Shortcode [table id=N /] is used to display a table in a post, on a page or in a text-widget. It can either be entered manually or automatically using the “Table” button in the editor toolbar when editing a post/page.

The Shortcode can have the following parameters. All parameters can simply by added to the Shortcode (in arbitrary order), e.g.

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

If a parameter is added, it overwrites the corresponding Table Option from the “Edit table” screen of this table! (Example: If the checkbox for the JS library is checked on the “Edit table” screen, then the parameter use_tablesorter=false will overwrite this setting (and the table will not be sortable).)

The average user will most likely not need these parameters as it is recommend to change the setting in question by using the corresponding checkbox on the “Edit table” screen.

id (integer) (required)
The ID of the table to show (can be seen in “List of Tables”). (It is recommend to use this parameter without quotation marks as in all examples, for the WP Search to function properly.)
column_widths (string) (optional)
string with column widths, separated by the |-symbol (pipe)
examples:

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

or

column_widths="20%|60%|20%"
alternating_row_colors (boolean) (optional)
whether the table shall get alternating row colors (see the CSS classes “odd” and “even”)
row_hover (boolean) (optional)
whether table rows shall be highlighted with a different background-color, if the mouse hovers over them
first_row_th (boolean) (optional)
whether the first row will get <th> HTML tags inside a <thead> HTML tag
first_column_th (boolean) (optional)
whether the first column will get <th> HTML tags (there is no backend checkbox for this!)
table_footer (boolean) (optional)
whether the last row will use <th> HTML tags inside a <tfoot> HTML tag
print_name (boolean) (optional)
whether the name of the table shall be printed above/below the table
print_name_position (string) (optional)
position for printing the table name: can be “above” or “below”
print_description (boolean) (optional)
whether the description of the table shall be printed above/below the table
print_description_position (string) (optional)
position for printing the table description: can be “above” or “below”
use_tablesorter (boolean) (optional)
whether the selected JavaScript library (a jQuery plugin) shall be used with this table (will only work, if the first row gets <th> HTML tags (either by the setting on the “Edit table” screen or by the Shortcode parameter) and the usage of one of the JavaScript libraries (DataTables, Tablesorter, Tablesorter Extended) is enabled on the “Plugin Options” screen)
datatables_sort, datatables_paginate, datatables_lengthchange, datatables_filter, datatables_info (boolean) (optional)
whether the corresponding feature of the DataTables JS library shall be activated for this table (will only work if DataTables is enabled as the JS library to use, more information in the DataTables section or on the DataTables website)
datatables_customcommands (string) (optional)
custom JS parameters to be added to the DataTables JS call (will only work if DataTables is enabled as the JS library to use, more information in the DataTables section or on the DataTables website)
row_offset (integer) (optional)
first row of the table to show (defaults to 1) (this way you can have data in your table which is not shown on posts/pages but in the admin-area)
row_count (integer) (optional)
number of rows to show (defaults to all) (If row_count is positive, then the that many rows will be shown (up to the last row of the table). If row_count is negative then the last shown row will be that many rows from the end of the table away. If it is omitted, then the table will show all rows from row_offset (defaults to 1) up until the end of the table’s last row.
show_rows, hide_rows, show_columns, hide_columns (string) (optional)
These parameters can be used to overwrite visibility settings in the backend on a per-Shortcode basis. Example:

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

will hide the first three columns and show rows 4, 5 and 6, regardless on what visibility setting they have in the backend. Instead of adding each row or column number manually, there’s also a parameter value “all” that will affect all rows/columns. They can also be used at the same time, if needed:

hide_columns="3,4,5" show_columns="8,9"
cellspacing, cellpadding, border (integer) (optional)
Corresponds to the parameters in

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

By default those are not set as the setting can be better influenced with CSS. In some rare cases they might necessary though.
If you experience problems with tables showing differently in older versions of Internet Explorer, please test adding cellspacing="0" or cellspacing="1" to your Shortcode, i.e.

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

The Shortcode [table-info id=N /]

The Shortcode [table-info id=N field="<field-name>"/] can be used to display values of Custom Data Fields in a post, page or text-widget. Custom Data Fields can be used to add extra metadata to a table. For example, this could be information about the source or the creator of the data.

You can show this data in the same way as tables by using the Shortcode

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

The Shortcode has three parameters:

id (integer) (required)
The ID of the table that has the Custom Data Field
field (string) (required)
The name of a Custom Data Field (that was created on the “Edit Table” screen of the table with ID id) or one of the default fields (see below)
format
only possible value: “raw”. Only applies to the default field “last_modified” and will return the raw datetime format instead of the pretty string

Possible values for field are:

<custom-data-field>
The name of a Custom Data Field
name
The name of the table with ID id
description
The description of the table with ID id
last_modified
The time of the last modification of the table with ID id, if the format parameter is set to "raw", a datetime string will be returned, otherwise a pretty string
last_editor
The author who last modified the table with ID id

Example of three Shortcodes in action (i.e. in a post or on a page near a table):

The table [table-info id=2 field="name" /] was last modified at [table-info id=2 field="last_modified" format="raw" /] by [table-info id=2 field="last_editor" /].

will produce something similar to

The table Demo Table was last modified at 2009-12-30 15:20:21 by TobiasBg.

There’s a also a Template Tag Function for this Shortcode available:

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

It works exactly as the Template Tag Function described below, with the parameters from this section.

The Template Tag Functions

To show a table in places not covered by the Shortcode (e.g. your page footer or in the sidebar) you can use the template tag function wp_table_reloaded_print_table( $query_string );. It can be put in any part of your theme (between PHP brackets: <?php and ?>).
The parameter $query_string is a string in the form of a query string in a URL or other WordPress functions like wp_list_pages(). Simply join the parameters and their desired values as a key-value pair by the “&” symbol. If you don’t want to immideately print the table, but just get the output, use wp_table_reloaded_get_table( $query_string ) which works the same way.

The possible parameters are the same as for the Shortcode.

Example:

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

There’s a also a Template Tag Function for the Shortcode [table-info id=N field="<field-name>" /] available:

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

It works exactly as the Template Tag Function described above, with the parameters from the previous section.

Table Options

Each table has individual options that only concern that table. They can be changed on the “Edit table” screen of the table. All of them may be overwritten by the corresponding parameters of the Shortcode (remember: if an option is set as a Shortcode parameter it has preference over the corresponding option on the “Edit Table” screen!)

The following options are available:

Alternating row colors
If enabled, every odd row will get the additional CSS class “odd”, every even row will get the class “even”. (Those classes have a different background-color applied to them by the Default CSS. There’s an example on how to change these colors in the FAQ.)
Row Highlighting
If enabled, the background-color of all cells of the row that is currently hovered with the mouse cursor is changed to highlight the row. (There’s an example on how to change the color in the FAQ.)
Table head
If this is activated, all cells in the first displayed row will be encapsuled by the <th> instead of the <td> HTML tag and the row will be put inside a <thead> HTML tag. This is mandatory for using any of the JS libraries functions!
Table footer
If this is activated, all cells in the last displayed row will be encapsuled by the <th> instead of the <td> HTML tag and the row will be put inside a <tfoot> HTML tag.
Table Name
If enabled, the Name of the Table will be printed above/below the table inside a <h2> HTML tag, which has the CSS class wp-table-reloaded-table-name. The position can be selected from “above” or “below”.
Table Description
If activated, the Description of the Table will be printed above/below the table inside a <span> HTML tag, which has the CSS class wp-table-reloaded-table-description. The position can be selected from “above” or “below”.
Use JavaScript library
This option is only available, if the option “Table head” as well as the Plugin Option “JavaScript library” are enabled. If enabled, certain functions of the selected JavaScript library are either applied automatically (Sorting for the Tablesorter library) or can be selected independently (features of DataTables). See the DataTables and the Tablesorter section for more.

Plugin Options

The plugin has the following general “Plugin Options”. They affect the global plugin behavior in different areas. You can restrict access to these options with the Admin Option “Plugin Options Access”, so that only certain user groups can access the options.

Frontend Options influence the output and used features of tables in pages, posts or text-widgets.

JavaScript library
This will globally enable the usage of the selected JavaScript library (a jQuery plugin). You can select from “DataTables” (recommended), “Tablesorter”, and “Tablesorter Extended”.
Default CSS
If this is enabled (recommended) the plugin will load default CSS Stylesheets that contain commands for the browser on how to style tables. If a JavaScript library is selected, this will also take care of loading appropriate CSS for that.
Custom CSS
If you want to change the style of tables, you can enter those additional commands into the “Custom CSS” textarea. There are examples on how to change certain style aspects in the FAQ.
Links in new window
If you want the “Add Link” Wizard on the “Edit Table” screen to add the necessary HTML to open a link in a new browser window, enable this checkbox. Note that the necessary HTML will then be added to all links created AFTER activating this, but not to already existing links (you need to manually change or re-create those). Personally, I don’t recommend using this, because it should be up to the visitor of your website/table, whether he wants a new window when if clicks a link or not. Most people favor to incluence this with their browser.

The Backend Options control the plugin’s admin area, e.g. the “Edit Table” screen.

Exit warning
If this is enabled (recommended), you will get a warning message, if you are about to leave the “Edit Table” screen (for whatever reason) and have not yet saved your most recent changes. You can then select to remain on the current page and should then save your changes by clicking either the “Update Changes” or “Save and Go Back” button. You can also select to leave the page and will then lose your latest changes, because they were not saved.
Growing textareas
If this is enabled, the textareas for entering cell content on the “Edit table” screen will grow in size, to allow for easier viewing and entering of more data.

Administrators have access to further Admin Options. These can never be changed by users without admin rights (actually the “manage_options” capability):

Plugin Access
You can select the minimum user role required to access the plugin here. Users with access to the plugin can view, add, edit, copy, delete, import, and export tables! They can only access the “Plugin Options”, if they are included in the setting below.
Plugin Options Access
You can select the minimum user role required to access the “Plugin Options” here. Users with access to the “Plugin Options” can change the Frontend and Backend Options. Only Administrators can change the Admin Options (including this setting).
Plugin Language
With this setting you can change the language, WP-Table Reloaded is shown in, while the rest of WordPress will remain in the original language. This can be useful, if you want to use a special translation of the plugin, because it is more complete or better understandable.
Admin menu entry
Use this setting to move the menu entry “WP-Table Reloaded” (by default in “Tools”) to another location in the WP Admin Menu.
Frontend Edit Link
If this is enabled, users who are logged in and have access to the plugin (i.e. have a user role that is included in the “Plugin Access” option above) will see a link “Edit” next to a table on the frontend that will take them to the “Edit table” screen for that table.
WordPress Search
Enable this to allow the WordPress search to search through tables and their contents. This works as follows: The plugin hooks into the Search process to get the search terms. It then searches all tables for any of the search terms and stores all table IDs in which one was found. It will then append search terms to the original WordPress Search that will look for the term “&table id=N” where N corresponds to the stored IDs appropriately. In other terms: The WP Search is expanded to also look for Shortcodes of tables that contain a search term.
Remove upon Deactivation
If you want to uninstall the plugin, you can enable this checkbox to have ALL data removed when you deactivate the plugin on the WordPress Plugins page in you admin area. This includes all settings, options and all tables and data of the plugin! You might want to export your tables or create dump file before doing this to have a backup. Remember: This checkbox should only be activated directly before deactivating the plugin to prevent unwanted or accidental data loss. You will have to delete the plugin folder (“wp-table-reloaded”) yourself after uninstalling the plugin or use the “Delete” link on the WordPress Plugins page. This checkbox has no effects on the “Uninstall Plugin WP-Table Reloaded” button (see below).

There are also several other features on the “Plugin Options” only available to Administrators:

Export a dump file
WP-Table Reloaded can export and import a so-called dump file that contains all tables, their settings and the plugin’s options. This file can be used as a backup or to move all data to another WordPress site. To export such file, just click the corresponding button.
Import a dump file
WP-Table Reloaded can export and import a so-called dump file that contains all tables, their settings and the plugin’s options. This file can be used as a backup or to move all data to another WordPress site. To import such file, upload it from your computer using the button. IMPORTANT: All current data of the importing WP-Table Reloaded installation (Tables, Options, Settings) WILL BE OVERWRITTEN with the data from the file!
It is highly recommended to export and backup the data of the importing installation before importing a dump file (see above).
Manually Uninstall WP-Table Reloaded (button)
This button will invoke the plugin uninstallation/deactivation. ALL data, settings, options of the plugin will be removed and the plugin will be deleted. You should only click this button if you really want to uninstall the plugin. You might want to make a backup of your tables by exporting them. You will have to delete the plugin folder (“wp-table-reloaded”) yourself after uninstalling the plugin or use the “Delete” link on the WordPress Plugins page.

CSS selectors, Styling

Every table gets certain CSS classes and an HTML-ID that can be used for styling. Add your styling commands to the “Custom CSS” textarea on the “Plugin Options” screen.

There are examples for the most common tasks in the FAQ.

CSS classes are attached as <element class="class-name">...</element> to an <element>, IDs are attached as <element id="html-id">...</element>.

CSS classes (use them as

.class { 
/* your CSS */ 
};
wp-table-reloaded (class of <table>)
Every table has this class.
wp-table-reloaded-id-<ID> (class of <table>)
Every table has this class (with its ID for <ID>).
row-<number> (class of <tr>)
Every row gets this. <number> is the number of the row displayed, no matter if it is a heading row or data row. Counting always starts at 1, regardless of the row_offset parameter.
column-<number> (class of every <th> or <td>)
<number> is the number of the column the cell belongs to. If the table heading option is activated, it will be a class of every <th>, otherwise of every <td>.
Use this for styling column widths! (e.g.

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

There’s another example in the FAQ. VERY IMPORTANT: If you use both the .column-X and the .row-X selectors, the .row-X has to stand BEFORE the .column-X (because it is given to the <tr> which encloses the <td>).

odd and even (classes of every <tr>)
If the Table Option “alternating row colors” (or the Shortcode parameter) is enabled, every row will get one of these classes, depending on whether it is an odd or even row. Use the classes to actually style the alternating background colors. There’s an example to do this in the FAQ
wp-table-reloaded-table-name (classes of <h2>)
If the Table Option “Print Table Name” is enabled, the Name of the Table will be printed above the table inside a <h2> HTML tag, which has this class.
wp-table-reloaded-table-description (classes of <span>)
If the Table Option “Print Table Description” is enabled, the Description of the Table will be printed below the table inside a <span> HTML tag, which has this class.

CSS/HTML IDs (use them as

#html-id { 
/* your CSS */ 
};
wp-table-reloaded-id-<ID>-no-<number> (ID of <table>)
Every table gets an ID like this. <ID> stands for the ID used in the “Table List” of WP-Table Reloaded. <number> is the count/occurance of that table on the page up to this point. (E.g. if you display the same table (with the same <ID>) twice on your site (eg. once in a post and the second time in the sidebar), the first one will have <number> = 1 and the second one will have <number> = 2. (This means, that these HTML IDs are not very reliable to be used for styling, as they might change depending on the occurance of the same table on the page again.) These IDs are used though to invoke the JavaScript library’s calls (if activated for this occurance of the table).

DataTables JavaScript Features

The DataTables JavaScript library (a jQuery plugin) is an additional feature (add-on) to WP-Table Reloaded. It was written by Allan Jardine and has its own Documentation.

It is the default JavaScript library of WP-Table Reloaded and can add features like sorting, pagination (with length change feature), and filtering/searching to a table. To enable those, check the corresponding checkboxes on the “Edit table” screen.

Please make sure that your theme’s “footer.php” contains the line

<?php wp_footer(); ?>

Otherwise the DataTables library will never work!

You have to globally activate its use on the “Plugin Options” screen. You may then decide for each table individually whether you want the DataTables library to be executed for it (see the section Table Options for more) and you can selected the desired features.
The library’s JavaScript file is located in the subfolder “js” of the plugin folder. It uses the jQuery library (which is included in WordPress and will be loaded automatically in the head every page your site).

You can add custom commands or parameters from the DataTables Documenation or Examples into the “Custom Commands” textfield. You can also use certain Plugin Hooks to add your own commands (see below).

Tablesorter Features

The Tablesorter JavaScript library (a jQuery plugin) is an additional feature (add-on) to WP-Table Reloaded. It was written by Christian Bach and has its own Documentation. It used to be the default JavaScript library until version 1.5. It seems that it is no longer maintained, therefore its usage is discouraged in favor of the DataTables script.

Please make sure that your theme’s “footer.php” contains the line

<?php wp_footer(); ?>

Otherwise the Tablesorter will never work!

Please understand that I can not give support for Tablesorter any longer! Consult the Tablesorter Documentation with any questions.

Plugin Hooks, Actions, and Filters

Beginning in WP-Table Reloaded 1.5, a large number of WordPress Plugin Hooks (Actions and Filters) where added to the plugin’s source code. They provide easy and well established methods to add further functions to the plugin. A more detailed explanation can be found in the WordPress Codex.

There are some examples on how to use the Hooks (and the recommended foundation to do so) on the page Extensions and in the corresponding announcement post.

The advantage of using these hooks in contrast to modifying the plugin’s source files is that the changes will still work after upgrading the plugin.

This is is a list of all available plugin hooks and a short description of use cases and purpose. All filter names start with “wp_table_reloaded_”.
The format is filter name ( $parameters )(return type).

Influence on the Frontend (i.e. table output)

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)
wp_table_reloaded_apply_nl2br ( true ) (boolean)
wp_table_reloaded_shortcode_table_info ( $this->shortcode_table_info ) (string)
wp_table_reloaded_shortcode_table ( $this->shortcode_table ) (string)
wp_table_reloaded_shortcode_table_info_default_atts ( $default_atts ) (array)
wp_table_reloaded_shortcode_table_default_atts ( $default_atts ) (array)
wp_table_reloaded_shortcode_table_info_overwrite ( false, $atts ) (boolean|string)
wp_table_reloaded_table_not_found_message ( $message, $table_id ) (string)
wp_table_reloaded_table_info_not_found_message ( $output, $table_id, $field ) (string)
wp_table_reloaded_shortcode_table_overwrite ( false, $atts ) (boolean|string)
wp_table_reloaded_table_not_found_message ( $message, $table_id ) (string)
wp_table_reloaded_table_empty_message ( $message, $table_id ) (string)
wp_table_reloaded_html_id ( $output_options['html_id'], $table_id ) (string)
wp_table_reloaded_table_js_options ( $js_options, $table_id ) (string)
wp_table_reloaded_min_needed_capability ( $min_capability ) (string)
wp_table_reloaded_admin_menu_parent_page ( $admin_menu_page ) (string)
wp_table_reloaded_plugin_path ( $plugin_path ) (string)
wp_table_reloaded_url_css_plugin ( $url_css_plugin ) (string)
wp_table_reloaded_url_css_datatables ( $url_css_datatables ) (string)
wp_table_reloaded_url_css_tablesorter ( $url_css_tablesorter ) (string)
wp_table_reloaded_default_css ( $default_css, $this->options['use_default_css'], $this->options['tablesorter_script'], $this->options['enable_tablesorter'] ) (string)
wp_table_reloaded_custom_css ( $custom_css, $this->options['use_custom_css'] ) (string)
wp_table_reloaded_frontend_css ( $css ) (string)
wp_table_reloaded_url_js_script ( $js_script_url, $jsfile ) (string)
wp_table_reloaded_url_js_zeroclipboard ( $js_zeroclipboard_url ) (string)
wp_table_reloaded_url_swf_zeroclipboard ( $swf_zeroclipboard_url ) (string)
wp_table_reloaded_datatables_locale ( $datatables_locale ) (string)
wp_table_reloaded_url_datatables_language_file ( $language_file_url ) (string)
wp_table_reloaded_js_frontend_parameters ( $parameters, $table_id, $html_id, $this->options['tablesorter_script'], $js_command, $js_options ) (string)
wp_table_reloaded_js_frontend_command ( $command, $table_id, $html_id, $this->options['tablesorter_script'], $js_command, $parameters, $js_options ) (string)
wp_table_reloaded_js_frontend_all_commands ( $commands ) (string)
wp_table_reloaded_frontend_output_options ( $output_options, $table_id, $table ) (array)

Influence on the Backend

wp_table_reloaded_admin_postbox_closed ($postbox_closed, $postbox_name) (boolean)
To change the closed/shown state of the postbox with the $postbox_name. Return true for closed, false for shown.
wp_table_reloaded_plugin_display_name ( $display_name ) (string)
wp_table_reloaded_default_action ( $default_action ) (string)
wp_table_reloaded_allowed_actions ( $this->allowed_actions ) (array)
wp_table_reloaded_action_pre_{$this->action} ( false ) (boolean|string)
wp_table_reloaded_backend_table_actions ( $table_actions ) (array)
wp_table_reloaded_backend_plugin_actions ( $plugin_actions ) (array)
wp_table_reloaded_update_options ( false, $this->options ) (array)
wp_table_reloaded_update_tables ( false, $this->tables ) (array)
wp_table_reloaded_save_table ( false, $table ) (array)
wp_table_reloaded_pre_save_table ( $table ) (boolean)
wp_table_reloaded_pre_save_table_id-{$table['id']} ( $table ) (boolean)
wp_table_reloaded_delete_table ( false, $table_id ) (boolean)
wp_table_reloaded_user_access_{$screen} ( $has_access, $this->options['user_access_plugin_options'] ) (boolean)
wp_table_reloaded_admin_use_datatables ( $use_datatables ) (boolean)
wp_table_reloaded_load_table ( false, $table_id ) (array)
wp_table_reloaded_post_load_table ( $table, $table_id ) (array)
wp_table_reloaded_post_load_table_id-{$table_id} ( $table ) (array)
wp_table_reloaded_load_tables_list ( false ) (array)
wp_table_reloaded_load_options ( false ) (array)

Import/Export Formats

Import Formats

The plugin can import tables from the following formats:

CSV (Character-Separated Values)
Every row is in a new line, every column is separated by a character (like “;” (semicolon), “:” (colon), “,” (comma), “.” (dot) or “|” (pipe)). The plugin will try to determine the used separation character automatically. See the Wikipedia article for more information on the CSV format.
HTML (Hypertext Markup Language)
The plugin will import the first occurance of a HTML-table (enclosed in <table></table>). It will not recognize or import tables with “colspan” or “rowspaned” cells!
XML (eXtended Markup Language)
To import from XML, the XML-file needs to have the following structure (with example data):

<?xml version="1.0" encoding="ISO-8859-1"?>
<table>
 <row>
  <col><![CDATA[<strong>HTML</strong>]]></col>
  <col>strong</col>
  <col>numbers: 343</col>
 </row>
</table>

(Rows are enclosed in <row> tags, columns are enclosed in <col> tags.)

Export Formats

The plugin can export tables into the following formats. You may choose to download the export dump as a file. Otherwise it will be printed inside a textarea on the page.

CSV (Character-Separated Values)
Every row is in a new line, every column is separated by a character (like “;” (semicolon), “:” (colon), “,” (comma), “.” (dot) or “|” (pipe)). You can choose your desired character in the export dialog.
See the Wikipedia article for more information on the CSV format.
HTML (Hypertext Markup Language)
The plugin will the table as HTML (enclosed in <table></table>, but without any formatting/styling). Combined cells (“rowspan” and “colspan”) will not be exported as such, but with the trigger words (#colspan# and #rowspan#) in the cell.
XML (eXtended Markup Language)
The exported XML-file will have the following structure (with example data):

<?xml version="1.0" encoding="ISO-8859-1"?>
<table>
  <row>
    <col><![CDATA[<strong>HTML</strong>]]></col>
    <col>strong</col>
    <col>numbers: 343</col>
  </row>
</table>

(Rows are enclosed in <row> tags, columns are enclosed in <col> tags.)

Source Code

The plugin’s source code is freely available in the zip-file that can be downloaded. It is Open Source and licensed as Free Software under GNU GPL 2.

The main development takes place in a Subversion (SVN) repository on Google Code. You can browse the code there.