PluginProbe
TablePress – Tables in WordPress made easy / 3.0
TablePress – Tables in WordPress made easy v3.0
3.3.4 3.3.3 3.3.2 3.3.1 trunk 1.12 1.14 1.9.2 2.0.4 2.1.7 2.1.8 2.2 2.2.1 2.2.2 2.2.3 2.2.4 2.2.5 2.3 2.3.1 2.3.2 2.4 2.4.1 2.4.2 2.4.3 2.4.4 All 44 releases
tablepress / views / view-list.php

view-list.php in TablePress – Tables in WordPress made easy 3.0, at views/view-list.php

407 lines 21.6 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 /**
3 * List Tables View
4 *
5 * @package TablePress
6 * @subpackage Views
7 * @author Tobias Bäthge
8 * @since 1.0.0
9 */
10
11 // Prohibit direct script loading.
12 defined( 'ABSPATH' ) || die( 'No direct script access allowed!' );
13
14 /**
15 * List Tables View class
16 *
17 * @package TablePress
18 * @subpackage Views
19 * @author Tobias Bäthge
20 * @since 1.0.0
21 */
22 class TablePress_List_View extends TablePress_View {
23
24 /**
25 * Object for the All Tables List Table.
26 *
27 * @since 1.0.0
28 */
29 protected \TablePress_All_Tables_List_Table $wp_list_table;
30
31 /**
32 * Set up the view with data and do things that are specific for this view.
33 *
34 * @since 1.0.0
35 *
36 * @param string $action Action for this view.
37 * @param array<string, mixed> $data Data for this view.
38 */
39 #[\Override]
40 public function setup( /* string */ $action, array $data ) /* : void */ {
41 // Don't use type hints in the method declaration to prevent PHP errors, as the method is inherited.
42
43 parent::setup( $action, $data );
44
45 add_thickbox(); // For the table preview.
46 $this->admin_page->enqueue_script( 'list' );
47
48 if ( $data['messages']['superseded_extensions'] ) {
49 $superseded_extensions = array(
50 'tablepress-advanced-access-rights/tablepress-advanced-access-rights.php' => array(
51 'name' => 'TablePress Extension: Advanced Access Rights',
52 'compatible' => true,
53 ),
54 'tablepress-auto-export-tables/tablepress-auto-export-tables.php' => array(
55 'name' => 'TablePress Extension: Automatic Table Export',
56 'compatible' => true,
57 ),
58 'tablepress-cell-highlighting/tablepress-cell-highlighting.php' => array(
59 'name' => 'TablePress Extension: Cell Highlighting',
60 'compatible' => true,
61 ),
62 'tablepress-datatables-alphabetsearch/tablepress-datatables-alphabetsearch.php' => array(
63 'name' => 'TablePress Extension: DataTables AlphabetSearch',
64 'compatible' => false,
65 ),
66 'tablepress-datatables-buttons/tablepress-datatables-buttons.php' => array(
67 'name' => 'TablePress Extension: DataTables Buttons',
68 'compatible' => true,
69 ),
70 'tablepress-datatables-column-filter-widgets/tablepress-datatables-column-filter-widgets.php' => array(
71 'name' => 'TablePress Extension: DataTables ColumnFilterWidgets',
72 'compatible' => false,
73 ),
74 'tablepress-datatables-columnfilter/tablepress-datatables-columnfilter.php' => array(
75 'name' => 'TablePress Extension: DataTables Column Filter',
76 'compatible' => false,
77 ),
78 'tablepress-datatables-counter-column/tablepress-datatables-counter-column.php' => array(
79 'name' => 'TablePress Extension: DataTables Counter Column',
80 'compatible' => true,
81 ),
82 'tablepress-datatables-fixedcolumns/tablepress-datatables-fixedcolumns.php' => array(
83 'name' => 'TablePress Extension: DataTables FixedColumns',
84 'compatible' => false,
85 ),
86 'tablepress-datatables-fixedheader/tablepress-datatables-fixedheader.php' => array(
87 'name' => 'TablePress Extension: DataTables FixedHeader',
88 'compatible' => true,
89 ),
90 'tablepress-datatables-row-details/tablepress-datatables-row-details.php' => array(
91 'name' => 'TablePress Extension: DataTables Row Details',
92 'compatible' => false,
93 ),
94 'tablepress-datatables-rowgroup/tablepress-datatables-rowgroup.php' => array(
95 'name' => 'TablePress Extension: DataTables RowGroup',
96 'compatible' => false,
97 ),
98 'tablepress-responsive-tables/tablepress-responsive-tables.php' => array(
99 'name' => 'TablePress Extension: Responsive Tables',
100 'compatible' => false,
101 ),
102 'tablepress-row-filter/tablepress-row-filter.php' => array(
103 'name' => 'TablePress Extension: Row Filtering',
104 'compatible' => true,
105 ),
106 'tablepress-row-highlighting/tablepress-row-highlighting.php' => array(
107 'name' => 'TablePress Extension: Row Highlighting',
108 'compatible' => true,
109 ),
110 'tablepress-table-auto-update/tablepress-table-auto-update.php' => array(
111 'name' => 'TablePress Extension: Table Auto Update',
112 'compatible' => true,
113 ),
114 'tablepress-table-column-order/tablepress-table-column-order.php' => array(
115 'name' => 'TablePress Extension: Table Column Order',
116 'compatible' => true,
117 ),
118 );
119
120 $active_compatible_superseded_extensions = array();
121 $active_incompatible_superseded_extensions = array();
122 foreach ( $superseded_extensions as $plugin => $extension ) {
123 if ( is_plugin_active( $plugin ) ) {
124 if ( $extension['compatible'] ) {
125 $active_compatible_superseded_extensions[] = $extension['name'];
126 } else {
127 $active_incompatible_superseded_extensions[] = $extension['name'];
128 }
129 }
130 }
131
132 /*
133 * If no superseded extensions are used, hide the message, to prevent running the checks on every load of the view.
134 * This leaves a small risk of an Extension being activated later, but that's acceptable as they are no longer publicly available.
135 */
136 if ( empty( $active_incompatible_superseded_extensions ) && ( empty( $active_compatible_superseded_extensions ) || ! tb_tp_fs()->is_free_plan() ) ) {
137 TablePress::$model_options->update( 'message_superseded_extensions', false );
138 }
139
140 $message = '';
141
142 $notice_css_classes = 'not-dismissible';
143
144 if ( ! empty( $active_incompatible_superseded_extensions ) ) {
145 $notice_css_classes .= ' notice-error notice-large';
146
147 $message .= '<p style="font-size:16px;">' . __( 'You are using <strong>TablePress Extension plugins</strong> on this website that have been retired more than 2 years ago.', 'tablepress' ) . '<br>' . __( 'For technical reasons, some or all features of these outdated plugins <strong>do no longer work with TablePress 3</strong>:', 'tablepress' ) . '</p>';
148 $message .= '<ul style="list-style:disc;margin:0.5em 1em;font-size:16px;">';
149 foreach ( $active_incompatible_superseded_extensions as $extension ) {
150 $message .= '<li>' . esc_html( $extension ) . '</li>';
151 }
152 $message .= '</ul>';
153 $message .= '<p style="font-size:16px;"><strong>' . __( 'Keeping them activated can lead to errors on your website.', 'tablepress' ) . '</strong></p>';
154
155 if ( tb_tp_fs()->is_free_plan() ) {
156 $message .= '<p style="font-size:16px;"><strong>' . sprintf( __( 'To continue using these features, <a href="%s">upgrade to a TablePress Premium license plan</a>!', 'tablepress' ), 'https://tablepress.org/upgrade-extensions/?utm_source=plugin&utm_medium=textlink&utm_content=superseded-extensions-message' ) . '</strong><br>'
157 . __( 'TablePress Pro and TablePress Max come with updated and heavily improved versions of these features and include direct priority email support.', 'tablepress' ) . '</p>';
158 }
159
160 if ( ! empty( $active_compatible_superseded_extensions ) && tb_tp_fs()->is_free_plan() ) {
161 $message .= '<p style="margin-top:1em;font-size:14px;">' . __( 'In addition, these TablePress Extension plugins have been retired and might become incompatible in the future as well:', 'tablepress' ) . '</strong></p>';
162 $message .= '<ul style="list-style:disc;margin:0.5em 1em;font-size:14px;">';
163 foreach ( $active_compatible_superseded_extensions as $extension ) {
164 $message .= '<li>' . esc_html( $extension ) . '</li>';
165 }
166 $message .= '</ul>';
167 }
168 } elseif ( ! empty( $active_compatible_superseded_extensions ) && tb_tp_fs()->is_free_plan() ) {
169 $notice_css_classes .= ' notice-warning notice-alt';
170
171 $message .= '<p style="font-size:14px;"><strong>' . __( 'You are using TablePress Extension plugins on this website that have been retired and will no longer receive updates or support:', 'tablepress' ) . '</strong></p>';
172 $message .= '<ul style="list-style:disc;margin:0.5em 1em;">';
173 foreach ( $active_compatible_superseded_extensions as $extension ) {
174 $message .= '<li>' . esc_html( $extension ) . '</li>';
175 }
176 $message .= '</ul>';
177 $message .= '<p style="font-size:14px;"><strong>' . __( 'It is possible that these become incompatible with TablePress or WordPress in the future!', 'tablepress' ) . '</strong></p>';
178 $message .= '<p style="margin-top:1em;font-size:14px;">' . sprintf( __( 'However, their features were heavily improved and are now part of the up-to-date <a href="%s">TablePress Premium versions</a>!', 'tablepress' ), 'https://tablepress.org/upgrade-extensions/?utm_source=plugin&utm_medium=textlink&utm_content=superseded-extensions-message' ) . '</p>';
179 }
180
181 if ( '' !== $message ) {
182 if ( tb_tp_fs()->is_free_plan() ) {
183 $message .= '<p style="font-size:16px;margin-top:1.5em;"><strong>' . __( 'Upgrade to a TablePress Premium license plan now and get:', 'tablepress' ) . '</strong></p>';
184 $message .= '<ul style="list-style:disc;margin:0.5em 1em;font-size:16px;">';
185 $message .= '<li>' . __( 'Updated and heavily improved versions of these features!', 'tablepress' ) . '</li>';
186 $message .= '<li>' . __( 'Direct integration into the user interface!', 'tablepress' ) . '</li>';
187 $message .= '<li>' . __( 'Regular updates that ensure compatibility with WordPress!', 'tablepress' ) . '</li>';
188 $message .= '<li>' . __( 'Priority email support!', 'tablepress' ) . '</li>';
189 $message .= '</ul>';
190 $message .= '<p style="font-size:16px;"><strong>' . sprintf( __( 'And the best: %s', 'tablepress' ), sprintf( __( 'Use the promo code %1$s during the checkout process for a special offer!', 'tablepress' ), '<code>UPGRADE</code>' ) ) . '</strong></p>';
191 $message .= '<p style="margin-top:2em;">' . sprintf( '<a href="%s" class="components-button is-primary" style="font-size:14px;margin-right:3em;background:linear-gradient(135deg,#00d184 0%%,#0791e3 100%%);border:none;font-weight:bold;">%s<span class="dashicons dashicons-arrow-right-alt" style="vertical-align:middle;margin:0 0 4px 4px"></span></a>', 'https://tablepress.org/upgrade-extensions/?utm_source=plugin&utm_medium=button&utm_content=superseded-extensions-message', __( 'Upgrade to a TablePress Premium version now!', 'tablepress' ) );
192 }
193 $message .= $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'superseded_extensions', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '</p>';
194
195 $title = '<em>' . __( 'Important Notice!', 'tablepress' ) . '</em>';
196
197 $this->add_header_message( $message, $notice_css_classes, $title );
198 }
199 }
200
201 if ( $data['messages']['first_visit'] ) {
202 $message = '<p style="font-size:14px;"><strong>' . __( 'Thank you for choosing TablePress, the most popular table plugin for WordPress!', 'tablepress' ) . '</strong></p>';
203 $message .= '<p>' . sprintf( __( 'If you encounter any questions or problems, please visit the <a href="%1$s">FAQ</a>, the <a href="%2$s">Documentation</a>, and the <a href="%3$s">Support</a> section on the <a href="%4$s">plugin website</a>.', 'tablepress' ), 'https://tablepress.org/faq/', 'https://tablepress.org/documentation/', 'https://tablepress.org/support/', 'https://tablepress.org/' ) . '</p>';
204
205 if ( tb_tp_fs()->is_free_plan() ) {
206 $message .= '<p style="font-size:14px;"><strong>' . sprintf( __( 'More great features for you and your site’s visitors and priority email support are available with a Premium license plan of TablePress. <a href="%s">Go check them out!</a>', 'tablepress' ), 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=first-visit-message' ) . '</strong></p>';
207 }
208
209 $message .= '<p style="margin-top:1em;">' . $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'first_visit', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '</p>';
210
211 $title = '<em>' . __( 'Welcome!', 'tablepress' ) . '</em>';
212
213 $this->add_header_message( $message, 'notice-info not-dismissible', $title );
214 }
215
216 if ( $data['messages']['donation_nag'] ) {
217 $message = '<p style="font-size:14px;"><img alt="' . esc_attr__( 'Tobias Bäthge, developer of TablePress', 'tablepress' ) . '" src="https://secure.gravatar.com/avatar/50f1cff2e27a1f522b18ce229c057bc5?s=300" height="150" width="150" style="float:left;margin:2px 15px 30px 0;">'
218 . __( 'Hi, my name is Tobias, I&#8217;m the developer of the TablePress plugin.', 'tablepress' ) . '</p>';
219 $message .= '<p style="font-size:14px;">' . __( 'Thank you for using it!', 'tablepress' ) . ' ';
220 if ( $data['table_count'] > 0 ) {
221 $message .= sprintf( _n( 'I hope that everything works and that you are satisfied with the results of managing your %s table.', 'I hope that everything works and that you are satisfied with the results of managing your %s tables.', $data['table_count'], 'tablepress' ), $data['table_count'] );
222 } else {
223 $message .= sprintf( __( 'It looks like you haven’t added a table yet. If you need help to get started, please find more information in the FAQ and Documentation on the <a href="%s">TablePress website</a>.', 'tablepress' ), 'https://tablepress.org/' );
224 }
225 $message .= '</p>';
226 $message .= '<p style="font-size:14px;"><strong>' . sprintf( __( 'I would like to invite you to check out the <a href="%s">Premium versions of TablePress</a>.', 'tablepress' ), 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=upgrade-message' ) . '<br>'
227 . __( 'The available Pro and Max plans offer user support and many exciting and helpful features for your tables.', 'tablepress' ) . '</strong></p>';
228 $message .= '<p style="font-size:14px;">' . __( 'Sincerely, Tobias', 'tablepress' ) . '</p>';
229 $message .= '<p style="margin-top:1em;">' . sprintf( '<a href="%s" class="components-button is-primary" style="font-size:14px;margin-right:3em;">%s<span class="dashicons dashicons-arrow-right-alt" style="vertical-align:middle;margin:0 0 4px 4px"></span></a>', 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=button&utm_content=upgrade-message', __( 'Tell me more about the Premium features', 'tablepress' ) )
230 . $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'donation_nag', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '</p>';
231
232 $title = '<em>' . __( 'TablePress has more to offer!', 'tablepress' ) . '</em>';
233
234 $this->add_header_message( $message, 'notice-success not-dismissible', $title );
235 }
236
237 if ( $data['messages']['plugin_update'] ) {
238 $message = '<p>' . sprintf( __( 'To find out more about what’s new, please read the <a href="%s"><strong>release announcement</strong></a>.', 'tablepress' ), 'https://tablepress.org/news/?utm_source=plugin&utm_medium=textlink&utm_content=plugin-update-message' ) . '</p>';
239
240 if ( tb_tp_fs()->is_free_plan() ) {
241 $message .= '<p><strong>' . sprintf( __( 'More great features and priority email support are available with a Premium license plan. <a href="%s">Check them out!</a>', 'tablepress' ), 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=plugin-update-message' ) . '</strong></p>';
242 }
243
244 $message .= '<p style="margin-top:1em;">' . $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'plugin_update', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '</p>';
245
246 $title = '<em>' . sprintf( __( 'Thank you for updating to TablePress %s!', 'tablepress' ), TablePress::version ) . '</em>';
247
248 $this->add_header_message( $message, 'notice-info not-dismissible', $title );
249 }
250
251 $this->process_action_messages( array(
252 'success_delete' => _n( 'The table was deleted successfully.', 'The tables were deleted successfully.', 1, 'tablepress' ),
253 'success_delete_plural' => _n( 'The table was deleted successfully.', 'The tables were deleted successfully.', 2, 'tablepress' ),
254 'error_delete' => __( 'Error: The table could not be deleted.', 'tablepress' ),
255 'success_copy' => _n( 'The table was copied successfully.', 'The tables were copied successfully.', 1, 'tablepress' ) . ( ( false !== $data['table_id'] ) ? ' ' . sprintf( __( 'The copied table has the table ID &#8220;%s&#8221;.', 'tablepress' ), esc_html( $data['table_id'] ) ) : '' ),
256 'success_copy_plural' => _n( 'The table was copied successfully.', 'The tables were copied successfully.', 2, 'tablepress' ),
257 'error_copy' => __( 'Error: The table could not be copied.', 'tablepress' ),
258 'error_no_table' => __( 'Error: You did not specify a valid table ID.', 'tablepress' ),
259 'error_load_table' => __( 'Error: This table could not be loaded!', 'tablepress' ),
260 'error_bulk_action_invalid' => __( 'Error: This bulk action is invalid!', 'tablepress' ),
261 'error_no_selection' => __( 'Error: You did not select any tables!', 'tablepress' ),
262 'error_delete_not_all_tables' => __( 'Notice: Not all selected tables could be deleted!', 'tablepress' ),
263 'error_copy_not_all_tables' => __( 'Notice: Not all selected tables could be copied!', 'tablepress' ),
264 'success_import' => __( 'The tables were imported successfully.', 'tablepress' ),
265 ) );
266
267 $this->add_text_box( 'head', array( $this, 'textbox_head' ), 'normal' );
268 $this->add_text_box( 'tables-list', array( $this, 'textbox_tables_list' ), 'normal' );
269
270 add_screen_option( 'per_page', array( 'label' => __( 'Tables', 'tablepress' ), 'default' => 20 ) ); // Admin_Controller contains function to allow changes to this in the Screen Options to be saved.
271 $this->wp_list_table = TablePress::load_class( 'TablePress_All_Tables_List_Table', 'class-all-tables-list-table.php', 'views' );
272 $this->wp_list_table->set_items( $this->data['table_ids'] );
273 $this->wp_list_table->prepare_items();
274
275 // Cleanup Request URI string, which WP_List_Table uses to generate the sort URLs.
276 $_SERVER['REQUEST_URI'] = remove_query_arg( array( 'message', 'table_id' ), $_SERVER['REQUEST_URI'] );
277 }
278
279 /**
280 * Render the current view (in this view: without form tag).
281 *
282 * @since 1.0.0
283 */
284 #[\Override]
285 public function render(): void {
286 ?>
287 <div id="tablepress-page" class="wrap">
288 <?php
289 $this->print_nav_tab_menu();
290 ?>
291 <div id="tablepress-body">
292 <hr class="wp-header-end">
293 <?php
294 // Print all header messages.
295 foreach ( $this->header_messages as $message ) {
296 echo $message;
297 }
298
299 // For this screen, this is done in textbox_tables_list(), to get the fields into the correct <form>:
300 // $this->do_text_boxes( 'header' );.
301 ?>
302 <div id="poststuff">
303 <div id="post-body" class="metabox-holder columns-<?php echo ( isset( $GLOBALS['screen_layout_columns'] ) && ( 2 === $GLOBALS['screen_layout_columns'] ) ) ? '2' : '1'; ?>">
304 <div id="postbox-container-2" class="postbox-container">
305 <?php
306 $this->do_text_boxes( 'normal' );
307 $this->do_meta_boxes( 'normal' );
308
309 $this->do_text_boxes( 'additional' );
310 $this->do_meta_boxes( 'additional' );
311
312 // Print all submit buttons.
313 $this->do_text_boxes( 'submit' );
314 ?>
315 </div>
316 <div id="postbox-container-1" class="postbox-container">
317 <?php
318 // Print all boxes in the sidebar.
319 $this->do_text_boxes( 'side' );
320 $this->do_meta_boxes( 'side' );
321 ?>
322 </div>
323 </div>
324 <br class="clear">
325 </div>
326 </div>
327 </div>
328 <?php
329 }
330
331 /**
332 * Print the screen head text.
333 *
334 * @since 1.0.0
335 *
336 * @param array<string, mixed> $data Data for this screen.
337 * @param array<string, mixed> $box Information about the text box.
338 */
339 public function textbox_head( array $data, array $box ): void {
340 echo '<p>';
341 _e( 'This is a list of your tables.', 'tablepress' );
342 echo ' ';
343 // Show the instructions string depending on whether the Block Editor is used on the site or not.
344 if ( $data['site_uses_block_editor'] ) {
345 printf( __( 'To insert a table into a post or page, add a “%1$s” block in the block editor and select the desired table.', 'tablepress' ), __( 'TablePress table', 'tablepress' ) );
346 } else {
347 _e( 'To insert a table into a post or page, paste its Shortcode at the desired place in the editor.', 'tablepress' );
348 echo ' ';
349 _e( 'Each table has a unique ID that needs to be adjusted in that Shortcode.', 'tablepress' );
350 }
351 echo '</p>';
352 }
353
354 /**
355 * Print the content of the "All Tables" text box.
356 *
357 * @since 1.0.0
358 *
359 * @param array<string, mixed> $data Data for this screen.
360 * @param array<string, mixed> $box Information about the text box.
361 */
362 public function textbox_tables_list( array $data, array $box ): void {
363 if ( ! empty( $_GET['s'] ) ) {
364 printf( '<span class="subtitle">' . __( 'Search results for &#8220;%s&#8221;', 'tablepress' ) . '</span>', esc_html( wp_unslash( $_GET['s'] ) ) );
365 }
366 ?>
367 <form method="get">
368 <?php
369 if ( isset( $_GET['page'] ) ) {
370 echo '<input type="hidden" name="page" value="' . esc_attr( $_GET['page'] ) . '">' . "\n";
371 }
372 $this->wp_list_table->search_box( __( 'Search Tables', 'tablepress' ), 'tables_search' );
373 ?>
374 </form>
375 <form action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" method="post">
376 <?php
377 // This prints the nonce and action fields for this screen (done here instead of render(), due to moved <form>).
378 $this->do_text_boxes( 'header' );
379 $this->wp_list_table->display();
380 ?>
381 </form>
382 <?php
383 }
384
385 /**
386 * Create HTML code for an AJAXified link.
387 *
388 * @since 1.0.0
389 *
390 * @param array<string, mixed> $params Parameters for the URL.
391 * @param string $text Text for the link.
392 * @return string HTML code for the link.
393 */
394 protected function ajax_link( array $params, string $text ): string {
395 $class = 'ajax-link';
396 if ( ! empty( $params['class'] ) ) {
397 $class .= ' ' . esc_attr( $params['class'] );
398 }
399 $url = TablePress::url( $params, true, 'admin-post.php' );
400 $action = esc_attr( $params['action'] );
401 $item = esc_attr( $params['item'] );
402 $target = esc_attr( $params['target'] ?? '' );
403 return "<a class=\"{$class}\" href=\"{$url}\" data-action=\"{$action}\" data-item=\"{$item}\" data-target=\"{$target}\">{$text}</a>";
404 }
405
406 } // class TablePress_List_View
407