PluginProbe
TablePress – Tables in WordPress made easy / 2.2.3
TablePress – Tables in WordPress made easy v2.2.3
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-edit.php

view-edit.php in TablePress – Tables in WordPress made easy 2.2.3, at views/view-edit.php

683 lines 36.0 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 /**
3 * Edit Table 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 * Edit Table View class
16 *
17 * @package TablePress
18 * @subpackage Views
19 * @author Tobias Bäthge
20 * @since 1.0.0
21 */
22 class TablePress_Edit_View extends TablePress_View {
23
24 /**
25 * List of WP feature pointers for this view.
26 *
27 * @since 2.0.0
28 * @var string[]
29 */
30 protected $wp_pointers = array( 'tp20_edit_context_menu', 'tp21_edit_screen_options' );
31
32 /**
33 * Set up the view with data and do things that are specific for this view.
34 *
35 * @since 1.0.0
36 *
37 * @param string $action Action for this view.
38 * @param array<string, mixed> $data Data for this view.
39 */
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 $this->add_text_box( 'no-javascript', array( $this, 'textbox_no_javascript' ), 'header' );
46
47 if ( isset( $data['table']['is_corrupted'] ) && $data['table']['is_corrupted'] ) {
48 $this->add_text_box( 'table-corrupted', array( $this, 'textbox_corrupted_table' ), 'header' );
49 return;
50 }
51
52 $this->process_action_messages( array(
53 'success_add' => __( 'The table was added successfully.', 'tablepress' ),
54 'success_copy' => _n( 'The table was copied successfully.', 'The tables were copied successfully.', 1, 'tablepress' ) . ' ' . sprintf( __( 'You are now seeing the copied table, which has the table ID &#8220;%s&#8221;.', 'tablepress' ), esc_html( $data['table']['id'] ) ),
55 'success_import' => __( 'The table was imported successfully.', 'tablepress' ),
56 'error_delete' => __( 'Error: The table could not be deleted.', 'tablepress' ),
57 ) );
58
59 wp_enqueue_style( 'wp-jquery-ui-dialog' );
60 wp_enqueue_style( 'editor-buttons' );
61 wp_enqueue_script( 'wpdialogs' ); // For the Advanced Editor, Table Preview, and Help Boxes.
62 add_filter( 'media_view_strings', array( $this, 'change_media_view_strings' ) );
63 wp_enqueue_media();
64 wp_enqueue_script( 'wplink' ); // JS for the "Insert Link" button.
65 $this->admin_page->enqueue_style( 'jspreadsheet' );
66 $this->admin_page->enqueue_style( 'jsuites', array( 'tablepress-jspreadsheet' ) );
67 $this->admin_page->enqueue_style( 'edit', array( 'tablepress-jspreadsheet', 'tablepress-jsuites' ) );
68 if ( tb_tp_fs()->is_free_plan() ) {
69 $this->admin_page->enqueue_style( 'edit-features', array( 'tablepress-edit' ) );
70 }
71 $this->admin_page->enqueue_script( 'jspreadsheet' );
72 $this->admin_page->enqueue_script( 'jsuites', array( 'tablepress-jspreadsheet' ) );
73 $this->admin_page->enqueue_script( 'edit', array( 'tablepress-jspreadsheet', 'tablepress-jsuites', 'jquery-core' ) );
74
75 $this->add_text_box( 'head', array( $this, 'textbox_head' ), 'normal' );
76 $this->add_text_box( 'buttons-1', array( $this, 'textbox_buttons' ), 'normal' );
77 $this->add_meta_box( 'table-information', __( 'Table Information', 'tablepress' ), array( $this, 'postbox_table_information' ), 'normal' );
78 $this->add_meta_box( 'table-data', __( 'Table Content', 'tablepress' ), array( $this, 'postbox_table_data' ), 'normal' );
79 $this->add_meta_box( 'table-manipulation', __( 'Table Manipulation', 'tablepress' ), array( $this, 'postbox_table_manipulation' ), 'normal' );
80 $this->add_meta_box( 'table-options', __( 'Table Options', 'tablepress' ), array( $this, 'postbox_table_options' ), 'normal' );
81 $this->add_meta_box( 'datatables-features', __( 'Table Features for Site Visitors', 'tablepress' ), array( $this, 'postbox_datatables_features' ), 'normal' );
82 $this->add_text_box( 'hidden-containers', array( $this, 'textbox_hidden_containers' ), 'additional' );
83 $this->add_text_box( 'buttons-2', array( $this, 'textbox_buttons' ), 'additional' );
84 $this->add_text_box( 'other-actions', array( $this, 'textbox_other_actions' ), 'submit' );
85
86 add_filter( 'screen_settings', array( $this, 'add_screen_options_output' ), 10, 2 );
87 }
88
89 /**
90 * Change Media View string "Insert into post" to "Insert into Table".
91 *
92 * @since 1.0.0
93 *
94 * @param array<string, string> $strings Current set of Media View strings.
95 * @return array<string, string> Changed Media View strings.
96 */
97 public function change_media_view_strings( array $strings ): array {
98 $strings['insertIntoPost'] = __( 'Insert into Table', 'tablepress' );
99 return $strings;
100 }
101
102 /**
103 * Adds custom screen options to the screen.
104 *
105 * @since 2.1.0
106 *
107 * @param string $screen_settings Screen settings.
108 * @param WP_Screen $screen WP_Screen object.
109 * @return string Extended Screen settings.
110 */
111 public function add_screen_options_output( /* string */ $screen_settings, WP_Screen $screen ): string {
112 // 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.
113
114 // Protect against other plugins not returning a string for the `$screen_settings` argument.
115 if ( ! is_string( $screen_settings ) ) {
116 $screen_settings = '';
117 }
118
119 $screen_settings = '<fieldset id="tablepress-screen-options" class="screen-options">';
120 $screen_settings .= '<legend>' . __( 'Table editor settings', 'tablepress' ) . '</legend>';
121 $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>';
122 $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>';
123 $screen_settings .= '<div>';
124 $screen_settings .= '<label for="table_editor_column_width">' . __( 'Default column width:', 'tablepress' ) . '</label> ';
125 $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" />';
126 $screen_settings .= sprintf( __( '%s pixels', 'tablepress' ), $input );
127 $screen_settings .= '</div>';
128 $screen_settings .= '<div style="margin-top: 6px;">';
129 $screen_settings .= '<label for="table_editor_line_clamp">' . __( 'Maximum visible lines of text:', 'tablepress' ) . '</label> ';
130 $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" />';
131 $screen_settings .= sprintf( __( '%s lines', 'tablepress' ), $input );
132 $screen_settings .= '</div>';
133 $screen_settings .= '</fieldset>';
134 return $screen_settings;
135 }
136
137
138 /**
139 * Renders the current view.
140 *
141 * In comparison to the parent class method, this contains handling for the no-js case and adjusts the HTML code structure.
142 *
143 * @since 2.0.0
144 */
145 public function render(): void {
146 ?>
147 <div id="tablepress-page" class="wrap">
148 <form>
149 <?php
150 $this->print_nav_tab_menu();
151 ?>
152 <div id="tablepress-body">
153 <hr class="wp-header-end" />
154 <?php
155 // Print all header messages.
156 foreach ( $this->header_messages as $message ) {
157 echo $message;
158 }
159
160 $this->do_text_boxes( 'header' );
161 ?>
162 <div id="poststuff" class="hide-if-no-js">
163 <div id="post-body" class="metabox-holder columns-1">
164 <div id="postbox-container-2" class="postbox-container">
165 <?php
166 $this->do_text_boxes( 'normal' );
167 $this->do_meta_boxes( 'normal' );
168
169 $this->do_text_boxes( 'additional' );
170 $this->do_meta_boxes( 'additional' );
171
172 $this->do_text_boxes( 'submit' );
173
174 $this->do_text_boxes( 'side' );
175 $this->do_meta_boxes( 'side' );
176 ?>
177 </div>
178 </div>
179 <br class="clear" />
180 </div>
181 </form>
182 </div>
183 </div>
184 <?php
185 }
186
187 /**
188 * Override parent class method, as the nonces for this view are generated in the JS code.
189 *
190 * @since 1.0.0
191 *
192 * @param array<string, mixed> $data Data for this screen.
193 * @param array<string, mixed> $box Information about the text box.
194 */
195 protected function action_nonce_field( array $data, array $box ): void {
196 // Intentionally left empty. Nonces for this view are generated in postbox_table_data().
197 }
198
199 /**
200 * Print the content of the "Table Information" post meta box.
201 *
202 * @since 1.0.0
203 *
204 * @param array<string, mixed> $data Data for this screen.
205 * @param array<string, mixed> $box Information about the meta box.
206 */
207 public function postbox_table_information( array $data, array $box ): void {
208 ?>
209 <table class="tablepress-postbox-table fixed">
210 <tr class="bottom-border">
211 <th class="column-1" scope="row"><label for="table-id"><?php _e( 'Table ID', 'tablepress' ); ?>:</label></th>
212 <td class="column-2">
213 <div id="table-id-shortcode-wrapper">
214 <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 ' : ''; ?>/>
215 <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>
216 </div>
217 </td>
218 </tr>
219 <tr class="top-border">
220 <th class="column-1" scope="row"><label for="table-name"><?php _e( 'Table Name', 'tablepress' ); ?>:</label></th>
221 <td class="column-2"><input type="text" id="table-name" class="large-text" value="<?php echo esc_attr( $data['table']['name'] ); ?>" /></td>
222 </tr>
223 <tr class="bottom-border">
224 <th class="column-1 top-align" scope="row"><label for="table-description"><?php _e( 'Description', 'tablepress' ); ?>:</label></th>
225 <td class="column-2"><textarea id="table-description" class="large-text" rows="4"><?php echo esc_textarea( $data['table']['description'] ); ?></textarea></td>
226 </tr>
227 <tr class="top-border">
228 <th class="column-1" scope="row"><?php _e( 'Last Modified', 'tablepress' ); ?>:</th>
229 <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>
230 </tr>
231 </table>
232 <?php
233 if ( tb_tp_fs()->is_free_plan() ) :
234 ?>
235 <div class="postbox premium-features">
236 <div>
237 <div>
238 <div class="postbox-header">
239 <h2><span class="dashicons dashicons-heart"></span> <?php _e( 'TablePress has more to offer!', 'tablepress' ); ?></h2>
240 </div>
241 <div class="inside">
242 <?php
243 TablePress::init_modules();
244 $random_module_slug = array_rand( TablePress::$modules );
245 $feature_module = TablePress::$modules[ $random_module_slug ];
246 $module_url = esc_url( "https://tablepress.org/modules/{$random_module_slug}/?utm_source=plugin&utm_medium=textlink&utm_content=edit-screen" );
247
248 echo '<strong>' . __( 'Supercharge your tables with exceptional features:', 'tablepress' ) . '</strong>';
249 echo '<h3><a href="' . $module_url . '">' . $feature_module['name'] . '</a></h3>';
250 echo '<span>' . $feature_module['description'] . ' <a href="' . $module_url . '">' . __( 'Read more!', 'tablepress' ) . '</a></span>';
251 ?>
252 </div>
253 </div>
254 <div class="buttons">
255 <a href="https://tablepress.org/premium/?utm_source=plugin&utm_medium=textlink&utm_content=edit-screen" class="tablepress-button">
256 <span><?php _e( 'Compare the TablePress premium versions', 'tablepress' ); ?></span>
257 <span class="dashicons dashicons-arrow-right-alt"></span>
258 </a>
259 </div>
260 </div>
261 </div>
262 <?php
263 endif;
264 }
265
266 /**
267 * Print the content of the "Table Content" post meta box.
268 *
269 * @since 1.0.0
270 *
271 * @param array<string, mixed> $data Data for this screen.
272 * @param array<string, mixed> $box Information about the meta box.
273 */
274 public function postbox_table_data( array $data, array $box ): void {
275 echo "<script>\n";
276 echo "window.tp = window.tp || {};\n";
277
278 echo "tp.nonces = {};\n";
279 echo "tp.nonces.edit_table = '" . wp_create_nonce( TablePress::nonce( $this->action, $data['table']['id'] ) ) . "';\n";
280 echo "tp.nonces.preview_table = '" . wp_create_nonce( TablePress::nonce( 'preview_table', $data['table']['id'] ) ) . "';\n";
281 echo "tp.nonces.screen_options = '" . wp_create_nonce( TablePress::nonce( 'screen_options' ) ) . "';\n";
282
283 echo "tp.table = {};\n";
284 echo "tp.table.shortcode = '" . esc_js( TablePress::$shortcode ) . "';\n";
285 echo "tp.table.id = '{$data['table']['id']}';\n";
286 echo "tp.table.new_id = '{$data['table']['id']}';\n";
287 // JSON-encode array items separately to save some PHP memory.
288 foreach ( array( 'data', 'options', 'visibility' ) as $item ) {
289 $json = $this->admin_page->convert_to_json_parse_output( $data['table'][ $item ] );
290 printf( 'tp.table.%1$s = %2$s;' . "\n", $item, $json );
291 }
292
293 echo "tp.screen_options = {};\n";
294 echo 'tp.screen_options.table_editor_column_width = ' . absint( TablePress::$model_options->get( 'table_editor_column_width' ) ) . ";\n";
295 echo "</script>\n";
296
297 $css_variables = '--table-editor-line-clamp:' . absint( TablePress::$model_options->get( 'table_editor_line_clamp' ) ) . ';';
298 $css_variables = esc_attr( $css_variables );
299 echo "<div id=\"table-editor\" style=\"{$css_variables}\"></div>";
300 }
301
302 /**
303 * Print the content of the "Table Manipulation" post meta box.
304 *
305 * @since 1.0.0
306 *
307 * @param array<string, mixed> $data Data for this screen.
308 * @param array<string, mixed> $box Information about the meta box.
309 */
310 public function postbox_table_manipulation( array $data, array $box ): void {
311 ?>
312 <table id="tablepress-manipulation-controls" class="tablepress-postbox-table fixed">
313 <tr class="bottom-border">
314 <td class="column-1">
315 <?php _e( 'Selected cells', 'tablepress' ); ?>:&nbsp;
316 <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' ) ); ?>" />
317 <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' ) ); ?>" />
318 <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' ) ); ?>" />
319 </td>
320 <td class="column-2">
321 <?php _e( 'Selected cells', 'tablepress' ); ?>:&nbsp;
322 <input type="button" class="button button-merge-unmerge" data-action="merge" value="<?php esc_attr_e( 'Combine/Merge', 'tablepress' ); ?>" />
323 <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" />
324 </td>
325 </tr>
326 <tr class="top-border">
327 <td class="column-1">
328 <?php _e( 'Selected rows', 'tablepress' ); ?>:&nbsp;
329 <input type="button" class="button button-insert-duplicate" data-type="rows" data-action="duplicate" value="<?php esc_attr_e( 'Duplicate', 'tablepress' ); ?>" />
330 <input type="button" class="button button-insert-duplicate" data-type="rows" data-action="insert" value="<?php esc_attr_e( 'Insert', 'tablepress' ); ?>" />
331 <input type="button" class="button button-remove" data-type="rows" value="<?php esc_attr_e( 'Delete', 'tablepress' ); ?>" />
332 </td>
333 <td class="column-2">
334 <?php _e( 'Selected columns', 'tablepress' ); ?>:&nbsp;
335 <input type="button" class="button button-insert-duplicate" data-type="columns" data-action="duplicate" value="<?php esc_attr_e( 'Duplicate', 'tablepress' ); ?>" />
336 <input type="button" class="button button-insert-duplicate" data-type="columns" data-action="insert" value="<?php esc_attr_e( 'Insert', 'tablepress' ); ?>" />
337 <input type="button" class="button button-remove" data-type="columns" value="<?php esc_attr_e( 'Delete', 'tablepress' ); ?>" />
338 </td>
339 </tr>
340 <tr>
341 <td class="column-1">
342 <?php _e( 'Selected rows', 'tablepress' ); ?>:&nbsp;
343 <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' ) ); ?>" />
344 <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' ) ); ?>" />
345 </td>
346 <td class="column-2">
347 <?php _e( 'Selected columns', 'tablepress' ); ?>:&nbsp;
348 <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' ) ); ?>" />
349 <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' ) ); ?>" />
350 </td>
351 </tr>
352 <tr class="bottom-border">
353 <td class="column-1">
354 <?php _e( 'Selected rows', 'tablepress' ); ?>:&nbsp;
355 <input type="button" class="button button-hide-unhide" data-type="rows" data-action="hide" value="<?php esc_attr_e( 'Hide', 'tablepress' ); ?>" />
356 <input type="button" class="button button-hide-unhide" data-type="rows" data-action="unhide" value="<?php esc_attr_e( 'Show', 'tablepress' ); ?>" />
357 </td>
358 <td class="column-2">
359 <?php _e( 'Selected columns', 'tablepress' ); ?>:&nbsp;
360 <input type="button" class="button button-hide-unhide" data-type="columns" data-action="hide" value="<?php esc_attr_e( 'Hide', 'tablepress' ); ?>" />
361 <input type="button" class="button button-hide-unhide" data-type="columns" data-action="unhide" value="<?php esc_attr_e( 'Show', 'tablepress' ); ?>" />
362 </td>
363 </tr>
364 <tr class="top-border">
365 <td class="column-1">
366 <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>&nbsp;
367 <input type="button" class="button button-append" data-type="rows" value="<?php esc_attr_e( 'Add', 'tablepress' ); ?>" />
368 </td>
369 <td class="column-2">
370 <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>&nbsp;
371 <input type="button" class="button button-append" data-type="columns" value="<?php esc_attr_e( 'Add', 'tablepress' ); ?>" />
372 </td>
373 </tr>
374 </table>
375 <?php
376 }
377
378 /**
379 * Print the "Preview" and "Save Changes" button.
380 *
381 * @since 1.0.0
382 *
383 * @param array<string, mixed> $data Data for this screen.
384 * @param array<string, mixed> $box Information about the text box.
385 */
386 public function textbox_buttons( array $data, array $box ): void {
387 $preview_url = TablePress::url( array( 'action' => 'preview_table', 'item' => $data['table']['id'], 'return' => 'edit', 'return_item' => $data['table']['id'] ), true, 'admin-post.php' );
388
389 echo '<p id="' . $box['id'] . '-submit" class="submit">';
390 if ( current_user_can( 'tablepress_preview_table', $data['table']['id'] ) ) {
391 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>';
392 }
393 ?>
394 <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' ) ); ?>" />
395 <?php
396 echo '</p>';
397 }
398
399 /**
400 * Print the "Delete Table" and "Export Table" buttons.
401 *
402 * @since 1.0.0
403 *
404 * @param array<string, mixed> $data Data for this screen.
405 * @param array<string, mixed> $box Information about the text box.
406 */
407 public function textbox_other_actions( array $data, array $box ): void {
408 $user_can_copy_table = current_user_can( 'tablepress_copy_table', $data['table']['id'] );
409 $user_can_export_table = current_user_can( 'tablepress_export_table', $data['table']['id'] );
410 $user_can_delete_table = current_user_can( 'tablepress_delete_table', $data['table']['id'] );
411
412 if ( ! $user_can_copy_table && ! $user_can_export_table && ! $user_can_delete_table ) {
413 return;
414 }
415
416 echo '<p class="submit">';
417 echo __( 'Other Actions', 'tablepress' ) . ':&nbsp; ';
418 if ( $user_can_copy_table ) {
419 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> ';
420 }
421 if ( $user_can_export_table ) {
422 echo '<a href="' . TablePress::url( array( 'action' => 'export', 'table_id' => $data['table']['id'] ) ) . '" class="button">' . __( 'Export Table', 'tablepress' ) . '</a> ';
423 }
424 if ( $user_can_delete_table ) {
425 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>';
426 }
427 echo '</p>';
428 }
429
430 /**
431 * Print the hidden containers for the Preview.
432 *
433 * @since 1.0.0
434 *
435 * @param array<string, mixed> $data Data for this screen.
436 * @param array<string, mixed> $box Information about the text box.
437 */
438 public function textbox_hidden_containers( array $data, array $box ): void {
439 ?>
440 <div class="hidden-container">
441 <div id="advanced-editor">
442 <label id="advanced-editor-label" for="advanced-editor-content" class="screen-reader-text"><?php esc_html_e( 'Advanced Editor', 'tablepress' ); ?></label>
443 <?php
444 $wp_editor_options = array(
445 'textarea_rows' => 10,
446 'tinymce' => false,
447 'quicktags' => array(
448 'buttons' => 'strong,em,link,del,ins,img,code,spell,close',
449 ),
450 );
451 wp_editor( '', 'advanced-editor-content', $wp_editor_options );
452 ?>
453 </div>
454 </div>
455 <div id="preview-container" class="hidden-container">
456 <div id="table-preview">
457 <iframe id="table-preview-iframe" src="about:blank"></iframe>
458 </div>
459 </div>
460 <div class="hidden-container">
461 <textarea id="textarea-insert-helper" class="hidden"></textarea>
462 </div>
463 <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">
464 <?php
465 echo '<p>' . __( 'Table cells can span across more than one column or row.', 'tablepress' ) . '</p>';
466 echo '<p>' . __( 'Combining consecutive cells within the same row is called &#8220;colspanning&#8221;.', 'tablepress' )
467 . ' ' . __( 'Combining consecutive cells within the same column is called &#8220;rowspanning&#8221;.', 'tablepress' ) . '</p>';
468 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' ) )
469 . ' ' . __( 'The corresponding keywords, <code>#colspan#</code> and <code>#rowspan#</code>, will then be added for you.', 'tablepress' ) . '</p>';
470 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>';
471 ?>
472 </div>
473 <?php
474 }
475
476 /**
477 * Print the content of the "Table Options" post meta box.
478 *
479 * @since 1.0.0
480 *
481 * @param array<string, mixed> $data Data for this screen.
482 * @param array<string, mixed> $box Information about the meta box.
483 */
484 public function postbox_table_options( array $data, array $box ): void {
485 ?>
486 <table class="tablepress-postbox-table fixed">
487 <tr>
488 <th class="column-1" scope="row"><?php _e( 'Table Head Row', 'tablepress' ); ?>:</th>
489 <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>
490 </tr>
491 <tr class="bottom-border">
492 <th class="column-1" scope="row"><?php _e( 'Table Foot Row', 'tablepress' ); ?>:</th>
493 <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>
494 </tr>
495 <tr class="top-border">
496 <th class="column-1" scope="row"><?php _e( 'Alternating Row Colors', 'tablepress' ); ?>:</th>
497 <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>
498 </tr>
499 <tr class="bottom-border">
500 <th class="column-1" scope="row"><?php _e( 'Row Hover Highlighting', 'tablepress' ); ?>:</th>
501 <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>
502 </tr>
503 <tr class="top-border">
504 <th class="column-1" scope="row"><label for="option-print_name"><?php _e( 'Print Table Name', 'tablepress' ); ?></label>:</th>
505 <?php
506 $position_select = '<select id="option-print_name_position" name="print_name_position">';
507 $position_select .= '<option value="above">' . __( 'above', 'tablepress' ) . '</option>';
508 $position_select .= '<option value="below">' . __( 'below', 'tablepress' ) . '</option>';
509 $position_select .= '</select>';
510 ?>
511 <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>
512 </tr>
513 <tr class="bottom-border">
514 <th class="column-1" scope="row"><label for="option-print_description"><?php _e( 'Print Table Description', 'tablepress' ); ?></label>:</th>
515 <?php
516 $position_select = '<select id="option-print_description_position" name="print_description_position">';
517 $position_select .= '<option value="above">' . __( 'above', 'tablepress' ) . '</option>';
518 $position_select .= '<option value="below">' . __( 'below', 'tablepress' ) . '</option>';
519 $position_select .= '</select>';
520 ?>
521 <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>
522 </tr>
523 <tr class="top-border">
524 <th class="column-1" scope="row"><?php _e( 'Extra CSS Classes', 'tablepress' ); ?>:</th>
525 <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>
526 </tr>
527 </table>
528 <?php
529 }
530
531 /**
532 * Print the content of the "Table Features for Site Visitors" post meta box.
533 *
534 * @since 1.0.0
535 *
536 * @param array<string, mixed> $data Data for this screen.
537 * @param array<string, mixed> $box Information about the meta box.
538 */
539 public function postbox_datatables_features( array $data, array $box ): void {
540 ?>
541 <p id="notice-datatables-head-row"><em><?php printf( __( 'These features and options are only available when the &#8220;%1$s&#8221; checkbox in the &#8220;%2$s&#8221; section is checked.', 'tablepress' ), __( 'Table Head Row', 'tablepress' ), __( 'Table Options', 'tablepress' ) ); ?></em></p>
542 <table class="tablepress-postbox-table fixed">
543 <tr class="bottom-border">
544 <th class="column-1" scope="row"><?php _e( 'Enable Visitor Features', 'tablepress' ); ?>:</th>
545 <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>
546 </tr>
547 <tr class="top-border">
548 <th class="column-1" scope="row"><?php _e( 'Sorting', 'tablepress' ); ?>:</th>
549 <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>
550 </tr>
551 <tr>
552 <th class="column-1" scope="row"><?php _e( 'Search/Filtering', 'tablepress' ); ?>:</th>
553 <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>
554 </tr>
555 <tr>
556 <th class="column-1" scope="row" style="vertical-align: top;"><?php _e( 'Pagination', 'tablepress' ); ?>:</th>
557 <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 />
558 <label for="option-datatables_paginate_entries" class="checkbox-left">&nbsp;<?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>
559 </tr>
560 <tr>
561 <th class="column-1" scope="row"><?php _e( 'Pagination Length Change', 'tablepress' ); ?>:</th>
562 <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>
563 </tr>
564 <tr>
565 <th class="column-1" scope="row"><?php _e( 'Info', 'tablepress' ); ?>:</th>
566 <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>
567 </tr>
568 <tr<?php echo current_user_can( 'unfiltered_html' ) ? ' class="bottom-border"' : ''; ?>>
569 <th class="column-1" scope="row"><?php _e( 'Horizontal Scrolling', 'tablepress' ); ?>:</th>
570 <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>
571 </tr>
572 <?php
573 // "Custom Commands" must only be available to trusted users.
574 if ( current_user_can( 'unfiltered_html' ) ) {
575 ?>
576 <tr class="top-border">
577 <th class="column-1" scope="row"><?php _e( 'Custom Commands', 'tablepress' ); ?>:</th>
578 <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>
579 </tr>
580 <?php
581 } // if
582 ?>
583 </table>
584 <?php
585 }
586
587 /**
588 * Print a notification about a corrupted table.
589 *
590 * @since 1.4.0
591 *
592 * @param array<string, mixed> $data Data for this screen.
593 * @param array<string, mixed> $box Information about the text box.
594 */
595 public function textbox_corrupted_table( array $data, array $box ): void {
596 ?>
597 <div class="notice notice-error notice-large">
598 <h3><em>
599 <?php _e( 'Attention: Unfortunately, an error occurred.', 'tablepress' ); ?>
600 </em></h3>
601 <p>
602 <?php
603 printf( __( 'The internal data of table &#8220;%1$s&#8221; (ID %2$s) is corrupted.', 'tablepress' ), esc_html( $data['table']['name'] ), esc_html( $data['table']['id'] ) );
604 echo ' ';
605 printf( __( 'The following error was registered: %s.', 'tablepress' ), '<code>' . esc_html( $data['table']['json_error'] ) . '</code>' );
606 ?>
607 </p>
608 <p>
609 <?php
610 _e( 'Because of this error, the table can not be edited at this time, to prevent possible further data loss.', 'tablepress' );
611 echo ' ';
612 printf( __( 'Please see the <a href="%s">TablePress FAQ page</a> for further instructions.', 'tablepress' ), 'https://tablepress.org/faq/corrupted-tables/' );
613 ?>
614 </p>
615 <p>
616 <?php echo '<a href="' . TablePress::url( array( 'action' => 'list' ) ) . '" class="button">' . __( 'Back to the List of Tables', 'tablepress' ) . '</a>'; ?>
617 </p>
618 </div>
619 <?php
620 }
621
622 /**
623 * Print the screen head text.
624 *
625 * @since 1.0.0
626 *
627 * @param array<string, mixed> $data Data for this screen.
628 * @param array<string, mixed> $box Information about the text box.
629 */
630 public function textbox_head( array $data, array $box ): void {
631 echo '<p>';
632 _e( 'To edit the content or modify the structure of this table, use the input fields and buttons below.', 'tablepress' );
633 echo ' ';
634 // Show the instructions string depending on whether the Block Editor is used on the site or not.
635 if ( $data['site_uses_block_editor'] ) {
636 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' ) );
637 } else {
638 _e( 'To insert a table into a post or page, paste its Shortcode at the desired place in the editor.', 'tablepress' );
639 }
640 echo '</p>';
641 }
642
643 /**
644 * Sets the content for the WP feature pointer about the drag and drop and sort on the "Edit" screen.
645 *
646 * @since 2.0.0
647 */
648 public function wp_pointer_tp20_edit_context_menu(): void {
649 $content = '<h3>' . __( 'TablePress feature: Context menu', 'tablepress' ) . '</h3>';
650 $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>';
651
652 $this->admin_page->print_wp_pointer_js(
653 'tp20_edit_context_menu',
654 '#table-editor',
655 array(
656 'content' => $content,
657 'position' => array( 'edge' => 'bottom', 'align' => 'center' ),
658 )
659 );
660 }
661
662 /**
663 * Sets the content for the WP feature pointer about the screen options for changing the cell size.
664 *
665 * @since 2.1.0
666 */
667 public function wp_pointer_tp21_edit_screen_options(): void {
668 $content = '<h3>' . __( 'TablePress feature: Column width and row height of the table editor', 'tablepress' ) . '</h3>';
669 $content .= '<p>' . __( 'Did you know?', 'tablepress' ) . ' ' . sprintf( __( 'You can change the default cell size for the table editor on this “Edit” screen in the “%s”.', 'tablepress' ), __( 'Screen Options', 'default' ) ) . '</p>';
670
671 $this->admin_page->print_wp_pointer_js(
672 'tp21_edit_screen_options',
673 '#screen-options-link-wrap',
674 array(
675 'content' => $content,
676 'position' => array( 'edge' => 'top', 'align' => 'right' ),
677 'pointerClass' => 'wp-pointer pointer-tp21_edit_screen_options',
678 )
679 );
680 }
681
682 } // class TablePress_Edit_View
683