| @@ -3,9 +3,9 @@ | ||
| 3 | 3 | * @package Polylang |
| 4 | 4 | */ |
| 5 | 5 | |
| 6 | 6 | /** |
| 7 | - * Extends the PLL_Model class with methods needed only in Polylang settings pages | |
| 7 | + * Extends the PLL_Model class with methods needed only in Polylang settings pages. | |
| 8 | 8 | * |
| 9 | 9 | * @since 1.2 |
| 10 | 10 | */ |
| 11 | 11 | class PLL_Admin_Model extends PLL_Model { |
| @@ -11,35 +11,39 @@ | ||
| 11 | 11 | class PLL_Admin_Model extends PLL_Model { |
| 12 | 12 | |
| 13 | 13 | /** |
| 14 | 14 | * Adds a new language |
| 15 | - * Creates a default category for this language | |
| 15 | + * and creates a default category for this language. | |
| 16 | 16 | * |
| 17 | - * List of arguments that $args must contain: | |
| 18 | - * name -> language name ( used only for display ) | |
| 19 | - * slug -> language code ( ideally 2-letters ISO 639-1 language code ) | |
| 20 | - * locale -> WordPress locale. If something wrong is used for the locale, the .mo files will not be loaded... | |
| 21 | - * rtl -> 1 if rtl language, 0 otherwise | |
| 22 | - * term_group -> language order when displayed | |
| 23 | - * | |
| 24 | - * Optional arguments that $args can contain: | |
| 25 | - * no_default_cat -> if set, no default category will be created for this language | |
| 26 | - * flag -> country code, see flags.php | |
| 27 | - * | |
| 28 | 17 | * @since 1.2 |
| 29 | 18 | * |
| 30 | - * @param array $args | |
| 31 | - * @return bool true if success / false if failed | |
| 19 | + * @param array $args { | |
| 20 | + * @type string $name Language name (used only for display). | |
| 21 | + * @type string $slug Language code (ideally 2-letters ISO 639-1 language code). | |
| 22 | + * @type string $locale WordPress locale. If something wrong is used for the locale, the .mo files will | |
| 23 | + * not be loaded... | |
| 24 | + * @type int $rtl 1 if rtl language, 0 otherwise. | |
| 25 | + * @type int $term_group Language order when displayed. | |
| 26 | + * @type string $no_default_cat Optional, if set, no default category will be created for this language. | |
| 27 | + * @type string $flag Optional, country code, {@see settings/flags.php}. | |
| 28 | + * } | |
| 29 | + * @return WP_Error|true true if success / WP_Error if failed. | |
| 32 | 30 | */ |
| 33 | 31 | public function add_language( $args ) { |
| 34 | 32 | $errors = $this->validate_lang( $args ); |
| 35 | - if ( $errors->get_error_code() ) { // Using has_errors() would be more meaningful but is available only since WP 5.0 | |
| 33 | + if ( $errors->has_errors() ) { | |
| 36 | 34 | return $errors; |
| 37 | 35 | } |
| 38 | 36 | |
| 39 | 37 | // First the language taxonomy |
| 40 | - $description = maybe_serialize( array( 'locale' => $args['locale'], 'rtl' => (int) $args['rtl'], 'flag_code' => empty( $args['flag'] ) ? '' : $args['flag'] ) ); | |
| 41 | - $r = wp_insert_term( $args['name'], 'language', array( 'slug' => $args['slug'], 'description' => $description ) ); | |
| 38 | + $r = wp_insert_term( | |
| 39 | + $args['name'], | |
| 40 | + 'language', | |
| 41 | + array( | |
| 42 | + 'slug' => $args['slug'], | |
| 43 | + 'description' => $this->build_language_metas( $args ), | |
| 44 | + ) | |
| 45 | + ); | |
| 42 | 46 | if ( is_wp_error( $r ) ) { |
| 43 | 47 | // Avoid an ugly fatal error if something went wrong ( reported once in the forum ) |
| 44 | 48 | return new WP_Error( 'pll_add_language', __( 'Impossible to add the language.', 'polylang' ) ); |
| 45 | 49 | } |
| @@ -44,49 +48,42 @@ | ||
| 44 | 48 | return new WP_Error( 'pll_add_language', __( 'Impossible to add the language.', 'polylang' ) ); |
| 45 | 49 | } |
| 46 | 50 | wp_update_term( (int) $r['term_id'], 'language', array( 'term_group' => (int) $args['term_group'] ) ); // can't set the term group directly in wp_insert_term |
| 47 | 51 | |
| 48 | - // The term_language taxonomy | |
| 49 | - // Don't want shared terms so use a different slug | |
| 50 | - wp_insert_term( $args['name'], 'term_language', array( 'slug' => 'pll_' . $args['slug'] ) ); | |
| 52 | + // The other language taxonomies. | |
| 53 | + $this->update_secondary_language_terms( $args['slug'], $args['name'] ); | |
| 51 | 54 | |
| 52 | - $this->clean_languages_cache(); // Update the languages list now ! | |
| 53 | - | |
| 54 | 55 | if ( ! isset( $this->options['default_lang'] ) ) { |
| 55 | 56 | // If this is the first language created, set it as default language |
| 56 | 57 | $this->options['default_lang'] = $args['slug']; |
| 57 | 58 | update_option( 'polylang', $this->options ); |
| 59 | + } | |
| 58 | 60 | |
| 59 | - // And assign default language to default category | |
| 60 | - $this->term->set_language( (int) get_option( 'default_category' ), (int) $r['term_id'] ); | |
| 61 | - } elseif ( empty( $args['no_default_cat'] ) ) { | |
| 62 | - $this->create_default_category( $args['slug'] ); | |
| 63 | - } | |
| 61 | + // Refresh languages. | |
| 62 | + $this->clean_languages_cache(); | |
| 63 | + $this->get_languages_list(); | |
| 64 | 64 | |
| 65 | - // Init a mo_id for this language | |
| 66 | - $mo = new PLL_MO(); | |
| 67 | - $mo->export_to_db( $this->get_language( $args['slug'] ) ); | |
| 65 | + flush_rewrite_rules(); // Refresh rewrite rules. | |
| 68 | 66 | |
| 69 | 67 | /** |
| 70 | - * Fires when a language is added | |
| 68 | + * Fires when a language is added. | |
| 71 | 69 | * |
| 72 | 70 | * @since 1.9 |
| 73 | 71 | * |
| 74 | - * @param array $args arguments used to create the language | |
| 72 | + * @param array $args Arguments used to create the language. @see PLL_Admin_Model::add_language(). | |
| 75 | 73 | */ |
| 76 | 74 | do_action( 'pll_add_language', $args ); |
| 77 | 75 | |
| 78 | - $this->clean_languages_cache(); // Again to set add mo_id in the cached languages list | |
| 79 | - flush_rewrite_rules(); // Refresh rewrite rules | |
| 80 | 76 | return true; |
| 81 | 77 | } |
| 82 | 78 | |
| 83 | 79 | /** |
| 84 | - * Delete a language | |
| 80 | + * Delete a language. | |
| 85 | 81 | * |
| 86 | 82 | * @since 1.2 |
| 87 | 83 | * |
| 88 | - * @param int $lang_id language term_id | |
| 84 | + * @param int $lang_id Language term_id. | |
| 85 | + * @return bool | |
| 89 | 86 | */ |
| 90 | 87 | public function delete_language( $lang_id ) { |
| 91 | 88 | $lang = $this->get_language( (int) $lang_id ); |
| 92 | 89 | |
| @@ -95,9 +92,9 @@ | ||
| 95 | 92 | } |
| 96 | 93 | |
| 97 | 94 | // Oops ! we are deleting the default language... |
| 98 | 95 | // Need to do this before loosing the information for default category translations |
| 99 | - if ( $this->options['default_lang'] == $lang->slug ) { | |
| 96 | + if ( $lang->is_default ) { | |
| 100 | 97 | $slugs = $this->get_languages_list( array( 'fields' => 'slug' ) ); |
| 101 | 98 | $slugs = array_diff( $slugs, array( $lang->slug ) ); |
| 102 | 99 | |
| 103 | 100 | if ( ! empty( $slugs ) ) { |
| @@ -134,28 +131,29 @@ | ||
| 134 | 131 | } |
| 135 | 132 | } |
| 136 | 133 | |
| 137 | 134 | // Delete users options |
| 138 | - foreach ( get_users( array( 'fields' => 'ID' ) ) as $user_id ) { | |
| 139 | - delete_user_meta( $user_id, 'pll_filter_content', $lang->slug ); | |
| 140 | - delete_user_meta( $user_id, 'description_' . $lang->slug ); | |
| 141 | - } | |
| 135 | + delete_metadata( 'user', 0, 'pll_filter_content', '', true ); | |
| 136 | + delete_metadata( 'user', 0, "description_{$lang->slug}", '', true ); | |
| 142 | 137 | |
| 143 | - // Delete the string translations | |
| 144 | - $post = wpcom_vip_get_page_by_title( 'polylang_mo_' . $lang->term_id, OBJECT, 'polylang_mo' ); | |
| 145 | - if ( ! empty( $post ) ) { | |
| 146 | - wp_delete_post( $post->ID ); | |
| 147 | - } | |
| 148 | - | |
| 149 | 138 | // Delete domain |
| 150 | 139 | unset( $this->options['domains'][ $lang->slug ] ); |
| 151 | 140 | |
| 152 | - // Delete the language itself | |
| 153 | - wp_delete_term( $lang->term_id, 'language' ); | |
| 154 | - wp_delete_term( $lang->tl_term_id, 'term_language' ); | |
| 141 | + /* | |
| 142 | + * Delete the language itself. | |
| 143 | + * | |
| 144 | + * Reverses the language taxonomies order is required to make sure 'language' is deleted in last. | |
| 145 | + * | |
| 146 | + * The initial order with the 'language' taxonomy at the beginning of 'PLL_Language::term_props' property | |
| 147 | + * is done by {@see PLL_Model::filter_language_terms_orderby()} | |
| 148 | + */ | |
| 149 | + foreach ( array_reverse( $lang->get_tax_props( 'term_id' ) ) as $taxonomy_name => $term_id ) { | |
| 150 | + wp_delete_term( $term_id, $taxonomy_name ); | |
| 151 | + } | |
| 155 | 152 | |
| 156 | - // Update languages list | |
| 153 | + // Refresh languages. | |
| 157 | 154 | $this->clean_languages_cache(); |
| 155 | + $this->get_languages_list(); | |
| 158 | 156 | |
| 159 | 157 | update_option( 'polylang', $this->options ); |
| 160 | 158 | flush_rewrite_rules(); // refresh rewrite rules |
| 161 | 159 | return true; |
| @@ -161,29 +159,30 @@ | ||
| 161 | 159 | return true; |
| 162 | 160 | } |
| 163 | 161 | |
| 164 | 162 | /** |
| 165 | - * Update language properties | |
| 163 | + * Updates language properties. | |
| 166 | 164 | * |
| 167 | - * List of arguments that $args must contain: | |
| 168 | - * lang_id -> term_id of the language to modify | |
| 169 | - * name -> language name ( used only for display ) | |
| 170 | - * slug -> language code ( ideally 2-letters ISO 639-1 language code | |
| 171 | - * locale -> WordPress locale. If something wrong is used for the locale, the .mo files will not be loaded... | |
| 172 | - * rtl -> 1 if rtl language, 0 otherwise | |
| 173 | - * term_group -> language order when displayed | |
| 174 | - * | |
| 175 | - * Optional arguments that $args can contain: | |
| 176 | - * flag -> country code, see flags.php | |
| 177 | - * | |
| 178 | 165 | * @since 1.2 |
| 179 | 166 | * |
| 180 | - * @param array $args | |
| 181 | - * @return bool true if success / false if failed | |
| 167 | + * @param array $args { | |
| 168 | + * @type int $lang_id Id of the language to modify. | |
| 169 | + * @type string $name Language name ( used only for display ). | |
| 170 | + * @type string $slug Language code ( ideally 2-letters ISO 639-1 language code ). | |
| 171 | + * @type string $locale WordPress locale. If something wrong is used for the locale, the .mo files will not be loaded... | |
| 172 | + * @type int $rtl 1 if rtl language, 0 otherwise. | |
| 173 | + * @type int $term_group Language order when displayed. | |
| 174 | + * @type string $flag Optional, country code, @see flags.php. | |
| 175 | + * } | |
| 176 | + * @return WP_Error|true true if success / WP_Error if failed. | |
| 182 | 177 | */ |
| 183 | 178 | public function update_language( $args ) { |
| 184 | 179 | $lang = $this->get_language( (int) $args['lang_id'] ); |
| 185 | 180 | |
| 181 | + if ( empty( $lang ) ) { | |
| 182 | + return new WP_Error( 'pll_invalid_language_id', __( 'The language does not seem to exist.', 'polylang' ) ); | |
| 183 | + } | |
| 184 | + | |
| 186 | 185 | $errors = $this->validate_lang( $args, $lang ); |
| 187 | 186 | if ( $errors->get_error_code() ) { // Using has_errors() would be more meaningful but is available only since WP 5.0 |
| 188 | 187 | return $errors; |
| 189 | 188 | } |
| @@ -229,9 +228,9 @@ | ||
| 229 | 228 | unset( $this->options['domains'][ $old_slug ] ); |
| 230 | 229 | } |
| 231 | 230 | |
| 232 | 231 | // Update the default language option if necessary |
| 233 | - if ( $this->options['default_lang'] == $old_slug ) { | |
| 232 | + if ( $lang->is_default ) { | |
| 234 | 233 | $this->options['default_lang'] = $slug; |
| 235 | 234 | } |
| 236 | 235 | } |
| 237 | 236 | |
| @@ -236,37 +235,130 @@ | ||
| 236 | 235 | } |
| 237 | 236 | |
| 238 | 237 | update_option( 'polylang', $this->options ); |
| 239 | 238 | |
| 240 | - // And finally update the language itself | |
| 241 | - $description = maybe_serialize( array( 'locale' => $args['locale'], 'rtl' => (int) $args['rtl'], 'flag_code' => empty( $args['flag'] ) ? '' : $args['flag'] ) ); | |
| 242 | - wp_update_term( (int) $lang->term_id, 'language', array( 'slug' => $slug, 'name' => $args['name'], 'description' => $description, 'term_group' => (int) $args['term_group'] ) ); | |
| 243 | - wp_update_term( (int) $lang->tl_term_id, 'term_language', array( 'slug' => 'pll_' . $slug, 'name' => $args['name'] ) ); | |
| 239 | + // And finally update the language itself. | |
| 240 | + $this->update_secondary_language_terms( $args['slug'], $args['name'], $lang ); | |
| 244 | 241 | |
| 242 | + $description = $this->build_language_metas( $args ); | |
| 243 | + wp_update_term( $lang->get_tax_prop( 'language', 'term_id' ), 'language', array( 'slug' => $slug, 'name' => $args['name'], 'description' => $description, 'term_group' => (int) $args['term_group'] ) ); | |
| 244 | + | |
| 245 | + // Refresh languages. | |
| 246 | + $this->clean_languages_cache(); | |
| 247 | + $this->get_languages_list(); | |
| 248 | + | |
| 249 | + // Refresh rewrite rules. | |
| 250 | + flush_rewrite_rules(); | |
| 251 | + | |
| 245 | 252 | /** |
| 246 | - * Fires when a language is added | |
| 253 | + * Fires after a language is updated. | |
| 247 | 254 | * |
| 248 | 255 | * @since 1.9 |
| 256 | + * @since 3.2 Added $lang parameter. | |
| 249 | 257 | * |
| 250 | - * @param array $args arguments used to modify the language | |
| 258 | + * @param array $args { | |
| 259 | + * Arguments used to modify the language. @see PLL_Admin_Model::update_language(). | |
| 260 | + * | |
| 261 | + * @type string $name Language name (used only for display). | |
| 262 | + * @type string $slug Language code (ideally 2-letters ISO 639-1 language code). | |
| 263 | + * @type string $locale WordPress locale. | |
| 264 | + * @type int $rtl 1 if rtl language, 0 otherwise. | |
| 265 | + * @type int $term_group Language order when displayed. | |
| 266 | + * @type string $no_default_cat Optional, if set, no default category has been created for this language. | |
| 267 | + * @type string $flag Optional, country code, @see flags.php. | |
| 268 | + * } | |
| 269 | + * @param PLL_Language $lang Previous value of the language being edited. | |
| 251 | 270 | */ |
| 252 | - do_action( 'pll_update_language', $args ); | |
| 271 | + do_action( 'pll_update_language', $args, $lang ); | |
| 253 | 272 | |
| 254 | - $this->clean_languages_cache(); | |
| 255 | - flush_rewrite_rules(); // Refresh rewrite rules | |
| 256 | 273 | return true; |
| 257 | 274 | } |
| 258 | 275 | |
| 259 | 276 | /** |
| 260 | - * Validates data entered when creating or updating a language | |
| 277 | + * Builds the language metas into an array and serializes it, to be stored in the term description. | |
| 261 | 278 | * |
| 262 | - * @see PLL_Admin_Model::add_language() | |
| 279 | + * @since 3.4 | |
| 263 | 280 | * |
| 281 | + * @param array $args { | |
| 282 | + * @type string $name Language name (used only for display). | |
| 283 | + * @type string $slug Language code (ideally 2-letters ISO 639-1 language code). | |
| 284 | + * @type string $locale WordPress locale. If something wrong is used for the locale, the .mo files will not be | |
| 285 | + * loaded... | |
| 286 | + * @type int $rtl 1 if rtl language, 0 otherwise. | |
| 287 | + * @type int $term_group Language order when displayed. | |
| 288 | + * @type int $lang_id Optional, ID of the language to modify. An empty value means the language is being | |
| 289 | + * created. | |
| 290 | + * @type string $flag Optional, country code, {@see settings/flags.php}. | |
| 291 | + * } | |
| 292 | + * @return string The serialized description array updated. | |
| 293 | + */ | |
| 294 | + protected function build_language_metas( array $args ) { | |
| 295 | + if ( ! empty( $args['lang_id'] ) ) { | |
| 296 | + $language_term = get_term( (int) $args['lang_id'] ); | |
| 297 | + | |
| 298 | + if ( $language_term instanceof WP_Term ) { | |
| 299 | + $old_data = maybe_unserialize( $language_term->description ); | |
| 300 | + } | |
| 301 | + } | |
| 302 | + | |
| 303 | + if ( empty( $old_data ) || ! is_array( $old_data ) ) { | |
| 304 | + $old_data = array(); | |
| 305 | + } | |
| 306 | + | |
| 307 | + $new_data = array( | |
| 308 | + 'locale' => $args['locale'], | |
| 309 | + 'rtl' => ! empty( $args['rtl'] ) ? 1 : 0, | |
| 310 | + 'flag_code' => empty( $args['flag'] ) ? '' : $args['flag'], | |
| 311 | + ); | |
| 312 | + | |
| 313 | + /** | |
| 314 | + * Allow to add data to store for a language. | |
| 315 | + * `$locale`, `$rtl`, and `$flag_code` cannot be overwritten. | |
| 316 | + * | |
| 317 | + * @since 3.4 | |
| 318 | + * | |
| 319 | + * @param mixed[] $add_data Data to add. | |
| 320 | + * @param mixed[] $args { | |
| 321 | + * Arguments used to create the language. | |
| 322 | + * | |
| 323 | + * @type string $name Language name (used only for display). | |
| 324 | + * @type string $slug Language code (ideally 2-letters ISO 639-1 language code). | |
| 325 | + * @type string $locale WordPress locale. If something wrong is used for the locale, the .mo files will | |
| 326 | + * not be loaded... | |
| 327 | + * @type int $rtl 1 if rtl language, 0 otherwise. | |
| 328 | + * @type int $term_group Language order when displayed. | |
| 329 | + * @type int $lang_id Optional, ID of the language to modify. An empty value means the language is | |
| 330 | + * being created. | |
| 331 | + * @type string $flag Optional, country code, {@see settings/flags.php}. | |
| 332 | + * } | |
| 333 | + * @param mixed[] $new_data New data. | |
| 334 | + * @param mixed[] $old_data { | |
| 335 | + * Original data. Contains at least the following: | |
| 336 | + * | |
| 337 | + * @type string $locale WordPress locale. | |
| 338 | + * @type int $rtl 1 if rtl language, 0 otherwise. | |
| 339 | + * @type string $flag_code Country code. | |
| 340 | + * } | |
| 341 | + */ | |
| 342 | + $add_data = apply_filters( 'pll_language_metas', array(), $args, $new_data, $old_data ); | |
| 343 | + // Don't allow to overwrite `$locale`, `$rtl`, and `$flag_code`. | |
| 344 | + $new_data = array_merge( $old_data, $add_data, $new_data ); | |
| 345 | + | |
| 346 | + /** @var non-empty-string $serialized maybe_serialize() cannot return anything else than a string when fed by an array. */ | |
| 347 | + $serialized = maybe_serialize( $new_data ); | |
| 348 | + return $serialized; | |
| 349 | + } | |
| 350 | + | |
| 351 | + /** | |
| 352 | + * Validates data entered when creating or updating a language. | |
| 353 | + * | |
| 354 | + * @see PLL_Admin_Model::add_language(). | |
| 355 | + * | |
| 264 | 356 | * @since 0.4 |
| 265 | 357 | * |
| 266 | - * @param array $args | |
| 267 | - * @param object $lang optional the language currently updated, the language is created if not set | |
| 268 | - * @return bool true if success / false if failed | |
| 358 | + * @param array $args Parameters of {@see PLL_Admin_Model::add_language() or @see PLL_Admin_Model::update_language()}. | |
| 359 | + * @param PLL_Language|null $lang Optional the language currently updated, the language is created if not set. | |
| 360 | + * @return WP_Error | |
| 269 | 361 | */ |
| 270 | 362 | protected function validate_lang( $args, $lang = null ) { |
| 271 | 363 | $errors = new WP_Error(); |
| 272 | 364 | |
| @@ -281,9 +373,9 @@ | ||
| 281 | 373 | } |
| 282 | 374 | |
| 283 | 375 | // Validate slug is unique |
| 284 | 376 | foreach ( $this->get_languages_list() as $language ) { |
| 285 | - if ( $language->slug === $args['slug'] && ( null === $lang || ( isset( $lang ) && $lang->term_id != $language->term_id ) ) ) { | |
| 377 | + if ( $language->slug === $args['slug'] && ( null === $lang || $lang->term_id !== $language->term_id ) ) { | |
| 286 | 378 | $errors->add( 'pll_non_unique_slug', __( 'The language code must be unique', 'polylang' ) ); |
| 287 | 379 | } |
| 288 | 380 | } |
| 289 | 381 | |
| @@ -293,9 +385,9 @@ | ||
| 293 | 385 | $errors->add( 'pll_invalid_name', __( 'The language must have a name', 'polylang' ) ); |
| 294 | 386 | } |
| 295 | 387 | |
| 296 | 388 | // Validate flag |
| 297 | - if ( ! empty( $args['flag'] ) && ! file_exists( POLYLANG_DIR . '/flags/' . $args['flag'] . '.png' ) ) { | |
| 389 | + if ( ! empty( $args['flag'] ) && ! is_readable( POLYLANG_DIR . '/flags/' . $args['flag'] . '.png' ) ) { | |
| 298 | 390 | $flag = PLL_Language::get_flag_informations( $args['flag'] ); |
| 299 | 391 | |
| 300 | 392 | if ( ! empty( $flag['url'] ) ) { |
| 301 | 393 | $response = function_exists( 'vip_safe_wp_remote_get' ) ? vip_safe_wp_remote_get( esc_url_raw( $flag['url'] ) ) : wp_remote_get( esc_url_raw( $flag['url'] ) ); |
| @@ -309,226 +401,67 @@ | ||
| 309 | 401 | return $errors; |
| 310 | 402 | } |
| 311 | 403 | |
| 312 | 404 | /** |
| 313 | - * Used to set the language of posts or terms in mass | |
| 405 | + * Updates the translations when a language slug has been modified in settings | |
| 406 | + * or deletes them when a language is removed. | |
| 314 | 407 | * |
| 315 | - * @since 1.2 | |
| 316 | - * | |
| 317 | - * @param string $type either 'post' or 'term' | |
| 318 | - * @param array $ids array of post ids or term ids | |
| 319 | - * @param object|string $lang object or slug | |
| 320 | - */ | |
| 321 | - public function set_language_in_mass( $type, $ids, $lang ) { | |
| 322 | - global $wpdb; | |
| 323 | - | |
| 324 | - $ids = array_map( 'intval', $ids ); | |
| 325 | - $lang = $this->get_language( $lang ); | |
| 326 | - $tt_id = 'term' === $type ? $lang->tl_term_taxonomy_id : $lang->term_taxonomy_id; | |
| 327 | - $values = array(); | |
| 328 | - | |
| 329 | - foreach ( $ids as $id ) { | |
| 330 | - $values[] = $wpdb->prepare( '( %d, %d )', $id, $tt_id ); | |
| 331 | - } | |
| 332 | - | |
| 333 | - if ( ! empty( $values ) ) { | |
| 334 | - // PHPCS:ignore WordPress.DB.PreparedSQL.NotPrepared | |
| 335 | - $wpdb->query( "INSERT INTO {$wpdb->term_relationships} ( object_id, term_taxonomy_id ) VALUES " . implode( ',', array_unique( $values ) ) ); | |
| 336 | - $lang->update_count(); // Updating term count is mandatory ( thanks to AndyDeGroo ) | |
| 337 | - } | |
| 338 | - | |
| 339 | - if ( 'term' === $type ) { | |
| 340 | - clean_term_cache( $ids, 'term_language' ); | |
| 341 | - $translations = array(); | |
| 342 | - | |
| 343 | - foreach ( $ids as $id ) { | |
| 344 | - $translations[] = array( $lang->slug => $id ); | |
| 345 | - } | |
| 346 | - | |
| 347 | - if ( ! empty( $translations ) ) { | |
| 348 | - $this->set_translation_in_mass( 'term', $translations ); | |
| 349 | - } | |
| 350 | - } else { | |
| 351 | - clean_term_cache( $ids, 'language' ); | |
| 352 | - } | |
| 353 | - } | |
| 354 | - | |
| 355 | - /** | |
| 356 | - * Used to create a translations groups in mass | |
| 357 | - * | |
| 358 | - * @since 1.6.3 | |
| 359 | - * | |
| 360 | - * @param string $type either 'post' or 'term' | |
| 361 | - * @param array $translations array of translations arrays | |
| 362 | - */ | |
| 363 | - public function set_translation_in_mass( $type, $translations ) { | |
| 364 | - global $wpdb; | |
| 365 | - | |
| 366 | - $taxonomy = $type . '_translations'; | |
| 367 | - $terms = array(); | |
| 368 | - $slugs = array(); | |
| 369 | - $description = array(); | |
| 370 | - $count = array(); | |
| 371 | - | |
| 372 | - foreach ( $translations as $t ) { | |
| 373 | - $term = uniqid( 'pll_' ); // the term name | |
| 374 | - $terms[] = $wpdb->prepare( '( %s, %s )', $term, $term ); | |
| 375 | - $slugs[] = $wpdb->prepare( '%s', $term ); | |
| 376 | - $description[ $term ] = maybe_serialize( $t ); | |
| 377 | - $count[ $term ] = count( $t ); | |
| 378 | - } | |
| 379 | - | |
| 380 | - // Insert terms | |
| 381 | - if ( ! empty( $terms ) ) { | |
| 382 | - // PHPCS:ignore WordPress.DB.PreparedSQL.NotPrepared | |
| 383 | - $wpdb->query( "INSERT INTO {$wpdb->terms} ( slug, name ) VALUES " . implode( ',', array_unique( $terms ) ) ); | |
| 384 | - } | |
| 385 | - | |
| 386 | - // Get all terms with their term_id | |
| 387 | - // PHPCS:ignore WordPress.DB.PreparedSQL.NotPrepared | |
| 388 | - $terms = $wpdb->get_results( "SELECT term_id, slug FROM {$wpdb->terms} WHERE slug IN ( " . implode( ',', $slugs ) . ' )' ); | |
| 389 | - $term_ids = array(); | |
| 390 | - $tts = array(); | |
| 391 | - | |
| 392 | - // Prepare terms taxonomy relationship | |
| 393 | - foreach ( $terms as $term ) { | |
| 394 | - $term_ids[] = $term->term_id; | |
| 395 | - $tts[] = $wpdb->prepare( '( %d, %s, %s, %d )', $term->term_id, $taxonomy, $description[ $term->slug ], $count[ $term->slug ] ); | |
| 396 | - } | |
| 397 | - | |
| 398 | - // Insert term_taxonomy | |
| 399 | - if ( ! empty( $tts ) ) { | |
| 400 | - // PHPCS:ignore WordPress.DB.PreparedSQL.NotPrepared | |
| 401 | - $wpdb->query( "INSERT INTO {$wpdb->term_taxonomy} ( term_id, taxonomy, description, count ) VALUES " . implode( ',', array_unique( $tts ) ) ); | |
| 402 | - } | |
| 403 | - | |
| 404 | - // Get all terms with term_taxonomy_id | |
| 405 | - $terms = get_terms( $taxonomy, array( 'hide_empty' => false ) ); | |
| 406 | - $trs = array(); | |
| 407 | - | |
| 408 | - // Prepare objects relationships | |
| 409 | - foreach ( $terms as $term ) { | |
| 410 | - $t = maybe_unserialize( $term->description ); | |
| 411 | - if ( in_array( $t, $translations ) ) { | |
| 412 | - foreach ( $t as $object_id ) { | |
| 413 | - if ( ! empty( $object_id ) ) { | |
| 414 | - $trs[] = $wpdb->prepare( '( %d, %d )', $object_id, $term->term_taxonomy_id ); | |
| 415 | - } | |
| 416 | - } | |
| 417 | - } | |
| 418 | - } | |
| 419 | - | |
| 420 | - // Insert term_relationships | |
| 421 | - if ( ! empty( $trs ) ) { | |
| 422 | - // PHPCS:ignore WordPress.DB.PreparedSQL.NotPrepared | |
| 423 | - $wpdb->query( "INSERT INTO {$wpdb->term_relationships} ( object_id, term_taxonomy_id ) VALUES " . implode( ',', $trs ) ); | |
| 424 | - $trs = array_unique( $trs ); | |
| 425 | - } | |
| 426 | - | |
| 427 | - clean_term_cache( $term_ids, $taxonomy ); | |
| 428 | - } | |
| 429 | - | |
| 430 | - /** | |
| 431 | - * Returns untranslated posts and terms ids ( used in settings ) | |
| 432 | - * | |
| 433 | - * @since 0.9 | |
| 434 | - * @since 2.2.6 Add the $limit argument | |
| 435 | - * | |
| 436 | - * @param in $limit Max number of posts or terms to return. Defaults to -1 (no limit). | |
| 437 | - * @return array Array made of an array of post ids and an array of term ids | |
| 438 | - */ | |
| 439 | - public function get_objects_with_no_lang( $limit = -1 ) { | |
| 440 | - global $wpdb; | |
| 441 | - | |
| 442 | - /** | |
| 443 | - * Filters the max number of posts or terms to return when searching objects with no language | |
| 444 | - * This filter can be used to decrease the memory usage in case the number of objects | |
| 445 | - * without language is too big. Using a negative value is equivalent to have no limit. | |
| 446 | - * | |
| 447 | - * @since 2.2.6 | |
| 448 | - * | |
| 449 | - * @param int $limit Max number of posts or terms to retrieve from the database | |
| 450 | - */ | |
| 451 | - $limit = (int) apply_filters( 'get_objects_with_no_lang_limit', $limit ); | |
| 452 | - | |
| 453 | - $posts = get_posts( | |
| 454 | - array( | |
| 455 | - 'numberposts' => $limit, | |
| 456 | - 'nopaging' => $limit <= 0, | |
| 457 | - 'post_type' => $this->get_translated_post_types(), | |
| 458 | - 'post_status' => 'any', | |
| 459 | - 'fields' => 'ids', | |
| 460 | - 'tax_query' => array( | |
| 461 | - array( | |
| 462 | - 'taxonomy' => 'language', | |
| 463 | - 'terms' => $this->get_languages_list( array( 'fields' => 'term_id' ) ), | |
| 464 | - 'operator' => 'NOT IN', | |
| 465 | - ), | |
| 466 | - ), | |
| 467 | - ) | |
| 468 | - ); | |
| 469 | - | |
| 470 | - // PHPCS:disable WordPress.DB.PreparedSQL | |
| 471 | - $terms = $wpdb->get_col( | |
| 472 | - sprintf( | |
| 473 | - "SELECT {$wpdb->term_taxonomy}.term_id FROM {$wpdb->term_taxonomy} | |
| 474 | - WHERE taxonomy IN ('%s') | |
| 475 | - AND {$wpdb->term_taxonomy}.term_id NOT IN ( | |
| 476 | - SELECT object_id FROM {$wpdb->term_relationships} WHERE term_taxonomy_id IN (%s) | |
| 477 | - ) | |
| 478 | - %s", | |
| 479 | - implode( "','", array_map( 'esc_sql', $this->get_translated_taxonomies() ) ), | |
| 480 | - implode( ',', array_map( 'intval', $this->get_languages_list( array( 'fields' => 'tl_term_taxonomy_id' ) ) ) ), | |
| 481 | - $limit > 0 ? "LIMIT {$limit}" : '' | |
| 482 | - ) | |
| 483 | - ); | |
| 484 | - // PHPCS:enable | |
| 485 | - | |
| 486 | - /** | |
| 487 | - * Filter the list of untranslated posts ids and terms ids | |
| 488 | - * | |
| 489 | - * @since 0.9 | |
| 490 | - * | |
| 491 | - * @param bool|array $objects false if no ids found, list of post and/or term ids otherwise | |
| 492 | - */ | |
| 493 | - return apply_filters( 'pll_get_objects_with_no_lang', empty( $posts ) && empty( $terms ) ? false : array( 'posts' => $posts, 'terms' => $terms ) ); | |
| 494 | - } | |
| 495 | - | |
| 496 | - /** | |
| 497 | - * Used to delete translations or update the translations when a language slug has been modified in settings | |
| 498 | - * | |
| 499 | 408 | * @since 0.5 |
| 500 | 409 | * |
| 501 | - * @param string $old_slug the old language slug | |
| 502 | - * @param string $new_slug optional, the new language slug, if not set it means the correspondent has been deleted | |
| 410 | + * @param string $old_slug The old language slug. | |
| 411 | + * @param string $new_slug Optional, the new language slug, if not set it means that the language has been deleted. | |
| 412 | + * @return void | |
| 503 | 413 | */ |
| 504 | 414 | public function update_translations( $old_slug, $new_slug = '' ) { |
| 505 | 415 | global $wpdb; |
| 506 | 416 | |
| 507 | - $terms = get_terms( array( 'post_translations', 'term_translations' ) ); | |
| 508 | 417 | $term_ids = array(); |
| 509 | 418 | $dr = array(); |
| 510 | 419 | $dt = array(); |
| 511 | 420 | $ut = array(); |
| 512 | 421 | |
| 513 | - foreach ( $terms as $term ) { | |
| 514 | - $term_ids[ $term->taxonomy ][] = $term->term_id; | |
| 515 | - $tr = maybe_unserialize( $term->description ); | |
| 516 | - if ( ! empty( $tr[ $old_slug ] ) ) { | |
| 517 | - if ( $new_slug ) { | |
| 518 | - $tr[ $new_slug ] = $tr[ $old_slug ]; // Suppress this for delete | |
| 519 | - } else { | |
| 520 | - $dr['id'][] = (int) $tr[ $old_slug ]; | |
| 521 | - $dr['tt'][] = (int) $term->term_taxonomy_id; | |
| 522 | - } | |
| 523 | - unset( $tr[ $old_slug ] ); | |
| 422 | + $taxonomies = $this->translatable_objects->get_taxonomy_names( array( 'translations' ) ); | |
| 423 | + $terms = get_terms( array( 'taxonomy' => $taxonomies ) ); | |
| 524 | 424 | |
| 525 | - if ( empty( $tr ) || 1 == count( $tr ) ) { | |
| 526 | - $dt['t'][] = (int) $term->term_id; | |
| 527 | - $dt['tt'][] = (int) $term->term_taxonomy_id; | |
| 528 | - } else { | |
| 529 | - $ut['case'][] = $wpdb->prepare( 'WHEN %d THEN %s', $term->term_id, maybe_serialize( $tr ) ); | |
| 530 | - $ut['in'][] = (int) $term->term_id; | |
| 425 | + if ( is_array( $terms ) ) { | |
| 426 | + foreach ( $terms as $term ) { | |
| 427 | + $term_ids[ $term->taxonomy ][] = $term->term_id; | |
| 428 | + $tr = maybe_unserialize( $term->description ); | |
| 429 | + | |
| 430 | + /** | |
| 431 | + * Filters the unserialized translation group description before it is | |
| 432 | + * updated when a language is deleted or a language slug is changed. | |
| 433 | + * | |
| 434 | + * @since 3.2 | |
| 435 | + * | |
| 436 | + * @param (int|string[])[] $tr { | |
| 437 | + * List of translations with lang codes as array keys and IDs as array values. | |
| 438 | + * Also in this array: | |
| 439 | + * | |
| 440 | + * @type string[] $sync List of synchronized translations with lang codes as array keys and array values. | |
| 441 | + * } | |
| 442 | + * @param string $old_slug The old language slug. | |
| 443 | + * @param string $new_slug The new language slug. | |
| 444 | + * @param WP_Term $term The term containing the post or term translation group. | |
| 445 | + */ | |
| 446 | + $tr = apply_filters( 'update_translation_group', $tr, $old_slug, $new_slug, $term ); | |
| 447 | + | |
| 448 | + if ( ! empty( $tr[ $old_slug ] ) ) { | |
| 449 | + if ( $new_slug ) { | |
| 450 | + $tr[ $new_slug ] = $tr[ $old_slug ]; // Suppress this for delete | |
| 451 | + } else { | |
| 452 | + $dr['id'][] = (int) $tr[ $old_slug ]; | |
| 453 | + $dr['tt'][] = (int) $term->term_taxonomy_id; | |
| 454 | + } | |
| 455 | + unset( $tr[ $old_slug ] ); | |
| 456 | + | |
| 457 | + if ( empty( $tr ) || 1 == count( $tr ) ) { | |
| 458 | + $dt['t'][] = (int) $term->term_id; | |
| 459 | + $dt['tt'][] = (int) $term->term_taxonomy_id; | |
| 460 | + } else { | |
| 461 | + $ut['case'][] = $wpdb->prepare( 'WHEN %d THEN %s', $term->term_id, maybe_serialize( $tr ) ); | |
| 462 | + $ut['in'][] = (int) $term->term_id; | |
| 463 | + } | |
| 531 | 464 | } |
| 532 | 465 | } |
| 533 | 466 | } |
| 534 | 467 | |
| @@ -568,13 +501,14 @@ | ||
| 568 | 501 | } |
| 569 | 502 | |
| 570 | 503 | /** |
| 571 | 504 | * Updates the default language |
| 572 | - * taking care to update the default category & the nav menu locations | |
| 505 | + * taking care to update the default category & the nav menu locations. | |
| 573 | 506 | * |
| 574 | 507 | * @since 1.8 |
| 575 | 508 | * |
| 576 | - * @param string $slug new language slug | |
| 509 | + * @param string $slug New language slug. | |
| 510 | + * @return void | |
| 577 | 511 | */ |
| 578 | 512 | public function update_default_lang( $slug ) { |
| 579 | 513 | // The nav menus stored in theme locations should be in the default language |
| 580 | 514 | $theme = get_stylesheet(); |
| @@ -586,13 +520,16 @@ | ||
| 586 | 520 | } |
| 587 | 521 | set_theme_mod( 'nav_menu_locations', $menus ); |
| 588 | 522 | } |
| 589 | 523 | |
| 590 | - // The default category should be in the default language | |
| 591 | - $default_cats = $this->term->get_translations( get_option( 'default_category' ) ); | |
| 592 | - if ( isset( $default_cats[ $slug ] ) ) { | |
| 593 | - update_option( 'default_category', $default_cats[ $slug ] ); | |
| 594 | - } | |
| 524 | + /** | |
| 525 | + * Fires when a default language is updated. | |
| 526 | + * | |
| 527 | + * @since 3.1 | |
| 528 | + * | |
| 529 | + * @param string $slug Slug. | |
| 530 | + */ | |
| 531 | + do_action( 'pll_update_default_lang', $slug ); | |
| 595 | 532 | |
| 596 | 533 | // Update options |
| 597 | 534 | $this->options['default_lang'] = $slug; |
| 598 | 535 | update_option( 'polylang', $this->options ); |
