__( string $text, string $textdomain = 'default' )

Açıklaması:

Bir texti tercüme edilmiş şekilde getirir ve döndürür. Eğer bu fonksiyonda belirtilen text ifadesi, tercüme edilmemiş ise ya da $textdomain parametresi girilmemiş ise, text tercüme edilmeden olduğu gibi getirilir.

Parametreleri:

$text

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

$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ş text ifadesini döndürür.

Kaynak kodu:

Dizini : wp-includes/l10n.php

function __( $text, $domain = 'default' ) {
    return translate( $text, $domain );
}

Kullanımı:

Örnek-1

__() fonksiyonunun, temel kullanımı şöyledir:

<h2><?php echo __('Tercümeye Hazır Bir Başlık', 'textdomainim'); ?></h2>

Örnek-2

__() fonksiyonunun, esnek bir kullanımı şöyledir:

$baslik = __( 'Tercümeye Hazır Bir Başlık', 'textdomainim' );
<h2><?php echo $baslik; ?></h2>

Örnek-3

__() fonksiyonunun, esnek bir kullanımı şöyledir:

$text_domain = 'textdomainim';
$text= 'Tercümeye Hazır Bir Başlık';
$baslik = __( $text, $text_domain );
<h2><?php echo $baslik; ?></h2>

Örnek-4

__() fonksiyonu ile, dizi elemanlarınızın değerlerini de tercümeye hazır olarak verebilirsiniz:

$benim_dizim = array(
  'anahtar1' => __('Değerim Bir','textdomainim'),
  'anahtar2' => __('Değerim iki','textdomainim'),
);