| @@ -1,26 +1,54 @@ | ||
| 1 | -=== TablePress === | |
| 1 | +=== TablePress - Tables in WordPress made easy === | |
| 2 | 2 | Contributors: TobiasBg |
| 3 | -Donate link: https://tablepress.org/donate/ | |
| 4 | -Tags: table,spreadsheet,data,csv,excel,html,tables | |
| 5 | -Requires at least: 5.8 | |
| 6 | -Requires PHP: 5.6.20 | |
| 7 | -Tested up to: 6.1 | |
| 8 | -Stable tag: 2.0.4 | |
| 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.7 | |
| 6 | +Requires PHP: 7.4 | |
| 7 | +Tested up to: 7.1 | |
| 8 | +Stable tag: 3.4 | |
| 9 | 9 | License: GPLv2 |
| 10 | 10 | License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 11 | 11 | |
| 12 | -Embed beautiful and feature-rich tables into your posts and pages, without having to write code. | |
| 12 | +Embed beautiful, accessible, and interactive tables into your WordPress website’s posts and pages, without having to write code! | |
| 13 | 13 | |
| 14 | 14 | == Description == |
| 15 | 15 | |
| 16 | -TablePress is the most popular and highest rated WordPress table plugin. It allows you to easily create and manage beautiful tables on your website. You can embed the tables into posts, pages, or other site areas using a block in the block editor. Table data can be edited in a spreadsheet-like interface, without any coding. Tables can contain any type of data, even math formulas that will be evaluated. Additional features like sorting, pagination, and filtering make it easy for site visitors to interact with the table data. Tables can be imported and exported from/to Excel, CSV, HTML, and JSON files. | |
| 16 | +**Boost your website with feature-rich tables that your visitors will love!** | |
| 17 | 17 | |
| 18 | -**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/)** | |
| 18 | +TablePress is the most popular and highest-rated WordPress table plugin. | |
| 19 | 19 | |
| 20 | +* Easily create, edit, and manage **beautiful and modern** data tables, from simple **price lists** to searchable **directories, product and model tables, inventories, schedules**, and research datasets. | |
| 21 | +* Add live **sorting**, **pagination**, **searching**, and other interactive features that help visitors find what they’re looking for on any device. | |
| 22 | +* Use any type of data and enrich your tables with **images**, **links**, and even **math formulas**. | |
| 23 | +* **Import** and **export** tables from/to **Excel**, CSV, HTML, and JSON files or URLs, including spreadsheet data from **Google Sheets**, **Excel Online**, and files stored on **Dropbox** or **OneDrive**. | |
| 24 | +* Embed tables into posts, pages, or other site areas using the block editor, an Elementor widget, 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 | += Common use cases = | |
| 30 | + | |
| 31 | +TablePress will handle a wide range of tables, from simple price lists to searchable directories and large datasets. Popular examples include: | |
| 32 | + | |
| 33 | +* Product and model tables | |
| 34 | +* Service and price lists | |
| 35 | +* Directories and listings | |
| 36 | +* Schedules and timetables | |
| 37 | +* Participant and member lists | |
| 38 | +* Inventories and collections | |
| 39 | +* Comparison tables | |
| 40 | +* Research and statistical data | |
| 41 | + | |
| 42 | += Accessible and SEO-friendly tables = | |
| 43 | + | |
| 44 | +TablePress creates accessible HTML tables whose content can be searched by visitors, WordPress search, and search engines alike. Interactive features like sorting, filtering, and pagination include accessibility enhancements for screen readers and other assistive technologies. | |
| 45 | +This makes it easy for visitors to find relevant information, whether they are browsing a large directory, searching a product table, or using your site’s search function. | |
| 46 | + | |
| 20 | 47 | = More information = |
| 21 | -Visit the plugin website at [tablepress.org](https://tablepress.org/) for more information, take a look at [example tables](https://tablepress.org/demo/), or [check out TablePress on a free test site](https://tablepress.org/demo/#try). For latest news, [follow @TablePress](https://twitter.com/TablePress) on Twitter. | |
| 22 | 48 | |
| 49 | +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). | |
| 50 | + | |
| 23 | 51 | == Screenshots == |
| 24 | 52 | |
| 25 | 53 | 1. "All Tables" screen |
| 26 | 54 | 2. "Edit" screen |
| @@ -29,39 +57,39 @@ | ||
| 29 | 57 | 5. "Export" screen |
| 30 | 58 | 6. "Plugin Options" screen |
| 31 | 59 | 7. "About" screen |
| 32 | 60 | 8. The “TablePress table” block in the block editor |
| 33 | -9. An example table (as it can be seen on the [TablePress website](https://tablepress.org/demo/)) | |
| 61 | +9. An example table as shown on a frontend page | |
| 34 | 62 | |
| 35 | 63 | == Installation == |
| 36 | 64 | |
| 37 | 65 | The easiest way to install TablePress is via your WordPress Dashboard: |
| 38 | 66 | |
| 39 | -1. Go to the "Plugins" screen, click "Add New", and search for "TablePress" in the WordPress Plugin Directory. | |
| 67 | +1. Go to the "Plugins" screen, click "Add Plugin", and search for "TablePress" in the WordPress Plugin Directory. | |
| 40 | 68 | 1. Click "Install Now" and after that's complete, click "Activate". |
| 41 | 69 | 1. Create and manage tables by going to the "TablePress" screen in the admin menu. |
| 42 | -1. To insert a table into a post or page, add a "TablePress table" block in the block editor and select the desired table. | |
| 43 | -1. You can change the table styling by using CSS code, which can be entered into the "Custom CSS" textarea on the "Plugin Options" screen. | |
| 70 | +1. To insert a table into a post or page, add a "TablePress table" block in the block editor or a widget in the Elementor page builder and select the desired table or use Shortcodes with other page builders. | |
| 44 | 71 | |
| 45 | 72 | Manual installation works just as for other WordPress plugins: |
| 46 | 73 | |
| 47 | -1. [Download](https://downloads.wordpress.org/plugin/tablepress.latest-stable.zip) and extract the ZIP file. | |
| 48 | -1. Move the folder "tablepress" to the "wp-content/plugins/" directory of your WordPress installation, e.g. via FTP. | |
| 49 | -1. Activate the plugin "TablePress" on the "Plugins" screen of your WordPress Dashboard. | |
| 74 | +1. [Download the TablePress ZIP file](https://downloads.wordpress.org/plugin/tablepress.latest-stable.zip). | |
| 75 | +1. Go to the “Plugins” screen on your site and upload it by clicking “Add Plugin” → “Upload Plugin”. | |
| 76 | +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. | |
| 77 | +1. Activate "TablePress" on the "Plugins" screen of your WordPress Dashboard. | |
| 50 | 78 | 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. | |
| 52 | -1. You can change the table styling by using CSS code, which can be entered into the "Custom CSS" textarea on the "Plugin Options" screen. | |
| 79 | +1. To insert a table into a post or page, add a "TablePress table" block in the block editor or a widget in the Elementor page builder and select the desired table or use Shortcodes with other page builders. | |
| 53 | 80 | |
| 54 | 81 | == Frequently Asked Questions == |
| 55 | 82 | |
| 56 | 83 | = Where can I find answers to Frequently Asked Questions? = |
| 57 | -Many questions, regarding different features or styling, have been answered on the [FAQ page](https://tablepress.org/faq/) on the plugin website. | |
| 58 | 84 | |
| 85 | +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. | |
| 86 | + | |
| 59 | 87 | = Support? = |
| 60 | 88 | |
| 61 | 89 | **Premium Support** |
| 62 | 90 | |
| 63 | -Users with a valid TablePress Premium license plan are eligible for Priority Email Support, directly from the plugin developer! [Find out more!](https://tablepress.org/premium/) | |
| 91 | +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) | |
| 64 | 92 | |
| 65 | 93 | **Community Support for users of the Free version** |
| 66 | 94 | |
| 67 | 95 | 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! |
| @@ -66,132 +94,80 @@ | ||
| 66 | 94 | |
| 67 | 95 | 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! |
| 68 | 96 | |
| 69 | 97 | = Requirements? = |
| 70 | -In short: WordPress 5.8 or higher, while the latest version of WordPress is always recommended. | |
| 71 | 98 | |
| 99 | +In short: WordPress 6.7 or higher, while the latest version of WordPress is always recommended. In addition, the server must be running PHP 7.4 or newer. | |
| 100 | + | |
| 72 | 101 | = Languages and Localization? = |
| 102 | + | |
| 73 | 103 | 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. |
| 74 | 104 | |
| 75 | 105 | 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. |
| 76 | 106 | |
| 77 | 107 | = Development = |
| 108 | + | |
| 78 | 109 | You can follow the development of TablePress more closely in its official [GitHub repository](https://github.com/TablePress/TablePress). |
| 79 | 110 | |
| 80 | -= Where can I get more information? = | |
| 81 | -Visit the plugin website at [tablepress.org](https://tablepress.org/) for the latest information on TablePress or [follow @TablePress](https://twitter.com/TablePress) on Twitter. | |
| 111 | += Where do I report security issues? = | |
| 82 | 112 | |
| 83 | -== Usage == | |
| 113 | +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). | |
| 114 | +The Patchstack team will assist you with verification, CVE assignment, and notify the TablePress developer. | |
| 84 | 115 | |
| 85 | -After installing the plugin, you can create and manage tables on the "TablePress" screen in the WordPress Dashboard. | |
| 116 | += Where can I get more information? = | |
| 86 | 117 | |
| 87 | -To insert a table into a post or page, add a "TablePress table" block in the block editor and select the desired table. | |
| 118 | +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). | |
| 88 | 119 | |
| 89 | -Examples for common styling changes via "Custom CSS" code can be found on the [TablePress FAQ page](https://tablepress.org/faq/). | |
| 90 | -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. | |
| 120 | +== How to use TablePress == | |
| 91 | 121 | |
| 92 | -**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/)** | |
| 122 | +After installing the plugin, you can create and manage tables on the "TablePress" screen in the WordPress Dashboard. | |
| 93 | 123 | |
| 94 | -== License == | |
| 124 | +To insert a table into a post or page, add a "TablePress table" block in the block editor or a widget in the Elementor page builder and select the desired table or use Shortcodes with other page builders. | |
| 95 | 125 | |
| 96 | -This plugin is Free Software, released and licensed under the [GPL, version 2](https://www.gnu.org/licenses/gpl-2.0.html). You may use it free of charge for any purpose. | |
| 126 | +Beginner-friendly step-by-step [tutorials, guides, and how-tos](https://tablepress.org/tutorials/) show how to achieve common and popular tasks with TablePress. | |
| 127 | +You can find examples for common styling changes via “Custom CSS” code on the [TablePress FAQ page](https://tablepress.org/faq/). | |
| 128 | +You may also add features like sorting, pagination, searching, filtering, alternating row colors, row highlighting, and more by enabling the corresponding options on a table’s “Edit” screen. | |
| 97 | 129 | |
| 98 | -== Changelog == | |
| 130 | +== Premium features == | |
| 99 | 131 | |
| 100 | -Recent changes are shown below. For earlier changes, please see the [changelog history](https://tablepress.org/info/#changelog). | |
| 132 | +Need additional functionality for larger tables or advanced use cases? Premium license plans for TablePress add features such as: | |
| 101 | 133 | |
| 102 | -= Version 2.0.4 = | |
| 134 | +* Options for responsive tables | |
| 135 | +* Advanced filtering and search | |
| 136 | +* Fixed table headers and columns | |
| 137 | +* Automatic periodic imports | |
| 138 | +* Custom styling options | |
| 139 | +* And much more | |
| 103 | 140 | |
| 104 | -TablePress 2.0.4 fixes a few bugs and brings some nice enhancements. For more information on changes and new features in TablePress 2.x, please see below. | |
| 141 | +Priority email support is also included. [Check out the details on the TablePress website.](https://tablepress.org/premium/?utm_source=wordpress.org&utm_medium=textlink&utm_content=readme) | |
| 105 | 142 | |
| 106 | -* The “Table” button for users that don’t use the WordPress block editor is back! | |
| 107 | -* Issues that some users had with saving changes on the “Edit” screen are fixed. | |
| 108 | -* No errors should be thrown anymore when required PHP extensions are missing on a server when importing files. | |
| 109 | -* Visual glitches in the Horizontal Scrolling, caused by themes adding conflicting CSS, are reduced. | |
| 110 | -* The “Automatic Filtering” feature now allows retrieving the filter term from a URL parameter. (TablePress Pro and Max only.) | |
| 111 | -* A backwards compatibility improvement was added to the “Individual Column Filtering” feature. (TablePress Pro and Max only.) | |
| 112 | -* The “Server-side Processing” feature now uses much shorter request URL which improves performance and prevents possible server errors. (TablePress Max only.) | |
| 113 | -* Some internal documentation and build tools were updated. | |
| 143 | +== Changelog == | |
| 114 | 144 | |
| 115 | -TablePress 2.0.3 contains these changes: | |
| 145 | +Changes in recent versions are shown below. For earlier changes, please see the [changelog history](https://tablepress.org/info/#changelog). | |
| 116 | 146 | |
| 117 | -* The “Edit” screen now has context menu entries and supports Ctrl/Cmd + Alt/option + Shift + ↑/↓/←/→ keyboard shortcuts for moving the currently selected rows to the top or bottom, or the currently selected columns to the left or right edge. | |
| 118 | -* On the “Edit” screen, it's now easier to drag and drop rows and columns with the mouse, as the clickable regions are now bigger. | |
| 119 | -* On the “Edit” screen, the cell height was reduced, so that more content fits on the screen. | |
| 120 | -* The “Edit” screen now properly supports copying and pasting of content that contains quotation marks. | |
| 121 | -* The “Show Shortcode” link on the “All tables” screen, often used for copy and paste, is back! | |
| 122 | -* The automatic format detection of the file import is more robust, especially when importing CSV files. | |
| 123 | -* TablePress better protects itself against conflicts caused by other plugins that use outdated versions of the Composer tool. | |
| 124 | -* An error where tables could not be saved was fixed. (TablePress Pro and Max only.) | |
| 125 | -* The Column Filter Dropdowns module now properly deals with & characters and HTML code in cells, and applies better sorting to the selectable options. (TablePress Pro and Max only.) | |
| 147 | += Version 3.4 (September 30, 2026) = | |
| 126 | 148 | |
| 127 | -TablePress 2.0.2 contains these changes: | |
| 149 | +TablePress 3.4 is a feature, stability, maintenance, and compatibility update. Here are the highlights: | |
| 128 | 150 | |
| 129 | -* The “Edit” screen now supports Ctrl/Cmd + L/I/E keyboard shortcuts for the “Insert Link”, “Insert Image”, and “Advanced Editor” buttons, respectively. | |
| 130 | -* The “Edit” screen now supports Ctrl/Cmd + Shift + ↑/↓/←/→ keyboard shortcuts for moving the currently selected rows up or down, or the currently selected columns left or right. | |
| 131 | -* An error where tables could not be saved was fixed. (TablePress Pro and Max only.) | |
| 132 | -* The Fixed Columns module now properly shows multiple fixed columns. (TablePress Pro and Max only.) | |
| 133 | -* The integration of the Automatic Periodic Table Import module was fixed. (TablePress Max only.) | |
| 151 | +**New Table Editor Toolbar on the “Edit” Screen** | |
| 134 | 152 | |
| 135 | -TablePress 2.0.1 contains these changes: | |
| 153 | +The new Table Editor Toolbar makes all editing features available right where you need them. Your mouse’s scroll wheel can rest easy now: Gone are the days of going back and forth between the Table Content and Table Manipulation sections. We already can’t imagine living without it. | |
| 136 | 154 | |
| 137 | -* TablePress will again work correctly when it's “network activated” on WordPress Multisite installations. | |
| 138 | -* Issues that some users had with saving changes on the “Edit” screen are fixed. | |
| 139 | -* The misalignment between head and body rows when using “Horizontal Scrolling” is fixed. | |
| 140 | -* The vertical alignment of elements in table cells is back to its old behavior, due to issues in some themes. | |
| 141 | -* No errors should be thrown anymore when the “Table Features for Site Visitors” are active for tables that have combined cells or no head row. | |
| 142 | -* The “Shortcode” text field, often used for copy and paste, on the “Edit” screen is back! | |
| 143 | -* More valuable information about errors is given when a table import fails. | |
| 144 | -* An issue with the sorting arrow icons showing as weird characters is fixed. | |
| 145 | -* No errors should be thrown anymore when required PHP extensions are missing on a server when evaluating math formulas. | |
| 155 | +* The toolbar will stick to the top of the screen so that it’s always available when your table is in view. | |
| 156 | +* It also offers quick access to operations like Undo/Redo or Cut/Copy/Paste that have previously only been available through the right-click context menu. | |
| 157 | +* Hovering over a button shows its name and keyboard shortcut for even quicker editing! | |
| 146 | 158 | |
| 147 | -Besides a fresh and modern look of the TablePress screens, here are the highlights of TablePress 2.0: | |
| 159 | +**Behind the scenes** | |
| 148 | 160 | |
| 149 | -**Completely new “Edit” screen for tables** | |
| 161 | +* Various code modernizations, removal of outdated legacy code, and optimizations for better performance. | |
| 162 | +* Several minor bugs and inconsistencies have been fixed and improved! | |
| 163 | +* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. | |
| 164 | +* Several external code libraries and build tools have been updated to benefit from enhancements and bug fixes. | |
| 150 | 165 | |
| 151 | -* TablePress now has an even more spreadsheet-like user interface that makes working with large tables a breeze. | |
| 152 | -* Editing will be much faster: A right-click context menu allows for quick access to the table manipulation tools. | |
| 153 | -* A keyboard shortcut for saving changes will save a lot of scrolling. | |
| 154 | - | |
| 155 | -**Block editor support instead of having to deal with Shortcodes** | |
| 156 | - | |
| 157 | -* The new “TablePress table” block will give you a preview of the table when inserting it into a post or page, for a more intuitive embedding of tables. You won’t even have to remember the table ID, as a table search is included. | |
| 158 | -* And if you want, converting existing Shortcodes is just two clicks away. | |
| 159 | - | |
| 160 | -**Easier styling of tables with CSS variables** | |
| 161 | - | |
| 162 | -* You can now use CSS variables instead of complex CSS selectors for quicker and easier styling changes, in particular of table colors. | |
| 163 | -* The CSS selectors in the default CSS have been simplified for higher compatibility with more themes. | |
| 164 | - | |
| 165 | -**Importing tables is easier and more powerful than ever** | |
| 166 | - | |
| 167 | -* Simply drag&drop files to import them -- even multiple files at once, even of different formats! | |
| 168 | -* No more need to choose the import file format: The auto detection will know if it’s a CSV, Excel, HTML, or JSON file. | |
| 169 | -* In addition, more file formats are recognized, like the LibreOffice ODS format. | |
| 170 | -* The Excel import is much more powerful: For example, clickable links and simple styling will be recognized and imported! | |
| 171 | -* The Replace/Append select box also has a live-search with autocomplete now, making finding the right table much faster. | |
| 172 | - | |
| 173 | -**New formula calculation engine** | |
| 174 | - | |
| 175 | -* TablePress now understands many more formulas, just as you know them from Excel! | |
| 176 | -* The formulas even support text strings now, which enables many new ways of automatically creating table content. | |
| 177 | -* When exporting tables, potentially dangerous formulas will be escaped, to increase protection against CSV injection attacks. | |
| 178 | - | |
| 179 | 166 | **Premium versions** |
| 180 | 167 | |
| 181 | -* 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/) | |
| 168 | +* 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) | |
| 182 | 169 | |
| 183 | -**Behind the scenes** | |
| 184 | - | |
| 185 | -* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. | |
| 186 | -* Updated external libraries to benefit from enhancements and bug fixes. | |
| 187 | -* Automated code compatibility checks and build tools simplify chores for easier development. | |
| 188 | -* Support for PHP 8.1 and PHP 8.2. | |
| 189 | -* TablePress 2.0 requires WordPress 5.8. | |
| 190 | - | |
| 191 | 170 | == Upgrade Notice == |
| 192 | 171 | |
| 193 | -= 2.0.4 = | |
| 194 | -This update is a stability, maintenance, and compatibility release. Updating is highly recommended. | |
| 195 | - | |
| 196 | -= 2.0 = | |
| 197 | -This update is a major feature update that brings many cool and new things. Updating is highly recommended. | |
| 172 | += 3.4 = | |
| 173 | +This update is a feature, stability, maintenance, and compatibility release. Updating is highly recommended! | |
