$data Data for this view. */ #[\Override] public function setup( /* string */ $action, array $data ) /* : void */ { // Don't use type hints in the method declaration to prevent PHP errors, as the method is inherited. parent::setup( $action, $data ); $this->admin_page->enqueue_script( 'list' ); if ( $data['messages']['superseded_extensions'] ) { $superseded_extensions = array( 'tablepress-advanced-access-rights/tablepress-advanced-access-rights.php' => array( 'name' => 'TablePress Extension: Advanced Access Rights', 'compatible' => true, ), 'tablepress-auto-export-tables/tablepress-auto-export-tables.php' => array( 'name' => 'TablePress Extension: Automatic Table Export', 'compatible' => true, ), 'tablepress-cell-highlighting/tablepress-cell-highlighting.php' => array( 'name' => 'TablePress Extension: Cell Highlighting', 'compatible' => true, ), 'tablepress-datatables-alphabetsearch/tablepress-datatables-alphabetsearch.php' => array( 'name' => 'TablePress Extension: DataTables AlphabetSearch', 'compatible' => false, ), 'tablepress-datatables-buttons/tablepress-datatables-buttons.php' => array( 'name' => 'TablePress Extension: DataTables Buttons', 'compatible' => true, ), 'tablepress-datatables-column-filter-widgets/tablepress-datatables-column-filter-widgets.php' => array( 'name' => 'TablePress Extension: DataTables ColumnFilterWidgets', 'compatible' => false, ), 'tablepress-datatables-columnfilter/tablepress-datatables-columnfilter.php' => array( 'name' => 'TablePress Extension: DataTables Column Filter', 'compatible' => false, ), 'tablepress-datatables-counter-column/tablepress-datatables-counter-column.php' => array( 'name' => 'TablePress Extension: DataTables Counter Column', 'compatible' => true, ), 'tablepress-datatables-fixedcolumns/tablepress-datatables-fixedcolumns.php' => array( 'name' => 'TablePress Extension: DataTables FixedColumns', 'compatible' => false, ), 'tablepress-datatables-fixedheader/tablepress-datatables-fixedheader.php' => array( 'name' => 'TablePress Extension: DataTables FixedHeader', 'compatible' => true, ), 'tablepress-datatables-inverted-filter/tablepress-datatables-inverted-filter.php' => array( 'name' => 'TablePress Extension: DataTables Inverted Filter', 'compatible' => false, ), 'tablepress-datatables-row-details/tablepress-datatables-row-details.php' => array( 'name' => 'TablePress Extension: DataTables Row Details', 'compatible' => false, ), 'tablepress-datatables-rowgroup/tablepress-datatables-rowgroup.php' => array( 'name' => 'TablePress Extension: DataTables RowGroup', 'compatible' => false, ), 'tablepress-responsive-tables/tablepress-responsive-tables.php' => array( 'name' => 'TablePress Extension: Responsive Tables', 'compatible' => false, ), 'tablepress-row-filter/tablepress-row-filter.php' => array( 'name' => 'TablePress Extension: Row Filtering', 'compatible' => true, ), 'tablepress-row-highlighting/tablepress-row-highlighting.php' => array( 'name' => 'TablePress Extension: Row Highlighting', 'compatible' => true, ), 'tablepress-table-auto-update/tablepress-table-auto-update.php' => array( 'name' => 'TablePress Extension: Table Auto Update', 'compatible' => true, ), 'tablepress-table-column-order/tablepress-table-column-order.php' => array( 'name' => 'TablePress Extension: Table Column Order', 'compatible' => true, ), ); $active_compatible_superseded_extensions = array(); $active_incompatible_superseded_extensions = array(); foreach ( $superseded_extensions as $plugin => $extension ) { if ( is_plugin_active( $plugin ) ) { if ( $extension['compatible'] ) { $active_compatible_superseded_extensions[] = $extension['name']; } else { $active_incompatible_superseded_extensions[] = $extension['name']; } } } /* * If no superseded extensions are used, hide the message, to prevent running the checks on every load of the view. * This leaves a small risk of an Extension being activated later, but that's acceptable as they are no longer publicly available. */ if ( empty( $active_incompatible_superseded_extensions ) && ( empty( $active_compatible_superseded_extensions ) || ! tb_tp_fs()->is_free_plan() ) ) { TablePress::$model_options->update( 'message_superseded_extensions', false ); } $message = ''; $notice_css_classes = 'not-dismissible'; if ( ! empty( $active_incompatible_superseded_extensions ) ) { $notice_css_classes .= ' is-error'; $message .= '

' . __( 'You are using TablePress Extension plugins on this website that have been retired more than 2 years ago.', 'tablepress' ) . '
' . __( 'For technical reasons, some or all features of these outdated plugins do no longer work with TablePress 3:', 'tablepress' ) . '

'; $message .= ''; $message .= '

' . __( 'Keeping them activated can lead to errors on your website.', 'tablepress' ) . '

'; if ( tb_tp_fs()->is_free_plan() ) { $message .= '

' . sprintf( __( 'To continue using these features, upgrade to a TablePress Premium license plan!', 'tablepress' ), 'https://tablepress.org/upgrade-extensions/?utm_source=plugin&utm_medium=textlink&utm_content=superseded-extensions-message' ) . '
' . __( 'TablePress Pro and TablePress Max come with updated and heavily improved versions of these features and include direct priority email support.', 'tablepress' ) . '

'; } if ( ! empty( $active_compatible_superseded_extensions ) && tb_tp_fs()->is_free_plan() ) { $message .= '

' . __( 'In addition, these TablePress Extension plugins have been retired and might become incompatible in the future as well:', 'tablepress' ) . '

'; $message .= ''; } } elseif ( ! empty( $active_compatible_superseded_extensions ) && tb_tp_fs()->is_free_plan() ) { $notice_css_classes .= ' is-warning'; $message .= '

' . __( 'You are using TablePress Extension plugins on this website that have been retired and will no longer receive updates or support:', 'tablepress' ) . '

'; $message .= ''; $message .= '

' . __( 'It is possible that these become incompatible with TablePress or WordPress in the future!', 'tablepress' ) . '

'; $message .= '

' . sprintf( __( 'However, their features were heavily improved and are now part of the up-to-date TablePress Premium versions!', 'tablepress' ), 'https://tablepress.org/upgrade-extensions/?utm_source=plugin&utm_medium=textlink&utm_content=superseded-extensions-message' ) . '

'; } if ( '' !== $message ) { if ( tb_tp_fs()->is_free_plan() ) { $message .= '

' . __( 'Upgrade to a TablePress Premium license plan now and get:', 'tablepress' ) . '

'; $message .= ''; $message .= '

' . sprintf( __( 'And the best: %s', 'tablepress' ), sprintf( __( 'Use the promo code %1$s during the checkout process for a special offer!', 'tablepress' ), 'UPGRADE' ) ) . '

'; $message .= '

' . sprintf( '%s', 'https://tablepress.org/upgrade-extensions/?utm_source=plugin&utm_medium=button&utm_content=superseded-extensions-message', __( 'Upgrade to a TablePress Premium version now!', 'tablepress' ) ); } $message .= $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'superseded_extensions', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '

'; $title = '' . __( 'Important Notice!', 'tablepress' ) . ''; $this->add_header_message( $message, $notice_css_classes, $title ); } } if ( $data['messages']['first_visit'] ) { $message = '

' . __( 'Thank you for choosing TablePress, the most popular table plugin for WordPress!', 'tablepress' ) . '

'; /* translators: %1$s: URL to FAQ, %2$s: URL to Documentation, %3$s: URL to Support, %4$s: URL to plugin website */ $message .= '

' . sprintf( __( 'If you encounter any questions or problems, please visit the FAQ, the Documentation, and the Support section on the plugin website.', 'tablepress' ), 'https://tablepress.org/faq/', 'https://tablepress.org/documentation/', 'https://tablepress.org/support/', 'https://tablepress.org/' ) . '

'; if ( tb_tp_fs()->is_free_plan() ) { $message .= '

' . sprintf( __( '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!', 'tablepress' ), 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=first-visit-message' ) . '

'; } $message .= '

' . $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'first_visit', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '

'; $title = '' . __( 'Welcome!', 'tablepress' ) . ''; $this->add_header_message( $message, 'is-info not-dismissible', $title ); } if ( $data['messages']['donation_nag'] ) { $message = '

' . esc_attr__( 'Tobias Bäthge, developer of TablePress', 'tablepress' ) . '' . __( 'Hi, my name is Tobias, I’m the developer of the TablePress plugin.', 'tablepress' ) . '

'; $message .= '

' . __( 'Thank you for using it!', 'tablepress' ) . ' '; if ( $data['table_count'] > 0 ) { /* translators: %s: Number of tables */ $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'] ); } else { /* translators: %s: URL to TablePress website */ $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 TablePress website.', 'tablepress' ), 'https://tablepress.org/' ); } $message .= '

'; $message .= '

' . sprintf( __( 'I would like to invite you to check out the Premium versions of TablePress.', 'tablepress' ), 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=upgrade-message' ) . '
' . __( 'The available Pro and Max plans offer user support and many exciting and helpful features for your tables.', 'tablepress' ) . '

'; $message .= '

' . __( 'Sincerely, Tobias', 'tablepress' ) . '

'; $message .= '

' . sprintf( '%s', 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=button&utm_content=upgrade-message', __( 'Tell me more about the Premium features', 'tablepress' ) ) . $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'donation_nag', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '

'; $title = '' . __( 'TablePress has more to offer!', 'tablepress' ) . ''; $this->add_header_message( $message, 'is-success not-dismissible', $title ); } if ( $data['messages']['plugin_update'] ) { $message = '

' . sprintf( __( 'To find out more about what’s new, please read the release announcement.', 'tablepress' ), 'https://tablepress.org/news/?utm_source=plugin&utm_medium=textlink&utm_content=plugin-update-message' ) . '

'; if ( tb_tp_fs()->is_free_plan() ) { $message .= '

' . sprintf( __( 'More great features and priority email support are available with a Premium license plan. Check them out!', 'tablepress' ), 'https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=plugin-update-message' ) . '

'; } $message .= '

' . $this->ajax_link( array( 'action' => 'hide_message', 'item' => 'plugin_update', 'return' => 'list' ), __( 'Hide this message', 'tablepress' ) ) . '

'; $title = '' . sprintf( __( 'Thank you for updating to TablePress %s!', 'tablepress' ), TablePress::version ) . ''; $this->add_header_message( $message, 'is-info not-dismissible', $title ); } $this->process_action_messages( array( 'success_delete' => _n( 'The table was deleted successfully.', 'The tables were deleted successfully.', 1, 'tablepress' ), 'success_delete_plural' => _n( 'The table was deleted successfully.', 'The tables were deleted successfully.', 2, 'tablepress' ), 'error_delete' => __( 'Error: The table could not be deleted.', 'tablepress' ), 'success_copy' => _n( 'The table was copied successfully.', 'The tables were copied successfully.', 1, 'tablepress' ) . ( ( false !== $data['table_id'] ) ? ' ' . ( current_user_can( 'tablepress_edit_table', $data['table_id'] ) ? sprintf( __( 'You can now edit the copied table, which has the table ID “%2$s”.', 'tablepress' ), esc_url( TablePress::url( array( 'action' => 'edit', 'table_id' => $data['table_id'] ) ) ), $data['table_id'] ) : sprintf( __( 'The copied table has the table ID “%s”.', 'tablepress' ), esc_html( $data['table_id'] ) ) ) : '' ), 'success_copy_plural' => _n( 'The table was copied successfully.', 'The tables were copied successfully.', 2, 'tablepress' ), 'error_copy' => __( 'Error: The table could not be copied.', 'tablepress' ), 'error_no_table' => __( 'Error: You did not specify a valid table ID.', 'tablepress' ), 'error_load_table' => __( 'Error: This table could not be loaded!', 'tablepress' ), 'error_bulk_action_invalid' => __( 'Error: This bulk action is invalid!', 'tablepress' ), 'error_no_selection' => __( 'Error: You did not select any tables!', 'tablepress' ), 'error_delete_not_all_tables' => __( 'Notice: Not all selected tables could be deleted!', 'tablepress' ), 'error_copy_not_all_tables' => __( 'Notice: Not all selected tables could be copied!', 'tablepress' ), 'success_import' => __( 'The tables were imported successfully.', 'tablepress' ), ) ); $this->add_text_box( 'head', array( $this, 'textbox_head' ), 'normal' ); $this->add_text_box( 'tables-list', array( $this, 'textbox_tables_list' ), 'normal' ); 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. $this->wp_list_table = TablePress::load_class( 'TablePress_All_Tables_List_Table', 'class-all-tables-list-table.php', 'views' ); $this->wp_list_table->set_items( $this->data['table_ids'] ); $this->wp_list_table->prepare_items(); // Cleanup Request URI string, which WP_List_Table uses to generate the sort URLs. $_SERVER['REQUEST_URI'] = remove_query_arg( array( 'message', 'table_id' ), $_SERVER['REQUEST_URI'] ); } /** * Render the current view (in this view: without form tag). * * @since 1.0.0 */ #[\Override] public function render(): void { ?>
print_nav_tab_menu(); ?>
header_messages as $message ) { echo $message; } // For this screen, this is done in textbox_tables_list(), to get the fields into the correct
: // $this->do_text_boxes( 'header' );. ?>
do_text_boxes( 'normal' ); $this->do_meta_boxes( 'normal' ); $this->do_text_boxes( 'additional' ); $this->do_meta_boxes( 'additional' ); // Print all submit buttons. $this->do_text_boxes( 'submit' ); ?>
do_text_boxes( 'side' ); $this->do_meta_boxes( 'side' ); ?>

$data Data for this screen. * @param array $box Information about the text box. */ public function textbox_head( array $data, array $box ): void { echo '

'; _e( 'This is a list of your tables.', 'tablepress' ); echo ' '; // Show the instructions string depending on whether the Block Editor is used on the site or not. if ( 'block' === $data['site_used_editor'] ) { 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' ) ); } elseif ( 'elementor' === $data['site_used_editor'] ) { printf( __( 'To insert a table into a post or page, add a “%1$s” widget in the Elementor editor and select the desired table.', 'tablepress' ), __( 'TablePress table', 'tablepress' ) ); } else { _e( 'To insert a table into a post or page, paste its Shortcode at the desired place in the editor.', 'tablepress' ); echo ' '; _e( 'Each table has a unique ID that needs to be adjusted in that Shortcode.', 'tablepress' ); } echo '

'; } /** * Print the content of the "All Tables" text box. * * @since 1.0.0 * * @param array $data Data for this screen. * @param array $box Information about the text box. */ public function textbox_tables_list( array $data, array $box ): void { if ( ! empty( $_GET['s'] ) ) { printf( '' . __( 'Search results for “%s”', 'tablepress' ) . '', esc_html( wp_unslash( $_GET['s'] ) ) ); } ?> ' . "\n"; } $this->wp_list_table->search_box( __( 'Search Tables', 'tablepress' ), 'tables_search' ); ?>
). $this->do_text_boxes( 'header' ); $this->wp_list_table->display(); ?>
$params Parameters for the URL. * @param string $text Text for the link. * @return string HTML code for the link. */ protected function ajax_link( array $params, string $text ): string { $class = 'ajax-link'; if ( ! empty( $params['class'] ) ) { $class .= ' ' . esc_attr( $params['class'] ); } $url = TablePress::url( $params, true, 'admin-post.php' ); $action = esc_attr( $params['action'] ); $item = esc_attr( $params['item'] ); $target = esc_attr( $params['target'] ?? '' ); return "{$text}"; } } // class TablePress_List_View