'he', 'in' => 'id', 'ji' => 'yi' );
if ( isset( $aliases[ $primary ] ) ) { $primary = $aliases[ $primary ]; }
$iso_languages = explode( ' ', 'aa ab ae af ak am an ar as av ay az ba be bg bh bi bm bn bo br bs ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu hy hz ia id ie ig ii ik io is it iu ja jv ka kg ki kj kk kl km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh mi mk ml mn mr ms mt my na nb nd ne ng nl nn no nr nv ny oc oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za zh zu' );
if ( ! in_array( $primary, $iso_languages, true ) ) { return ''; }
$tag = $primary;
$position = 1;
if ( isset( $parts[1] ) && in_array( ucfirst( strtolower( $parts[1] ) ), array( 'Latn', 'Cyrl', 'Hans', 'Hant', 'Arab', 'Deva', 'Hebr', 'Grek' ), true ) ) {
$tag .= '-' . ucfirst( strtolower( $parts[1] ) );
$position = 2;
}
$regions = explode( ' ', 'AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW' );
if ( isset( $parts[ $position ] ) && in_array( strtoupper( $parts[ $position ] ), $regions, true ) ) { $tag .= '-' . strtoupper( $parts[ $position ] ); }
return apply_filters( 'qtrad_seo_language_tag', $tag, $language );
}
function qtrad_seo_text( $value ) {
return qtrad_use_language( $value, qtrad_current_language(), false, true );
}
/** Get a stable permalink without inheriting the current request language. */
function qtrad_seo_post_url( $post, $language ) {
$previous = ! empty( $GLOBALS['qtrad_seo_neutral_url'] );
$GLOBALS['qtrad_seo_neutral_url'] = true;
try { $url = qtrad_slugs_in_language( $language, function () use ( $post ) { return get_permalink( $post ); } ); }
finally { $GLOBALS['qtrad_seo_neutral_url'] = $previous; }
return qtrad_convert_url( $url, $language, true, false );
}
function qtrad_seo_raw_meta( $post_id, $key ) {
$values = qtrad_raw_post_meta( $post_id, $key );
return $values ? $values[0] : '';
}
function qtrad_seo_post_indexable( $post, $language ) {
if ( ! $post || $post->post_status !== 'publish' || $post->post_password !== '' || ! get_option( 'blog_public' ) ) { return false; }
$owner = qtrad_seo_owner();
if ( $owner === 'yoast' && (string) qtrad_seo_raw_meta( $post->ID, '_yoast_wpseo_meta-robots-noindex' ) === '1' ) { return false; }
if ( $owner === 'rankmath' && in_array( 'noindex', (array) qtrad_seo_raw_meta( $post->ID, 'rank_math_robots' ), true ) ) { return false; }
$key = $owner === 'yoast' ? '_yoast_wpseo_canonical' : ( $owner === 'rankmath' ? 'rank_math_canonical_url' : '' );
if ( $key ) {
$custom = qtrad_use_language( qtrad_seo_raw_meta( $post->ID, $key ), $language, false, true );
if ( is_string( $custom ) && $custom !== '' && qtrad_convert_url( $custom, $language, true, false ) !== qtrad_seo_post_url( $post, $language ) ) { return false; }
}
return (bool) apply_filters( 'qtrad_seo_post_indexable', true, $post, $language );
}
function qtrad_seo_post_languages( $post ) {
return array_values( array_filter( qtrad_post_available_languages( $post ), function ( $language ) use ( $post ) {
return qtrad_seo_language_tag( $language ) !== '' && qtrad_seo_post_indexable( $post, $language );
} ) );
}
function qtrad_seo_missing_translation() {
if ( is_singular() ) {
return ! in_array( qtrad_current_language(), qtrad_post_available_languages( get_post( get_queried_object_id() ) ), true );
}
$languages = qtrad_seo_archive_languages();
return is_array( $languages ) && ! in_array( qtrad_current_language(), $languages, true );
}
/**
* Languages an archive of a term, an author or a post type has content in:
* those in which at least one of its published posts is translated. Null for
* other pages, which keep all languages.
*/
function qtrad_seo_archive_languages() {
if ( is_category() || is_tag() || is_tax() ) {
$object = get_queried_object();
return $object instanceof WP_Term ? qtrad_seo_term_languages( $object ) : null;
}
if ( is_author() ) {
return qtrad_seo_languages_with_posts( array( 'author' => (int) get_queried_object_id(), 'post_type' => 'post' ), 'author:' . (int) get_queried_object_id() );
}
if ( is_post_type_archive() ) {
$type = get_queried_object();
return isset( $type->name ) ? qtrad_seo_languages_with_posts( array( 'post_type' => $type->name ), 'type:' . $type->name ) : null;
}
return null;
}
function qtrad_seo_term_languages( $term ) {
$taxonomy = get_taxonomy( $term->taxonomy );
$types = $taxonomy ? array_values( array_filter( (array) $taxonomy->object_type, 'is_post_type_viewable' ) ) : array();
if ( ! $types ) {
return qtrad_enabled_languages();
}
$args = array( 'post_type' => $types, 'tax_query' => array( array( 'taxonomy' => $term->taxonomy, 'terms' => (int) $term->term_id, 'include_children' => true ) ) ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query -- One small existence check per language, cached.
return qtrad_seo_languages_with_posts( $args, 'term:' . (int) $term->term_id );
}
/**
* When a cache group last changed, the stamp core keeps in the object cache
* under 'last_changed'. Set to now when the group has none yet.
*/
function qtrad_cache_last_changed( $group ) {
$stamp = wp_cache_get( 'last_changed', $group );
if ( ! $stamp ) {
$stamp = microtime();
wp_cache_set( 'last_changed', $stamp, $group );
}
return (string) $stamp;
}
/** Enabled languages in which at least one published post matching $args has content. Cached until posts change. */
function qtrad_seo_languages_with_posts( $args, $key ) {
$cache_key = $key . ':' . md5( implode( ',', qtrad_enabled_languages() ) ) . ':' . qtrad_cache_last_changed( 'posts' ) . ':' . qtrad_cache_last_changed( 'terms' );
$found = wp_cache_get( $cache_key, 'qtrad_seo' );
if ( is_array( $found ) ) {
return $found;
}
$found = array();
foreach ( qtrad_enabled_languages() as $language ) {
$query = new WP_Query( array_merge( $args, array( 'post_status' => 'publish', 'has_password' => false, 'posts_per_page' => 1, 'fields' => 'ids', 'no_found_rows' => true, 'ignore_sticky_posts' => true, 'qtrad_language_probe' => $language ) ) );
if ( $query->posts ) {
$found[] = $language;
}
}
wp_cache_set( $cache_key, $found, 'qtrad_seo' );
return $found;
}
/** The probe queries above only count posts with content in their language. */
function qtrad_seo_language_probe_where( $where, $query ) {
$language = $query instanceof WP_Query ? $query->get( 'qtrad_language_probe' ) : '';
return is_string( $language ) && qtrad_is_enabled( $language ) ? $where . qtrad_available_language_where( $language ) : $where;
}
function qtrad_seo_canonical( $url ) {
return is_string( $url ) && $url !== '' ? qtrad_convert_url( qtrad_slugs_localize_url( qtrad_seo_text( $url ), qtrad_current_language() ), qtrad_current_language(), true, false ) : $url;
}
/** Canonical archive URLs omit request tracking arguments and retain pagination. */
function qtrad_seo_current_url( $language ) {
if ( is_singular() ) {
$url = wp_get_canonical_url( get_queried_object_id() );
return $url ? qtrad_convert_url( qtrad_slugs_localize_url( $url, $language ), $language, true, false ) : qtrad_seo_post_url( get_post( get_queried_object_id() ), $language );
}
if ( is_category() || is_tag() || is_tax() ) { $url = get_term_link( get_queried_object() ); }
elseif ( is_author() ) { $url = get_author_posts_url( get_queried_object_id() ); }
elseif ( is_post_type_archive() ) { $url = get_post_type_archive_link( get_queried_object()->name ); }
elseif ( is_home() && get_option( 'page_for_posts' ) ) { $url = qtrad_seo_post_url( get_post( get_option( 'page_for_posts' ) ), $language ); }
elseif ( is_home() || is_front_page() ) { $url = trailingslashit( get_option( 'home' ) ); }
else { return qtrad_convert_url( '', $language, true, false ); }
if ( is_wp_error( $url ) || ! is_string( $url ) || $url === '' ) { return ''; }
$page = max( 1, (int) get_query_var( 'paged' ), (int) get_query_var( 'page' ) );
if ( $page > 1 ) {
global $wp_rewrite;
$url = $wp_rewrite->using_permalinks() ? trailingslashit( $url ) . user_trailingslashit( $wp_rewrite->pagination_base . '/' . $page, 'paged' ) : add_query_arg( 'paged', $page, $url );
}
return qtrad_convert_url( qtrad_slugs_localize_url( $url, $language ), $language, true, false );
}
function qtrad_seo_core_robots( $robots ) {
if ( qtrad_seo_missing_translation() ) { unset( $robots['index'] ); $robots['noindex'] = true; }
return $robots;
}
function qtrad_seo_vendor_robots( $robots ) {
if ( ! qtrad_seo_missing_translation() ) { return $robots; }
if ( is_array( $robots ) ) {
foreach ( $robots as $key => $value ) { if ( $value === 'index' || $key === 'index' ) { unset( $robots[ $key ] ); } }
$robots['index'] = 'noindex';
return $robots;
}
$directives = preg_split( '/\s*,\s*/', (string) $robots );
$directives = array_diff( $directives, array( 'index', 'noindex', '' ) );
$directives[] = 'noindex';
return implode( ', ', $directives );
}
function qtrad_seo_head_links() {
if ( is_admin() || is_feed() || is_404() || is_search() || qtrad_is_rest_request() || qtrad_is_sitemap_request() || ! get_option( 'blog_public' ) || qtrad_seo_missing_translation() ) { return; }
$post = is_singular() ? get_post( get_queried_object_id() ) : null;
$archive = $post ? null : qtrad_seo_archive_languages();
$languages = $post ? qtrad_seo_post_languages( $post ) : ( is_array( $archive ) ? array_values( array_filter( $archive, function ( $language ) { return qtrad_seo_language_tag( $language ) !== ''; } ) ) : qtrad_enabled_languages() );
$tags = array();
foreach ( $languages as $language ) {
$tag = qtrad_seo_language_tag( $language );
if ( $tag === '' || isset( $tags[ $tag ] ) ) { continue; }
$tags[ $tag ] = true;
$url = qtrad_seo_current_url( $language );
echo '' . "\n";
}
$default = qtrad_default_language();
if ( in_array( $default, $languages, true ) && qtrad_seo_language_tag( $default ) !== '' ) {
$url = qtrad_seo_current_url( $default );
echo '' . "\n";
}
}
function qtrad_seo_description() {
$post = is_singular() ? get_post( get_queried_object_id() ) : null;
// A password-protected post shows its form; its text must not reach metadata either.
if ( $post && post_password_required( $post ) ) { return ''; }
$override = $post ? qtrad_seo_override( $post->ID, 'description', qtrad_current_language() ) : '';
if ( $override !== '' ) { return $override; }
$text = $post ? qtrad_seo_text( $post->post_excerpt !== '' ? $post->post_excerpt : $post->post_content ) : get_option( 'blogdescription' );
return wp_trim_words( wp_strip_all_tags( strip_shortcodes( $text ), true ), 32, '…' );
}
function qtrad_seo_og_locale( $unused = '' ) {
$tag = qtrad_seo_language_tag( qtrad_current_language() );
if ( preg_match( '/^([a-z]{2,3})(?:-[A-Za-z]{4})?-([A-Z]{2})$/D', $tag, $match ) ) { return $match[1] . '_' . $match[2]; }
return preg_match( '/^([a-z]{2,3})_[A-Z]{2}$/D', $unused, $match ) && $match[1] === $tag ? $unused : '';
}
/** Native fallback output; SEO plugins remain responsible for their own tags. */
function qtrad_seo_native_head() {
if ( qtrad_seo_owner() || is_admin() || is_feed() || is_404() || is_search() || qtrad_is_rest_request() || qtrad_is_sitemap_request() ) { return; }
$url = qtrad_seo_current_url( qtrad_current_language() );
$title = wp_get_document_title();
$description = qtrad_seo_description();
if ( ! is_singular() ) { echo '' . "\n"; }
foreach ( array( 'description' => $description, 'twitter:card' => 'summary', 'twitter:title' => $title, 'twitter:description' => $description ) as $name => $value ) {
if ( $value !== '' ) { echo '' . "\n"; }
}
foreach ( array( 'og:title' => $title, 'og:description' => $description, 'og:url' => $url, 'og:locale' => qtrad_seo_og_locale(), 'og:type' => 'website' ) as $name => $value ) {
if ( $value !== '' ) { echo '' . "\n"; }
}
$schema = apply_filters( 'qtrad_seo_schema', array( '@context' => 'https://schema.org', '@type' => 'WebPage', '@id' => $url . '#webpage', 'url' => $url, 'name' => $title, 'description' => $description, 'inLanguage' => qtrad_seo_language_tag( qtrad_current_language() ) ) );
wp_print_inline_script_tag( wp_json_encode( $schema, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ), array( 'type' => 'application/ld+json' ) );
}
/** Read multilingual SEO overrides from raw storage, independent of indexable caches. */
function qtrad_seo_vendor_text( $value ) {
$keys = array(
'wpseo_title' => '_yoast_wpseo_title', 'wpseo_metadesc' => '_yoast_wpseo_metadesc',
'wpseo_opengraph_title' => '_yoast_wpseo_opengraph-title', 'wpseo_opengraph_desc' => '_yoast_wpseo_opengraph-description',
'wpseo_twitter_title' => '_yoast_wpseo_twitter-title', 'wpseo_twitter_description' => '_yoast_wpseo_twitter-description',
'rank_math/frontend/title' => 'rank_math_title', 'rank_math/frontend/description' => 'rank_math_description',
'rank_math/opengraph/facebook/og_title' => 'rank_math_facebook_title', 'rank_math/opengraph/facebook/og_description' => 'rank_math_facebook_description',
'rank_math/opengraph/twitter/twitter_title' => 'rank_math_twitter_title', 'rank_math/opengraph/twitter/twitter_description' => 'rank_math_twitter_description',
);
$hook = current_filter();
$kind = strpos( $hook, 'title' ) !== false ? 'title' : ( strpos( $hook, 'desc' ) !== false ? 'description' : '' );
// Some SEO plugin versions build a description from the content even while a password protects it.
if ( 'description' === $kind && qtrad_seo_protected() ) { return ''; }
$override = is_singular() && $kind ? qtrad_seo_override( get_queried_object_id(), $kind, qtrad_current_language() ) : '';
if ( $override !== '' ) { return $override; }
if ( is_singular() && isset( $keys[ $hook ] ) ) {
$raw = qtrad_seo_raw_meta( get_queried_object_id(), $keys[ $hook ] );
if ( is_string( $raw ) && qtrad_has_lang_tags( $raw ) && ! ( 'description' === $kind && post_password_required( get_queried_object_id() ) ) ) {
$value = qtrad_seo_text( $raw );
if ( strpos( $hook, 'wpseo_' ) === 0 && function_exists( 'wpseo_replace_vars' ) ) { $value = wpseo_replace_vars( $value, get_queried_object() ); }
elseif ( class_exists( 'RankMath\\Helper' ) ) { $value = \RankMath\Helper::replace_vars( $value ); }
}
}
return qtrad_seo_text( $value );
}
function qtrad_seo_yoast_replacements( $replacements ) {
if ( is_singular() ) {
$post = get_post( get_queried_object_id() );
if ( $post ) { $replacements['%%title%%'] = qtrad_seo_text( $post->post_title ); }
}
$replacements['%%sitename%%'] = qtrad_seo_text( get_option( 'blogname' ) );
$replacements['%%sitedesc%%'] = qtrad_seo_text( get_option( 'blogdescription' ) );
return $replacements;
}
/** Translate text and site-local identifiers throughout the vendor's existing graph. */
function qtrad_seo_schema( $data ) {
if ( ! is_array( $data ) ) { return qtrad_seo_text( $data ); }
foreach ( $data as $key => $value ) {
if ( in_array( $key, array( 'description', 'articleBody', 'text' ), true ) && is_string( $value ) && qtrad_seo_protected() ) { unset( $data[ $key ] ); continue; }
if ( is_array( $value ) ) { $data[ $key ] = qtrad_seo_schema( $value ); }
elseif ( is_string( $value ) ) {
$data[ $key ] = qtrad_seo_text( $value );
if ( in_array( $key, array( 'url', '@id', 'item' ), true ) ) { $data[ $key ] = qtrad_seo_canonical( $data[ $key ] ); }
if ( $key === 'inLanguage' ) { $data[ $key ] = qtrad_seo_language_tag( qtrad_current_language() ); }
}
}
$types = isset( $data['@type'] ) ? (array) $data['@type'] : array();
if ( is_singular() && array_intersect( $types, array( 'WebPage', 'Article', 'BlogPosting', 'NewsArticle' ) ) ) {
foreach ( array( 'name' => 'title', 'headline' => 'title', 'description' => 'description' ) as $key => $kind ) {
$override = qtrad_seo_override( get_queried_object_id(), $kind, qtrad_current_language() );
if ( isset( $data[ $key ] ) && $override !== '' ) { $data[ $key ] = $override; }
}
}
return $data;
}
/** Whether the queried post is password-protected for this visitor. */
function qtrad_seo_protected() {
return is_singular() && post_password_required( get_queried_object_id() );
}
function qtrad_seo_override( $post_id, $kind, $language ) {
if ( 'description' === $kind && post_password_required( $post_id ) ) { return ''; }
$value = qtrad_seo_raw_meta( $post_id, '_qtrad_seo_' . $kind );
return is_string( $value ) ? wp_strip_all_tags( qtrad_use_language( $value, $language, false, true ), true ) : '';
}
function qtrad_seo_document_title( $parts ) {
if ( ! qtrad_seo_owner() && is_singular() ) {
$title = qtrad_seo_override( get_queried_object_id(), 'title', qtrad_current_language() );
if ( $title !== '' ) { $parts['title'] = $title; }
}
return $parts;
}
/** Explicit, labelled fields work in both editors without a JavaScript dependency. */
function qtrad_seo_add_meta_box( $post_type, $post ) {
$type = get_post_type_object( $post_type );
if ( $type && $type->public && $post_type !== 'attachment' && current_user_can( 'edit_post', $post->ID ) ) {
add_meta_box( 'qtrad-seo', esc_html__( 'SEO translations', 'qtrad' ), 'qtrad_seo_meta_box', $post_type, 'normal', 'default' );
}
}
function qtrad_seo_meta_box( $post ) {
wp_nonce_field( 'qtrad_seo_' . $post->ID, 'qtrad_seo_nonce' );
echo '';
echo '
' . esc_html__( 'Optional titles and descriptions for search engines and social sharing. Leave blank to use existing SEO settings or automatically generated text.', 'qtrad' ) . '