esc_attr_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. Bir metni tercüme ederek, tercümeleri HTML elemanlarının özelliklerinde (title, alt gibi… ) güvenle kullanılacak hale getirir.

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ümeye edilmiş ve güvenli hale getirilmiş bir text döndürür.

Kaynak kodu:

Dizini : wp-includes/l10n.php

function esc_attr_x( $text, $context, $domain = 'default' ) {
    return esc_attr( 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_attr_x('Yüz', 'Sayı olarak', 'textdomain');

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