links = &$polylang->links;
$this->model = &$polylang->model;
$this->pref_lang = &$polylang->pref_lang;
$this->default_term = &$polylang->default_term;
foreach ( $this->model->get_translated_taxonomies() as $tax ) {
// Adds the language field in the 'Categories' and 'Post Tags' panels
add_action( $tax . '_add_form_fields', array( $this, 'add_term_form' ) );
// Adds the language field and translations tables in the 'Edit Category' and 'Edit Tag' panels
add_action( $tax . '_edit_form_fields', array( $this, 'edit_term_form' ) );
}
// Adds actions related to languages when creating or saving categories and post tags.
add_filter( 'taxonomy_parent_dropdown_args', array( $this, 'taxonomy_parent_dropdown_args' ), 10, 3 );
add_action( 'create_term', array( $this, 'save_term' ), 900, 3 );
add_action( 'edit_term', array( $this, 'save_term' ), 900, 3 ); // Late as it may conflict with other plugins, see http://wordpress.org/support/topic/polylang-and-wordpress-seo-by-yoast
add_action( 'pre_post_update', array( $this, 'pre_post_update' ) );
add_filter( 'pll_inserted_term_language', array( $this, 'get_inserted_term_language' ) );
add_filter( 'pll_inserted_term_parent', array( $this, 'get_inserted_term_parent' ), 10, 2 );
// Ajax response for edit term form
add_action( 'wp_ajax_term_lang_choice', array( $this, 'term_lang_choice' ) );
add_action( 'wp_ajax_pll_terms_not_translated', array( $this, 'ajax_terms_not_translated' ) );
// Updates the translations term ids when splitting a shared term
add_action( 'split_shared_term', array( $this, 'split_shared_term' ), 10, 4 ); // WP 4.2
}
/**
* Adds the language field in the 'Categories' and 'Post Tags' panels
*
* @since 0.1
*
* @return void
*/
public function add_term_form() {
if ( isset( $_GET['taxonomy'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$taxonomy = sanitize_key( $_GET['taxonomy'] ); // phpcs:ignore WordPress.Security.NonceVerification
}
if ( isset( $_REQUEST['post_type'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$post_type = sanitize_key( $_REQUEST['post_type'] ); // phpcs:ignore WordPress.Security.NonceVerification
}
if ( isset( $GLOBALS['post_type'] ) ) {
$post_type = $GLOBALS['post_type'];
}
if ( ! isset( $taxonomy, $post_type ) || ! taxonomy_exists( $taxonomy ) || ! post_type_exists( $post_type ) ) {
return;
}
$from_term_id = isset( $_GET['from_tag'] ) ? (int) $_GET['from_tag'] : 0; // phpcs:ignore WordPress.Security.NonceVerification
$lang = isset( $_GET['new_lang'] ) ? $this->model->get_language( sanitize_key( $_GET['new_lang'] ) ) : $this->pref_lang; // phpcs:ignore WordPress.Security.NonceVerification
$dropdown = new PLL_Walker_Dropdown();
$dropdown_html = $dropdown->walk(
$this->model->languages->filter( 'translator' )->get_list(),
-1,
array(
'name' => 'term_lang_choice',
'value' => 'term_id',
'selected' => $lang ? $lang->term_id : '',
'flag' => true,
)
);
wp_nonce_field( 'pll_language', '_pll_nonce' );
printf(
'
',
esc_html__( 'Language', 'polylang' ),
$dropdown_html, // phpcs:ignore
esc_html__( 'Sets the language', 'polylang' )
);
if ( ! empty( $from_term_id ) ) {
printf( '', (int) $from_term_id );
}
// Adds translation fields
echo '';
if ( $lang ) {
include __DIR__ . '/view-translations-term.php';
}
echo '
' . "\n";
}
/**
* Adds the language field and translations tables in the 'Edit Category' and 'Edit Tag' panels.
*
* @since 0.1
*
* @param WP_Term $term The term being edited.
* @return void
*/
public function edit_term_form( $term ) {
if ( isset( $_REQUEST['post_type'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$post_type = sanitize_key( $_REQUEST['post_type'] ); // phpcs:ignore WordPress.Security.NonceVerification
}
if ( isset( $GLOBALS['post_type'] ) ) {
$post_type = $GLOBALS['post_type'];
}
if ( ! isset( $post_type ) || ! post_type_exists( $post_type ) ) {
return;
}
$taxonomy = $term->taxonomy; // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
$lang = $this->model->term->get_language( $term->term_id );
$lang = empty( $lang ) ? $this->pref_lang : $lang;
// Disable the language dropdown and the translations input fields for default terms to prevent removal
$disabled = $this->default_term->is_default_term( $term->term_id );
$dropdown = new PLL_Walker_Dropdown();
$dropdown_html = $dropdown->walk(
$this->model->languages->filter( 'translator' )->get_list(),
-1,
array(
'name' => 'term_lang_choice',
'value' => 'term_id',
'selected' => $lang->term_id,
'disabled' => $disabled,
'flag' => true,
)
);
wp_nonce_field( 'pll_language', '_pll_nonce' );
printf(
'
|
|
%s
%s
|
',
esc_html__( 'Language', 'polylang' ),
$dropdown_html, // phpcs:ignore
esc_html__( 'Sets the language', 'polylang' )
);
echo '';
include __DIR__ . '/view-translations-term.php';
echo '
' . "\n";
}
/**
* Translates the term parent if it exists when using "Add new".
*
* @since 3.9
*
* @param array $args The taxonomy parent dropdown arguments.
* @param string $taxonomy The taxonomy name.
* @param string $context The filter context, 'new' or 'edit'.
* @return array
*/
public function taxonomy_parent_dropdown_args( $args, $taxonomy, $context ) {
if ( ! isset( $_GET['from_tag'], $_GET['new_lang'] ) || 'new' !== $context ) { // phpcs:ignore WordPress.Security.NonceVerification
return $args;
}
$term = get_term( (int) $_GET['from_tag'], $taxonomy ); // phpcs:ignore WordPress.Security.NonceVerification
if ( ! $term instanceof WP_Term || ! $term->parent ) {
return $args;
}
$lang = $this->model->get_language( sanitize_key( $_GET['new_lang'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
$args['selected'] = $this->model->term->get_translation( $term->parent, $lang );
return $args;
}
/**
* Stores the current post_id when bulk editing posts for use in save_language and get_inserted_term_language.
*
* @since 1.7
*
* @param int $post_id Post ID.
* @return void
*/
public function pre_post_update( $post_id ) {
if ( isset( $_GET['bulk_edit'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$this->post_id = $post_id;
}
}
/**
* Saves the language of a term.
*
* @since 1.5
*
* @param int $term_id The term ID.
* @param string $taxonomy Taxonomy name.
* @return void|never
*/
protected function save_language( $term_id, $taxonomy ) {
$term_id = (int) $term_id;
/*
* Category metabox.
*/
if ( isset( $_POST['term_lang_choice'], $_REQUEST[ '_ajax_nonce-add-' . $taxonomy ] ) && wp_verify_nonce( $_REQUEST[ '_ajax_nonce-add-' . $taxonomy ], 'add-' . $taxonomy ) ) {
$this->maybe_set_language( $term_id, sanitize_key( $_POST['term_lang_choice'] ) );
return;
}
/*
* Edit tags or tags metabox.
*/
if ( isset( $_POST['term_lang_choice'] ) ) {
check_admin_referer( 'pll_language', '_pll_nonce' );
$this->maybe_set_language( $term_id, sanitize_key( $_POST['term_lang_choice'] ) );
return;
}
/*
* *Post* bulk edit, in case a new term is created.
*/
if ( isset( $_GET['bulk_edit'], $_GET['inline_lang_choice'], $_REQUEST['_wpnonce'] ) && wp_verify_nonce( $_REQUEST['_wpnonce'], 'bulk-posts' ) ) {
/*
* Bulk edit does not modify the language, so we possibly create a tag in several languages.
*/
if ( -1 === (int) $_GET['inline_lang_choice'] ) {
// The language of the current term is set a according to the language of the current post.
$language = $this->model->post->get_language( $this->post_id );
if ( empty( $language ) ) {
return;
}
Capabilities::get_user()->can_translate_or_die( $language );
$this->model->term->set_language( $term_id, $language );
$term = get_term( $term_id, $taxonomy );
// Get all terms with the same name.
if ( $term instanceof WP_Term ) {
$term_ids = get_terms( array( 'taxonomy' => $taxonomy, 'name' => $term->name, 'hide_empty' => false, 'fields' => 'ids' ) );
// If we have several terms with the same name, they are translations of each other.
if ( is_array( $term_ids ) && count( $term_ids ) > 1 ) {
$translations = array();
foreach ( $term_ids as $_id ) {
$translations[ $this->model->term->get_language( $_id )->slug ] = $_id;
}
$this->model->term->save_translations( $term_id, $translations );
}
}
return;
}
if ( current_user_can( 'edit_term', $term_id ) ) {
$this->maybe_set_language( $term_id, sanitize_key( $_GET['inline_lang_choice'] ) );
}
return;
}
/*
* Quick edit.
*/
if ( isset( $_POST['inline_lang_choice'], $_REQUEST['_inline_edit'] ) ) {
if ( ! wp_verify_nonce( $_REQUEST['_inline_edit'], 'inlineeditnonce' ) && ! wp_verify_nonce( $_REQUEST['_inline_edit'], 'taxinlineeditnonce' ) ) { // Post quick edit or tag quick edit?
return;
}
$this->maybe_set_language( $term_id, sanitize_key( $_POST['inline_lang_choice'] ) );
return;
}
/*
* Edit post.
*/
if ( isset( $_POST['post_lang_choice'] ) ) { // FIXME should be useless now.
check_admin_referer( 'pll_language', '_pll_nonce' );
$this->maybe_set_language( $term_id, sanitize_key( $_POST['post_lang_choice'] ) );
}
}
/**
* Sets the language of a term if the user is allowed to.
*
* @since 3.8
*
* @param int $term_id The term ID.
* @param string $language Language slug.
* @return void|never
*/
private function maybe_set_language( int $term_id, string $language ): void {
$language = $this->model->get_language( $language );
if ( empty( $language ) ) {
return;
}
Capabilities::get_user()->can_translate_or_die( $language );
$this->model->term->set_language( $term_id, $language );
}
/**
* Save translations from our form.
*
* @since 1.5
*
* @param int $term_id The term id of the term being saved.
* @return int[] The array of translated term ids.
*/
protected function save_translations( $term_id ) {
// Security check as 'wp_update_term' can be called from outside WP admin.
check_admin_referer( 'pll_language', '_pll_nonce' );
$translations = array();
// Save translations after checking the translated term is in the right language ( as well as cast id to int ).
if ( isset( $_POST['term_tr_lang'] ) ) {
foreach ( array_map( 'absint', $_POST['term_tr_lang'] ) as $lang => $tr_id ) {
$tr_lang = $this->model->term->get_language( $tr_id );
$translations[ $lang ] = $tr_lang && $tr_lang->slug == $lang ? $tr_id : 0;
}
}
$this->model->term->save_translations( $term_id, $translations );
return $translations;
}
/**
* Called when a category or post tag is created or edited
* Saves language and translations
*
* @since 0.1
*
* @param int $term_id Term ID.
* @param int $tt_id Term taxonomy ID.
* @param string $taxonomy Taxonomy name.
* @return void
*/
public function save_term( $term_id, $tt_id, $taxonomy ) {
// Does nothing except on taxonomies which are filterable
if ( ! $this->model->is_translated_taxonomy( $taxonomy ) ) {
return;
}
$tax = get_taxonomy( $taxonomy );
if ( empty( $tax ) ) {
return;
}
// Capability check
// As 'wp_update_term' can be called from outside WP admin
// 2nd test for creating tags when creating / editing a post
if ( current_user_can( $tax->cap->edit_terms ) || ( isset( $_POST['tax_input'][ $taxonomy ] ) && current_user_can( $tax->cap->assign_terms ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$this->save_language( $term_id, $taxonomy );
if ( isset( $_POST['term_tr_lang'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$this->save_translations( $term_id );
}
}
}
/**
* Ajax response for edit term form
*
* @since 0.2
*
* @return void
*/
public function term_lang_choice() {
check_ajax_referer( 'pll_language', '_pll_nonce' );
if ( ! isset( $_POST['taxonomy'], $_POST['post_type'], $_POST['lang'] ) ) {
wp_die( 0 );
}
$lang = $this->model->get_language( sanitize_key( $_POST['lang'] ) );
$taxonomy = sanitize_key( $_POST['taxonomy'] );
$post_type = sanitize_key( $_POST['post_type'] );
if ( empty( $lang ) || ! post_type_exists( $post_type ) || ! taxonomy_exists( $taxonomy ) ) {
wp_die( 0 );
}
if ( ! empty( $_POST['term_id'] ) ) {
$term = get_term( (int) $_POST['term_id'], $taxonomy ); // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
$term = $term instanceof WP_Term ? $term : null;
}
ob_start();
include __DIR__ . '/view-translations-term.php';
$x = new WP_Ajax_Response( array( 'what' => 'translations', 'data' => ob_get_contents() ) );
ob_end_clean();
// Parent dropdown list ( only for hierarchical taxonomies )
// $args copied from edit_tags.php except echo
if ( is_taxonomy_hierarchical( $taxonomy ) ) {
$args = array(
'hide_empty' => 0,
'hide_if_empty' => false,
'taxonomy' => $taxonomy,
'name' => 'parent',
'orderby' => 'name',
'hierarchical' => true,
'show_option_none' => __( 'None', 'polylang' ),
'echo' => 0,
);
$x->Add( array( 'what' => 'parent', 'data' => wp_dropdown_categories( $args ) ) );
}
// Tag cloud
// Tests copied from edit_tags.php
else {
$tax = get_taxonomy( $taxonomy );
if ( ! empty( $tax ) && ! is_null( $tax->labels->popular_items ) ) {
$args = array( 'taxonomy' => $taxonomy, 'echo' => false );
if ( current_user_can( $tax->cap->edit_terms ) ) {
$args = array_merge( $args, array( 'link' => 'edit' ) );
}
$tag_cloud = wp_tag_cloud( $args );
if ( ! empty( $tag_cloud ) ) {
/** @phpstan-var non-falsy-string $tag_cloud */
$html = sprintf( '%1$s
%2$s', esc_html( $tax->labels->popular_items ), $tag_cloud );
$x->Add( array( 'what' => 'tag_cloud', 'data' => $html ) );
}
}
}
// Flag
$x->Add( array( 'what' => 'flag', 'data' => $lang->get_admin_flag( 'aria-hidden' ) ) );
$x->send();
}
/**
* Ajax response for input in translation autocomplete input box.
*
* @since 1.5
*
* @return void
*/
public function ajax_terms_not_translated() {
check_ajax_referer( 'pll_language', '_pll_nonce' );
if ( ! isset( $_GET['term'], $_GET['post_type'], $_GET['taxonomy'], $_GET['term_language'], $_GET['translation_language'] ) ) {
wp_die( 0 );
}
/** @var string */
$s = wp_unslash( $_GET['term'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput
$post_type = sanitize_key( $_GET['post_type'] );
$taxonomy = sanitize_key( $_GET['taxonomy'] );
if ( ! post_type_exists( $post_type ) || ! taxonomy_exists( $taxonomy ) ) {
wp_die( 0 );
}
$term_language = $this->model->get_language( sanitize_key( $_GET['term_language'] ) );
$translation_language = $this->model->get_language( sanitize_key( $_GET['translation_language'] ) );
$terms = array();
$return = array();
// Add current translation in list.
// Not in add term as term_id is not set.
if ( isset( $_GET['term_id'] ) && 'undefined' !== $_GET['term_id'] && $term_id = $this->model->term->get_translation( (int) $_GET['term_id'], $translation_language ) ) {
$terms = array( get_term( $term_id, $taxonomy ) );
}
// It is more efficient to use one common query for all languages as soon as there are more than 2.
$all_terms = get_terms( array( 'taxonomy' => $taxonomy, 'hide_empty' => false, 'lang' => '', 'name__like' => $s ) );
if ( is_array( $all_terms ) ) {
foreach ( $all_terms as $term ) {
$lang = $this->model->term->get_language( $term->term_id );
if ( $lang && $lang->slug == $translation_language->slug && ! $this->model->term->get_translation( $term->term_id, $term_language ) ) {
$terms[] = $term;
}
}
}
// Format the ajax response.
foreach ( $terms as $term ) {
if ( ! $term instanceof WP_Term ) {
continue;
}
$parents_list = get_term_parents_list(
$term->term_id,
$term->taxonomy,
array(
'separator' => ' > ',
'link' => false,
)
);
if ( ! is_string( $parents_list ) ) {
continue;
}
$return[] = array(
'id' => $term->term_id,
'value' => rtrim( $parents_list, ' >' ), // Trim the separator added at the end by WP.
'link' => $this->links->get_edit_term_link_html( $term, $post_type ),
);
}
wp_die( wp_json_encode( $return ) ?: '[]' );
}
/**
* Updates the translations term ids when splitting a shared term
* Splits translations if these are shared terms too
*
* @since 1.7
*
* @param int $term_id ID of the formerly shared term.
* @param int $new_term_id ID of the new term created for the $term_taxonomy_id.
* @param int $term_taxonomy_id ID for the term_taxonomy row affected by the split.
* @param string $taxonomy Taxonomy name.
* @return void
*/
public function split_shared_term( $term_id, $new_term_id, $term_taxonomy_id, $taxonomy ) {
if ( ! $this->model->is_translated_taxonomy( $taxonomy ) ) {
return;
}
// Avoid recursion
static $avoid_recursion = false;
if ( $avoid_recursion ) {
return;
}
$lang = $this->model->term->get_language( $term_id );
if ( empty( $lang ) ) {
return;
}
$avoid_recursion = true;
$translations = array();
foreach ( $this->model->term->get_translations( $term_id ) as $key => $tr_id ) {
if ( $lang->slug == $key ) {
$translations[ $key ] = $new_term_id;
}
else {
$tr_term = get_term( $tr_id, $taxonomy );
if ( ! $tr_term instanceof WP_Term ) {
continue;
}
$split_term_id = _split_shared_term( $tr_id, $tr_term->term_taxonomy_id );
if ( is_int( $split_term_id ) ) {
$translations[ $key ] = $split_term_id;
} else {
$translations[ $key ] = $tr_id;
}
// Hack translation ids sent by the form to avoid overwrite in PLL_Admin_Filters_Term::save_translations
if ( isset( $_POST['term_tr_lang'][ $key ] ) && $_POST['term_tr_lang'][ $key ] == $tr_id ) { // phpcs:ignore WordPress.Security.NonceVerification
$_POST['term_tr_lang'][ $key ] = $translations[ $key ];
}
}
$this->model->term->set_language( $translations[ $key ], $key );
}
$this->model->term->save_translations( $new_term_id, $translations );
$avoid_recursion = false;
}
/**
* Returns the language for subsequently inserted term in admin.
*
* @since 3.3
*
* @param PLL_Language|null $lang Term language object if found, null otherwise.
* @return PLL_Language|null Language object, null if none found.
*/
public function get_inserted_term_language( $lang ) {
if ( $lang instanceof PLL_Language ) {
return $lang;
}
if ( ! empty( $_POST['term_lang_choice'] ) && is_string( $_POST['term_lang_choice'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$lang_slug = sanitize_key( $_POST['term_lang_choice'] ); // phpcs:ignore WordPress.Security.NonceVerification
$lang = $this->model->get_language( $lang_slug );
return $lang instanceof PLL_Language ? $lang : null;
}
if ( ! empty( $_POST['inline_lang_choice'] ) && is_string( $_POST['inline_lang_choice'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$lang_slug = sanitize_key( $_POST['inline_lang_choice'] ); // phpcs:ignore WordPress.Security.NonceVerification
$lang = $this->model->get_language( $lang_slug );
return $lang instanceof PLL_Language ? $lang : null;
}
// *Post* bulk edit, in case a new term is created
if ( isset( $_GET['bulk_edit'], $_GET['inline_lang_choice'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
// Bulk edit does not modify the language
if ( -1 === (int) $_GET['inline_lang_choice'] ) { // phpcs:ignore WordPress.Security.NonceVerification
$lang = $this->model->post->get_language( $this->post_id );
return $lang instanceof PLL_Language ? $lang : null;
} elseif ( is_string( $_GET['inline_lang_choice'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$lang_slug = sanitize_key( $_GET['inline_lang_choice'] ); // phpcs:ignore WordPress.Security.NonceVerification
$lang = $this->model->get_language( $lang_slug );
return $lang instanceof PLL_Language ? $lang : null;
}
}
// Special cases for default categories as the select is disabled.
$default_term = get_option( 'default_category' );
if ( ! is_numeric( $default_term ) ) {
return null;
}
if ( ! empty( $_POST['tag_ID'] ) && in_array( (int) $default_term, $this->model->term->get_translations( (int) $_POST['tag_ID'] ), true ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$lang = $this->model->term->get_language( (int) $_POST['tag_ID'] ); // phpcs:ignore WordPress.Security.NonceVerification
return $lang instanceof PLL_Language ? $lang : null;
}
if ( ! empty( $_POST['tax_ID'] ) && in_array( (int) $default_term, $this->model->term->get_translations( (int) $_POST['tax_ID'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$lang = $this->model->term->get_language( (int) $_POST['tax_ID'] ); // phpcs:ignore WordPress.Security.NonceVerification
return $lang instanceof PLL_Language ? $lang : null;
}
return null;
}
/**
* Filters the subsequently inserted term parent in admin.
*
* @since 3.3
*
* @param int $parent Parent term ID, 0 if none found.
* @param string $taxonomy Term taxonomy.
* @return int Parent term ID if found, 0 otherwise.
*/
public function get_inserted_term_parent( $parent, $taxonomy ) {
if ( $parent ) {
return $parent;
}
if ( isset( $_POST['parent'], $_POST['term_lang_choice'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$parent = intval( $_POST['parent'] ); // phpcs:ignore WordPress.Security.NonceVerification
} elseif ( isset( $_POST[ "new{$taxonomy}_parent" ], $_POST['term_lang_choice'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$parent = intval( $_POST[ "new{$taxonomy}_parent" ] ); // phpcs:ignore WordPress.Security.NonceVerification
}
return $parent;
}
}