PluginProbe
TablePress – Tables in WordPress made easy / 2.0.4
TablePress – Tables in WordPress made easy v2.0.4
3.4 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 All 45 releases
tablepress / views / view-edit.php

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

614 lines 31.5 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 array
29 */
30 protected $wp_pointers = array( 'tp20_edit_context_menu' );
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 $data Data for this view.
39 */
40 public function setup( $action, array $data ) {
41 parent::setup( $action, $data );
42
43 $this->add_text_box( 'no-javascript', array( $this, 'textbox_no_javascript' ), 'header' );
44
45 if ( isset( $data['table']['is_corrupted'] ) && $data['table']['is_corrupted'] ) {
46 $this->add_text_box( 'table-corrupted', array( $this, 'textbox_corrupted_table' ), 'header' );
47 return;
48 }
49
50 $this->process_action_messages( array(
51 'success_add' => __( 'The table was added successfully.', 'tablepress' ),
52 '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'] ) ),
53 'success_import' => __( 'The table was imported successfully.', 'tablepress' ),
54 'error_delete' => __( 'Error: The table could not be deleted.', 'tablepress' ),
55 ) );
56
57 wp_enqueue_style( 'wp-jquery-ui-dialog' );
58 wp_enqueue_style( 'editor-buttons' );
59 wp_enqueue_script( 'wpdialogs' ); // For the Advanced Editor, Table Preview, and Help Boxes.
60 add_filter( 'media_view_strings', array( $this, 'change_media_view_strings' ) );
61 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' ) );
69
70 $this->add_text_box( 'head', array( $this, 'textbox_head' ), 'normal' );
71 $this->add_text_box( 'buttons-1', array( $this, 'textbox_buttons' ), 'normal' );
72 $this->add_meta_box( 'table-information', __( 'Table Information', 'tablepress' ), array( $this, 'postbox_table_information' ), 'normal' );
73 $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 $this->add_meta_box( 'table-options', __( 'Table Options', 'tablepress' ), array( $this, 'postbox_table_options' ), 'normal' );
76 $this->add_meta_box( 'datatables-features', __( 'Table Features for Site Visitors', 'tablepress' ), array( $this, 'postbox_datatables_features' ), 'normal' );
77 $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' );
80 }
81
82 /**
83 * Change Media View string "Insert into post" to "Insert into Table".
84 *
85 * @since 1.0.0
86 *
87 * @param array $strings Current set of Media View strings.
88 * @return array Changed Media View strings.
89 */
90 public function change_media_view_strings( array $strings ) {
91 $strings['insertIntoPost'] = __( 'Insert into Table', 'tablepress' );
92 return $strings;
93 }
94
95 /**
96 * Renders the current view.
97 *
98 * In comparison to the parent class method, this contains handling for the no-js case and adjusts the HTML code structure.
99 *
100 * @since 2.0.0
101 */
102 public function render() {
103 ?>
104 <div id="tablepress-page" class="wrap">
105 <form>
106 <?php
107 $this->print_nav_tab_menu();
108 ?>
109 <div id="tablepress-body">
110 <hr class="wp-header-end" />
111 <?php
112 // Print all header messages.
113 foreach ( $this->header_messages as $message ) {
114 echo $message;
115 }
116
117 $this->do_text_boxes( 'header' );
118 ?>
119 <div id="poststuff" class="hide-if-no-js">
120 <div id="post-body" class="metabox-holder columns-1">
121 <div id="postbox-container-2" class="postbox-container">
122 <?php
123 $this->do_text_boxes( 'normal' );
124 $this->do_meta_boxes( 'normal' );
125
126 $this->do_text_boxes( 'additional' );
127 $this->do_meta_boxes( 'additional' );
128
129 $this->do_text_boxes( 'submit' );
130
131 $this->do_text_boxes( 'side' );
132 $this->do_meta_boxes( 'side' );
133 ?>
134 </div>
135 </div>
136 <br class="clear" />
137 </div>
138 </form>
139 </div>
140 </div>
141 <?php
142 }
143
144 /**
145 * Override parent class method, as the nonces for this view are generated in the JS code.
146 *
147 * @since 1.0.0
148 *
149 * @param array $data Data for this screen.
150 * @param array $box Information about the text box.
151 */
152 protected function action_nonce_field( array $data, array $box ) {
153 // Intentionally left empty. Nonces for this view are generated in postbox_table_data().
154 }
155
156 /**
157 * Print the content of the "Table Information" post meta box.
158 *
159 * @since 1.0.0
160 *
161 * @param array $data Data for this screen.
162 * @param array $box Information about the meta box.
163 */
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 }
191
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;
206
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";
211
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";
216 // 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 );
222 }
223 echo "</script>\n";
224
225 echo '<div id="table-editor"></div>';
226 }
227
228 /**
229 * Print the content of the "Table Manipulation" post meta box.
230 *
231 * @since 1.0.0
232 *
233 * @param array $data Data for this screen.
234 * @param array $box Information about the meta box.
235 */
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' ); ?>:&nbsp;
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' ); ?>:&nbsp;
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' ); ?>:&nbsp;
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' ); ?>:&nbsp;
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' ); ?>:&nbsp;
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' ); ?>:&nbsp;
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' ); ?>:&nbsp;
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' ); ?>:&nbsp;
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>&nbsp;
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>&nbsp;
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
302 }
303
304 /**
305 * Print the "Preview" and "Save Changes" button.
306 *
307 * @since 1.0.0
308 *
309 * @param array $data Data for this screen.
310 * @param array $box Information about the text box.
311 */
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>';
323 }
324
325 /**
326 * Print the "Delete Table" and "Export Table" buttons.
327 *
328 * @since 1.0.0
329 *
330 * @param array $data Data for this screen.
331 * @param array $box Information about the text box.
332 */
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' ) . ':&nbsp; ';
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>';
354 }
355
356 /**
357 * Print the hidden containers for the Preview.
358 *
359 * @since 1.0.0
360 *
361 * @param array $data Data for this screen.
362 * @param array $box Information about the text box.
363 */
364 public function textbox_hidden_containers( array $data, array $box ) {
365 ?>
366 <div class="hidden-container">
367 <div id="advanced-editor">
368 <label id="advanced-editor-label" for="advanced-editor-content" class="screen-reader-text"><?php esc_html_e( 'Advanced Editor', 'tablepress' ); ?></label>
369 <?php
370 $wp_editor_options = array(
371 'textarea_rows' => 10,
372 'tinymce' => false,
373 'quicktags' => array(
374 'buttons' => 'strong,em,link,del,ins,img,code,spell,close',
375 ),
376 );
377 wp_editor( '', 'advanced-editor-content', $wp_editor_options );
378 ?>
379 </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 <textarea id="textarea-insert-helper" class="hidden"></textarea>
388 </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 <?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 &#8220;colspanning&#8221;.', 'tablepress' )
393 . ' ' . __( 'Combining consecutive cells within the same column is called &#8220;rowspanning&#8221;.', '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 }
401
402 /**
403 * Print the content of the "Table Options" post meta box.
404 *
405 * @since 1.0.0
406 *
407 * @param array $data Data for this screen.
408 * @param array $box Information about the meta box.
409 */
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
455 }
456
457 /**
458 * Print the content of the "Table Features for Site Visitors" post meta box.
459 *
460 * @since 1.0.0
461 *
462 * @param array $data Data for this screen.
463 * @param array $box Information about the meta box.
464 */
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 &#8220;%1$s&#8221; checkbox in the &#8220;%2$s&#8221; 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">&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>
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
511 }
512
513 /**
514 * Print a notification about JavaScript not being activated in the browser.
515 *
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 * @since 1.4.0
542 *
543 * @param array $data Data for this screen.
544 * @param array $box Information about the text box.
545 */
546 public function textbox_corrupted_table( array $data, array $box ) {
547 ?>
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 &#8220;%1$s&#8221; (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>
569 </div>
570 <?php
571 }
572
573 /**
574 * Print the screen head text.
575 *
576 * @since 1.0.0
577 *
578 * @param array $data Data for this screen.
579 * @param array $box Information about the text box.
580 */
581 public function textbox_head( array $data, array $box ) {
582 echo '<p>';
583 _e( 'To edit the content or modify the structure of this table, use the input fields and buttons below.', 'tablepress' );
584 echo ' ';
585 // Show the instructions string depending on whether the Block Editor is used on the site or not.
586 if ( $data['site_uses_block_editor'] ) {
587 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' ) );
588 } else {
589 _e( 'To insert a table into a post or page, paste its Shortcode at the desired place in the editor.', 'tablepress' );
590 }
591 echo '</p>';
592 }
593
594 /**
595 * Set the content for the WP feature pointer about the drag and drop and sort on the "Edit" screen.
596 *
597 * @since 2.0.0
598 */
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>';
602
603 $this->admin_page->print_wp_pointer_js(
604 'tp20_edit_context_menu',
605 '#table-editor',
606 array(
607 'content' => $content,
608 'position' => array( 'edge' => 'bottom', 'align' => 'center' ),
609 )
610 );
611 }
612
613 } // class TablePress_Edit_View
614