WordPress qTranslate X Eklentisi

WordPress.org Plugin Directory¹ dışında CodeCanyon WordPress Plugins² güvenilir kaynaklardan bir diğeri.

Diğer yandan, GitHub üzerinden de pek çok plugine ulaşmak mümkün³. Ancak, GitHub üzerinden edinilen eklentilerde güvenlik, sürüm uygunluğu ve geliştirmelere yönelik destek dikkat edilmesi gereken konulardan bazıları. Wordpress çoklu dil eklentileri de bu süreç içerisinde kayda değer bir öneme sahipler. Öne çıkan dil eklentilerini şu şekilde sıralayabiliriz:

Bu eklentiler arasında qTranslate X WordPress qTranslate XT ve Polylang favorilerim arasında yer almaktalar. Bu vesileyle, ilerleyen süreçte yayınlayacağım birkaç içerikte çoklu dil konusu geçeceği için öncesinde bu yazıyı yayınlayarak eklenti hakkında bilgi vermek istiyorum.

25.01.2019: qTranslate-X eklentisi güncel olarak qTranslate-XT (eXTended) adıyla geliştirilmektedir⁴. Ancak eklenti WordPress Plugins altında yer almadığı için GitHub üzerinden⁵ edinilmek durumundadır.

WordPress Eklentisi: qTranslate X

qTranslate X (güncel olarak WordPress qTranslate XT) esasında qTranslate eklentisinin geliştirilmeye devam eden (bu süreçte farklı forklar; zTranslate⁶, qTranslate Plus⁷, mqTranslate⁸, vs. çıksa da pek uzun ömürlü olamadılar.), JSON kodlu bir yapılandırma dosyası (i18n-config.json) aracılığıyla hangi alanların çok dilli olacağının belirtildiği ve buna uygun şekilde dil ayrımının sağlandığı, WordPress için geliştirilen pratik bir çoklu dil eklentisidir. i18n-config.json, temalar ve eklentiler tarafından entegre bir şekilde kullanılabilmektedir⁹.

Ekleti herhangi bir çeviri hizmeti sunmamakta. Ancak, qTranslate Team gelecek sürümlerde bu tür bir hizmet verilebileceği belirtilmekte. Eklenti tarafından sunulan özelliklere özetle değinecek olursak;

Diller arasında tek tıklamayla yerel geçiş yapılır. Dilin değiştirilmesi, Görsel ve HTML arasında geçiş yapmak kadar kolaydır.
.Po / mo dosyalarını değiştirmeden dil özelleştirmeleri yapılabilir. Tüm çeviriler aynı post alanlarına (fields) kaydedilir, ilgili diller kullanıcı tarafından düzenlenecek şekilde ayrı ayrı sunulur.
Tema bünyesinde yer alan özel alanlar da qTranslate X ile düzenlenebilmektedir.
Dil seçimlerine istinaden SEO temelli URL özelleştirmeleri (get, subdirectory, subdomain) yapılabilmektedir.
Yeni dil tanımlamaları kolay bir şekilde oluşturulabilmektedir.
Pek çok eklenti desteği mevcuttur. Bunlar eklentilerden bazıları; WooCommerce, Google XML Site Maps, WPBakery Page Builder, All in One SEO Pack ve Yoast SEO.

Eklentinin sunduğu özellikler ve daha pek çok detaylı bilgi için WordPress plugin sayfasını, eklentinin web sitesini ve/veya GitHub sayfasını inceleyebilirsiniz.

Eklentiyi WordPress yönetici panelinizde yer alan Eklentiler > Yeni Ekle > “qTranslate X” araması ile indirebilirsiniz. Ayrıca wp-cli üzerinden de indirme işlemini (slug: qtranslate-x) kolaylıkla gerçekleştirebilirsiniz.

wp plugin install qtranslate-x --activate

qTranslate X Eklentisinin Kullanımı

Eklentinin kurulumunun ardından yönetici panelinde yer alan Ayarlar başlığı altında Diller bölümünü görebilirsiniz. General bölümü sitenin öncelikli dilinin (ön tanımlı dil), URL yapısının, farklı dillerdeki içeriklerin sunuluş biçimlerinin ayarlanacağı bölümdür. Özellikle URL bölümüne dair tavsiyem URL Değiştirme Biçimi seçimini Ön-Yol Biçimini Kullan olarak belirlemeniz olacaktır.

Bunun yanı sıra, eğer bazı içerikleriniz tek dil ile yayınlanmakta ise seçilen dil için çevirisi olmayan içeriği gizleyebilir, içerik ilgili dilde mevcut değilse yine de sayfanın görüntülenip görüntülenmeyeceğini belirleyebilir ve eğer sunulan içerik ilgili dilde mevcut değilse diğer dildeki içeriği önerebilirsiniz. Advanced bölümünde dil ayrımının olacağı field ve post tiplerini belirleyebilirsiniz. Aynı şekilde dillere ait görseller (bayrak) ve css kodlarının tanımlanması da bu bölüm üzerinden gerçekleştirilmekte. Integration bölümü kullandığınız tema ve/veya plugin qTranslate X eklentisini desteklemiyor ise i18n-config.json düzenlemesini yapabileceğiniz alan olarak kullanılabilmekte.

Import/Export bölümü aktarım ve eklenti ayarlarının yönetileceği bölüm olarak kullanılmaktadır. Son olarak, Languages başlığı altında yeni dil ekleme, dil etkinleştirme ve dil yönetimi işlemlerini gerçekleştirebilirsiniz. Tüm bu düzenlemelerden sonra artık farklı dillerde içerikler üretmeye hazırsınız. Yeni yazı, sayfa veya ürün eklemek istediğinizde metin alanının üst bölümünde aktif dillere dair tab alanlarının eklendiğini göreceksiniz.

Dillere göre eklediğiniz içerikler şu şekilde kayıt edilmektedirler;

[:tr]Yazı Başlığı [:en]Post Title ya da <!–:en–>English Text<!–:–><!–:tr–>Türkçe Yazı<!–:–>

İçerik ekleme ve düzenleme sürecinde, bu yapı sayfa yüklenme esnasında az çok gözünüce ilişecektir. Tema içerisinde PHP tanımlamaları yapmak için ilgili aktif dili $GLOBALS['q_config']['language'] ile çekebilirsiniz.

$lang = $GLOBALS['q_config']['language'];

Örnek bir kullanım olarak dillere göre farklı içerikler gösterilmesini sağlayalım.

if ($GLOBALS['q_config']['language']=='tr') {
echo 'Seçili dil: <strong>Türkçe</strong>';
} else {
echo 'Selected language: <strong>English</strong>';
}

veya aynı işleve sahip şu kod kullanılabilir;

echo($GLOBALS['q_config']['language']=='tr') ? 'Seçili dil: <strong>Türkçe</strong>' : 'Selected language: <strong>English</strong>';

Eğer bir görsel, link, form url ya da utm tanımında dile göre değişiklik oluşmasını istiyorsanız şu şekilde bir kullanıma gidebilirsiniz;

<img src="./gorsel-yolu/gorselin-adi-<?php echo(!empty($GLOBALS['q_config']['language'])) ? $GLOBALS['q_config']['language'] : 'tr' ?>" />

qTranslate X eklentisi ile ilgili olarak ayrıca paylaşılmış diğer bilgilendirme ve karşılaştırma yazılarını da inceleyebilirsiniz.