Current Version: 1.3
Release date: December 12th, 2013
Requirements: WordPress 3.8 or higher
License: GNU General Public License 2 (GNU GPL2)
Download TablePress from the WordPress Plugin Repository
TablePress allows you to do the following (not necessarily a complete list):
- Manage tables in your WordPress admin Dashboard
- Show tables in your posts, on pages, or in text widgets using a Shortcode
- Show tables anywhere in your theme using a Template Tag function (see Usage)
- Table features include (may be enabled for each table individually):
- Excel-like formulas in tables
- Table structure can contain combined cells (
- First row can be table head row
- Last row can be table foot row
- Alternating row background colors
- Row highlighting (when hovered with the mouse)
- Print table name above or under the table
- Print table description above or under the table
- Individual styling of your table via CSS possible (e.g. for sizing or color changes)
- Functions in the editing interface include:
- Add/create tables (by manual input)
- Import tables (in Excel (.xls/.xlsx), CSV, HTML, or JSON format, from file upload, URLs, server location, or direct input), even with bulk import
- Export/save/backup tables to most of these formats, even with bulk export
- Edit the table data and structure (add/insert/delete/move/swap/duplicate/hide columns/rows, sort columns)
- Easily add links or images to your table (from the Media Library)
- Advanced editor for styling changes without having to know HTML
- Copy/duplicate and delete tables
- Easily insert a table into your posts and pages using a button in the editor toolbar
- Preview of the table
Screenshots are available on the TablePress page in the WordPress Plugin Directory.
Introduction and motivation
Back in 2009, I wanted to show tables on a WordPress powered website. I didn’t want to mess with HTML tables in the code (as they are very hard to maintain and manage), so I decided to try to write a WordPress plugin myself. I did some reading on WordPress plugin development and based on Alex Rabe’s wp-Table, I created WP-Table Reloaded, which became very successful. Unfortunately, as I had to learn later on, I made some design decisions that did not turn out well, made the plugin hard to maintain, and could even lead to data loss for certain server configurations. To fix these problems and issues, I decided that a complete rewrite of the plugin was necessary. With that, TablePress was born, and with that there are less problems, more features, and easier maintainability in the future :-)
For more on my motivation, also read this interview that I gave about WP-Table Reloaded and TablePress.
The easiest way to install TablePress is through your WordPress Dashboard. Go to “Add New” in the “Plugins” section and search for “TablePress” in the WordPress Plugin Directory. Then click “Install” and the following steps will be done for you automatically. You will just have to activate the plugin after that.
Manual Installation works just as for most other WordPress plugins:
- Download the plugin’s ZIP file.
- Extract the file: You’ll get a folder called “tablepress”.
- Upload that folder to the “wp-content/plugins/” folder on your server.
- Go to the “Plugins” page in your WordPress Dashboard.
- Activate “TablePress”.
Just deactivate the plugin and delete the folder “tablepress”. Tables will still be stored in the “wp_posts” table in your WordPress database, as a Custom Post Type of “tablepress_table”. If you are sure that you will never need these again, you can delete the corresponding entries. Be extra careful to not delete your regular posts or pages accidentally! Creating a full mySQL backup is recommended!
To completely remove all data, including tables and plugin settings, use the “Uninstall” button on the “Plugin Options” screen of TablePress.
WordPress will notify you, when a plugin update for TablePress is available. The easiest way is then to click “Update automatically” to get the latest version.
To manually update, delete the old plugin folder on the server and replace it with the new one, extracted from the freshly downloaded ZIP file.
After installing the plugin, you can add, import, export, edit, copy, delete, … tables via the “TablePress” 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> /] into your post/page/text widget, where
<the-ID> is the ID of your table (can be found on the left side of the “All Tables” screen in TablePress).
You can also click on the “Table” button in the toolbar of the post/page editor to see a list of your tables. If you click “Insert” then, the correct Shortcode will be inserted for you automatically.
To insert a table somewhere else in your theme, you can use a Template Tag function. Please see the Documentation for more information on this.
After that you might want to change the styling of the table. For that, just enter your desired CSS style information into the “Custom CSS” textarea on the “Plugin Options” screen. Examples for common styling questions can be found in the plugin FAQ.
You may also add certain features (like Sorting, Pagination, Filtering/Search, Alternating Row Colors, Row Highlighting, Print name and/or description, …) by checking the checkboxes on the “Edit” screen of your table.
Languages and localization
TablePress is available in the following languages (should be enabled automatically, if your WordPress language is set correctly in your
- Brazilian Portuguese
- Chinese (Simplified)
- Chinese (Taiwan)
I’d really appreciate it, if you would translate the plugin into your language! Using the plugin Codestyling Localization, that’s really easy. Just install the plugin, add your language, create the .po-file, translate the strings and create the .mo-file. It will automatically be saved in TablePress’ 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’s also a .pot-file available in the “languages” subfolder, if you’d rather use that, e.g. with the Poedit editor.
Credits and Thanks
|1.3||12/12/2013||· Compatibility with WordPress 3.8 and the new admin styling |
· Bugfix: Import of JSON files did not take row/column visibility into account
· Bugfix: File names of exported files were sometimes broken
· Bugfix: Translations for some strings were not loaded properly
· Enhancement: Don't search for tables outside of the main search query
· Enhancement: Broken tables are now skipped
· Updated external libraries
· Added Chinese (Taiwan) translation
· Internal improvements to coding standards, inline documentation, and build tools
· TablePress 1.3 requires WordPress 3.8!
|1.2||10/24/2013||· Compatibility with WordPress 3.7 |
· Bugfix: WordPress search did not find tables in some cases
· Bugfix: Cells were sometimes erroneously interpreted as formulas
· Bugfix: HTML export did not encode entities properly
· Bugfix: Wrong variable name in table render code
· Enhancement: Add logarithm to math functions for formulas
· Enhancement: Better internal code documentation and variable type checks
· Enhancement: Add parameter to Shortcode that allows showing debug information
· Updated external libraries
· Updated several translations (Brazilian Portuguese, Czech, French, German, Latvian)
· Many more internal code improvements
· TablePress now requires WordPress 3.6!
|1.1.1||09/10/2013||· Fixed a bug with CSS handling that broke some TablePress Extensions|
|1.1||09/08/2013||· Experimental import for Excel files (.xls and .xlsx) |
· More math functions in formulas (if-conditionals, statistical functions, ...)
· Better "Custom CSS" saving for higher performance
· Bugfix: Encoding problem during HTML import
· Bugfix: Roles are now deleted during uninstallation
· Bugfix: Search for tables was broken, if Shortcode had been changed
· Plugin Unit Tests for automated code testing
· Added several new translations (Brazilian Portuguese, Czech, Dutch, Finnish, Hebrew, Icelandic, Italian, Japanese, Latvian, Russian, and Turkish)
· Many more internal improvements of code and usability
· Updated external libraries
|1.0||04/23/2013||· Possibility to uninstall TablePress and delete all data automatically |
· Better import of DataTables settings from WP-Table Reloaded
· "Append" as another import option, addionally to "Add" and "Replace"
· Turn off DataTables if rowspan/colspan is added
· Better RTL language support on frontend
· Better character encoding handling for HTML import
· Compatibility of Custom CSS files with WP Multisite installations
· Remove margin/padding/borders around images in tables
· Extend [table-info /] Shortcode
· Better filter hooks in rendering process (useful for Extensions)
· Hide "Import from WP-Table Reloaded" by default, if it's not installed
· Added Polish translation and updated existing ones
· Updated external CodeMirror JS library