Plugin WP-Table Reloaded (English)

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.

Diese Seite ist auch auf German Deutsch verfügbar.

WP-Table Reloaded enables you to create and manage tables in your WP Dashboard. No HTML knowledge is needed. A comfortable backend allows to easily edit table data. Tables can contain any type of data and additional JavaScript libraries can be used to extend it with features like sorting, pagination, filtering, and more. You can include the tables into your posts, on your pages or in text widgets by using a shortcode or a template tag function. Tables can be imported and exported from/to CSV, XML and HTML.

Download

Current Version: 1.9.4
Release date: January 27th, 2013 (release announcement)
Requirements: WordPress 3.1 or higher
License: GNU GPL2

Download WP-Table Reloaded Download from the WordPress Plugin Directory

If you like the plugin, please give it a high rating on its plugin page in the WP Plugin Directory. You might also consider a donation or having a look at my Amazon wishlist. Thanks!

Features

WP-Table Reloaded allows you the following (not necessarily a complete list):

  • manage tables in your WP admin area
  • show them in your posts, on pages or in text widgets using a shortcode or anywhere else in your theme using a template tag function (see Usage)
  • possible table features include (may be enabled for each table individually)
    • any content, even HTML, you like
    • table structure can contain colspanned and rowspanned cells
    • first row will be table headline (HTML tag <th>)
    • last row will be table footer (HTML tag <th>)
    • alternating row colors
    • row highlighting (when hovered with the mouse)
    • print table’s name above or under the table
    • print table’s description above or under the table
    • use the DataTables JavaScript library to allow pagination, sorting, and filtering of table data (see Demo)
    • individual styling of your table via CSS Styling possible (this may be used for different column widths or text-alignment)
  • functions in the backend include:
    • add/create tables (by manual input)
    • import a table (from CSV, XML or HTML files, URLs or direct input)
    • export/save/backup a table to these formats
    • import tables from old WP-Table plugin (if found)
    • edit the table data and structure (add/insert/delete/move/swap/hide columns/rows, sort columns)
    • easily add links or images to your table (from the Media Library)
    • copy/duplicate and delete tables
    • easily insert a table in to your posts/pages using a button in the editor toolbar
    • preview the table

Screenshots

Demo

You can see a demo table here, which was output here with the shortcode [table id=1 /]. The data was entered in the backend. Enabled options are the DataTables library (click on a column header to sort, or use the pagination buttons, or type in a search word), “alternating row colors”, “row highlighting”, “table head”, “table footer”, “print name”, and “print description”.

Demo Table

This

dfg
isademotable!
AndIamthefooter :-)
Youcanpresentdatahere.
Likenumbers:123
Orevenhtml:Strongemphasized
a linkoranimage:flag
Demo Table Description (You could tell people here, what they can actually see in the table.)


Here’s a table that shows the possibilities of combining cells with “rowspan” and “colspan”:

This is a colspanned cell out of four cells.I'm a single cell.
1And I'm a rowspan
of three cells!
emptysinglealone
2123
3testI'm a 2x2 block!
empty4single

The Changelog table was also created with this plugin.

Introduction and motivation

A couple months ago, I wanted to show tables (of baseball results and standings) on a WordPress powered website. I didn’t want do mess with HTML tables in the code (as they are very hard to maintain and manage), so I found the plugin WP-Table by Alex Rabe which allows comfortable editing of the data in WP’s admin area and easy usage of the table in blog posts or on pages. I used it for quite some time, but found some miscues. Thus, I decided to try to write a WordPress plugin myself and the idea to completely rewrite WP-Table was born. So I did some reading on WordPress plugin development and decided to use some of the new WordPress techniques from WordPress 2.7 through 2.9. And now, after a few months of programming, I’m very proud of WP-Table Reloaded :-)

Installation / Update

Installation
The easiest way is through your WordPress Admin area. Go to the plugin section and search for “WP-Table Reloaded” in the WordPress Plugin Directory. Then you can click “Install” and the following steps will be done for you automatically. You just have to activate the plugin (step 5).

Manual Installation works just as for most other WordPress plugins:

  1. Download the plugin’s zip file
  2. Unzip the file (you’ll get a folder called “wp-table-reloaded”).
  3. Upload that folder to the “wp-content/plugins/” folder of your WordPress installation
  4. Go to the Plugins Page in your WP Admin area
  5. Activate the plugin “WP-Table Reloaded”

Uninstalling / Deactivation
Just deactivate the plugin and delete the folder “wp-table-reloaded”. You might want to delete all tables and plugin options by clicking the appropriate button or enabling the “Uninstall upon Deactivation” option on the WP-Table Reloaded options screen before deactivating the plugin.

Update
The plugin will notify you, if there is an update available. The easiest way is then to “update automatically” using the provided WordPress function.

To manually update, just deactivate the plugin, delete the old plugin folder and replace it by the new one, extracted from the downloaded zip-file. Then activate the plugin again. Make sure that the option “Uninstall upon Deactivation” ist not checked or you’ll lose all your data!

Usage

After installing the plugin, you can add, import, export, edit, copy, delete, … tables via the “WP-Table Reloaded” screen which appears under the “Tools” section in your Admin menu.
Everything should be self-explaining there.
To show one of your tables in a post, on a page or in a text widget just include the shortcode [table id=<the-ID> /] to your post/page/text-widget, where <the-ID> is the ID of your table (can be found on the left side of the “List Tables” page.)

You can click on the “Table” button in the post/page editor to see a list of your tables. If you click “Insert” then, the correct shortcode will be inserted for you.

To insert a table somewhere else in your theme, you can use the Template Tag function. Please see the Documentation for more information on this.

After that you might want to change the style of the table. Just enter your CSS style information into the textarea on the “Plugin Options” screen.

You may also add certain features (like Sorting, Pagination, Filtering, alternating row colors, row highlighting, print name and/or description, …) by checking the appropriate options on the “Edit table” screen.

Languages and localization

The plugin contains the following languages (should be enabled automatically, if your WordPress language is set up correctly in your wp-config.php):

I’d really appreciate it, if you would translate the plugin into your language! Using Heiko Rabe’s WordPress plugin “Codestyling Localization” that really is as easy as pie. Just install the plugin, add your language, create the .po-file, translate the strings in the comfortable editor and create the .mo-file. It will automatically be saved in WP-Table Reloaded’s plugin folder. If you email me the .mo- and .po-file, I will gladly include them into future plugin releases, so that other users may enjoy the plugin in their language, too. There is also a .pot-file available to use in the “languages” subfolder.

Documentation

More technical information can be found on the Documentation page. It contains explanations of the Shortcodes, the Template Tag functions, Table and Plugin Options, CSS selectors (for styling), import/export formats and the JavaScript libraries. Please read this page, the FAQ and the Documentation page thoroughly before asking for support. Thank you!

Support

For help or support questions, use the WordPress Support Forums. Please open a new topic there (with the tag “wp-table-reloaded”). Please make sure, to read the FAQ and the Documentation first! Thank you!

To see older support request, please see the Support page. It contains all older comments that concern the plugin.

Credits and Thanks

Thanks go to Alex Rabe for the original WP-Table plugin,
Allan Jardine for the DataTables JavaScript library,
Christian Bach for the Tablesorter jQuery Plugin,
Sören Krings for the Tablesorter extension,
and all donors, translators, contributors, supporters, reviewers and users of the plugin!

Version History/Changelog

VersionreleasedChanges
1.9.42013-01-27bugfix: Remove DataTables TableTools, due to compatibility and security issues
1.9.32012-01-05enhancement: reduce problems with blank space below tables, caused by a no-longer necessary minimum height; enhancement: improve behavior and returned results of integration of the WP search; enhancement: many improvements to the performance of JavaScript code on the WP-Table Reloaded screens; enhancement: more possibilities for developer interaction (additional plugin filters, etc.); bugfix: fixed naming of the sorting arrow images, which where pointing in the wrong direction; bugfix: fixes to handling of the “Insert Image” thickbox; bugfix: minor fixes to logical errors in JavaScript code on the WP-Table Reloaded screens; IMPORTANT: Dropped support for outdated WordPress 3.0 (I always recommend using the newest version!); languages: Added Bulgarian
1.9.22011-09-16bugfix: Correct column width of "Edit" screen input fields in Internet Explorer 9; bugfix: Fix bug when a moved columns/rows were not moved to the correct place; bugfix: Restore functionality of the "Delete" link on the "List of Tables"; update: Added new DataTables version 1.8.2; enhancement: several code changes for better compatibility, adjustments to current WordPress versions; Dropped support for outdated WordPress versions 2.8 and 2.9; languages: Added Irish and Portuguese (Portugal), updated other languages, renamed Finnish language code to "fi"
1.9.12011-02-27bugfix: Update handling was broken in certain scenarios
1.92011-02-26feature: option to have the generated table HTML cached in a WordPress transient for faster page generation; feature: tables can get additional custom CSS classes, e.g. for easier layout and styling, and grouping tables; feature: Updated DataTables JavaScript library to 1.7.5; enhancement: adjustments to make the plugin work better with WordPress 3.1; enhancement: Add cell content as a parameter for the CSS class filter; enhancement: Additional ID-based CSS classes for the table name and description texts; enhancement: JavaScript features on "List of Tables" screen can be customized more; enhancement: cleaned up and optimized some code; languages: Added Dutch and Indonesian, updated other languages
1.82010-08-05feature: Updated JavaScript libraries to DataTables 1.7 and TableTools 1.1.4; enhancement: Template tag functions now accept strings and arrays for passing parameters; enhancement: Backwards compatibility for deprecated functions, don't use deprecated functions anymore; enhancement: Sort on "Edit" screen no longer moves header or footer row, if they are activated; enhancement: Added plugin filter hook to change table content prior to rendering; enhancement: Added "summary" attribute filter for <table> HTML element; enhancement: RTL-languages supported in frontend CSS; enhancement: Adjusted default CSS for new default theme "TwentyTen"; bugfix: Fixed search to not find table IDs with the same beginning; bugfix: Fixed problem with certain call-by-reference functions in certain versions of PHP; bugfix: valid HTML on "Plugin Options" screen; bugfix: Fixed notice due to not initialized variable; bugfix: Fixed DataTables translations for Danish and Norwegian; languages: Added Polish and Belarusian; languages: Added Romanian for DataTables
1.72010-03-16feature: add "Table" button to the visual editor (TinyMCE); feature: update DataTables JavaScript library to version 1.6.2, including TableTools; enhancement: add option for initial number of rows per pagination page; enhancement: add value "all" to the four Shortcode parameters show_rows, hide_rows, show_columns, hide_columns; enhancement: add WP-Table Reloaded screen icon to all plugin screens and the Top-Level menu entry; enhancement: add two template tag functions that return the output instead of echoing it; bugfix: fix problem with admin menu parent pages, make them ready for WP 3.0; bugfix: import/replace replaces only data; name, description, options, and visibility settings are kept; languages: added French, Chinese (Simplified), Russian, and Ukrainian
1.6.12010-01-30enhancement: let WP Search also search table name and description, enhancement: replacing a table during an import will leave options untouched and only replace table data, bugfix: better fix for DataTables invisibility issue in IE 7, enhancement: add 3 new plugin filters for frontend, bugfix: fix for problem with search, if data is empty somehow
1.62010-01-08Support for "rowspan" and "colspan" in tables; Search will now also search in tables; Possibility to select the plugin language; Highlight row background-color change when hovering); Option to show an "Edit Table" link on the frontend; select fields for position of name and description; internal plugin restructuring; dropped support for outdated WordPress 2.7
1.52009-12-19added the DataTables JavaScript library with these features: sorting, pagination, filtering, TableTools (Copy to Clipboard, CSV/XLS export, Print) (also added these to the "List Tables" screen); heavily redesigned the "Edit Table" screen: Bulk operations for inserting, deleting,..., Warning message if changes not yet saved; added features to the "Plugin Options": set access requirements (user roles) to the plugin and the Options, Change position of the plugin in the admin menu, better loading/inclusion of CSS; many, many plugin filters and actions for plugin customisation; export/import a dump file (with ALL tables/options/settings at once); dropped support for outdated WordPress 2.6
1.4.2a2009-09-29fixed bug: JavaScript errors in IE6 and 7 on Import screen; fixed bug: escapaping of delimiter when exporting was broken; added check for functions from mbstring library
1.4.12009-08-04fixed a small bug that may lead to JavaScript timeouts when editing large tables
1.42009-07-31restyled “List of Tables” to suit WP 2.7/2.8 layout, list now sortable; added Table and shortcode Preview in the backend; added possibility to show/hide rows/columns with checkboxes in the backend; "Insert Image" now allows inserting from WP Media Library"; textarea for cell data now grows when focussed; added “Custom Data Fields” to be able to store table meta data, accessible with a shortcode; added “Last edited” (time and user) information; fixed many minor bugs, errors and glitches (improved HTML validation); optimized and restructured big parts of the code; dropped support for WordPress 2.5; added Italian and Japanese language files
1.32009-06-09fixed bug with shortcode in text widgets for WP 2.8; added Brazilian Portuguese language file; fixed small bug with "Table" button in editor toolbar; table ID can now be changed and existing tables can be replaced upon import; possibility to add multiple rows/columns; import from URLs/webserver; WordPress shortcodes are supported within table cells; inputs are now textareas to allow easier editing of larger texts
1.2.12009-05-18bug fixes for syntax errors some users experienced, added Polish language file
1.22009-05-10editor toolbar button to insert tables; bulk actions; improved CSS and JS loading and performance; template tag function; new CSV import/export class; table specific settings can be overwritten by shortcode parameters; fixed a few minor bugs; smaller enhancements and text corrections
1.12009-04-28changed way of CSS handling (database option instead of file), fixed bug for users with PHP4 (certain function doesn't exist there), added two additional shortcode parameters, added button to easily insert links and images; also put Save-buttons above the table on the Edit-screen; more languages
1.0.12009-04-21language support; more import/export (import from old WP-Table); shortcode supported in text widgets; etc...
0.9.22009-04-10fixed bug in plugin deactivation hook, added missing css-file
0.9.12009-04-09first good release with all mentioned functions working well
0.9 beta 1b2009-04-07small bug which prevented showing of tables (but still not everything implemented)
0.9 beta 12009-04-06first release (not everything functional)