PluginProbe
Polylang / 3.7.1
Polylang v3.7.1
3.8.9 3.8.8 3.8.7 3.8.6 3.8.5 3.8.4 3.8.3 2.7 2.7.0.1 2.7.1 2.7.2 2.7.3 2.7.4 2.8 2.8.1 2.8.2 2.8.3 2.8.4 2.9 2.9.1 2.9.2 3.0 3.0.1 3.0.2 3.0.3 All 233 releases
← All changes | admin/admin-base.php +237 -116 2.8 → 3.7.1 View file →
@@ -3,37 +3,82 @@
3 3 * @package Polylang
4 4 */
5 5
6 6 /**
7 - * Base class for both admin
7 + * Setup features available on all admin pages.
8 8 *
9 9 * @since 1.8
10 10 */
11 -class PLL_Admin_Base extends PLL_Base {
12 - public $filter_lang, $curlang, $pref_lang;
11 +abstract class PLL_Admin_Base extends PLL_Base {
12 + /**
13 + * Current language (used to filter the content).
14 + *
15 + * @var PLL_Language|null
16 + */
17 + public $curlang;
13 18
14 19 /**
15 - * Loads the polylang text domain
16 - * Setups actions needed on all admin pages
20 + * Language selected in the admin language filter.
17 21 *
22 + * @var PLL_Language|null
23 + */
24 + public $filter_lang;
25 +
26 + /**
27 + * Preferred language to assign to new contents.
28 + *
29 + * @var PLL_Language|null
30 + */
31 + public $pref_lang;
32 +
33 + /**
34 + * @var PLL_Filters_Links|null
35 + */
36 + public $filters_links;
37 +
38 + /**
39 + * @var PLL_Admin_Links|null
40 + */
41 + public $links;
42 +
43 + /**
44 + * @var PLL_Admin_Notices|null
45 + */
46 + public $notices;
47 +
48 + /**
49 + * @var PLL_Admin_Static_Pages|null
50 + */
51 + public $static_pages;
52 +
53 + /**
54 + * @var PLL_Admin_Default_Term|null
55 + */
56 + public $default_term;
57 +
58 + /**
59 + * Setups actions needed on all admin pages.
60 + *
18 61 * @since 1.8
19 62 *
20 - * @param object $links_model
63 + * @param PLL_Links_Model $links_model Reference to the links model.
21 64 */
22 65 public function __construct( &$links_model ) {
23 66 parent::__construct( $links_model );
24 67
25 - // Plugin i18n, only needed for backend
26 - load_plugin_textdomain( 'polylang' );
27 -
28 68 // Adds the link to the languages panel in the WordPress admin menu
29 69 add_action( 'admin_menu', array( $this, 'add_menus' ) );
30 70
71 + add_action( 'admin_menu', array( $this, 'remove_customize_submenu' ) );
72 +
31 73 // Setup js scripts and css styles
32 - add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueue_scripts' ) );
33 - add_action( 'admin_print_footer_scripts', array( $this, 'admin_print_footer_scripts' ), 0 ); // High priority in case an ajax request is sent by an immediately invoked function
74 + add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueue_scripts' ), 0 ); // High priority in case an ajax request is sent by an immediately invoked function
34 75
35 76 add_action( 'customize_controls_enqueue_scripts', array( $this, 'customize_controls_enqueue_scripts' ) );
77 +
78 + // Early instantiated to be able to correctly initialize language properties.
79 + $this->static_pages = new PLL_Admin_Static_Pages( $this );
80 + $this->model->set_languages_ready();
36 81 }
37 82
38 83 /**
39 84 * Setups filters and action needed on all admin pages and on plugins page
@@ -45,14 +90,16 @@
45 90 parent::init();
46 91
47 92 $this->notices = new PLL_Admin_Notices( $this );
48 93
49 - if ( ! $this->model->get_languages_list() ) {
94 + $this->default_term = new PLL_Admin_Default_Term( $this );
95 + $this->default_term->add_hooks();
96 +
97 + if ( ! $this->model->has_languages() ) {
50 98 return;
51 99 }
52 100
53 101 $this->links = new PLL_Admin_Links( $this ); // FIXME needed here ?
54 - $this->static_pages = new PLL_Admin_Static_Pages( $this ); // FIXME needed here ?
55 102 $this->filters_links = new PLL_Filters_Links( $this ); // FIXME needed here ?
56 103
57 104 // Filter admin language for users
58 105 // We must not call user info before WordPress defines user roles in wp-settings.php
@@ -66,8 +113,10 @@
66 113 /**
67 114 * Adds the link to the languages panel in the WordPress admin menu
68 115 *
69 116 * @since 0.1
117 + *
118 + * @return void
70 119 */
71 120 public function add_menus() {
72 121 global $admin_page_hooks;
73 122
@@ -74,10 +123,10 @@
74 123 // Prepare the list of tabs
75 124 $tabs = array( 'lang' => __( 'Languages', 'polylang' ) );
76 125
77 126 // Only if at least one language has been created
78 - if ( $this->model->get_languages_list() ) {
79 - $tabs['strings'] = __( 'Strings translations', 'polylang' );
127 + if ( $this->model->has_languages() ) {
128 + $tabs['strings'] = __( 'Translations', 'polylang' );
80 129 }
81 130
82 131 $tabs['settings'] = __( 'Settings', 'polylang' );
83 132
@@ -95,9 +144,9 @@
95 144 foreach ( $tabs as $tab => $title ) {
96 145 $page = 'lang' === $tab ? 'mlang' : "mlang_$tab";
97 146 if ( empty( $parent ) ) {
98 147 $parent = $page;
99 - add_menu_page( $title, __( 'Languages', 'polylang' ), 'manage_options', $page, null, 'dashicons-translation' );
148 + add_menu_page( $title, __( 'Languages', 'polylang' ), 'manage_options', $page, '__return_null', 'dashicons-translation' );
100 149 $admin_page_hooks[ $page ] = 'languages'; // Hack to avoid the localization of the hook name. See: https://core.trac.wordpress.org/ticket/18857
101 150 }
102 151
103 152 add_submenu_page( $parent, $title, $title, 'manage_options', $page, array( $this, 'languages_page' ) );
@@ -104,80 +153,130 @@
104 153 }
105 154 }
106 155
107 156 /**
157 + * Dummy method to display the 3 tabs pages: languages, strings translations, settings.
158 + * Overwritten in `PLL_Settings`.
159 + *
160 + * @since 3.7
161 + *
162 + * @return void
163 + */
164 + public function languages_page() {}
165 +
166 + /**
108 167 * Setup js scripts & css styles ( only on the relevant pages )
109 168 *
110 169 * @since 0.6
170 + *
171 + * @return void
111 172 */
112 173 public function admin_enqueue_scripts() {
174 + $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
175 +
176 + wp_enqueue_script( 'pll_admin', plugins_url( "/js/build/admin{$suffix}.js", POLYLANG_ROOT_FILE ), array( 'jquery' ), POLYLANG_VERSION, true );
177 + $inline_script = sprintf( 'let pll_admin = %s;', wp_json_encode( array( 'ajax_filter' => $this->get_ajax_filter_data() ) ) );
178 + wp_add_inline_script( 'pll_admin', $inline_script, 'before' );
179 +
113 180 $screen = get_current_screen();
114 181 if ( empty( $screen ) ) {
115 182 return;
116 183 }
117 184
118 - $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
119 -
120 185 /*
121 186 * For each script:
122 187 * 0 => the pages on which to load the script
123 188 * 1 => the scripts it needs to work
124 - * 2 => 1 if loaded even if languages have not been defined yet, 0 otherwise
125 - * 3 => 1 if loaded in footer
189 + * 2 => true if loaded even if languages have not been defined yet, false otherwise
190 + * 3 => true if loaded in footer
126 191 */
127 192 $scripts = array(
128 - 'user' => array( array( 'profile', 'user-edit' ), array( 'jquery' ), 0, 0 ),
129 - 'widgets' => array( array( 'widgets' ), array( 'jquery' ), 0, 0 ),
193 + 'user' => array( array( 'profile', 'user-edit' ), array( 'jquery' ), false, false ),
194 + 'widgets' => array( array( 'widgets' ), array( 'jquery' ), false, false ),
130 195 );
131 196
197 + $block_screens = array( 'widgets', 'site-editor' );
198 +
132 199 if ( ! empty( $screen->post_type ) && $this->model->is_translated_post_type( $screen->post_type ) ) {
133 - $scripts['post'] = array( array( 'edit', 'upload' ), array( 'jquery', 'wp-ajax-response' ), 0, 1 );
200 + $scripts['post'] = array( array( 'edit', 'upload' ), array( 'jquery', 'wp-ajax-response' ), false, true );
134 201
135 202 // Classic editor.
136 203 if ( ! method_exists( $screen, 'is_block_editor' ) || ! $screen->is_block_editor() ) {
137 - $scripts['classic-editor'] = array( array( 'post', 'media', 'async-upload' ), array( 'jquery', 'wp-ajax-response', 'post' ), 0, 1 );
204 + $scripts['classic-editor'] = array( array( 'post', 'media', 'async-upload' ), array( 'jquery', 'wp-ajax-response', 'post', 'jquery-ui-dialog', 'wp-i18n' ), false, true );
138 205 }
139 206
140 207 // Block editor with legacy metabox in WP 5.0+.
141 - if ( method_exists( $screen, 'is_block_editor' ) && $screen->is_block_editor() && ! pll_use_block_editor_plugin() ) {
142 - $scripts['block-editor'] = array( array( 'post' ), array( 'jquery', 'wp-ajax-response', 'wp-api-fetch' ), 0, 1 );
143 - }
208 + $block_screens[] = 'post';
144 209 }
145 210
211 + if ( $this->is_block_editor( $screen ) ) {
212 + $scripts['block-editor'] = array( $block_screens, array( 'jquery', 'wp-ajax-response', 'wp-api-fetch', 'jquery-ui-dialog', 'wp-i18n' ), false, true );
213 + }
214 +
146 215 if ( ! empty( $screen->taxonomy ) && $this->model->is_translated_taxonomy( $screen->taxonomy ) ) {
147 - $scripts['term'] = array( array( 'edit-tags', 'term' ), array( 'jquery', 'wp-ajax-response', 'jquery-ui-autocomplete' ), 0, 1 );
216 + $scripts['term'] = array( array( 'edit-tags', 'term' ), array( 'jquery', 'wp-ajax-response', 'jquery-ui-autocomplete' ), false, true );
148 217 }
149 218
150 219 foreach ( $scripts as $script => $v ) {
151 - if ( in_array( $screen->base, $v[0] ) && ( $v[2] || $this->model->get_languages_list() ) ) {
152 - wp_enqueue_script( 'pll_' . $script, plugins_url( '/js/' . $script . $suffix . '.js', POLYLANG_FILE ), $v[1], POLYLANG_VERSION, $v[3] );
220 + if ( in_array( $screen->base, $v[0] ) && ( $v[2] || $this->model->has_languages() ) ) {
221 + wp_enqueue_script( "pll_{$script}", plugins_url( "/js/build/{$script}{$suffix}.js", POLYLANG_ROOT_FILE ), $v[1], POLYLANG_VERSION, $v[3] );
222 + if ( 'classic-editor' === $script || 'block-editor' === $script ) {
223 + wp_set_script_translations( "pll_{$script}", 'polylang' );
224 + }
153 225 }
154 226 }
155 227
156 - wp_enqueue_style( 'polylang_admin', plugins_url( '/css/admin' . $suffix . '.css', POLYLANG_FILE ), array(), POLYLANG_VERSION );
228 + wp_register_style( 'polylang_admin', plugins_url( "/css/build/admin{$suffix}.css", POLYLANG_ROOT_FILE ), array( 'wp-jquery-ui-dialog' ), POLYLANG_VERSION );
229 + wp_enqueue_style( 'polylang_dialog', plugins_url( "/css/build/dialog{$suffix}.css", POLYLANG_ROOT_FILE ), array( 'polylang_admin' ), POLYLANG_VERSION );
157 230
158 - $this->localize_scripts();
231 + $this->add_inline_scripts();
159 232 }
160 233
161 234 /**
235 + * Tells whether or not the given screen is block editor kind.
236 + * e.g. widget, site or post editor.
237 + *
238 + * @since 3.3
239 + *
240 + * @param WP_Screen $screen Screen object.
241 + * @return bool True if the screen is a block editor, false otherwise.
242 + */
243 + protected function is_block_editor( $screen ) {
244 + return method_exists( $screen, 'is_block_editor' ) && $screen->is_block_editor() && ! pll_use_block_editor_plugin();
245 + }
246 +
247 + /**
162 248 * Enqueue scripts to the WP Customizer.
163 249 *
164 250 * @since 2.4.0
251 + *
252 + * @return void
165 253 */
166 254 public function customize_controls_enqueue_scripts() {
167 - if ( $this->model->get_languages_list() ) {
255 + if ( $this->model->has_languages() ) {
168 256 $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
169 - wp_enqueue_script( 'pll_widgets', plugins_url( '/js/widgets' . $suffix . '.js', POLYLANG_FILE ), array( 'jquery' ), POLYLANG_VERSION, true );
170 - $this->localize_scripts();
257 + wp_enqueue_script( 'pll_widgets', plugins_url( '/js/build/widgets' . $suffix . '.js', POLYLANG_ROOT_FILE ), array( 'jquery' ), POLYLANG_VERSION, true );
258 + $this->add_inline_scripts();
171 259 }
172 260 }
173 261
174 262 /**
175 - * Localize scripts.
263 + * Adds inline scripts to set the default language in JS
264 + * and localizes scripts.
176 265 *
177 - * @since 2.4.0
266 + * @since 3.3
267 + *
268 + * @return void
178 269 */
179 - public function localize_scripts() {
270 + private function add_inline_scripts() {
271 + if ( wp_script_is( 'pll_block-editor', 'enqueued' ) ) {
272 + $default_lang_script = 'const pllDefaultLanguage = "' . $this->options['default_lang'] . '";';
273 + wp_add_inline_script(
274 + 'pll_block-editor',
275 + $default_lang_script,
276 + 'before'
277 + );
278 + }
180 279 if ( wp_script_is( 'pll_widgets', 'enqueued' ) ) {
181 280 wp_localize_script(
182 281 'pll_widgets',
183 282 'pll_widgets',
@@ -188,22 +287,24 @@
188 287 }
189 288 }
190 289
191 290 /**
192 - * Sets pll_ajax_backend on all backend ajax request
193 - * The final goal is to detect if an ajax request is made on admin or frontend
291 + * Returns the data to use with the AJAX filter.
292 + * The final goal is to detect if an ajax request is made on admin or frontend.
194 293 *
195 294 * Takes care to various situations:
196 - * when the ajax request has no options.data thanks to ScreenfeedFr
197 - * see: https://wordpress.org/support/topic/ajaxprefilter-may-not-work-as-expected
198 - * when options.data is a json string
199 - * see: https://wordpress.org/support/topic/polylang-breaking-third-party-ajax-requests-on-admin-panels
200 - * when options.data is an empty string (GET request with the method 'load')
201 - * see: https://wordpress.org/support/topic/invalid-url-during-wordpress-new-dashboard-widget-operation
295 + * - When the AJAX request has no `options.data` thanks to ScreenfeedFr.
296 + * See: https://wordpress.org/support/topic/ajaxprefilter-may-not-work-as-expected.
297 + * - When `options.data` is a JSON string.
298 + * See: https://wordpress.org/support/topic/polylang-breaking-third-party-ajax-requests-on-admin-panels.
299 + * - When `options.data` is an empty string (GET request with the method 'load').
300 + * See: https://wordpress.org/support/topic/invalid-url-during-wordpress-new-dashboard-widget-operation.
202 301 *
203 - * @since 1.4
302 + * @since 3.7
303 + *
304 + * @return array
204 305 */
205 - public function admin_print_footer_scripts() {
306 + public function get_ajax_filter_data(): array {
206 307 global $post_ID, $tag_ID;
207 308
208 309 $params = array( 'pll_ajax_backend' => 1 );
209 310 if ( ! empty( $post_ID ) ) {
@@ -213,42 +314,16 @@
213 314 if ( ! empty( $tag_ID ) ) {
214 315 $params = array_merge( $params, array( 'pll_term_id' => (int) $tag_ID ) );
215 316 }
216 317
217 - $str = http_build_query( $params );
218 - $arr = wp_json_encode( $params );
219 - ?>
220 - <script type="text/javascript">
221 - if (typeof jQuery != 'undefined') {
222 - (function($){
223 - $.ajaxPrefilter(function (options, originalOptions, jqXHR) {
224 - if ( -1 != options.url.indexOf( ajaxurl ) || -1 != ajaxurl.indexOf( options.url ) ) {
225 - if ( 'undefined' === typeof options.data ) {
226 - options.data = ( 'get' === options.type.toLowerCase() ) ? '<?php echo $str; // phpcs:ignore WordPress.Security.EscapeOutput ?>' : <?php echo $arr; // phpcs:ignore WordPress.Security.EscapeOutput ?>;
227 - } else {
228 - if ( 'string' === typeof options.data ) {
229 - if ( '' === options.data && 'get' === options.type.toLowerCase() ) {
230 - options.url = options.url+'&<?php echo $str; // phpcs:ignore WordPress.Security.EscapeOutput ?>';
231 - } else {
232 - try {
233 - var o = $.parseJSON(options.data);
234 - o = $.extend(o, <?php echo $arr; // phpcs:ignore WordPress.Security.EscapeOutput ?>);
235 - options.data = JSON.stringify(o);
236 - }
237 - catch(e) {
238 - options.data = '<?php echo $str; // phpcs:ignore WordPress.Security.EscapeOutput ?>&'+options.data;
239 - }
240 - }
241 - } else {
242 - options.data = $.extend(options.data, <?php echo $arr; // phpcs:ignore WordPress.Security.EscapeOutput ?>);
243 - }
244 - }
245 - }
246 - });
247 - })(jQuery)
248 - }
249 - </script>
250 - <?php
318 + /**
319 + * Filters the list of parameters to add to the admin ajax request.
320 + *
321 + * @since 3.4.5
322 + *
323 + * @param array $params List of parameters to add to the admin ajax request.
324 + */
325 + return (array) apply_filters( 'pll_admin_ajax_params', $params );
251 326 }
252 327
253 328 /**
254 329 * Sets the admin current language, used to filter the content
@@ -253,8 +328,10 @@
253 328 /**
254 329 * Sets the admin current language, used to filter the content
255 330 *
256 331 * @since 2.0
332 + *
333 + * @return void
257 334 */
258 335 public function set_current_language() {
259 336 $this->curlang = $this->filter_lang;
260 337
@@ -260,9 +337,9 @@
260 337
261 338 // Edit Post
262 339 if ( isset( $_REQUEST['pll_post_id'] ) && $lang = $this->model->post->get_language( (int) $_REQUEST['pll_post_id'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
263 340 $this->curlang = $lang;
264 - } elseif ( 'post.php' === $GLOBALS['pagenow'] && isset( $_GET['post'] ) && $lang = $this->model->post->get_language( (int) $_GET['post'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
341 + } elseif ( 'post.php' === $GLOBALS['pagenow'] && isset( $_GET['post'] ) && $this->model->is_translated_post_type( get_post_type( (int) $_GET['post'] ) ) && $lang = $this->model->post->get_language( (int) $_GET['post'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
265 342 $this->curlang = $lang;
266 343 } elseif ( 'post-new.php' === $GLOBALS['pagenow'] && ( empty( $_GET['post_type'] ) || $this->model->is_translated_post_type( sanitize_key( $_GET['post_type'] ) ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
267 344 $this->curlang = empty( $_GET['new_lang'] ) ? $this->pref_lang : $this->model->get_language( sanitize_key( $_GET['new_lang'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
268 345 }
@@ -267,15 +344,14 @@
267 344 $this->curlang = empty( $_GET['new_lang'] ) ? $this->pref_lang : $this->model->get_language( sanitize_key( $_GET['new_lang'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
268 345 }
269 346
270 347 // Edit Term
271 - // FIXME 'edit-tags.php' for backward compatibility with WP < 4.5
272 - elseif ( in_array( $GLOBALS['pagenow'], array( 'edit-tags.php', 'term.php' ) ) && isset( $_GET['tag_ID'] ) && $lang = $this->model->term->get_language( (int) $_GET['tag_ID'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
348 + elseif ( isset( $_REQUEST['pll_term_id'] ) && $lang = $this->model->term->get_language( (int) $_REQUEST['pll_term_id'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
273 349 $this->curlang = $lang;
274 - } elseif ( isset( $_REQUEST['pll_term_id'] ) && $lang = $this->model->term->get_language( (int) $_REQUEST['pll_term_id'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
275 - $this->curlang = $lang;
276 - } elseif ( 'edit-tags.php' === $GLOBALS['pagenow'] && isset( $_GET['taxonomy'] ) && $this->model->is_translated_taxonomy( sanitize_key( $_GET['taxonomy'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
277 - if ( ! empty( $_GET['new_lang'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
350 + } elseif ( in_array( $GLOBALS['pagenow'], array( 'edit-tags.php', 'term.php' ) ) && isset( $_GET['taxonomy'] ) && $this->model->is_translated_taxonomy( sanitize_key( $_GET['taxonomy'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
351 + if ( isset( $_GET['tag_ID'] ) && $lang = $this->model->term->get_language( (int) $_GET['tag_ID'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
352 + $this->curlang = $lang;
353 + } elseif ( ! empty( $_GET['new_lang'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
278 354 $this->curlang = $this->model->get_language( sanitize_key( $_GET['new_lang'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
279 355 } elseif ( empty( $this->curlang ) ) {
280 356 $this->curlang = $this->pref_lang;
281 357 }
@@ -284,8 +360,27 @@
284 360 // Ajax
285 361 if ( wp_doing_ajax() && ! empty( $_REQUEST['lang'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
286 362 $this->curlang = $this->model->get_language( sanitize_key( $_REQUEST['lang'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
287 363 }
364 +
365 + /**
366 + * Filters the current language used by Polylang in the admin context.
367 + *
368 + * @since 3.2
369 + *
370 + * @param PLL_Language|false|null $curlang Instance of the current language.
371 + * @param PLL_Admin_Base $polylang Instance of the main Polylang's object.
372 + */
373 + $this->curlang = apply_filters( 'pll_admin_current_language', $this->curlang, $this );
374 +
375 + // Inform that the admin language has been set.
376 + if ( $this->curlang instanceof PLL_Language ) {
377 + /** This action is documented in frontend/choose-lang.php */
378 + do_action( 'pll_language_defined', $this->curlang->slug, $this->curlang );
379 + } else {
380 + /** This action is documented in include/class-polylang.php */
381 + do_action( 'pll_no_language_defined' ); // To load overridden textdomains.
382 + }
288 383 }
289 384
290 385 /**
291 386 * Defines the backend language and the admin language filter based on user preferences
@@ -290,8 +385,10 @@
290 385 /**
291 386 * Defines the backend language and the admin language filter based on user preferences
292 387 *
293 388 * @since 1.2.3
389 + *
390 + * @return void
294 391 */
295 392 public function init_user() {
296 393 // Language for admin language filter: may be empty
297 394 // $_GET['lang'] is numeric when editing a language, not when selecting a new language in the filter
@@ -302,31 +399,21 @@
302 399
303 400 $this->filter_lang = $this->model->get_language( get_user_meta( get_current_user_id(), 'pll_filter_content', true ) );
304 401
305 402 // Set preferred language for use when saving posts and terms: must not be empty
306 - $this->pref_lang = empty( $this->filter_lang ) ? $this->model->get_language( $this->options['default_lang'] ) : $this->filter_lang;
403 + $this->pref_lang = empty( $this->filter_lang ) ? $this->model->get_default_language() : $this->filter_lang;
307 404
308 405 /**
309 - * Filter the preferred language on admin side
310 - * The preferred language is used for example to determine the language of a new post
406 + * Filters the preferred language on admin side.
407 + * The preferred language is used for example to determine the language of a new post.
311 408 *
312 409 * @since 1.2.3
313 410 *
314 - * @param object $pref_lang preferred language
411 + * @param PLL_Language $pref_lang Preferred language.
315 412 */
316 413 $this->pref_lang = apply_filters( 'pll_admin_preferred_language', $this->pref_lang );
317 414
318 415 $this->set_current_language();
319 -
320 - // Inform that the admin language has been set
321 - // Only if the admin language is one of the Polylang defined language
322 - if ( $curlang = $this->model->get_language( get_user_locale() ) ) {
323 - /** This action is documented in frontend/choose-lang.php */
324 - do_action( 'pll_language_defined', $curlang->slug, $curlang );
325 - } else {
326 - /** This action is documented in include/class-polylang.php */
327 - do_action( 'pll_no_language_defined' ); // to load overridden textdomains
328 - }
329 416 }
330 417
331 418 /**
332 419 * Avoids parsing a tax query when all languages are requested
@@ -331,13 +418,13 @@
331 418 /**
332 419 * Avoids parsing a tax query when all languages are requested
333 420 * Fixes https://wordpress.org/support/topic/notice-undefined-offset-0-in-wp-includesqueryphp-on-line-3877 introduced in WP 4.1
334 421 *
335 - * @see the suggestion of @boonebgorges, https://core.trac.wordpress.org/ticket/31246
422 + * @see https://core.trac.wordpress.org/ticket/31246 the suggestion of @boonebgorges.
336 423 *
337 424 * @since 1.6.5
338 425 *
339 - * @param array $qvars
426 + * @param array $qvars The array of requested query variables.
340 427 * @return array
341 428 */
342 429 public function request( $qvars ) {
343 430 if ( isset( $qvars['lang'] ) && 'all' === $qvars['lang'] ) {
@@ -347,13 +434,14 @@
347 434 return $qvars;
348 435 }
349 436
350 437 /**
351 - * Adds the languages list in admin bar for the admin languages filter
438 + * Adds the languages list in admin bar for the admin languages filter.
352 439 *
353 440 * @since 0.9
354 441 *
355 - * @param object $wp_admin_bar
442 + * @param WP_Admin_Bar $wp_admin_bar WP_Admin_Bar global object.
443 + * @return void
356 444 */
357 445 public function admin_bar_menu( $wp_admin_bar ) {
358 446 $all_item = (object) array(
359 447 'slug' => 'all',
@@ -364,9 +452,9 @@
364 452 $selected = empty( $this->filter_lang ) ? $all_item : $this->filter_lang;
365 453
366 454 $title = sprintf(
367 455 '<span class="ab-label"%1$s><span class="screen-reader-text">%2$s</span>%3$s</span>',
368 - 'all' === $selected->slug ? '' : sprintf( ' lang="%s"', esc_attr( $selected->get_locale( 'display' ) ) ),
456 + $selected instanceof PLL_Language ? sprintf( ' lang="%s"', esc_attr( $selected->get_locale( 'display' ) ) ) : '',
369 457 __( 'Filters content by language', 'polylang' ),
370 458 esc_html( $selected->name )
371 459 );
372 460
@@ -378,17 +466,23 @@
378 466 * @param array $items The admin languages filter submenu items.
379 467 */
380 468 $items = apply_filters( 'pll_admin_languages_filter', array_merge( array( $all_item ), $this->model->get_languages_list() ) );
381 469
470 + $menu = array(
471 + 'id' => 'languages',
472 + 'title' => $selected->flag . $title,
473 + 'href' => esc_url( add_query_arg( 'lang', $selected->slug, remove_query_arg( 'paged' ) ) ),
474 + 'meta' => array(
475 + 'title' => __( 'Filters content by language', 'polylang' ),
476 + ),
477 + );
478 +
479 + if ( 'all' !== $selected->slug ) {
480 + $menu['meta']['class'] = 'pll-filtered-languages';
481 + }
482 +
382 483 if ( ! empty( $items ) ) {
383 - $wp_admin_bar->add_menu(
384 - array(
385 - 'id' => 'languages',
386 - 'title' => $selected->flag . $title,
387 - 'href' => esc_url( add_query_arg( 'lang', $selected->slug, remove_query_arg( 'paged' ) ) ),
388 - 'meta' => array( 'title' => __( 'Filters content by language', 'polylang' ) ),
389 - )
390 - );
484 + $wp_admin_bar->add_menu( $menu );
391 485 }
392 486
393 487 foreach ( $items as $lang ) {
394 488 if ( $selected->slug === $lang->slug ) {
@@ -403,7 +497,34 @@
403 497 'href' => esc_url( add_query_arg( 'lang', $lang->slug, remove_query_arg( 'paged' ) ) ),
404 498 'meta' => 'all' === $lang->slug ? array() : array( 'lang' => esc_attr( $lang->get_locale( 'display' ) ) ),
405 499 )
406 500 );
501 + }
502 + }
503 +
504 + /**
505 + * Remove the customize submenu when using a block theme.
506 + *
507 + * WordPress removes the Customizer menu if a block theme is activated and no other plugins interact with it.
508 + * As Polylang interacts with the Customizer, we have to delete this menu ourselves in the case of a block theme,
509 + * unless another plugin than Polylang interacts with the Customizer.
510 + *
511 + * @since 3.2
512 + *
513 + * @return void
514 + */
515 + public function remove_customize_submenu() {
516 + if ( ! $this->should_customize_menu_be_removed() ) {
517 + return;
518 + }
519 +
520 + global $submenu;
521 +
522 + if ( ! empty( $submenu['themes.php'] ) ) {
523 + foreach ( $submenu['themes.php'] as $submenu_item ) {
524 + if ( 'customize' === $submenu_item[1] ) {
525 + remove_submenu_page( 'themes.php', $submenu_item[2] );
526 + }
527 + }
407 528 }
408 529 }
409 530 }