PluginProbe
Polylang / 1.5
Polylang v1.5
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-nav-menu.php +182 -162 2.71.5 View file →
@@ -1,128 +1,149 @@
1 1 <?php
2 2
3 -/**
4 - * Manages custom menus translations as well as the language switcher menu item on admin side
3 +/*
4 + * manages custom menus translations as well as the language switcher menu item on admin side
5 5 *
6 6 * @since 1.2
7 7 */
8 -class PLL_Admin_Nav_Menu extends PLL_Nav_Menu {
8 +class PLL_Admin_Nav_Menu {
9 9
10 - /**
11 - * Constructor: setups filters and actions
10 + /*
11 + * constructor: setups filters and actions
12 12 *
13 13 * @since 1.2
14 14 *
15 15 * @param object $polylang
16 16 */
17 - public function __construct( &$polylang ) {
18 - parent::__construct( $polylang );
17 + public function __construct(&$polylang) {
18 + $this->model = &$polylang->model;
19 + $this->options = &$polylang->options;
20 + $this->theme = get_option( 'stylesheet' );
19 21
20 - // Populates nav menus locations
21 - // Since WP 4.4, must be done before customize_register is fired
22 - add_filter( 'theme_mod_nav_menu_locations', array( $this, 'theme_mod_nav_menu_locations' ), 20 );
22 + // integration in the WP menu interface
23 + add_action('admin_init', array(&$this, 'admin_init')); // after Polylang upgrade
23 24
24 - // Integration in the WP menu interface
25 - add_action( 'admin_init', array( $this, 'admin_init' ) ); // after Polylang upgrade
25 + // integration with WP customizer
26 + add_action('customize_register', array(&$this, 'create_nav_menu_locations'), 5);
27 +
28 + // protection against #24802
29 + add_filter('pre_insert_term', array(&$this, 'pre_insert_term'), 10, 2);
26 30 }
27 31
28 - /**
29 - * Setups filters and terms
32 + /*
33 + * setups filters and terms
30 34 * adds the language switcher metabox and create new nav menu locations
31 35 *
32 36 * @since 1.1
33 37 */
34 - public function admin_init() {
35 - add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueue_scripts' ) );
36 - add_action( 'wp_update_nav_menu_item', array( $this, 'wp_update_nav_menu_item' ), 10, 2 );
38 + public function admin_init(){
39 + add_action('admin_enqueue_scripts', array(&$this, 'admin_enqueue_scripts'));
40 + add_action('wp_update_nav_menu_item', array(&$this, 'wp_update_nav_menu_item'), 10, 2);
41 + add_filter('wp_get_nav_menu_items', array(&$this, 'translate_switcher_title'));
37 42
38 - // Translation of menus based on chosen locations
39 - add_filter( 'pre_update_option_theme_mods_' . $this->theme, array( $this, 'pre_update_option_theme_mods' ) );
40 - add_action( 'delete_nav_menu', array( $this, 'delete_nav_menu' ) );
43 + // translation of menus based on chosen locations
44 + add_filter('pre_update_option_theme_mods_' . $this->theme, array($this, 'update_nav_menu_locations'));
45 + add_filter('theme_mod_nav_menu_locations', array($this, 'nav_menu_locations'), 20);
41 46
42 - // FIXME is it possible to choose the order ( after theme locations in WP3.5 and older ) ?
47 + // filter _wp_auto_add_pages_to_menu by language
48 + add_action('transition_post_status', array(&$this, 'auto_add_pages_to_menu'), 5, 3); // before _wp_auto_add_pages_to_menu
49 +
50 + // FIXME is it possible to choose the order (after theme locations in WP3.5 and older) ?
43 51 // FIXME not displayed if Polylang is activated before the first time the user goes to nav menus http://core.trac.wordpress.org/ticket/16828
44 - add_meta_box( 'pll_lang_switch_box', __( 'Language switcher', 'polylang' ), array( $this, 'lang_switch' ), 'nav-menus', 'side', 'high' );
52 + add_meta_box('pll_lang_switch_box', __('Language switcher', 'polylang'), array( &$this, 'lang_switch' ), 'nav-menus', 'side', 'high');
45 53
46 54 $this->create_nav_menu_locations();
47 55 }
48 56
49 - /**
50 - * Language switcher metabox
57 + /*
58 + * create temporary nav menu locations (one per location and per language) for all non-default language
59 + *
60 + * @since 1.2
61 + */
62 + public function create_nav_menu_locations() {
63 + global $_wp_registered_nav_menus;
64 +
65 + if (isset($_wp_registered_nav_menus)) {
66 + foreach ($_wp_registered_nav_menus as $loc => $name)
67 + foreach ($this->model->get_languages_list() as $lang)
68 + $arr[$loc . (pll_default_language() == $lang->slug ? '' : '___' . $lang->slug)] = $name . ' ' . $lang->name;
69 +
70 + $_wp_registered_nav_menus = $arr;
71 + }
72 + }
73 +
74 + /*
75 + * language switcher metabox
51 76 * The checkbox and all hidden fields are important
52 - * Thanks to John Morris for his very interesting post http://www.johnmorrisonline.com/how-to-add-a-fully-functional-custom-meta-box-to-wordpress-navigation-menus/
77 + * thanks to John Morris for his very interesting post http://www.johnmorrisonline.com/how-to-add-a-fully-functional-custom-meta-box-to-wordpress-navigation-menus/
53 78 *
54 79 * @since 1.1
55 80 */
56 81 public function lang_switch() {
57 82 global $_nav_menu_placeholder, $nav_menu_selected_id;
58 - $_nav_menu_placeholder = 0 > $_nav_menu_placeholder ? $_nav_menu_placeholder - 1 : -1;
59 - ?>
83 + $_nav_menu_placeholder = 0 > $_nav_menu_placeholder ? $_nav_menu_placeholder - 1 : -1;?>
84 +
60 85 <div id="posttype-lang-switch" class="posttypediv">
61 86 <div id="tabs-panel-lang-switch" class="tabs-panel tabs-panel-active">
62 - <ul id="lang-switch-checklist" class="categorychecklist form-no-clear">
87 + <ul id ="lang-switch-checklist" class="categorychecklist form-no-clear">
63 88 <li>
64 89 <label class="menu-item-title">
65 - <input type="checkbox" class="menu-item-checkbox" name="menu-item[<?php echo (int) $_nav_menu_placeholder; ?>][menu-item-object-id]" value="-1"> <?php esc_html_e( 'Languages', 'polylang' ); ?>
90 + <input type="checkbox" class="menu-item-checkbox" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-object-id]" value="-1"> <?php _e('Language switcher', 'polylang'); ?>
66 91 </label>
67 - <input type="hidden" class="menu-item-type" name="menu-item[<?php echo (int) $_nav_menu_placeholder; ?>][menu-item-type]" value="custom">
68 - <input type="hidden" class="menu-item-title" name="menu-item[<?php echo (int) $_nav_menu_placeholder; ?>][menu-item-title]" value="<?php esc_html_e( 'Languages', 'polylang' ); ?>">
69 - <input type="hidden" class="menu-item-url" name="menu-item[<?php echo (int) $_nav_menu_placeholder; ?>][menu-item-url]" value="#pll_switcher">
70 - </li>
71 - </ul>
72 - </div>
73 - <p class="button-controls">
74 - <span class="add-to-menu">
75 - <input type="submit" <?php disabled( $nav_menu_selected_id, 0 ); ?> class="button-secondary submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu', 'polylang' ); ?>" name="add-post-type-menu-item" id="submit-posttype-lang-switch">
76 - <span class="spinner"></span>
77 - </span>
78 - </p>
79 - </div>
80 - <?php
92 + <input type="hidden" class="menu-item-type" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-type]" value="custom">
93 + <input type="hidden" class="menu-item-title" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-title]" value="<?php _e('Language switcher', 'polylang'); ?>">
94 + <input type="hidden" class="menu-item-url" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-url]" value="#pll_switcher">
95 + </li>
96 + </ul>
97 + </div>
98 + <p class="button-controls">
99 + <span class="add-to-menu">
100 + <input type="submit" <?php disabled( $nav_menu_selected_id, 0 ); ?> class="button-secondary submit-add-to-menu right" value="Add to Menu" name="add-post-type-menu-item" id="submit-posttype-lang-switch">
101 + <span class="spinner"></span>
102 + </span>
103 + </p>
104 + </div><?php
81 105 }
82 106
83 - /**
84 - * Prepares javascript to modify the language switcher menu item
107 + /*
108 + * prepares javascript to modify the language switcher menu item
85 109 *
86 110 * @since 1.1
87 111 */
88 112 public function admin_enqueue_scripts() {
89 113 $screen = get_current_screen();
90 - if ( 'nav-menus' != $screen->base ) {
114 + if ('nav-menus' != $screen->base)
91 115 return;
92 - }
93 116
94 - $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
95 - wp_enqueue_script( 'pll_nav_menu', plugins_url( '/js/nav-menu' . $suffix . '.js', POLYLANG_FILE ), array( 'jquery' ), POLYLANG_VERSION );
117 + $suffix = defined('SCRIPT_DEBUG') && SCRIPT_DEBUG ? '' : '.min';
118 + wp_enqueue_script('pll_nav_menu', POLYLANG_URL .'/js/nav-menu'.$suffix.'.js', array('jquery'), POLYLANG_VERSION);
96 119
97 - $data = array(
98 - 'strings' => PLL_Switcher::get_switcher_options( 'menu', 'string' ), // The strings for the options
99 - 'title' => __( 'Languages', 'polylang' ), // The title
100 - 'val' => array(),
101 - );
120 + // the strings for the options
121 + foreach (array_reverse(PLL_Switcher::get_switcher_options('menu', 'string')) as $str)
122 + $data['strings'][] = $str;
102 123
103 - // Get all language switcher menu items
104 - $items = get_posts(
105 - array(
106 - 'numberposts' => -1,
107 - 'nopaging' => true,
108 - 'post_type' => 'nav_menu_item',
109 - 'fields' => 'ids',
110 - 'meta_key' => '_pll_menu_item',
111 - )
112 - );
124 + $data['strings'][] = __('Language switcher', 'polylang'); // the title
113 125
114 - // The options values for the language switcher
115 - foreach ( $items as $item ) {
116 - $data['val'][ $item ] = get_post_meta( $item, '_pll_menu_item', true );
117 - }
126 + // get all language switcher menu items
127 + $items = get_posts(array(
128 + 'numberposts' => -1,
129 + 'nopaging' => true,
130 + 'post_type' => 'nav_menu_item',
131 + 'fields' => 'ids',
132 + 'meta_key' => '_pll_menu_item'
133 + ));
118 134
119 - // Send all these data to javascript
120 - wp_localize_script( 'pll_nav_menu', 'pll_data', $data );
135 + // the options values for the language switcher
136 + $data['val'] = array();
137 + foreach ($items as $item)
138 + $data['val'][$item] = get_post_meta($item, '_pll_menu_item', true);
139 +
140 + // send all these data to javascript
141 + wp_localize_script('pll_nav_menu', 'pll_data', $data);
121 142 }
122 143
123 - /**
124 - * Save our menu item options
144 + /*
145 + * save our menu item options
125 146 *
126 147 * @since 1.1
127 148 *
128 149 * @param int $menu_id not used
@@ -128,56 +149,49 @@
128 149 * @param int $menu_id not used
129 150 * @param int $menu_item_db_id
130 151 */
131 152 public function wp_update_nav_menu_item( $menu_id = 0, $menu_item_db_id = 0 ) {
132 - if ( empty( $_POST['menu-item-url'][ $menu_item_db_id ] ) || '#pll_switcher' !== $_POST['menu-item-url'][ $menu_item_db_id ] ) { // phpcs:ignore WordPress.Security.NonceVerification
153 + if (empty($_POST['menu-item-url'][$menu_item_db_id]) || $_POST['menu-item-url'][$menu_item_db_id] != '#pll_switcher')
133 154 return;
134 - }
135 155
136 - // Security check as 'wp_update_nav_menu_item' can be called from outside WP admin
137 - if ( current_user_can( 'edit_theme_options' ) ) {
138 - check_admin_referer( 'update-nav_menu', 'update-nav-menu-nonce' );
156 + // security check
157 + // as 'wp_update_nav_menu_item' can be called from outside WP admin
158 + if ( ! current_user_can('edit_theme_options') )
159 + wp_die( __( 'Cheatin&#8217; uh?' ) );
139 160
140 - $options = array( 'hide_if_no_translation' => 0, 'hide_current' => 0, 'force_home' => 0, 'show_flags' => 0, 'show_names' => 1, 'dropdown' => 0 ); // Default values
141 - // Our jQuery form has not been displayed
142 - if ( empty( $_POST['menu-item-pll-detect'][ $menu_item_db_id ] ) ) {
143 - if ( ! get_post_meta( $menu_item_db_id, '_pll_menu_item', true ) ) { // Our options were never saved
144 - update_post_meta( $menu_item_db_id, '_pll_menu_item', $options );
145 - }
146 - }
147 - else {
148 - foreach ( array_keys( $options ) as $opt ) {
149 - $options[ $opt ] = empty( $_POST[ 'menu-item-' . $opt ][ $menu_item_db_id ] ) ? 0 : 1;
150 - }
151 - update_post_meta( $menu_item_db_id, '_pll_menu_item', $options ); // Allow us to easily identify our nav menu item
152 - }
161 + check_admin_referer( 'update-nav_menu', 'update-nav-menu-nonce' );
162 +
163 + $options = array('hide_current' => 0,'force_home' => 0 ,'show_flags' => 0 ,'show_names' => 1); // default values
164 + // our jQuery form has not been displayed
165 + if (empty($_POST['menu-item-pll-detect'][$menu_item_db_id])) {
166 + if (!get_post_meta($menu_item_db_id, '_pll_menu_item', true)) // our options were never saved
167 + update_post_meta($menu_item_db_id, '_pll_menu_item', $options);
153 168 }
169 + else {
170 + foreach ($options as $opt => $v)
171 + $options[$opt] = empty($_POST['menu-item-'.$opt][$menu_item_db_id]) ? 0 : 1;
172 + update_post_meta($menu_item_db_id, '_pll_menu_item', $options); // allow us to easily identify our nav menu item
173 + }
174 +
154 175 }
155 176
156 - /**
157 - * Assign menu languages and translations based on ( temporary ) locations
177 + /*
178 + * translates the language switcher menu items title in case the user switches the admin language
158 179 *
159 - * @since 1.8
180 + * @since 1.1.1
160 181 *
161 - * @param array $locations nav menu locations
162 - * @return array
182 + * @param array $items
183 + * @return array modified $items
163 184 */
164 - public function update_nav_menu_locations( $locations ) {
165 - // Extract language and menu from locations
166 - foreach ( $locations as $loc => $menu ) {
167 - $infos = $this->explode_location( $loc );
168 - $this->options['nav_menus'][ $this->theme ][ $infos['location'] ][ $infos['lang'] ] = $menu;
169 - if ( $this->options['default_lang'] != $infos['lang'] ) {
170 - unset( $locations[ $loc ] ); // Remove temporary locations before database update
171 - }
172 - }
173 -
174 - update_option( 'polylang', $this->options );
175 - return $locations;
185 + public function translate_switcher_title($items) {
186 + foreach ($items as $item)
187 + if ('#pll_switcher' == $item->url)
188 + $item->post_title = __('Language switcher', 'polylang');
189 + return $items;
176 190 }
177 191
178 - /**
179 - * Assign menu languages and translations based on ( temporary ) locations
192 + /*
193 + * assign menu languages and translations based on (temporary) locations
180 194 *
181 195 * @since 1.1
182 196 *
183 197 * @param array $mods theme mods
@@ -182,42 +196,44 @@
182 196 *
183 197 * @param array $mods theme mods
184 198 * @return unmodified $mods
185 199 */
186 - public function pre_update_option_theme_mods( $mods ) {
187 - if ( current_user_can( 'edit_theme_options' ) && isset( $mods['nav_menu_locations'] ) ) {
200 + public function update_nav_menu_locations($mods) {
201 + if (isset($mods['nav_menu_locations'])) {
188 202
189 - // Manage Locations tab in Appearance -> Menus
190 - if ( isset( $_GET['action'] ) && 'locations' === $_GET['action'] ) { // phpcs:ignore WordPress.Security.NonceVerification
203 + // security check
204 + if ( ! current_user_can('edit_theme_options') )
205 + wp_die( __( 'Cheatin&#8217; uh?' ) );
206 +
207 + if (isset($_REQUEST['action']) && 'locations' == $_REQUEST['action'])
191 208 check_admin_referer( 'save-menu-locations' );
192 - $this->options['nav_menus'][ $this->theme ] = array();
193 - }
194 209
195 - // Edit Menus tab in Appearance -> Menus
196 - // Add the test of $_POST['update-nav-menu-nonce'] to avoid conflict with Vantage theme
197 - elseif ( isset( $_POST['action'], $_POST['update-nav-menu-nonce'] ) && 'update' === $_POST['action'] ) {
210 + elseif (isset($_REQUEST['action']) && 'update' == $_REQUEST['action'])
198 211 check_admin_referer( 'update-nav_menu', 'update-nav-menu-nonce' );
199 - $this->options['nav_menus'][ $this->theme ] = array();
200 - }
201 212
202 - // Customizer
203 - // Don't reset locations in this case.
204 - // see http://wordpress.org/support/topic/menus-doesnt-show-and-not-saved-in-theme-settings-multilingual-site
205 - elseif ( isset( $_POST['action'] ) && 'customize_save' == $_POST['action'] ) {
206 - check_ajax_referer( 'save-customize_' . $GLOBALS['wp_customize']->get_stylesheet(), 'nonce' );
207 - }
213 + else
214 + return; // not called from WP Admin
208 215
209 - else {
210 - return $mods; // No modification for nav menu locations
216 + $default = pll_default_language();
217 + $arr = array();
218 +
219 + // extract language and menu from locations
220 + foreach ($mods['nav_menu_locations'] as $loc => $menu) {
221 + if ($pos = strpos($loc, '___')) {
222 + $this->options['nav_menus'][$this->theme][substr($loc, 0, $pos)][substr($loc, $pos+3)] = $menu;
223 + unset($mods['nav_menu_locations'][$loc]); // remove temporary locations before database update
224 + }
225 + else
226 + $this->options['nav_menus'][$this->theme][$loc][$default] = $menu;
211 227 }
212 228
213 - $mods['nav_menu_locations'] = $this->update_nav_menu_locations( $mods['nav_menu_locations'] );
229 + update_option('polylang', $this->options);
214 230 }
215 231 return $mods;
216 232 }
217 233
218 - /**
219 - * Fills temporary menu locations based on menus translations
234 + /*
235 + * fills temporary menu locations based on menus translations
220 236 *
221 237 * @since 1.2
222 238 *
223 239 * @param bool|array $menus
@@ -222,22 +238,14 @@
222 238 *
223 239 * @param bool|array $menus
224 240 * @return bool|array modified list of menu locations
225 241 */
226 - public function theme_mod_nav_menu_locations( $menus ) {
227 - // Prefill locations with 0 value in case a location does not exist in $menus
228 - $locations = get_registered_nav_menus();
229 - if ( is_array( $locations ) ) {
230 - $locations = array_fill_keys( array_keys( $locations ), 0 );
231 - $menus = is_array( $menus ) ? array_merge( $locations, $menus ) : $locations;
232 - }
233 -
234 - if ( is_array( $menus ) ) {
235 - foreach ( array_keys( $menus ) as $loc ) {
236 - foreach ( $this->model->get_languages_list() as $lang ) {
237 - if ( ! empty( $this->options['nav_menus'][ $this->theme ][ $loc ][ $lang->slug ] ) && term_exists( $this->options['nav_menus'][ $this->theme ][ $loc ][ $lang->slug ], 'nav_menu' ) ) {
238 - $menus[ $this->combine_location( $loc, $lang ) ] = $this->options['nav_menus'][ $this->theme ][ $loc ][ $lang->slug ];
239 - }
242 + public function nav_menu_locations($menus) {
243 + if (is_array($menus)) {
244 + foreach ($menus as $loc => $menu) {
245 + foreach ($this->model->get_languages_list() as $lang) {
246 + if (pll_default_language() != $lang->slug && !empty($this->options['nav_menus'][$this->theme][$loc][$lang->slug]))
247 + $menus[$loc . '___' . $lang->slug] = $this->options['nav_menus'][$this->theme][$loc][$lang->slug];
240 248 }
241 249 }
242 250 }
243 251
@@ -243,27 +251,39 @@
243 251
244 252 return $menus;
245 253 }
246 254
247 - /**
248 - * Removes the nav menu term_id from the locations stored in Polylang options when a nav menu is deleted
255 + /*
256 + * filters _wp_auto_add_pages_to_menu by language
249 257 *
250 - * @since 1.7.3
258 + * @since 0.9.4
251 259 *
252 - * @param int $term_id nav menu id
260 + * @param string $new_status Transition to this post status.
261 + * @param string $old_status Previous post status.
262 + * @param object $post Post data.
253 263 */
254 - public function delete_nav_menu( $term_id ) {
255 - if ( isset( $this->options['nav_menus'] ) ) {
256 - foreach ( $this->options['nav_menus'] as $theme => $locations ) {
257 - foreach ( $locations as $loc => $languages ) {
258 - foreach ( $languages as $lang => $menu_id ) {
259 - if ( $menu_id === $term_id ) {
260 - unset( $this->options['nav_menus'][ $theme ][ $loc ][ $lang ] );
261 - }
262 - }
263 - }
264 - }
264 + public function auto_add_pages_to_menu( $new_status, $old_status, $post ) {
265 + if ('publish' != $new_status || 'publish' == $old_status || 'page' != $post->post_type || ! empty($post->post_parent) || !($lang = $this->model->get_post_language($post->ID)))
266 + return;
265 267
266 - update_option( 'polylang', $this->options );
267 - }
268 + // get all the menus in the post language
269 + $menus = get_terms('nav_menu', array('lang' => $lang->slug, 'fields' => 'ids', 'hide_empty' => false));
270 + $menus = implode(',', $menus);
271 +
272 + add_filter('option_nav_menu_options', create_function('$a', "\$a['auto_add'] = array_intersect(\$a['auto_add'], array($menus)); return \$a;"));
273 + }
274 +
275 + /*
276 + * FIXME prevents sharing a menu term with a language term by renaming the nav menu before its creation
277 + * to avoid http://core.trac.wordpress.org/ticket/24802
278 + * and http://wordpress.org/support/topic/all-connection-between-elements-lost
279 + *
280 + * @since 1.1.3
281 + *
282 + * @param string $name term name
283 + * @param string $taxonomy
284 + * @return string modified (nav menu) term name if necessary
285 + */
286 + function pre_insert_term($name, $taxonomy) {
287 + return ('nav_menu' == $taxonomy && in_array($name, $this->model->get_languages_list(array('fields' => 'name')))) ? $name .= '-menu' : $name;
268 288 }
269 289 }