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

Açıklaması:

Bu fonksiyon, tercümanların, aynı texti farklı şekillerde tercüme edebilmesi için oluşturulmuş bir fonksiyondur. Yani, eş sesli kelimeleri, farklı metinlerde farklı anlamlarda tercüme etmeyi mümkün kılan bir fonksiyondur.

Türkçeden örnek vermek gerekirse; “Yüz” kelimesi, her zaman aynı anlamı taşımaz. Bazen suda yüzmek, bazen bir insanın yüzü, bazen de bir sayı olan yüz anlamlarına gelir. İşte, “Yüz” kelimesinin, farklı anlamlarına göre tercüme edilebilmesini mümkün kılmak için, _x() fonksiyonundan yardım istemek zorundayız.

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ş olarak, $text parametresindeki ifadeyi döndürür.

Kaynak kodu:

Dizini : wp-includes/l10n.php

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

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