| 1 |
=== TablePress - Tables in WordPress made easy === |
| 2 |
Contributors: TobiasBg |
| 3 |
Donate link: https://tablepress.org/premium/?utm_source=wordpress.org&utm_medium=textlink&utm_content=donate-link |
| 4 |
Tags: table, spreadsheet, csv, excel, tables |
| 5 |
Requires at least: 6.2 |
| 6 |
Requires PHP: 7.4 |
| 7 |
Tested up to: 6.7 |
| 8 |
Stable tag: 3.0.4 |
| 9 |
License: GPLv2 |
| 10 |
License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
Embed beautiful, accessible, and interactive tables into your WordPress website’s posts and pages, without having to write code! |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
**Boost your website with feature-rich tables that your visitors will love!** |
| 17 |
|
| 18 |
TablePress is the most popular and highest-rated WordPress table plugin. |
| 19 |
|
| 20 |
* Easily create, edit, and manage **beautiful and modern** data tables, no matter if **small or large**! |
| 21 |
* Add live **sorting**, **pagination**, **searching**, and more interactivity for your site’s visitors! |
| 22 |
* Use any type of data, insert **images**, **links**, and even **math formulas**! |
| 23 |
* **Import** and **export** tables from/to Excel, CSV, HTML, and JSON files or URLs. |
| 24 |
* Embed tables into posts, pages, or other site areas using the block editor or Shortcodes. |
| 25 |
* All with **no coding knowledge needed**! |
| 26 |
|
| 27 |
Even **more great features** for you and your site’s visitors and **priority email support** are **available** with a Premium license plan of TablePress. [Go check them out!](https://tablepress.org/premium/?utm_source=wordpress.org&utm_medium=textlink&utm_content=readme) |
| 28 |
|
| 29 |
= More information = |
| 30 |
Visit [tablepress.org](https://tablepress.org/) for more information, take a look at [example tables](https://tablepress.org/demo/), or [try TablePress on a free test site](https://tablepress.org/demo/#try). For latest news, [follow @TablePress](https://twitter.com/TablePress) on Twitter/X or subscribe to the [TablePress Newsletter](https://tablepress.org/#newsletter). |
| 31 |
|
| 32 |
== Screenshots == |
| 33 |
|
| 34 |
1. "All Tables" screen |
| 35 |
2. "Edit" screen |
| 36 |
3. "Add new Table" screen |
| 37 |
4. "Import" screen |
| 38 |
5. "Export" screen |
| 39 |
6. "Plugin Options" screen |
| 40 |
7. "About" screen |
| 41 |
8. The “TablePress table” block in the block editor |
| 42 |
9. An example table (as it can be seen on the [TablePress website](https://tablepress.org/demo/)) |
| 43 |
|
| 44 |
== Installation == |
| 45 |
|
| 46 |
The easiest way to install TablePress is via your WordPress Dashboard: |
| 47 |
|
| 48 |
1. Go to the "Plugins" screen, click "Add New", and search for "TablePress" in the WordPress Plugin Directory. |
| 49 |
1. Click "Install Now" and after that's complete, click "Activate". |
| 50 |
1. Create and manage tables by going to the "TablePress" screen in the admin menu. |
| 51 |
1. To insert a table into a post or page, add a "TablePress table" block in the block editor and select the desired table or use Shortcodes with common page builders. |
| 52 |
|
| 53 |
Manual installation works just as for other WordPress plugins: |
| 54 |
|
| 55 |
1. [Download the TablePress ZIP file](https://downloads.wordpress.org/plugin/tablepress.latest-stable.zip). |
| 56 |
1. Go to the “Plugins“ screen on your site and upload it by clicking “Add New” → “Upload Plugin“. |
| 57 |
1. Or, extract the ZIP file and move the folder “tablepress“ to the “wp-content/plugins/“ directory of your WordPress installation, e.g. via FTP. |
| 58 |
1. Activate "TablePress" on the "Plugins" screen of your WordPress Dashboard. |
| 59 |
1. Create and manage tables by going to the "TablePress" screen in the admin menu. |
| 60 |
1. To insert a table into a post or page, add a "TablePress table" block in the block editor and select the desired table or use Shortcodes with common page builders. |
| 61 |
|
| 62 |
== Frequently Asked Questions == |
| 63 |
|
| 64 |
= Where can I find answers to Frequently Asked Questions? = |
| 65 |
Many questions, regarding different features or styling, have been answered on the [FAQ page](https://tablepress.org/faq/) and in the extensive [TablePress plugin documentation](https://tablepress.org/documentation/) on the TablePress website. |
| 66 |
|
| 67 |
= Support? = |
| 68 |
|
| 69 |
**Premium Support** |
| 70 |
|
| 71 |
Users with an active TablePress Premium license plan are eligible for Priority Email Support, directly from the plugin developer! [Find out more!](https://tablepress.org/premium/?utm_source=wordpress.org&utm_medium=textlink&utm_content=readme) |
| 72 |
|
| 73 |
**Community Support for users of the Free version** |
| 74 |
|
| 75 |
For support questions, bug reports, or feature requests, please use the [WordPress Support Forums](https://wordpress.org/support/plugin/tablepress/). Please search through the forums first, and only [create a new topic](https://wordpress.org/support/plugin/tablepress/#new-post) if you don't find an existing answer. Thank you! |
| 76 |
|
| 77 |
= Requirements? = |
| 78 |
In short: WordPress 6.2 or higher, while the latest version of WordPress is always recommended. In addition, the server must be running PHP 7.4 or newer. |
| 79 |
|
| 80 |
= Languages and Localization? = |
| 81 |
TablePress uses the ["Translate WordPress" platform](https://translate.wordpress.org/). Please see the sidebar on the TablePress page in the [WordPress Plugin Directory](https://wordpress.org/plugins/tablepress/) for available translations. |
| 82 |
|
| 83 |
To make TablePress available in your language, go to the [TablePress translations page](https://translate.wordpress.org/projects/wp-plugins/tablepress), log in with a free wordpress.org account and start translating. |
| 84 |
|
| 85 |
= Development = |
| 86 |
You can follow the development of TablePress more closely in its official [GitHub repository](https://github.com/TablePress/TablePress). |
| 87 |
|
| 88 |
= Where do I report security issues? = |
| 89 |
Please report security issues and bugs found in the source code of TablePress through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/tablepress). |
| 90 |
The Patchstack team will assist you with verification, CVE assignment, and notify the TablePress developer. |
| 91 |
|
| 92 |
= Where can I get more information? = |
| 93 |
Visit the plugin website at [tablepress.org](https://tablepress.org/) for the latest news on TablePress, [follow @TablePress](https://twitter.com/TablePress) on Twitter/X, or subscribe to the [TablePress Newsletter](https://tablepress.org/#newsletter). |
| 94 |
|
| 95 |
== How to use TablePress == |
| 96 |
|
| 97 |
After installing the plugin, you can create and manage tables on the "TablePress" screen in the WordPress Dashboard. |
| 98 |
|
| 99 |
To insert a table into a post or page, add a "TablePress table" block in the block editor and select the desired table or use Shortcodes with common page builders. |
| 100 |
|
| 101 |
Beginner-friendly step-by-step [tutorials, guides, and how-tos](https://tablepress.org/tutorials/) show how to achieve common and popular tasks with TablePress. |
| 102 |
Examples for common styling changes via "Custom CSS" code can be found on the [TablePress FAQ page](https://tablepress.org/faq/). |
| 103 |
You may also add certain features (like sorting, pagination, filtering, alternating row colors, row highlighting, print name and/or description, ...) by enabling the corresponding checkboxes on a table's "Edit" screen. |
| 104 |
|
| 105 |
**Even more great features for you and your site’s visitors and priority email support are available with a Premium license plan of TablePress. [Go check them out!](https://tablepress.org/premium/?utm_source=wordpress.org&utm_medium=textlink&utm_content=readme)** |
| 106 |
|
| 107 |
== Changelog == |
| 108 |
|
| 109 |
Changes in recent versions are shown below. For earlier changes, please see the [changelog history](https://tablepress.org/info/#changelog). |
| 110 |
|
| 111 |
= Version 3.0.4 (February 20, 2025) = |
| 112 |
|
| 113 |
* Improvement: The “Custom Commands” text field on the “Edit” screen will now automatically resize when working with longer commands. |
| 114 |
* Bugfix: The “Ctrl/cmd+E” keyboard shortcut for the “Advanced Editor” on the “Edit” screen no longer loses edits that were made before pressing the keyboard shortcut. |
| 115 |
* Bugfix: When saving styling changes made via the “Default Style Customizer”, the required “Load this ‘Custom CSS’ code to change the table styling” setting will be turned on. (TablePress Pro and Max only.) |
| 116 |
* Bugfix: The styling of header cells in the table body is now correct, when using the “Responsive Tables” feature module’s “Flip” mode. (TablePress Pro and Max only.) |
| 117 |
* Several external code libraries and build tools have been updated to benefit from enhancements and bug fixes. |
| 118 |
* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. |
| 119 |
|
| 120 |
= Version 3.0.3 (January 27, 2025) = |
| 121 |
|
| 122 |
* Several external code libraries and build tools have been updated to benefit from enhancements and bug fixes. |
| 123 |
* Bugfix: Ensure that the table exists in the DOM before trying to work with it, when using the “Individual Column Filtering” feature module. (TablePress Pro and Max only.) |
| 124 |
* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. |
| 125 |
|
| 126 |
= Version 3.0.2 (January 8, 2025) = |
| 127 |
|
| 128 |
* Bugfix: The “TablePress table” block in the WordPress Block Editor will properly show the table preview again, when using a non-block theme. |
| 129 |
* Bugfix: Prevent an error in the integration into the WordPress Export feature when using the WP-CLI command line tool. |
| 130 |
* Several external code libraries and build tools have been updated to benefit from enhancements and bug fixes. |
| 131 |
* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. |
| 132 |
|
| 133 |
= Version 3.0.1 (November 25, 2024) = |
| 134 |
|
| 135 |
* Bugfix: The loading of CSS style files when using non-block themes is now working properly again. |
| 136 |
* Bugfix: The JavaScript file for the "Table Features for Site Visitors" is no longer loaded when it's not needed. |
| 137 |
* Bugfix: The table width is correct again, when using the "Responsive Tables" module's "Scroll" mode. (TablePress Pro and Max only.) |
| 138 |
* Improvement: Potentially corrupt table settings are detected more reliably during the update process. |
| 139 |
* Improved support for PHP 8.4. |
| 140 |
* Several external code libraries and build tools have been updated to benefit from enhancements and bug fixes. |
| 141 |
|
| 142 |
= Version 3.0 (November 19, 2024) = |
| 143 |
|
| 144 |
TablePress 3.0 is a major feature update. Besides a new plugin logo and modernized admin screens, here are the highlights. |
| 145 |
Important: Note the list of changes that might require manual adjustments after updating TablePress on your site! |
| 146 |
|
| 147 |
**Heavily Improved Frontend Table Rendering** |
| 148 |
|
| 149 |
* When using a block theme on the site, CSS style files are only loaded if they are needed, to drastically improve the loading speed! |
| 150 |
* You can how have table headers with more than one row and with connected cells! |
| 151 |
* Tables are more accessible for visitors with disabilities or that use assistive technologies and easier to use with keyboard navigation! |
| 152 |
* Improved search for site visitors, like support of ! for negation as well as accents and diacritics. |
| 153 |
* The sorting allows returning to the unsorted order. |
| 154 |
* Control elements for filtering and pagination are now responsive, for superior look on small screens. |
| 155 |
* A new default pagination style makes it easier to navigate in long tables. |
| 156 |
* Automatic right alignment for numbers/dates can be turned on. |
| 157 |
* An improved automatic detection of date formats can be activated. |
| 158 |
|
| 159 |
**New Premium Feature Modules** |
| 160 |
|
| 161 |
* **Table Layout** |
| 162 |
* Easily customize the layout and position of features around your tables. |
| 163 |
* **Advanced Pagination Settings** |
| 164 |
* Customize the pagination settings of your tables. |
| 165 |
* **Inverted Filtering** |
| 166 |
* Turn the filtering into a search and hide tables if no search term is entered. |
| 167 |
|
| 168 |
**Many New Features and Enhancements for Existing Premium Features** |
| 169 |
|
| 170 |
* **Default Style Customizer** |
| 171 |
* You can now change colors for premium features with ease! |
| 172 |
* **Fixed Columns** |
| 173 |
* Fixed columns have a clearer separation from scrolling columns! |
| 174 |
* **Individual Column Filter** |
| 175 |
* Filters will be shown in an extra header or footer row! |
| 176 |
* An option to configure which columns get a filter control was added! |
| 177 |
* **Automatic Periodic Table Import**: |
| 178 |
* A "Run now" button allows triggering imports outside of the configured schedule. |
| 179 |
* E-Mail error notifications: TablePress can now notify the site admin if an import fails! |
| 180 |
* **Row Highlighting and Cell Highlighting** |
| 181 |
* The highlight term can now be provided via a URL parameter! |
| 182 |
* **Server-side Processing** |
| 183 |
* Added caching support for POST requests |
| 184 |
* Added compatibility with the "Automatic Filtering" feature module and the "Input" field mode of the "Individual Column Filtering" feature module. |
| 185 |
|
| 186 |
**Changes that Might Require Adjustments (Backwards-compatibility Breaks)** |
| 187 |
|
| 188 |
* Some outdated and retired TablePress Extensions will no longer work! [Read more!](https://tablepress.org/upgrade-extensions/?utm_source=wordpress.org&utm_medium=textlink&utm_content=readme) |
| 189 |
* The new structure of the table controls might require adjustments in your “Custom CSS” code! |
| 190 |
* The CSS code for "Alternating Row Colors" has changed! |
| 191 |
* The CSS code for changing colors of actively sorted-on column header cells has changed. |
| 192 |
* The sorting arrow icons look slightly different now — but are loaded faster. |
| 193 |
* The default pagination type now shows numbers in addition to left/right arrow icons, which also don’t show the “Previous”/”Next” texts anymore! |
| 194 |
|
| 195 |
**Behind the scenes** |
| 196 |
|
| 197 |
* **TablePress 3.0 requires WordPress 6.2 and PHP 7.4.** |
| 198 |
* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. |
| 199 |
* Updated external libraries to benefit from enhancements and bug fixes. |
| 200 |
* Automated code compatibility checks and build tools simplify chores for easier development. |
| 201 |
* Support for PHP 8.4. |
| 202 |
* Full compatibility with WordPress 6.7. |
| 203 |
|
| 204 |
**Premium versions** |
| 205 |
|
| 206 |
* Even more great features for you and your site’s visitors and priority email support are available with a Premium license plan of TablePress. [Go check them out!](https://tablepress.org/premium/?utm_source=wordpress.org&utm_medium=textlink&utm_content=readme) |
| 207 |
|
| 208 |
== Upgrade Notice == |
| 209 |
|
| 210 |
= 3.0.4 = |
| 211 |
This update is a stability, maintenance, and compatibility release. Updating is highly recommended. |
| 212 |
|
| 213 |
= 3.0 = |
| 214 |
This update is a major feature, stability, maintenance, and compatibility release. Updating is highly recommended after reading the release announcement! |
| 215 |
|
