| @@ -7,8 +7,10 @@ | ||
| 7 | 7 | * @author Tobias Bäthge |
| 8 | 8 | * @since 1.0.0 |
| 9 | 9 | */ |
| 10 | 10 | |
| 11 | +declare(strict_types=1); | |
| 12 | + | |
| 11 | 13 | // Prohibit direct script loading. |
| 12 | 14 | defined( 'ABSPATH' ) || die( 'No direct script access allowed!' ); |
| 13 | 15 | |
| 14 | 16 | /** |
| @@ -24,23 +26,28 @@ | ||
| 24 | 26 | /** |
| 25 | 27 | * List of WP feature pointers for this view. |
| 26 | 28 | * |
| 27 | 29 | * @since 2.0.0 |
| 28 | - * @var array | |
| 30 | + * @var string[] | |
| 29 | 31 | */ |
| 30 | - protected $wp_pointers = array( 'tp20_edit_context_menu' ); | |
| 32 | + protected array $wp_pointers = array( 'tp34_edit_toolbar', 'tp33_edit_quick_navigation' ); | |
| 31 | 33 | |
| 32 | 34 | /** |
| 33 | - * Set up the view with data and do things that are specific for this view. | |
| 35 | + * Sets up the view with data and do things that are specific for this view. | |
| 34 | 36 | * |
| 35 | 37 | * @since 1.0.0 |
| 36 | 38 | * |
| 37 | - * @param string $action Action for this view. | |
| 38 | - * @param array $data Data for this view. | |
| 39 | + * @param string $action Action for this view. | |
| 40 | + * @param array<string, mixed> $data Data for this view. | |
| 39 | 41 | */ |
| 40 | - public function setup( $action, array $data ) { | |
| 42 | + #[\Override] | |
| 43 | + public function setup( /* string */ $action, array $data ) /* : void */ { | |
| 44 | + // Don't use type hints in the method declaration to prevent PHP errors, as the method is inherited. | |
| 45 | + | |
| 41 | 46 | parent::setup( $action, $data ); |
| 42 | 47 | |
| 48 | + TablePress::enqueue_script( 'common', array( 'jquery-core', 'postbox' ) ); | |
| 49 | + | |
| 43 | 50 | $this->add_text_box( 'no-javascript', array( $this, 'textbox_no_javascript' ), 'header' ); |
| 44 | 51 | |
| 45 | 52 | if ( isset( $data['table']['is_corrupted'] ) && $data['table']['is_corrupted'] ) { |
| 46 | 53 | $this->add_text_box( 'table-corrupted', array( $this, 'textbox_corrupted_table' ), 'header' ); |
| @@ -53,47 +60,90 @@ | ||
| 53 | 60 | 'success_import' => __( 'The table was imported successfully.', 'tablepress' ), |
| 54 | 61 | 'error_delete' => __( 'Error: The table could not be deleted.', 'tablepress' ), |
| 55 | 62 | ) ); |
| 56 | 63 | |
| 64 | + // For the Advanced Editor. | |
| 57 | 65 | wp_enqueue_style( 'wp-jquery-ui-dialog' ); |
| 58 | 66 | wp_enqueue_style( 'editor-buttons' ); |
| 59 | - wp_enqueue_script( 'wpdialogs' ); // For the Advanced Editor, Table Preview, and Help Boxes. | |
| 67 | + wp_enqueue_script( 'wpdialogs' ); | |
| 68 | + // For the "Insert Image" dialog. | |
| 60 | 69 | add_filter( 'media_view_strings', array( $this, 'change_media_view_strings' ) ); |
| 61 | 70 | wp_enqueue_media(); |
| 62 | - wp_enqueue_script( 'wplink' ); // JS for the "Insert Link" button. | |
| 63 | - $this->admin_page->enqueue_style( 'jspreadsheet' ); | |
| 64 | - $this->admin_page->enqueue_style( 'jsuites', array( 'tablepress-jspreadsheet' ) ); | |
| 65 | - $this->admin_page->enqueue_style( 'edit', array( 'tablepress-jspreadsheet', 'tablepress-jsuites' ) ); | |
| 66 | - $this->admin_page->enqueue_script( 'jspreadsheet' ); | |
| 67 | - $this->admin_page->enqueue_script( 'jsuites', array( 'tablepress-jspreadsheet' ) ); | |
| 68 | - $this->admin_page->enqueue_script( 'edit', array( 'tablepress-jspreadsheet', 'tablepress-jsuites', 'jquery-core' ) ); | |
| 71 | + // For the "Insert Link" dialog. | |
| 72 | + wp_enqueue_script( 'wplink' ); | |
| 69 | 73 | |
| 74 | + TablePress::enqueue_style( 'jspreadsheet' ); | |
| 75 | + TablePress::enqueue_style( 'jsuites', array( 'tablepress-jspreadsheet' ) ); | |
| 76 | + TablePress::enqueue_style( 'edit', array( 'tablepress-jspreadsheet', 'tablepress-jsuites' ) ); | |
| 77 | + if ( ! TABLEPRESS_IS_PLAYGROUND_PREVIEW && tb_tp_fs()->is_free_plan() ) { | |
| 78 | + TablePress::enqueue_style( 'edit-features', array( 'tablepress-edit' ) ); | |
| 79 | + } | |
| 80 | + TablePress::enqueue_script( 'jspreadsheet' ); | |
| 81 | + TablePress::enqueue_script( 'jsuites', array( 'tablepress-jspreadsheet' ) ); | |
| 82 | + TablePress::enqueue_script( 'edit', array( 'tablepress-jspreadsheet', 'tablepress-jsuites', 'jquery-core' ) ); | |
| 83 | + | |
| 70 | 84 | $this->add_text_box( 'head', array( $this, 'textbox_head' ), 'normal' ); |
| 71 | - $this->add_text_box( 'buttons-1', array( $this, 'textbox_buttons' ), 'normal' ); | |
| 85 | + $this->add_text_box( 'header-bar', array( $this, 'textbox_header_bar' ), 'normal' ); | |
| 72 | 86 | $this->add_meta_box( 'table-information', __( 'Table Information', 'tablepress' ), array( $this, 'postbox_table_information' ), 'normal' ); |
| 73 | 87 | $this->add_meta_box( 'table-data', __( 'Table Content', 'tablepress' ), array( $this, 'postbox_table_data' ), 'normal' ); |
| 74 | - $this->add_meta_box( 'table-manipulation', __( 'Table Manipulation', 'tablepress' ), array( $this, 'postbox_table_manipulation' ), 'normal' ); | |
| 75 | 88 | $this->add_meta_box( 'table-options', __( 'Table Options', 'tablepress' ), array( $this, 'postbox_table_options' ), 'normal' ); |
| 76 | 89 | $this->add_meta_box( 'datatables-features', __( 'Table Features for Site Visitors', 'tablepress' ), array( $this, 'postbox_datatables_features' ), 'normal' ); |
| 77 | 90 | $this->add_text_box( 'hidden-containers', array( $this, 'textbox_hidden_containers' ), 'additional' ); |
| 78 | - $this->add_text_box( 'buttons-2', array( $this, 'textbox_buttons' ), 'additional' ); | |
| 79 | - $this->add_text_box( 'other-actions', array( $this, 'textbox_other_actions' ), 'submit' ); | |
| 91 | + | |
| 92 | + add_filter( 'screen_settings', array( $this, 'add_screen_options_output' ), 10, 2 ); | |
| 80 | 93 | } |
| 81 | 94 | |
| 82 | 95 | /** |
| 83 | - * Change Media View string "Insert into post" to "Insert into Table". | |
| 96 | + * Changes the Media View string "Insert into post" to "Insert into Table". | |
| 84 | 97 | * |
| 85 | 98 | * @since 1.0.0 |
| 86 | 99 | * |
| 87 | - * @param array $strings Current set of Media View strings. | |
| 88 | - * @return array Changed Media View strings. | |
| 100 | + * @param array<string, string> $strings Current set of Media View strings. | |
| 101 | + * @return array<string, string> Changed Media View strings. | |
| 89 | 102 | */ |
| 90 | - public function change_media_view_strings( array $strings ) { | |
| 103 | + public function change_media_view_strings( array $strings ): array { | |
| 91 | 104 | $strings['insertIntoPost'] = __( 'Insert into Table', 'tablepress' ); |
| 92 | 105 | return $strings; |
| 93 | 106 | } |
| 94 | 107 | |
| 95 | 108 | /** |
| 109 | + * Adds custom screen options to the screen. | |
| 110 | + * | |
| 111 | + * @since 2.1.0 | |
| 112 | + * | |
| 113 | + * @param string $screen_settings Screen settings. | |
| 114 | + * @param WP_Screen $screen WP_Screen object. | |
| 115 | + * @return string Extended Screen settings. | |
| 116 | + */ | |
| 117 | + public function add_screen_options_output( /* string */ $screen_settings, WP_Screen $screen ): string { | |
| 118 | + // Don't use a type hint for the `$screen_settings` argument as many WordPress plugins seem to be returning `null` in their filter hook handlers. | |
| 119 | + | |
| 120 | + // Protect against other plugins not returning a string for the `$screen_settings` argument. | |
| 121 | + if ( ! is_string( $screen_settings ) ) { // @phpstan-ignore function.alreadyNarrowedType (The `is_string()` check is needed as the input is coming from a filter hook.) | |
| 122 | + $screen_settings = ''; | |
| 123 | + } | |
| 124 | + | |
| 125 | + $screen_settings = '<fieldset id="tablepress-screen-options" class="screen-options">'; | |
| 126 | + $screen_settings .= '<legend>' . __( 'Table editor settings', 'tablepress' ) . '</legend>'; | |
| 127 | + $screen_settings .= '<p>' . __( 'Adjust the default size of the table cells in the table editor below.', 'tablepress' ) . ' ' . __( 'Cells with many lines of text will expand to their full height when they are edited.', 'tablepress' ) . '</p>'; | |
| 128 | + $screen_settings .= '<p><em>' . __( 'Please note: These settings only influence the table editor view on this screen, but not the table that the site visitor sees!', 'tablepress' ) . '</em></p>'; | |
| 129 | + $screen_settings .= '<div>'; | |
| 130 | + $screen_settings .= '<label for="table_editor_column_width">' . __( 'Default column width:', 'tablepress' ) . '</label> '; | |
| 131 | + $input = '<input type="number" id="table_editor_column_width" class="small-text" value="' . esc_attr( TablePress::$model_options->get( 'table_editor_column_width' ) ) . '" min="30" max="9999">'; | |
| 132 | + /* translators: %s: Input field for the number of pixels */ | |
| 133 | + $screen_settings .= sprintf( __( '%s pixels', 'tablepress' ), $input ); | |
| 134 | + $screen_settings .= '</div>'; | |
| 135 | + $screen_settings .= '<div style="margin-top: 6px;">'; | |
| 136 | + $screen_settings .= '<label for="table_editor_line_clamp">' . __( 'Maximum visible lines of text:', 'tablepress' ) . '</label> '; | |
| 137 | + $input = '<input type="number" id="table_editor_line_clamp" class="tiny-text" value="' . esc_attr( TablePress::$model_options->get( 'table_editor_line_clamp' ) ) . '" min="0" max="999">'; | |
| 138 | + /* translators: %s: Input field for the number of lines */ | |
| 139 | + $screen_settings .= sprintf( __( '%s lines', 'tablepress' ), $input ); | |
| 140 | + $screen_settings .= '</div>'; | |
| 141 | + $screen_settings .= '</fieldset>'; | |
| 142 | + return $screen_settings; | |
| 143 | + } | |
| 144 | + | |
| 145 | + /** | |
| 96 | 146 | * Renders the current view. |
| 97 | 147 | * |
| 98 | 148 | * In comparison to the parent class method, this contains handling for the no-js case and adjusts the HTML code structure. |
| 99 | 149 | * |
| @@ -98,9 +148,12 @@ | ||
| 98 | 148 | * In comparison to the parent class method, this contains handling for the no-js case and adjusts the HTML code structure. |
| 99 | 149 | * |
| 100 | 150 | * @since 2.0.0 |
| 101 | 151 | */ |
| 102 | - public function render() { | |
| 152 | + #[\Override] | |
| 153 | + public function render(): void { | |
| 154 | + $this->print_javascript_data(); | |
| 155 | + | |
| 103 | 156 | ?> |
| 104 | 157 | <div id="tablepress-page" class="wrap"> |
| 105 | 158 | <form> |
| 106 | 159 | <?php |
| @@ -106,9 +159,10 @@ | ||
| 106 | 159 | <?php |
| 107 | 160 | $this->print_nav_tab_menu(); |
| 108 | 161 | ?> |
| 109 | 162 | <div id="tablepress-body"> |
| 110 | - <hr class="wp-header-end" /> | |
| 163 | + <hr class="wp-header-end"> | |
| 164 | + <script>document.querySelectorAll('.notice:has(~#tablepress-page)').forEach(e=>document.querySelector('.wp-header-end').after(e));</script> | |
| 111 | 165 | <?php |
| 112 | 166 | // Print all header messages. |
| 113 | 167 | foreach ( $this->header_messages as $message ) { |
| 114 | 168 | echo $message; |
| @@ -132,9 +186,9 @@ | ||
| 132 | 186 | $this->do_meta_boxes( 'side' ); |
| 133 | 187 | ?> |
| 134 | 188 | </div> |
| 135 | 189 | </div> |
| 136 | - <br class="clear" /> | |
| 190 | + <br class="clear"> | |
| 137 | 191 | </div> |
| 138 | 192 | </form> |
| 139 | 193 | </div> |
| 140 | 194 | </div> |
| @@ -141,229 +195,160 @@ | ||
| 141 | 195 | <?php |
| 142 | 196 | } |
| 143 | 197 | |
| 144 | 198 | /** |
| 145 | - * Override parent class method, as the nonces for this view are generated in the JS code. | |
| 199 | + * Overrides parent class method, as the nonces for this view are generated in the JS code. | |
| 146 | 200 | * |
| 147 | 201 | * @since 1.0.0 |
| 148 | 202 | * |
| 149 | - * @param array $data Data for this screen. | |
| 150 | - * @param array $box Information about the text box. | |
| 203 | + * @param array<string, mixed> $data Data for this screen. | |
| 204 | + * @param array<string, mixed> $box Information about the text box. | |
| 151 | 205 | */ |
| 152 | - protected function action_nonce_field( array $data, array $box ) { | |
| 153 | - // Intentionally left empty. Nonces for this view are generated in postbox_table_data(). | |
| 206 | + #[\Override] | |
| 207 | + protected function action_nonce_field( array $data, array $box ): void { | |
| 208 | + // Intentionally left empty. Nonces for this view are generated in `print_javascript_data()`. | |
| 154 | 209 | } |
| 155 | 210 | |
| 156 | 211 | /** |
| 157 | - * Print the content of the "Table Information" post meta box. | |
| 212 | + * Prints the table data for use in JS code and the main React container. | |
| 158 | 213 | * |
| 159 | - * @since 1.0.0 | |
| 160 | - * | |
| 161 | - * @param array $data Data for this screen. | |
| 162 | - * @param array $box Information about the meta box. | |
| 214 | + * @since 3.0.0 | |
| 163 | 215 | */ |
| 164 | - public function postbox_table_information( array $data, array $box ) { | |
| 165 | - ?> | |
| 166 | -<table class="tablepress-postbox-table fixed"> | |
| 167 | - <tr class="bottom-border"> | |
| 168 | - <th class="column-1" scope="row"><label for="table-id"><?php _e( 'Table ID', 'tablepress' ); ?>:</label></th> | |
| 169 | - <td class="column-2"> | |
| 170 | - <div id="table-id-shortcode-wrapper"> | |
| 171 | - <input type="text" id="table-id" value="<?php echo esc_attr( $data['table']['id'] ); ?>" title="<?php esc_attr_e( 'The Table ID can only consist of letters, numbers, hyphens (-), and underscores (_).', 'tablepress' ); ?>" pattern="[A-Za-z1-9-_]|[A-Za-z0-9-_]{2,}" required <?php echo ( ! current_user_can( 'tablepress_edit_table_id', $data['table']['id'] ) ) ? 'readonly ' : ''; ?>/> | |
| 172 | - <div><label for="table-information-shortcode"><?php _e( 'Shortcode', 'tablepress' ); ?>:</label> <input type="text" id="table-information-shortcode" value="<?php echo esc_attr( '[' . TablePress::$shortcode . " id={$data['table']['id']} /]" ); ?>" readonly /></div> | |
| 173 | - </div> | |
| 174 | - </td> | |
| 175 | - </tr> | |
| 176 | - <tr class="top-border"> | |
| 177 | - <th class="column-1" scope="row"><label for="table-name"><?php _e( 'Table Name', 'tablepress' ); ?>:</label></th> | |
| 178 | - <td class="column-2"><input type="text" id="table-name" class="large-text" value="<?php echo esc_attr( $data['table']['name'] ); ?>" /></td> | |
| 179 | - </tr> | |
| 180 | - <tr class="bottom-border"> | |
| 181 | - <th class="column-1 top-align" scope="row"><label for="table-description"><?php _e( 'Description', 'tablepress' ); ?>:</label></th> | |
| 182 | - <td class="column-2"><textarea id="table-description" class="large-text" rows="4"><?php echo esc_textarea( $data['table']['description'] ); ?></textarea></td> | |
| 183 | - </tr> | |
| 184 | - <tr class="top-border"> | |
| 185 | - <th class="column-1" scope="row"><?php _e( 'Last Modified', 'tablepress' ); ?>:</th> | |
| 186 | - <td class="column-2"><?php printf( __( '%1$s by %2$s', 'tablepress' ), '<span id="last-modified">' . TablePress::format_datetime( $data['table']['last_modified'] ) . '</span>', '<span id="last-editor">' . TablePress::get_user_display_name( $data['table']['options']['last_editor'] ) . '</span>' ); ?></td> | |
| 187 | - </tr> | |
| 188 | -</table> | |
| 189 | - <?php | |
| 190 | - } | |
| 216 | + public function print_javascript_data(): void { | |
| 217 | + echo "<script>\n"; | |
| 218 | + echo "window.tp = window.tp || {};\n"; | |
| 191 | 219 | |
| 192 | - /** | |
| 193 | - * Print the content of the "Table Content" post meta box. | |
| 194 | - * | |
| 195 | - * @since 1.0.0 | |
| 196 | - * | |
| 197 | - * @param array $data Data for this screen. | |
| 198 | - * @param array $box Information about the meta box. | |
| 199 | - */ | |
| 200 | - public function postbox_table_data( array $data, array $box ) { | |
| 201 | - echo <<<JS | |
| 202 | -<script> | |
| 203 | -// Ensure the global `tp` object exists. | |
| 204 | -window.tp = window.tp || {};\n\n | |
| 205 | -JS; | |
| 220 | + echo "tp.nonces = {\n"; | |
| 221 | + echo "\tedit_table: '" . wp_create_nonce( TablePress::nonce( $this->action, $this->data['table']['id'] ) ) . "',\n"; | |
| 222 | + echo "\tpreview_table: '" . wp_create_nonce( TablePress::nonce( 'preview_table', $this->data['table']['id'] ) ) . "',\n"; | |
| 223 | + echo "\tcopy_table: '" . wp_create_nonce( TablePress::nonce( 'copy_table', $this->data['table']['id'] ) ) . "',\n"; | |
| 224 | + echo "\tdelete_table: '" . wp_create_nonce( TablePress::nonce( 'delete_table', $this->data['table']['id'] ) ) . "',\n"; | |
| 225 | + echo "\tscreen_options: '" . wp_create_nonce( TablePress::nonce( 'screen_options' ) ) . "',\n"; | |
| 226 | + echo "};\n"; | |
| 206 | 227 | |
| 207 | - echo "tp.nonces = {};\n"; | |
| 208 | - echo "tp.nonces.edit_table = '" . wp_create_nonce( TablePress::nonce( $this->action, $data['table']['id'] ) ) . "';\n"; | |
| 209 | - echo "tp.nonces.preview_table = '" . wp_create_nonce( TablePress::nonce( 'preview_table', $data['table']['id'] ) ) . "';\n"; | |
| 210 | - echo "\n"; | |
| 228 | + echo "tp.table = {\n"; | |
| 229 | + echo "\tid: '{$this->data['table']['id']}',\n"; | |
| 230 | + echo "\tshortcode: '" . esc_js( TablePress::$shortcode ) . "',\n"; | |
| 211 | 231 | |
| 212 | - echo "tp.table = {};\n"; | |
| 213 | - echo "tp.table.shortcode = '" . esc_js( TablePress::$shortcode ) . "';\n"; | |
| 214 | - echo "tp.table.id = '{$data['table']['id']}';\n"; | |
| 215 | - echo "tp.table.new_id = '{$data['table']['id']}';\n"; | |
| 232 | + // Add the table meta data. | |
| 233 | + $this->data['table']['meta'] = array( | |
| 234 | + 'id' => $this->data['table']['id'], | |
| 235 | + 'name' => $this->data['table']['name'], | |
| 236 | + 'description' => $this->data['table']['description'], | |
| 237 | + 'lastModified' => TablePress::format_datetime( $this->data['table']['last_modified'] ), | |
| 238 | + 'lastEditor' => TablePress::get_user_display_name( $this->data['table']['options']['last_editor'] ), | |
| 239 | + ); | |
| 240 | + | |
| 216 | 241 | // JSON-encode array items separately to save some PHP memory. |
| 217 | - foreach ( array( 'data', 'options', 'visibility' ) as $item ) { | |
| 218 | - $json = wp_json_encode( $data['table'][ $item ], TABLEPRESS_JSON_OPTIONS ); | |
| 219 | - // Print them inside a `JSON.parse()` call in JS for speed gains, with necessary escaping of `</script>`, `'`, and `\`. | |
| 220 | - $json = str_replace( array( '</script>', '\\', "'" ), array( '<\/script>', '\\\\', "\'" ), $json ); | |
| 221 | - printf( 'tp.table.%1$s = JSON.parse( \'%2$s\' );' . "\n", $item, $json ); | |
| 242 | + foreach ( array( 'meta', 'data', 'options', 'visibility' ) as $item ) { | |
| 243 | + $json = $this->convert_to_json_parse_output( $this->data['table'][ $item ] ); | |
| 244 | + echo "\t{$item}: {$json},\n"; | |
| 222 | 245 | } |
| 246 | + echo "};\n"; | |
| 247 | + | |
| 248 | + echo "tp.screenOptions = {\n"; | |
| 249 | + echo "\ttable_editor_column_width: " . absint( TablePress::$model_options->get( 'table_editor_column_width' ) ) . ",\n"; | |
| 250 | + echo "\tshowCustomCommands: " . ( current_user_can( 'unfiltered_html' ) ? 'true' : 'false' ) . ",\n"; | |
| 251 | + echo "\toptionsUrl: '" . TablePress::url( array( 'action' => 'options' ) ) . "',\n"; | |
| 252 | + echo "\tcurrentUserCanEditTableId: " . ( current_user_can( 'tablepress_edit_table_id', $this->data['table']['id'] ) ? 'true' : 'false' ) . ",\n"; | |
| 253 | + echo "\tcurrentUserCanCopyTable: " . ( current_user_can( 'tablepress_copy_table', $this->data['table']['id'] ) ? 'true' : 'false' ) . ",\n"; | |
| 254 | + echo "\tcurrentUserCanDeleteTable: " . ( current_user_can( 'tablepress_delete_table', $this->data['table']['id'] ) ? 'true' : 'false' ) . ",\n"; | |
| 255 | + echo "\tcurrentUserCanExportTable: " . ( current_user_can( 'tablepress_export_table', $this->data['table']['id'] ) ? 'true' : 'false' ) . ",\n"; | |
| 256 | + echo "\tcurrentUserCanPreviewTable: " . ( current_user_can( 'tablepress_preview_table', $this->data['table']['id'] ) ? 'true' : 'false' ) . ",\n"; | |
| 257 | + echo "\tcopyUrl: '" . str_replace( '&', '&', TablePress::url( array( 'action' => 'copy_table', 'item' => $this->data['table']['id'], 'return' => 'edit' ), true, 'admin-post.php' ) ) . "',\n"; | |
| 258 | + echo "\tdeleteUrl: '" . str_replace( '&', '&', TablePress::url( array( 'action' => 'delete_table', 'item' => $this->data['table']['id'], 'return' => 'edit', 'return_item' => $this->data['table']['id'] ), true, 'admin-post.php' ) ) . "',\n"; | |
| 259 | + echo "\texportUrl: '" . str_replace( '&', '&', TablePress::url( array( 'action' => 'export', 'table_id' => $this->data['table']['id'] ) ) ) . "',\n"; | |
| 260 | + echo "\tpreviewUrl: '" . str_replace( '&', '&', TablePress::url( array( 'action' => 'preview_table', 'item' => $this->data['table']['id'], 'return' => 'edit', 'return_item' => $this->data['table']['id'] ), true, 'admin-post.php' ) ) . "',\n"; | |
| 261 | + echo "};\n"; | |
| 262 | + | |
| 223 | 263 | echo "</script>\n"; |
| 224 | 264 | |
| 225 | - echo '<div id="table-editor"></div>'; | |
| 265 | + echo '<div id="tablepress-edit-screen"></div>'; // React container. | |
| 226 | 266 | } |
| 227 | 267 | |
| 228 | 268 | /** |
| 229 | - * Print the content of the "Table Manipulation" post meta box. | |
| 269 | + * Prints the content of the "Table Information" post meta box. | |
| 230 | 270 | * |
| 231 | 271 | * @since 1.0.0 |
| 232 | 272 | * |
| 233 | - * @param array $data Data for this screen. | |
| 234 | - * @param array $box Information about the meta box. | |
| 273 | + * @param array<string, mixed> $data Data for this screen. | |
| 274 | + * @param array<string, mixed> $box Information about the meta box. | |
| 235 | 275 | */ |
| 236 | - public function postbox_table_manipulation( array $data, array $box ) { | |
| 237 | - ?> | |
| 238 | -<table id="tablepress-manipulation-controls" class="tablepress-postbox-table fixed"> | |
| 239 | - <tr class="bottom-border"> | |
| 240 | - <td class="column-1"> | |
| 241 | - <?php _e( 'Selected cells', 'tablepress' ); ?>: | |
| 242 | - <input type="button" class="button" id="button-insert-link" value="<?php esc_attr_e( 'Insert Link', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$sL', 'keyboard shortcut for Insert Link', 'tablepress' ) ); ?>" /> | |
| 243 | - <input type="button" class="button" id="button-insert-image" value="<?php esc_attr_e( 'Insert Image', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$sI', 'keyboard shortcut for Insert Image', 'tablepress' ) ); ?>" /> | |
| 244 | - <input type="button" class="button" id="button-advanced-editor" value="<?php esc_attr_e( 'Advanced Editor', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$sE', 'keyboard shortcut for Advanced Editor', 'tablepress' ) ); ?>" /> | |
| 245 | - </td> | |
| 246 | - <td class="column-2"> | |
| 247 | - <?php _e( 'Selected cells', 'tablepress' ); ?>: | |
| 248 | - <input type="button" class="button button-merge-unmerge" data-action="merge" value="<?php esc_attr_e( 'Combine/Merge', 'tablepress' ); ?>" /> | |
| 249 | - <input type="button" class="button button-show-help-box" value="<?php esc_attr_e( '?', 'tablepress' ); ?>" title="<?php esc_attr_e( 'Help on combining cells', 'tablepress' ); ?>" data-help-box="#help-box-combine-cells" /> | |
| 250 | - </td> | |
| 251 | - </tr> | |
| 252 | - <tr class="top-border"> | |
| 253 | - <td class="column-1"> | |
| 254 | - <?php _e( 'Selected rows', 'tablepress' ); ?>: | |
| 255 | - <input type="button" class="button button-insert-duplicate" data-type="rows" data-action="duplicate" value="<?php esc_attr_e( 'Duplicate', 'tablepress' ); ?>" /> | |
| 256 | - <input type="button" class="button button-insert-duplicate" data-type="rows" data-action="insert" value="<?php esc_attr_e( 'Insert', 'tablepress' ); ?>" /> | |
| 257 | - <input type="button" class="button button-remove" data-type="rows" value="<?php esc_attr_e( 'Delete', 'tablepress' ); ?>" /> | |
| 258 | - </td> | |
| 259 | - <td class="column-2"> | |
| 260 | - <?php _e( 'Selected columns', 'tablepress' ); ?>: | |
| 261 | - <input type="button" class="button button-insert-duplicate" data-type="columns" data-action="duplicate" value="<?php esc_attr_e( 'Duplicate', 'tablepress' ); ?>" /> | |
| 262 | - <input type="button" class="button button-insert-duplicate" data-type="columns" data-action="insert" value="<?php esc_attr_e( 'Insert', 'tablepress' ); ?>" /> | |
| 263 | - <input type="button" class="button button-remove" data-type="columns" value="<?php esc_attr_e( 'Delete', 'tablepress' ); ?>" /> | |
| 264 | - </td> | |
| 265 | - </tr> | |
| 266 | - <tr> | |
| 267 | - <td class="column-1"> | |
| 268 | - <?php _e( 'Selected rows', 'tablepress' ); ?>: | |
| 269 | - <input type="button" class="button button-move" data-type="rows" data-direction="up" value="<?php esc_attr_e( 'Move up', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$s⇧↑', 'keyboard shortcut for Move up', 'tablepress' ) ); ?>" /> | |
| 270 | - <input type="button" class="button button-move" data-type="rows" data-direction="down" value="<?php esc_attr_e( 'Move down', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$s⇧↓', 'keyboard shortcut for Move down', 'tablepress' ) ); ?>" /> | |
| 271 | - </td> | |
| 272 | - <td class="column-2"> | |
| 273 | - <?php _e( 'Selected columns', 'tablepress' ); ?>: | |
| 274 | - <input type="button" class="button button-move" data-type="columns" data-direction="left" value="<?php esc_attr_e( 'Move left', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$s⇧←', 'keyboard shortcut for Move left', 'tablepress' ) ); ?>" /> | |
| 275 | - <input type="button" class="button button-move" data-type="columns" data-direction="right" value="<?php esc_attr_e( 'Move right', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$s⇧→', 'keyboard shortcut for Move right', 'tablepress' ) ); ?>" /> | |
| 276 | - </td> | |
| 277 | - </tr> | |
| 278 | - <tr class="bottom-border"> | |
| 279 | - <td class="column-1"> | |
| 280 | - <?php _e( 'Selected rows', 'tablepress' ); ?>: | |
| 281 | - <input type="button" class="button button-hide-unhide" data-type="rows" data-action="hide" value="<?php esc_attr_e( 'Hide', 'tablepress' ); ?>" /> | |
| 282 | - <input type="button" class="button button-hide-unhide" data-type="rows" data-action="unhide" value="<?php esc_attr_e( 'Show', 'tablepress' ); ?>" /> | |
| 283 | - </td> | |
| 284 | - <td class="column-2"> | |
| 285 | - <?php _e( 'Selected columns', 'tablepress' ); ?>: | |
| 286 | - <input type="button" class="button button-hide-unhide" data-type="columns" data-action="hide" value="<?php esc_attr_e( 'Hide', 'tablepress' ); ?>" /> | |
| 287 | - <input type="button" class="button button-hide-unhide" data-type="columns" data-action="unhide" value="<?php esc_attr_e( 'Show', 'tablepress' ); ?>" /> | |
| 288 | - </td> | |
| 289 | - </tr> | |
| 290 | - <tr class="top-border"> | |
| 291 | - <td class="column-1"> | |
| 292 | - <label><?php printf( __( 'Add %s row(s)', 'tablepress' ), '<input type="number" id="rows-append-number" class="small-text" title="' . esc_attr__( 'This field must contain a positive number.', 'tablepress' ) . '" value="1" min="1" max="99999" required />' ); ?></label> | |
| 293 | - <input type="button" class="button button-append" data-type="rows" value="<?php esc_attr_e( 'Add', 'tablepress' ); ?>" /> | |
| 294 | - </td> | |
| 295 | - <td class="column-2"> | |
| 296 | - <label><?php printf( __( 'Add %s column(s)', 'tablepress' ), '<input type="number" id="columns-append-number" class="small-text" title="' . esc_attr__( 'This field must contain a positive number.', 'tablepress' ) . '" value="1" min="1" max="99999" required />' ); ?></label> | |
| 297 | - <input type="button" class="button button-append" data-type="columns" value="<?php esc_attr_e( 'Add', 'tablepress' ); ?>" /> | |
| 298 | - </td> | |
| 299 | - </tr> | |
| 300 | -</table> | |
| 301 | - <?php | |
| 276 | + public function postbox_table_information( array $data, array $box ): void { | |
| 277 | + echo '<div id="tablepress-table-information-section"></div>'; | |
| 278 | + | |
| 279 | + if ( ! TABLEPRESS_IS_PLAYGROUND_PREVIEW && tb_tp_fs()->is_free_plan() ) : | |
| 280 | + ?> | |
| 281 | + <div class="postbox premium-features"> | |
| 282 | + <div> | |
| 283 | + <div> | |
| 284 | + <div class="postbox-header"> | |
| 285 | + <h2><span class="dashicons dashicons-lightbulb"></span> <?php _e( 'TablePress has more to offer!', 'tablepress' ); ?></h2> | |
| 286 | + </div> | |
| 287 | + <div class="inside"> | |
| 288 | + <?php | |
| 289 | + TablePress::load_modules_data(); | |
| 290 | + $random_module_slug = array_rand( TablePress::$modules ); | |
| 291 | + $feature_module = TablePress::$modules[ $random_module_slug ]; | |
| 292 | + $module_url = esc_url( "https://tablepress.org/modules/{$random_module_slug}/?utm_source=plugin&utm_medium=textlink&utm_content=edit-screen" ); | |
| 293 | + | |
| 294 | + echo '<strong>' . __( 'Supercharge your tables with exceptional features:', 'tablepress' ) . '</strong>'; | |
| 295 | + echo '<h3><a href="' . $module_url . '">' . $feature_module['name'] . '</a></h3>'; | |
| 296 | + echo '<span>' . $feature_module['description'] . ' <a href="' . $module_url . '">' . __( 'Read more!', 'tablepress' ) . '</a></span>'; | |
| 297 | + ?> | |
| 298 | + </div> | |
| 299 | + </div> | |
| 300 | + <div class="buttons"> | |
| 301 | + <a href="https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=edit-screen" class="tablepress-button"> | |
| 302 | + <span><?php _e( 'Compare the TablePress premium versions', 'tablepress' ); ?></span> | |
| 303 | + <span class="dashicons dashicons-arrow-right-alt"></span> | |
| 304 | + </a> | |
| 305 | + </div> | |
| 306 | + </div> | |
| 307 | + </div> | |
| 308 | + <?php | |
| 309 | + endif; | |
| 302 | 310 | } |
| 303 | 311 | |
| 304 | 312 | /** |
| 305 | - * Print the "Preview" and "Save Changes" button. | |
| 313 | + * Prints the content of the "Table Content" post meta box. | |
| 306 | 314 | * |
| 307 | 315 | * @since 1.0.0 |
| 308 | 316 | * |
| 309 | - * @param array $data Data for this screen. | |
| 310 | - * @param array $box Information about the text box. | |
| 317 | + * @param array<string, mixed> $data Data for this screen. | |
| 318 | + * @param array<string, mixed> $box Information about the meta box. | |
| 311 | 319 | */ |
| 312 | - public function textbox_buttons( array $data, array $box ) { | |
| 313 | - $preview_url = TablePress::url( array( 'action' => 'preview_table', 'item' => $data['table']['id'], 'return' => 'edit', 'return_item' => $data['table']['id'] ), true, 'admin-post.php' ); | |
| 314 | - | |
| 315 | - echo '<p id="' . $box['id'] . '-submit" class="submit">'; | |
| 316 | - if ( current_user_can( 'tablepress_preview_table', $data['table']['id'] ) ) { | |
| 317 | - echo '<a href="' . $preview_url . '" class="button button-large button-show-preview" target="_blank" data-shortcut="' . esc_attr( _x( '%1$sP', 'keyboard shortcut for Preview', 'tablepress' ) ) . '">' . __( 'Preview', 'tablepress' ) . '</a>'; | |
| 318 | - } | |
| 319 | - ?> | |
| 320 | - <input type="button" class="button button-primary button-large button-save-changes" value="<?php esc_attr_e( 'Save Changes', 'tablepress' ); ?>" data-shortcut="<?php echo esc_attr( _x( '%1$sS', 'keyboard shortcut for Save Changes', 'tablepress' ) ); ?>" /> | |
| 321 | - <?php | |
| 322 | - echo '</p>'; | |
| 320 | + public function postbox_table_data( array $data, array $box ): void { | |
| 321 | + echo '<div id="tablepress-table-editor-toolbar-section"></div>'; | |
| 322 | + $css_variables = '--table-editor-line-clamp:' . absint( TablePress::$model_options->get( 'table_editor_line_clamp' ) ) . ';'; | |
| 323 | + $css_variables = esc_attr( $css_variables ); | |
| 324 | + echo "<div id=\"table-editor\" style=\"{$css_variables}\"></div>"; | |
| 323 | 325 | } |
| 324 | 326 | |
| 325 | 327 | /** |
| 326 | - * Print the "Delete Table" and "Export Table" buttons. | |
| 328 | + * Prints the container for the sticky "Header Bar". | |
| 327 | 329 | * |
| 328 | - * @since 1.0.0 | |
| 330 | + * @since 3.3.0 | |
| 329 | 331 | * |
| 330 | - * @param array $data Data for this screen. | |
| 331 | - * @param array $box Information about the text box. | |
| 332 | + * @param array<string, mixed> $data Data for this screen. | |
| 333 | + * @param array<string, mixed> $box Information about the text box. | |
| 332 | 334 | */ |
| 333 | - public function textbox_other_actions( array $data, array $box ) { | |
| 334 | - $user_can_copy_table = current_user_can( 'tablepress_copy_table', $data['table']['id'] ); | |
| 335 | - $user_can_export_table = current_user_can( 'tablepress_export_table', $data['table']['id'] ); | |
| 336 | - $user_can_delete_table = current_user_can( 'tablepress_delete_table', $data['table']['id'] ); | |
| 337 | - | |
| 338 | - if ( ! $user_can_copy_table && ! $user_can_export_table && ! $user_can_delete_table ) { | |
| 339 | - return; | |
| 340 | - } | |
| 341 | - | |
| 342 | - echo '<p class="submit">'; | |
| 343 | - echo __( 'Other Actions', 'tablepress' ) . ': '; | |
| 344 | - if ( $user_can_copy_table ) { | |
| 345 | - echo '<a href="' . TablePress::url( array( 'action' => 'copy_table', 'item' => $data['table']['id'], 'return' => 'edit' ), true, 'admin-post.php' ) . '" class="button">' . __( 'Copy Table', 'tablepress' ) . '</a> '; | |
| 346 | - } | |
| 347 | - if ( $user_can_export_table ) { | |
| 348 | - echo '<a href="' . TablePress::url( array( 'action' => 'export', 'table_id' => $data['table']['id'] ) ) . '" class="button">' . __( 'Export Table', 'tablepress' ) . '</a> '; | |
| 349 | - } | |
| 350 | - if ( $user_can_delete_table ) { | |
| 351 | - echo '<a href="' . TablePress::url( array( 'action' => 'delete_table', 'item' => $data['table']['id'], 'return' => 'edit', 'return_item' => $data['table']['id'] ), true, 'admin-post.php' ) . '" class="button delete-link">' . __( 'Delete Table', 'tablepress' ) . '</a>'; | |
| 352 | - } | |
| 353 | - echo '</p>'; | |
| 335 | + public function textbox_header_bar( array $data, array $box ): void { | |
| 336 | + echo '<div id="tablepress-header-bar-section" class="section-has-react-loading-text">'; | |
| 337 | + echo '</div>'; | |
| 354 | 338 | } |
| 355 | 339 | |
| 356 | 340 | /** |
| 357 | - * Print the hidden containers for the Preview. | |
| 341 | + * Prints the hidden containers for the Preview. | |
| 358 | 342 | * |
| 359 | 343 | * @since 1.0.0 |
| 360 | 344 | * |
| 361 | - * @param array $data Data for this screen. | |
| 362 | - * @param array $box Information about the text box. | |
| 345 | + * @param array<string, mixed> $data Data for this screen. | |
| 346 | + * @param array<string, mixed> $box Information about the text box. | |
| 363 | 347 | */ |
| 364 | - public function textbox_hidden_containers( array $data, array $box ) { | |
| 348 | + public function textbox_hidden_containers( array $data, array $box ): void { | |
| 365 | 349 | ?> |
| 350 | +<div id="tablepress-table-preview-section"></div> | |
| 366 | 351 | <div class="hidden-container"> |
| 367 | 352 | <div id="advanced-editor"> |
| 368 | 353 | <label id="advanced-editor-label" for="advanced-editor-content" class="screen-reader-text"><?php esc_html_e( 'Advanced Editor', 'tablepress' ); ?></label> |
| 369 | 354 | <?php |
| @@ -376,216 +361,94 @@ | ||
| 376 | 361 | ); |
| 377 | 362 | wp_editor( '', 'advanced-editor-content', $wp_editor_options ); |
| 378 | 363 | ?> |
| 379 | 364 | </div> |
| 380 | -</div> | |
| 381 | -<div id="preview-container" class="hidden-container"> | |
| 382 | - <div id="table-preview"> | |
| 383 | - <iframe id="table-preview-iframe" src="about:blank"></iframe> | |
| 384 | - </div> | |
| 385 | -</div> | |
| 386 | -<div class="hidden-container"> | |
| 387 | 365 | <textarea id="textarea-insert-helper" class="hidden"></textarea> |
| 388 | 366 | </div> |
| 389 | -<div id="help-box-combine-cells" class="help-box hidden-container" title="<?php esc_attr_e( 'Help on combining cells', 'tablepress' ); ?>" data-height="380" data-width="420"> | |
| 390 | 367 | <?php |
| 391 | - echo '<p>' . __( 'Table cells can span across more than one column or row.', 'tablepress' ) . '</p>'; | |
| 392 | - echo '<p>' . __( 'Combining consecutive cells within the same row is called “colspanning”.', 'tablepress' ) | |
| 393 | - . ' ' . __( 'Combining consecutive cells within the same column is called “rowspanning”.', 'tablepress' ) . '</p>'; | |
| 394 | - echo '<p>' . sprintf( __( 'To combine adjacent cells, select the desired cells and click the “%s” button or use the context menu.', 'tablepress' ), __( 'Combine/Merge', 'tablepress' ) ) | |
| 395 | - . ' ' . __( 'The corresponding keywords, <code>#colspan#</code> and <code>#rowspan#</code>, will then be added for you.', 'tablepress' ) . '</p>'; | |
| 396 | - echo '<p><strong>' . __( 'Be aware that the Table Features for Site Visitors, like sorting, filtering, and pagination, will not work on tables which have combined cells.', 'tablepress' ) . '</strong></p>'; | |
| 397 | - ?> | |
| 398 | -</div> | |
| 399 | - <?php | |
| 400 | 368 | } |
| 401 | 369 | |
| 402 | 370 | /** |
| 403 | - * Print the content of the "Table Options" post meta box. | |
| 371 | + * Prints the content of the "Table Options" post meta box. | |
| 404 | 372 | * |
| 405 | 373 | * @since 1.0.0 |
| 406 | 374 | * |
| 407 | - * @param array $data Data for this screen. | |
| 408 | - * @param array $box Information about the meta box. | |
| 375 | + * @param array<string, mixed> $data Data for this screen. | |
| 376 | + * @param array<string, mixed> $box Information about the meta box. | |
| 409 | 377 | */ |
| 410 | - public function postbox_table_options( array $data, array $box ) { | |
| 411 | - ?> | |
| 412 | -<table class="tablepress-postbox-table fixed"> | |
| 413 | - <tr> | |
| 414 | - <th class="column-1" scope="row"><?php _e( 'Table Head Row', 'tablepress' ); ?>:</th> | |
| 415 | - <td class="column-2"><label for="option-table_head"><input type="checkbox" id="option-table_head" name="table_head" /> <?php _e( 'The first row of the table is the table header.', 'tablepress' ); ?></label></td> | |
| 416 | - </tr> | |
| 417 | - <tr class="bottom-border"> | |
| 418 | - <th class="column-1" scope="row"><?php _e( 'Table Foot Row', 'tablepress' ); ?>:</th> | |
| 419 | - <td class="column-2"><label for="option-table_foot"><input type="checkbox" id="option-table_foot" name="table_foot" /> <?php _e( 'The last row of the table is the table footer.', 'tablepress' ); ?></label></td> | |
| 420 | - </tr> | |
| 421 | - <tr class="top-border"> | |
| 422 | - <th class="column-1" scope="row"><?php _e( 'Alternating Row Colors', 'tablepress' ); ?>:</th> | |
| 423 | - <td class="column-2"><label for="option-alternating_row_colors"><input type="checkbox" id="option-alternating_row_colors" name="alternating_row_colors" /> <?php _e( 'The background colors of consecutive rows shall alternate.', 'tablepress' ); ?></label></td> | |
| 424 | - </tr> | |
| 425 | - <tr class="bottom-border"> | |
| 426 | - <th class="column-1" scope="row"><?php _e( 'Row Hover Highlighting', 'tablepress' ); ?>:</th> | |
| 427 | - <td class="column-2"><label for="option-row_hover"><input type="checkbox" id="option-row_hover" name="row_hover" /> <?php _e( 'Highlight a row while the mouse cursor hovers above it by changing its background color.', 'tablepress' ); ?></label></td> | |
| 428 | - </tr> | |
| 429 | - <tr class="top-border"> | |
| 430 | - <th class="column-1" scope="row"><label for="option-print_name"><?php _e( 'Print Table Name', 'tablepress' ); ?></label>:</th> | |
| 431 | - <?php | |
| 432 | - $position_select = '<select id="option-print_name_position" name="print_name_position">'; | |
| 433 | - $position_select .= '<option value="above">' . __( 'above', 'tablepress' ) . '</option>'; | |
| 434 | - $position_select .= '<option value="below">' . __( 'below', 'tablepress' ) . '</option>'; | |
| 435 | - $position_select .= '</select>'; | |
| 436 | - ?> | |
| 437 | - <td class="column-2"><input type="checkbox" id="option-print_name" name="print_name" /> <label><?php printf( _x( 'Show the table name %s the table.', 'position (above or below)', 'tablepress' ), $position_select ); ?></label></td> | |
| 438 | - </tr> | |
| 439 | - <tr class="bottom-border"> | |
| 440 | - <th class="column-1" scope="row"><label for="option-print_description"><?php _e( 'Print Table Description', 'tablepress' ); ?></label>:</th> | |
| 441 | - <?php | |
| 442 | - $position_select = '<select id="option-print_description_position" name="print_description_position">'; | |
| 443 | - $position_select .= '<option value="above">' . __( 'above', 'tablepress' ) . '</option>'; | |
| 444 | - $position_select .= '<option value="below">' . __( 'below', 'tablepress' ) . '</option>'; | |
| 445 | - $position_select .= '</select>'; | |
| 446 | - ?> | |
| 447 | - <td class="column-2"><input type="checkbox" id="option-print_description" name="print_description" /> <label><?php printf( _x( 'Show the table description %s the table.', 'position (above or below)', 'tablepress' ), $position_select ); ?></label></td> | |
| 448 | - </tr> | |
| 449 | - <tr class="top-border"> | |
| 450 | - <th class="column-1" scope="row"><?php _e( 'Extra CSS Classes', 'tablepress' ); ?>:</th> | |
| 451 | - <td class="column-2"><label for="option-extra_css_classes"><input type="text" id="option-extra_css_classes" name="extra_css_classes" class="large-text code" title="<?php esc_attr_e( 'This field can only contain letters, numbers, spaces, hyphens (-), underscores (_), and colons (:).', 'tablepress' ); ?>" pattern="[A-Za-z0-9- _:]*" /><p class="description"><?php echo __( 'Additional CSS classes for styling purposes can be entered here.', 'tablepress' ) . ' ' . sprintf( __( 'This is NOT the place to enter <a href="%s">Custom CSS</a> code!', 'tablepress' ), TablePress::url( array( 'action' => 'options' ) ) ); ?></p></label></td> | |
| 452 | - </tr> | |
| 453 | -</table> | |
| 454 | - <?php | |
| 378 | + public function postbox_table_options( array $data, array $box ): void { | |
| 379 | + echo '<div id="tablepress-table-options-section"></div>'; | |
| 455 | 380 | } |
| 456 | 381 | |
| 457 | 382 | /** |
| 458 | - * Print the content of the "Table Features for Site Visitors" post meta box. | |
| 383 | + * Prints the content of the "Table Features for Site Visitors" post meta box. | |
| 459 | 384 | * |
| 460 | 385 | * @since 1.0.0 |
| 461 | 386 | * |
| 462 | - * @param array $data Data for this screen. | |
| 463 | - * @param array $box Information about the meta box. | |
| 387 | + * @param array<string, mixed> $data Data for this screen. | |
| 388 | + * @param array<string, mixed> $box Information about the meta box. | |
| 464 | 389 | */ |
| 465 | - public function postbox_datatables_features( array $data, array $box ) { | |
| 466 | - ?> | |
| 467 | -<p id="notice-datatables-head-row"><em><?php printf( __( 'These features and options are only available when the “%1$s” checkbox in the “%2$s” section is checked.', 'tablepress' ), __( 'Table Head Row', 'tablepress' ), __( 'Table Options', 'tablepress' ) ); ?></em></p> | |
| 468 | -<table class="tablepress-postbox-table fixed"> | |
| 469 | - <tr class="bottom-border"> | |
| 470 | - <th class="column-1" scope="row"><?php _e( 'Enable Visitor Features', 'tablepress' ); ?>:</th> | |
| 471 | - <td class="column-2"><label for="option-use_datatables"><input type="checkbox" id="option-use_datatables" name="use_datatables" /> <?php _e( 'Offer the following functions for site visitors with this table:', 'tablepress' ); ?></label></td> | |
| 472 | - </tr> | |
| 473 | - <tr class="top-border"> | |
| 474 | - <th class="column-1" scope="row"><?php _e( 'Sorting', 'tablepress' ); ?>:</th> | |
| 475 | - <td class="column-2"><label for="option-datatables_sort"><input type="checkbox" id="option-datatables_sort" name="datatables_sort" /> <?php _e( 'Enable sorting of the table by the visitor.', 'tablepress' ); ?></label></td> | |
| 476 | - </tr> | |
| 477 | - <tr> | |
| 478 | - <th class="column-1" scope="row"><?php _e( 'Search/Filtering', 'tablepress' ); ?>:</th> | |
| 479 | - <td class="column-2"><label for="option-datatables_filter"><input type="checkbox" id="option-datatables_filter" name="datatables_filter" /> <?php _e( 'Enable the visitor to filter or search the table. Only rows with the search word in them are shown.', 'tablepress' ); ?></label></td> | |
| 480 | - </tr> | |
| 481 | - <tr> | |
| 482 | - <th class="column-1" scope="row" style="vertical-align: top;"><?php _e( 'Pagination', 'tablepress' ); ?>:</th> | |
| 483 | - <td class="column-2"><label for="option-datatables_paginate"><input type="checkbox" id="option-datatables_paginate" name="datatables_paginate" /> <?php _e( 'Enable pagination of the table (viewing only a certain number of rows at a time) by the visitor.', 'tablepress' ); ?></label><br /> | |
| 484 | - <label for="option-datatables_paginate_entries" class="checkbox-left"> <?php printf( __( 'Show %s rows per page.', 'tablepress' ), '<input type="number" id="option-datatables_paginate_entries" class="small-text" name="datatables_paginate_entries" min="1" max="99999" required />' ); ?></label></td> | |
| 485 | - </tr> | |
| 486 | - <tr> | |
| 487 | - <th class="column-1" scope="row"><?php _e( 'Pagination Length Change', 'tablepress' ); ?>:</th> | |
| 488 | - <td class="column-2"><label for="option-datatables_lengthchange"><input type="checkbox" id="option-datatables_lengthchange" name="datatables_lengthchange" /> <?php _e( 'Allow the visitor to change the number of rows shown when using pagination.', 'tablepress' ); ?></label></td> | |
| 489 | - </tr> | |
| 490 | - <tr> | |
| 491 | - <th class="column-1" scope="row"><?php _e( 'Info', 'tablepress' ); ?>:</th> | |
| 492 | - <td class="column-2"><label for="option-datatables_info"><input type="checkbox" id="option-datatables_info" name="datatables_info" /> <?php _e( 'Enable the table information display, with information about the currently visible data, like the number of rows.', 'tablepress' ); ?></label></td> | |
| 493 | - </tr> | |
| 494 | - <tr<?php echo current_user_can( 'unfiltered_html' ) ? ' class="bottom-border"' : ''; ?>> | |
| 495 | - <th class="column-1" scope="row"><?php _e( 'Horizontal Scrolling', 'tablepress' ); ?>:</th> | |
| 496 | - <td class="column-2"><label for="option-datatables_scrollx"><input type="checkbox" id="option-datatables_scrollx" name="datatables_scrollx" /> <?php _e( 'Enable horizontal scrolling, to make viewing tables with many columns easier.', 'tablepress' ); ?></label></td> | |
| 497 | - </tr> | |
| 498 | - <?php | |
| 499 | - // "Custom Commands" must only be available to trusted users. | |
| 500 | - if ( current_user_can( 'unfiltered_html' ) ) { | |
| 501 | - ?> | |
| 502 | - <tr class="top-border"> | |
| 503 | - <th class="column-1" scope="row"><?php _e( 'Custom Commands', 'tablepress' ); ?>:</th> | |
| 504 | - <td class="column-2"><label for="option-datatables_custom_commands"><textarea id="option-datatables_custom_commands" name="datatables_custom_commands" class="large-text code" rows="1"></textarea><p class="description"><?php echo sprintf( __( 'Additional parameters from the <a href="%s">DataTables documentation</a> to be added to the JS call.', 'tablepress' ), 'https://www.datatables.net/' ) . ' ' . __( 'For advanced use only.', 'tablepress' ); ?></p></label></td> | |
| 505 | - </tr> | |
| 506 | - <?php | |
| 507 | - } // if | |
| 508 | - ?> | |
| 509 | -</table> | |
| 510 | - <?php | |
| 390 | + public function postbox_datatables_features( array $data, array $box ): void { | |
| 391 | + echo '<div id="tablepress-datatables-features-section"></div>'; | |
| 511 | 392 | } |
| 512 | 393 | |
| 513 | 394 | /** |
| 514 | - * Print a notification about JavaScript not being activated in the browser. | |
| 395 | + * Prints a notification about a corrupted table. | |
| 515 | 396 | * |
| 516 | - * @since 2.0.0 | |
| 517 | - * | |
| 518 | - * @param array $data Data for this screen. | |
| 519 | - * @param array $box Information about the text box. | |
| 520 | - */ | |
| 521 | - public function textbox_no_javascript( array $data, array $box ) { | |
| 522 | - ?> | |
| 523 | - <div class="notice notice-error notice-alt notice-large hide-if-js"> | |
| 524 | - <h3><em> | |
| 525 | - <?php _e( 'Attention: Unfortunately, there is a problem!', 'tablepress' ); ?> | |
| 526 | - </em></h3> | |
| 527 | - <p style="font-size:14px"> | |
| 528 | - <strong><?php _e( 'The table editor requires JavaScript. Please enable JavaScript in your browser settings.', 'tablepress' ); ?></strong><br /> | |
| 529 | - <?php _e( 'For help, please follow <a href="https://www.enable-javascript.com/">the instructions on how to enable JavaScript in your browser</a>.', 'tablepress' ); ?> | |
| 530 | - </p> | |
| 531 | - <p> | |
| 532 | - <?php echo '<a href="' . TablePress::url( array( 'action' => 'list' ) ) . '">' . __( 'Back to the List of Tables', 'tablepress' ) . '</a>'; ?> | |
| 533 | - </p> | |
| 534 | - </div> | |
| 535 | - <?php | |
| 536 | - } | |
| 537 | - | |
| 538 | - /** | |
| 539 | - * Print a notification about a corrupted table. | |
| 540 | - * | |
| 541 | 397 | * @since 1.4.0 |
| 542 | 398 | * |
| 543 | - * @param array $data Data for this screen. | |
| 544 | - * @param array $box Information about the text box. | |
| 399 | + * @param array<string, mixed> $data Data for this screen. | |
| 400 | + * @param array<string, mixed> $box Information about the text box. | |
| 545 | 401 | */ |
| 546 | - public function textbox_corrupted_table( array $data, array $box ) { | |
| 402 | + public function textbox_corrupted_table( array $data, array $box ): void { | |
| 547 | 403 | ?> |
| 548 | - <div class="notice notice-error notice-large"> | |
| 549 | - <h3><em> | |
| 550 | - <?php _e( 'Attention: Unfortunately, an error occurred.', 'tablepress' ); ?> | |
| 551 | - </em></h3> | |
| 552 | - <p> | |
| 553 | - <?php | |
| 554 | - printf( __( 'The internal data of table “%1$s” (ID %2$s) is corrupted.', 'tablepress' ), esc_html( $data['table']['name'] ), esc_html( $data['table']['id'] ) ); | |
| 555 | - echo ' '; | |
| 556 | - printf( __( 'The following error was registered: %s.', 'tablepress' ), '<code>' . esc_html( $data['table']['json_error'] ) . '</code>' ); | |
| 557 | - ?> | |
| 558 | - </p> | |
| 559 | - <p> | |
| 560 | - <?php | |
| 561 | - _e( 'Because of this error, the table can not be edited at this time, to prevent possible further data loss.', 'tablepress' ); | |
| 562 | - echo ' '; | |
| 563 | - printf( __( 'Please see the <a href="%s">TablePress FAQ page</a> for further instructions.', 'tablepress' ), 'https://tablepress.org/faq/corrupted-tables/' ); | |
| 564 | - ?> | |
| 565 | - </p> | |
| 566 | - <p> | |
| 567 | - <?php echo '<a href="' . TablePress::url( array( 'action' => 'list' ) ) . '" class="button">' . __( 'Back to the List of Tables', 'tablepress' ) . '</a>'; ?> | |
| 568 | - </p> | |
| 404 | + <div class="notice components-notice is-error notice-error"> | |
| 405 | + <div class="components-notice__content"> | |
| 406 | + <h3><em> | |
| 407 | + <?php _e( 'Attention: Unfortunately, an error occurred.', 'tablepress' ); ?> | |
| 408 | + </em></h3> | |
| 409 | + <p> | |
| 410 | + <?php | |
| 411 | + /* translators: %1$s: Table name, %2$s: Table ID */ | |
| 412 | + printf( __( 'The internal data of table “%1$s” (ID %2$s) is corrupted.', 'tablepress' ), esc_html( $data['table']['name'] ), esc_html( $data['table']['id'] ) ); | |
| 413 | + echo ' '; | |
| 414 | + /* translators: %s: Error message */ | |
| 415 | + printf( __( 'The following error was registered: %s.', 'tablepress' ), '<code>' . esc_html( $data['table']['json_error'] ) . '</code>' ); | |
| 416 | + ?> | |
| 417 | + </p> | |
| 418 | + <p> | |
| 419 | + <?php | |
| 420 | + _e( 'Because of this error, the table can not be edited at this time, to prevent possible further data loss.', 'tablepress' ); | |
| 421 | + echo ' '; | |
| 422 | + /* translators: %s: URL to TablePress FAQ page */ | |
| 423 | + printf( __( 'Please see the <a href="%s">TablePress FAQ page</a> for further instructions.', 'tablepress' ), 'https://tablepress.org/faq/corrupted-tables/' ); | |
| 424 | + ?> | |
| 425 | + </p> | |
| 426 | + <p> | |
| 427 | + <?php echo '<a href="' . esc_url( TablePress::url( array( 'action' => 'list' ) ) ) . '" class="components-button is-secondary is-compact">' . __( 'Back to the List of Tables', 'tablepress' ) . '</a>'; ?> | |
| 428 | + </p> | |
| 429 | + </div> | |
| 569 | 430 | </div> |
| 570 | 431 | <?php |
| 571 | 432 | } |
| 572 | 433 | |
| 573 | 434 | /** |
| 574 | - * Print the screen head text. | |
| 435 | + * Prints the screen head text. | |
| 575 | 436 | * |
| 576 | 437 | * @since 1.0.0 |
| 577 | 438 | * |
| 578 | - * @param array $data Data for this screen. | |
| 579 | - * @param array $box Information about the text box. | |
| 439 | + * @param array<string, mixed> $data Data for this screen. | |
| 440 | + * @param array<string, mixed> $box Information about the text box. | |
| 580 | 441 | */ |
| 581 | - public function textbox_head( array $data, array $box ) { | |
| 442 | + public function textbox_head( array $data, array $box ): void { | |
| 582 | 443 | echo '<p>'; |
| 583 | 444 | _e( 'To edit the content or modify the structure of this table, use the input fields and buttons below.', 'tablepress' ); |
| 584 | 445 | echo ' '; |
| 585 | 446 | // Show the instructions string depending on whether the Block Editor is used on the site or not. |
| 586 | - if ( $data['site_uses_block_editor'] ) { | |
| 447 | + if ( 'block' === $data['site_used_editor'] ) { | |
| 587 | 448 | 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' ) ); |
| 449 | + } elseif ( 'elementor' === $data['site_used_editor'] ) { | |
| 450 | + 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' ) ); | |
| 588 | 451 | } else { |
| 589 | 452 | _e( 'To insert a table into a post or page, paste its Shortcode at the desired place in the editor.', 'tablepress' ); |
| 590 | 453 | } |
| 591 | 454 | echo '</p>'; |
| @@ -591,23 +454,44 @@ | ||
| 591 | 454 | echo '</p>'; |
| 592 | 455 | } |
| 593 | 456 | |
| 594 | 457 | /** |
| 595 | - * Set the content for the WP feature pointer about the drag and drop and sort on the "Edit" screen. | |
| 458 | + * Sets the content for the WP feature pointer about the Table Editor Toolbar on the "Edit" screen. | |
| 596 | 459 | * |
| 597 | - * @since 2.0.0 | |
| 460 | + * @since 3.4.0 | |
| 598 | 461 | */ |
| 599 | - public function wp_pointer_tp20_edit_context_menu() { | |
| 600 | - $content = '<h3>' . __( 'TablePress feature: Context menu', 'tablepress' ) . '</h3>'; | |
| 601 | - $content .= '<p>' . __( 'Did you know?', 'tablepress' ) . ' ' . __( 'Right-clicking the table content fields will open a context menu for quick access to common editing tools.', 'tablepress' ) . '</p>'; | |
| 462 | + public function wp_pointer_tp34_edit_toolbar(): void { | |
| 463 | + $content = '<h3>' . __( 'TablePress feature: Toolbar', 'tablepress' ) . '</h3>'; | |
| 464 | + $content .= '<p style="text-wrap:balance">' . __( 'Adding links or images or modifying the structure of your tables is very easy with the sticky Table Editor Toolbar!', 'tablepress' ) . '</p>'; | |
| 602 | 465 | |
| 603 | - $this->admin_page->print_wp_pointer_js( | |
| 604 | - 'tp20_edit_context_menu', | |
| 605 | - '#table-editor', | |
| 466 | + $this->print_wp_pointer_js( | |
| 467 | + 'tp34_edit_toolbar', | |
| 468 | + '#tablepress-table-editor-toolbar-section > div > div > div:first-child', | |
| 606 | 469 | array( |
| 607 | - 'content' => $content, | |
| 608 | - 'position' => array( 'edge' => 'bottom', 'align' => 'center' ), | |
| 609 | - ) | |
| 470 | + 'content' => $content, | |
| 471 | + 'position' => array( 'edge' => is_rtl() ? 'right' : 'left', 'align' => 'center' ), | |
| 472 | + 'pointerWidth' => 290, | |
| 473 | + ), | |
| 474 | + ); | |
| 475 | + } | |
| 476 | + | |
| 477 | + /** | |
| 478 | + * Sets the content for the WP feature pointer about the Quick Navigation on the "Edit" screen. | |
| 479 | + * | |
| 480 | + * @since 3.3.0 | |
| 481 | + */ | |
| 482 | + public function wp_pointer_tp33_edit_quick_navigation(): void { | |
| 483 | + $content = '<h3>' . __( 'TablePress feature: Quick Navigation', 'tablepress' ) . '</h3>'; | |
| 484 | + $content .= '<p style="text-wrap:balance">' . __( 'You can quickly navigate between different sections of the table editor using the Quick Navigation menu.', 'tablepress' ) . ' ' . __( 'Just click the logo or use the <kbd>%metaKey%J</kbd> keyboard shortcut!', 'tablepress' ) . '</p>'; | |
| 485 | + | |
| 486 | + $this->print_wp_pointer_js( | |
| 487 | + 'tp33_edit_quick_navigation', | |
| 488 | + '#tablepress-header-bar-section', | |
| 489 | + array( | |
| 490 | + 'content' => $content, | |
| 491 | + 'position' => array( 'edge' => 'top', 'align' => is_rtl() ? 'right+16' : 'left-16' ), | |
| 492 | + 'pointerWidth' => 330, | |
| 493 | + ), | |
| 610 | 494 | ); |
| 611 | 495 | } |
| 612 | 496 | |
| 613 | 497 | } // class TablePress_Edit_View |
