| @@ -1,16 +1,16 @@ | ||
| 1 | 1 | === TablePress - Tables in WordPress made easy === |
| 2 | 2 | Contributors: TobiasBg |
| 3 | 3 | Donate link: https://tablepress.org/premium/?utm_source=wordpress.org&utm_medium=textlink&utm_content=donate-link |
| 4 | -Tags: table,spreadsheet,data,csv,excel,html,tables | |
| 5 | -Requires at least: 6.0 | |
| 6 | -Requires PHP: 7.2 | |
| 7 | -Tested up to: 6.4 | |
| 8 | -Stable tag: 2.2.4 | |
| 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 interactive tables into your WordPress website’s 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 | 16 | **Boost your website with feature-rich tables that your visitors will love!** |
| @@ -16,18 +16,37 @@ | ||
| 16 | 16 | **Boost your website with feature-rich tables that your visitors will love!** |
| 17 | 17 | |
| 18 | 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, 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. | |
| 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 | 25 | * All with **no coding knowledge needed**! |
| 26 | 26 | |
| 27 | 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 | 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 | + | |
| 29 | 47 | = More information = |
| 48 | + | |
| 30 | 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). |
| 31 | 50 | |
| 32 | 51 | == Screenshots == |
| 33 | 52 | |
| @@ -38,32 +57,34 @@ | ||
| 38 | 57 | 5. "Export" screen |
| 39 | 58 | 6. "Plugin Options" screen |
| 40 | 59 | 7. "About" screen |
| 41 | 60 | 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/)) | |
| 61 | +9. An example table as shown on a frontend page | |
| 43 | 62 | |
| 44 | 63 | == Installation == |
| 45 | 64 | |
| 46 | 65 | The easiest way to install TablePress is via your WordPress Dashboard: |
| 47 | 66 | |
| 48 | -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. | |
| 49 | 68 | 1. Click "Install Now" and after that's complete, click "Activate". |
| 50 | 69 | 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. | |
| 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. | |
| 52 | 71 | |
| 53 | 72 | Manual installation works just as for other WordPress plugins: |
| 54 | 73 | |
| 55 | -1. [Download the TablePress ZIP file](https://downloads.wordpress.org/plugin/tablepress.latest-stable.zip) and extract it on your computer. | |
| 56 | -1. Move the folder "tablepress" to the "wp-content/plugins/" directory of your WordPress installation, e.g. via FTP. | |
| 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. | |
| 57 | 77 | 1. Activate "TablePress" on the "Plugins" screen of your WordPress Dashboard. |
| 58 | 78 | 1. Create and manage tables by going to the "TablePress" screen in the admin menu. |
| 59 | -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. | |
| 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. | |
| 60 | 80 | |
| 61 | 81 | == Frequently Asked Questions == |
| 62 | 82 | |
| 63 | 83 | = Where can I find answers to Frequently Asked Questions? = |
| 64 | -Many questions, regarding different features or styling, have been answered on the [FAQ page](https://tablepress.org/faq/) on the TablePress website. | |
| 65 | 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 | + | |
| 66 | 87 | = Support? = |
| 67 | 88 | |
| 68 | 89 | **Premium Support** |
| 69 | 90 | |
| @@ -73,23 +94,28 @@ | ||
| 73 | 94 | |
| 74 | 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! |
| 75 | 96 | |
| 76 | 97 | = Requirements? = |
| 77 | -In short: WordPress 6.0 or higher, while the latest version of WordPress is always recommended. In addition, the server must be running PHP 7.2 or newer. | |
| 78 | 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 | + | |
| 79 | 101 | = Languages and Localization? = |
| 102 | + | |
| 80 | 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. |
| 81 | 104 | |
| 82 | 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. |
| 83 | 106 | |
| 84 | 107 | = Development = |
| 108 | + | |
| 85 | 109 | You can follow the development of TablePress more closely in its official [GitHub repository](https://github.com/TablePress/TablePress). |
| 86 | 110 | |
| 87 | 111 | = Where do I report security issues? = |
| 112 | + | |
| 88 | 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). |
| 89 | 114 | The Patchstack team will assist you with verification, CVE assignment, and notify the TablePress developer. |
| 90 | 115 | |
| 91 | 116 | = Where can I get more information? = |
| 117 | + | |
| 92 | 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). |
| 93 | 119 | |
| 94 | 120 | == How to use TablePress == |
| 95 | 121 | |
| @@ -94,81 +120,49 @@ | ||
| 94 | 120 | == How to use TablePress == |
| 95 | 121 | |
| 96 | 122 | After installing the plugin, you can create and manage tables on the "TablePress" screen in the WordPress Dashboard. |
| 97 | 123 | |
| 98 | -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. | |
| 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. | |
| 99 | 125 | |
| 100 | -Examples for common styling changes via "Custom CSS" code can be found on the [TablePress FAQ page](https://tablepress.org/faq/). | |
| 101 | -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. | |
| 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. | |
| 102 | 129 | |
| 103 | -**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)** | |
| 130 | +== Premium features == | |
| 104 | 131 | |
| 105 | -== Changelog == | |
| 132 | +Need additional functionality for larger tables or advanced use cases? Premium license plans for TablePress add features such as: | |
| 106 | 133 | |
| 107 | -Changes in recent versions are shown below. For earlier changes, please see the [changelog history](https://tablepress.org/info/#changelog). | |
| 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 | |
| 108 | 140 | |
| 109 | -= Version 2.2.4 (December 11, 2023) = | |
| 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) | |
| 110 | 142 | |
| 111 | -* The math formula calculation engine now properly handles quotation marks in text around embedded formulas. | |
| 112 | -* An issue with the block theme preview when using the Site Editor on multisite installations was fixed. | |
| 113 | -* Data consistency when saving tables is checked more thorougly. | |
| 114 | -* Forward-compatibility with PHP 8.3 was added, to benefit from new features. | |
| 115 | -* The extraction of error information for displaying error messages was improved. | |
| 116 | -* The loading of the Default Style Customizer was improved. (TablePress Pro and Max only.) | |
| 117 | -* The handling and loading of translation files was improved. (TablePress Pro and Max only.) | |
| 118 | -* The debugging capabilities for the “Automatic Periodic Table Import” feature module were improved. (TablePress Max only.) | |
| 119 | -* Updated external libraries to benefit from enhancements and bug fixes. | |
| 120 | -* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. | |
| 143 | +== Changelog == | |
| 121 | 144 | |
| 122 | -= Version 2.2.3 (November 13, 2023) = | |
| 145 | +Changes in recent versions are shown below. For earlier changes, please see the [changelog history](https://tablepress.org/info/#changelog). | |
| 123 | 146 | |
| 124 | -* Further protection against bugs in other plugins that interfere with the loading of JavaScript files, causing the TablePress admin screens to be unusable, was added. | |
| 125 | -* An issue where it was not possible to replace existing tables during an import was fixed. | |
| 126 | -* Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. | |
| 147 | += Version 3.4 (September 30, 2026) = | |
| 127 | 148 | |
| 128 | -= Version 2.2.2 (November 6, 2023) = | |
| 149 | +TablePress 3.4 is a feature, stability, maintenance, and compatibility update. Here are the highlights: | |
| 129 | 150 | |
| 130 | -* Further protection against bugs in other plugins that interfere with the loading of JavaScript files, causing the TablePress admin screens to be unusable, was added. | |
| 131 | -* The code that evaluates Shortcode parameters was optimized for a higher performance. | |
| 132 | -* The “Sorted” order of the “Row Order” premium feature module no longer raises an error. (TablePress Pro and Max only.) | |
| 133 | -* Updated external libraries to benefit from enhancements and bug fixes. | |
| 151 | +**New Table Editor Toolbar on the “Edit” Screen** | |
| 134 | 152 | |
| 135 | -= Version 2.2.1 (November 2, 2023)= | |
| 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 | -* Further protection against bugs in other plugins that interfere with the loading of JavaScript files, causing the TablePress admin screens to be unusable, was added. | |
| 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! | |
| 138 | 158 | |
| 139 | -= Version 2.2 (November 2, 2023)= | |
| 140 | - | |
| 141 | -**Improvements around table styling** | |
| 142 | - | |
| 143 | -* The preview of the TablePress table block in the block editor now takes into account “Custom CSS”, for a more precise preview. | |
| 144 | -* TablePress Pro and Max now have an **easy-to-use visual “Default Style Customizer”**: Choose from pre-defined style variations or define your own color scheme to change your tables’ default style -- without touching CSS code! | |
| 145 | - | |
| 146 | -**The “Responsive Tables” premium module offers more possibilities** | |
| 147 | - | |
| 148 | -* The “Modal” mode can show all table data in an overlay modal window if columns don’t fit on the screen. (TablePress Pro and Max only.) | |
| 149 | -* The “Scroll” mode now allows the visitor to scroll left and right by clicking arrow buttons. (TablePress Pro and Max only.) | |
| 150 | - | |
| 151 | -**Enhanced and more polished user interfaces** | |
| 152 | - | |
| 153 | -* The “Advanced Access Rights” module now has a fixed header row and offers a keyboard shortcut for saving changes. (TablePress Max only.) | |
| 154 | -* The “Automatic Periodic Table Import” module now has a fixed header row, filtering, and sorting, to make working with long table lists easier. (TablePress Max only.) | |
| 155 | -* In addition, the “Automatic Periodic Table Import” module now allows periodic imports with a 1-minute interval. (TablePress Max only.) | |
| 156 | - | |
| 157 | -**Miscellaneous changes** | |
| 158 | - | |
| 159 | -* The TablePress REST API now has “Create table” and “Delete table” endpoints and received optimizations and improvements. (TablePress Max only.) | |
| 160 | -* The spacing between dropdowns of the “Column Filter Dropdowns” module is more consistent across different screen sizes. (TablePress Pro and Max only.) | |
| 161 | -* The legacy math formula evaluation engine now also supports the % (modulo) operator. | |
| 162 | -* A bug in the import format detection of the legacy import engine was fixed. | |
| 163 | -* TablePress Pro and TablePress Max are now fully translated to German. | |
| 164 | - | |
| 165 | 159 | **Behind the scenes** |
| 166 | 160 | |
| 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! | |
| 167 | 163 | * Cleaned up and simplified code, for easier future maintenance, to follow WordPress Coding Standards, and to offer helpful inline documentation. |
| 168 | -* Updated external libraries to benefit from enhancements and bug fixes. | |
| 169 | -* Automated code compatibility checks and build tools simplify chores for easier development. | |
| 170 | -* **TablePress 2.2 requires WordPress 6.0 and PHP 7.2!** | |
| 164 | +* Several external code libraries and build tools have been updated to benefit from enhancements and bug fixes. | |
| 171 | 165 | |
| 172 | 166 | **Premium versions** |
| 173 | 167 | |
| 174 | 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) |
| @@ -174,9 +168,6 @@ | ||
| 174 | 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) |
| 175 | 169 | |
| 176 | 170 | == Upgrade Notice == |
| 177 | 171 | |
| 178 | -= 2.2.4 = | |
| 179 | -This update is a stability and maintenance release. Updating is highly recommended. | |
| 180 | - | |
| 181 | -= 2.2 = | |
| 182 | -This update is a feature, stability, maintenance, and compatibility release. Updating is highly recommended. | |
| 172 | += 3.4 = | |
| 173 | +This update is a feature, stability, maintenance, and compatibility release. Updating is highly recommended! | |
