← All changes | classes/class-controller.php +46 -88 1.9.2 → 3.0.4 View file →

		@@ -12,8 +12,9 @@
12	12	defined( 'ABSPATH' ) || die( 'No direct script access allowed!' );
13	13
14	14	/**
15	15	* Base Controller class
	16	+ *
16	17	* @package TablePress
17	18	* @subpackage Controllers
18	19	* @author Tobias Bäthge
19	20	* @since 1.0.0
		@@ -20,64 +21,15 @@
20	21	*/
21	22	abstract class TablePress_Controller {
22	23
23	24	/**
24		- * Instance of the Options Model.
	25	+ * Initializes all controllers.
25	26	*
26	27	* @since 1.0.0
27		- * @var TablePress_Options_Model
28	28	*/
29		- public $model_options;
30		-
31		- /**
32		- * Instance of the Table Model.
33		- *
34		- * @since 1.0.0
35		- * @var TablePress_Table_Model
36		- */
37		- public $model_table;
38		-
39		- /**
40		- * File name of the admin screens' parent page in the admin menu.
41		- *
42		- * @since 1.0.0
43		- * @var string
44		- */
45		- public $parent_page = 'middle';
46		-
47		- /**
48		- * Whether TablePress admin screens are a top-level menu item in the admin menu.
49		- *
50		- * @since 1.0.0
51		- * @var bool
52		- */
53		- public $is_top_level_page = false;
54		-
55		- /**
56		- * Initialize all controllers, by loading Plugin and User Options, and by performing an update check.
57		- *
58		- * @since 1.0.0
59		- */
60	29	public function __construct() {
61		- /*
62		- * References to the TablePress models (only for backwards compatibility in TablePress Extensions!).
63		- * Using `TablePress::$model_options` and `TablePress::$model_table` is recommended!
64		- */
65		- $this->model_options = TablePress::$model_options;
66		- $this->model_table = TablePress::$model_table;
67		-
68	30	// Update check, in all controllers (frontend and admin), to make sure we always have up-to-date options, should be done very early.
69	31	$this->plugin_update_check();
70		-
71		- /**
72		- * Filter the admin menu parent page, which is needed for the construction of plugin URLs.
73		- *
74		- * @since 1.0.0
75		- *
76		- * @param string $parent_page Current admin menu parent page.
77		- */
78		- $this->parent_page = apply_filters( 'tablepress_admin_menu_parent_page', TablePress::$model_options->get( 'admin_menu_parent_page' ) );
79		- $this->is_top_level_page = in_array( $this->parent_page, array( 'top', 'middle', 'bottom' ), true );
80	32	}
81	33
82	34	/**
83	35	* Check if the plugin was updated and perform necessary actions, like updating the options.
		@@ -83,14 +35,16 @@
83	35	* Check if the plugin was updated and perform necessary actions, like updating the options.
84	36	*
85	37	* @since 1.0.0
86	38	*/
87		- protected function plugin_update_check() {
	39	+ protected function plugin_update_check(): void {
88	40	// First activation or plugin update.
89	41	$current_plugin_options_db_version = TablePress::$model_options->get( 'plugin_options_db_version' );
90	42	if ( $current_plugin_options_db_version < TablePress::db_version ) {
91	43	// Allow more PHP execution time for update process.
92		- @set_time_limit( 300 );
	44	+ if ( function_exists( 'set_time_limit' ) ) {
	45	+ @set_time_limit( 300 ); // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged
	46	+ }
93	47
94	48	// Add TablePress capabilities to the WP_Roles objects, for new installations and all versions below 12.
95	49	if ( $current_plugin_options_db_version < 12 ) {
96	50	TablePress::$model_options->add_access_capabilities();
		@@ -98,9 +52,9 @@
98	52
99	53	if ( 0 === TablePress::$model_options->get( 'first_activation' ) ) {
100	54	// Save initial set of plugin options, and time of first activation of the plugin, on first activation.
101	55	TablePress::$model_options->update( array(
102		- 'first_activation' => current_time( 'timestamp' ),
	56	+ 'first_activation' => time(),
103	57	'plugin_options_db_version' => TablePress::db_version,
104	58	) );
105	59	} else {
106	60	// Update Plugin Options Options, if necessary.
		@@ -111,21 +65,37 @@
111	65	'tablepress_version' => TablePress::version,
112	66	'message_plugin_update' => true,
113	67	);
114	68
115		- // Only write files, if "Custom CSS" is to be used, and if there is "Custom CSS".
116		- if ( TablePress::$model_options->get( 'use_custom_css' ) && '' !== TablePress::$model_options->get( 'custom_css' ) ) {
117		- // Re-save "Custom CSS" to re-create all files (as TablePress Default CSS might have changed).
	69	+ // If used, re-save "Custom CSS" to re-create all files (as TablePress Default CSS might have changed).
	70	+ $custom_css = TablePress::$model_options->get( 'custom_css' );
	71	+ if ( TablePress::$model_options->get( 'use_custom_css' ) && '' !== $custom_css ) {
118	72	/**
119	73	* Load WP file functions to provide filesystem access functions early.
120	74	*/
121		- require_once ABSPATH . 'wp-admin/includes/file.php';
	75	+ require_once ABSPATH . 'wp-admin/includes/file.php'; // @phpstan-ignore requireOnce.fileNotFound (This is a WordPress core file that always exists.)
122	76	/**
123	77	* Load WP admin template functions to provide `submit_button()` which is necessary for `request_filesystem_credentials()`.
124	78	*/
125		- require_once ABSPATH . 'wp-admin/includes/template.php';
	79	+ require_once ABSPATH . 'wp-admin/includes/template.php'; // @phpstan-ignore requireOnce.fileNotFound (This is a WordPress core file that always exists.)
126	80	$tablepress_css = TablePress::load_class( 'TablePress_CSS', 'class-css.php', 'classes' );
127		- $result = $tablepress_css->save_custom_css_to_file( TablePress::$model_options->get( 'custom_css' ), TablePress::$model_options->get( 'custom_css_minified' ) );
	81	+
	82	+ $custom_css_minified = TablePress::$model_options->get( 'custom_css_minified' );
	83	+
	84	+ // Update "Custom CSS" to be compatible with DataTables 2, introduced in TablePress 3.0.
	85	+ if ( $current_plugin_options_db_version < 96 ) {
	86	+ $old_custom_css = $custom_css;
	87	+ $custom_css = TablePress::convert_datatables_api_data( $custom_css );
	88	+ if ( $old_custom_css !== $custom_css ) {
	89	+ $custom_css = $tablepress_css->sanitize_css( $custom_css );
	90	+ $custom_css_minified = $tablepress_css->minify_css( $custom_css );
	91	+ $updated_options['custom_css'] = $custom_css;
	92	+ $updated_options['custom_css_minified'] = $custom_css_minified;
	93	+ }
	94	+ unset( $old_custom_css );
	95	+ }
	96	+
	97	+ $result = $tablepress_css->save_custom_css_to_file( $custom_css, $custom_css_minified );
128	98	// If saving was successful, use "Custom CSS" file.
129	99	$updated_options['use_custom_css_file'] = $result;
130	100	// Increase the "Custom CSS" version number for cache busting.
131	101	if ( $result ) {
		@@ -135,45 +105,31 @@
135	105
136	106	TablePress::$model_options->update( $updated_options );
137	107
138	108	// Clear table caches.
139		- if ( $current_plugin_options_db_version < 16 ) {
140		- // For pre-0.9-RC, where the arrays are serialized and not JSON encoded.
141		- TablePress::$model_table->invalidate_table_output_caches_tp09();
142		- } else {
143		- // For 0.9-RC and onwards.
144		- TablePress::$model_table->invalidate_table_output_caches();
145		- }
	109	+ TablePress::$model_table->invalidate_table_output_caches();
146	110
147		- // Add mime type field to existing posts with the TablePress Custom Post Type, so that other plugins know that they are not dealing with plain text.
	111	+ // Add mime type field to existing posts with the TablePress Custom Post Type, in TablePress 1.5.
148	112	if ( $current_plugin_options_db_version < 25 ) {
149	113	TablePress::$model_table->add_mime_type_to_posts();
150	114	}
151	115
152		- // Convert old parameter names to new ones in DataTables "Custom Commands".
153		- if ( $current_plugin_options_db_version < 26 ) {
154		- TablePress::$model_table->convert_datatables_parameter_names_tp15();
	116	+ // Add new access capabilities that were introduced in TablePress 2.3.2.
	117	+ if ( $current_plugin_options_db_version < 77 ) {
	118	+ TablePress::$model_options->add_access_capabilities_tp232();
155	119	}
	120	+
	121	+ // Update all tables' "Custom Commands" to be compatible with DataTables 2, introduced in TablePress 3.0.
	122	+ if ( $current_plugin_options_db_version < 96 ) {
	123	+ TablePress::$model_table->update_custom_commands_datatables_tp30();
	124	+ }
156	125	}
157	126	}
158	127
159	128	// Maybe update the table scheme in each existing table, independently from updating the plugin options.
160	129	if ( TablePress::$model_options->get( 'table_scheme_db_version' ) < TablePress::table_scheme_version ) {
161		- // Convert parameter "datatables_scrollX" to "datatables_scrollx", has to be done before merge_table_options_defaults() is called!
162		- if ( TablePress::$model_options->get( 'table_scheme_db_version' ) < 3 ) {
163		- TablePress::$model_table->merge_table_options_tp08();
164		- }
165		-
166	130	TablePress::$model_table->merge_table_options_defaults();
167		-
168		- // Merge print_name/print_description changes made for 0.6-beta.
169		- if ( TablePress::$model_options->get( 'table_scheme_db_version' ) < 2 ) {
170		- TablePress::$model_table->merge_table_options_tp06();
171		- }
172		-
173		- TablePress::$model_options->update( array(
174		- 'table_scheme_db_version' => TablePress::table_scheme_version,
175		- ) );
	131	+ TablePress::$model_options->update( 'table_scheme_db_version', TablePress::table_scheme_version );
176	132	}
177	133
178	134	/*
179	135	* Update User Options, if necessary.
		@@ -178,13 +134,15 @@
178	134	/*
179	135	* Update User Options, if necessary.
180	136	* User Options are not saved in DB until first change occurs.
181	137	*/
182		- if ( is_user_logged_in() && ( TablePress::$model_options->get( 'user_options_db_version' ) < TablePress::db_version ) ) {
	138	+ if ( is_user_logged_in() && TablePress::$model_options->get( 'user_options_db_version' ) < TablePress::db_version ) {
183	139	TablePress::$model_options->merge_user_options_defaults();
184		- TablePress::$model_options->update( array(
185		- 'user_options_db_version' => TablePress::db_version,
186		- ) );
	140	+ $updated_options = array(
	141	+ 'user_options_db_version' => TablePress::db_version,
	142	+ 'message_superseded_extensions' => true,
	143	+ );
	144	+ TablePress::$model_options->update( $updated_options );
187	145	}
188	146	}
189	147
190	148	} // class TablePress_Controller