esc_html_x( string $text, string $anlam_ipucu, string $textdomain = 'default' )

Açıklaması:

Bu fonksiyon, eşsesli kelimeleri, ayrı ayrı tercüme etmeyi mümkün kılan _x() fonksiyonun, güvenlik tedbirleri eklenmiş halidir.

Parametreleri:

$text

(Zorunludur.) Tercümeye hazır olmasını istediğimiz metindir.

$anlam_ipucu

(Zorunludur.) Kelimenin belli bir anlamı için ipucu niteliğinde bir texttir. Yani, kelimenin hangi anlamını kullandığımızı anlamak için, hatırlatıcı bir kelime ya da ifadedir.

$textdomain

Her temanın, diğer temalardan farklı bir textdomain değeri vardır. Textdomainler, WordPress’in, tema ya da eklentiye özgü tercümeleri saptayabilmesini sağlar, farklı temaların ya da eklentilerin tercümelerinin birbirine karışmasını engeller.

Varsayılan değeri 'default' olarak ayarlanmıştır.

Temanıza özel bir $textdomain değeri oluşturmayı öğrenmek için, Textdomain Parametresi başlığımızı okuyabilirsiniz.

Döndürdüğü değer:

Tercüme edilmiş ve güvenli hale getirilmiş $text ifadesini döndürür.

Kaynak kodu:

Dizini : wp-includes/l10n.php

function esc_html_x( $text, $context, $domain = 'default' ) {
    return esc_html( translate_with_gettext_context( $text, $context, $domain ) );
}

Kullanımı:

Örnek-1

Aşağıda verilen örneklerde, “Yüz” kelimesini, iki farklı şekilde tercüme edilebilecek halde hazırladık:

echo 'Birinci anlam: ' . esc_html_x('Yüz', 'Sayı olarak', 'textdomain');

echo 'İkinci anlam:  ' . esc_html_x('Yüz', 'Vücut bölümü olarak', 'textdomain');