WordPress Tema Türkçeleştirme Nedir?
WordPress temalarındaki “Read More”, “Search”, “Leave a comment” gibi arayüz metinleri, tema dosyalarında __() ve _e() gibi gettext fonksiyonlarıyla işaretlenir. Tema türkçeleştirme, bu metinlerin karşılıklarını bir çeviri dosyasında toplayıp temaya bağlamak demektir; tema kodunu tek tek elle değiştirmek gerekmez.
Arayüzün Türkçe olması, yerel ziyaretçi için okunabilirliği ve güveni artırır; form etiketleri, hata mesajları ve tarih biçimleri tutarlı hale gelir. Bu içerik çevirisiyle (yazı ve sayfa metinleri) karıştırılmamalıdır — çeviri yalnızca temanın kendi sabit metinlerini kapsar.
Tema Metinleri Nasıl Saklanır: .pot, .po ve .mo
Türkçeleştirme üç dosya türü etrafında döner:
- .pot — temanın çevrilebilir tüm metinlerini içeren şablon; çeviri buradan başlar.
- .po — belirli bir dile ait, insan tarafından düzenlenebilen çeviri dosyası (örneğin
tr_TR.po). - .mo —
.po’nun WordPress’in okuduğu derlenmiş ikili sürümü.
WordPress bir dil dosyasını önce wp-content/languages/themes/ dizininde, sonra temanın kendi languages klasöründe arar. Dosya adı dil koduyla eşleşmelidir: temanın metin alanı ornek-tema ise Türkçe dosya ornek-tema-tr_TR.mo olur.
Türkçeleştirme Yöntemleri
Üç yaygın yol vardır; hepsi aynı .po/.mo dosyalarını üretir, yalnızca çalışma biçimleri farklıdır.
Poedit (masaüstü uygulaması)
.pot dosyasını açıp Türkçe karşılıkları yazdığınız, .po ve .mo dosyalarını tek tıkla kaydeden ücretsiz bir program. Dosyaları elle yönetmek isteyenler için nettir.
Loco Translate (WordPress eklentisi)
Aynı işi WordPress yönetim panelinden yapar; ayrı program kurmadan tema ve eklenti çevirilerini düzenler, çevirileri güncellemeden etkilenmeyen bir dizine kaydedebilir.
TranslatePress / WPML (çok dilli site)
Amaç yalnızca arayüzü Türkçeleştirmek değil de siteyi birden çok dilde yayımlamaksa bu eklentiler kullanılır. Tek dilli bir Türkçe site için gerekli değildir; .po/.mo yöntemi yeterlidir.
Poedit ile Adım Adım Türkçeleştirme
- Poedit’i kurun. Resmî siteden indirin; Windows ve macOS ile uyumludur.
- .pot dosyasını bulun. Temanın
languagesya dalangklasöründeki.potdosyası tüm çevrilebilir metinleri içerir. - Yeni çeviri başlatın. “Yeni Çeviri Başlat” ile
.potdosyasını seçin ve dil olarak Türkçe (tr_TR) belirleyin. - Metinleri çevirin. Listedeki her metne anlaşılır Türkçe karşılık yazın (örneğin “Search” → “Ara”, “Home” → “Anasayfa”). Kısa ve tutarlı terim kullanın.
- .po ve .mo olarak kaydedin. Poedit ikisini de üretir.
- Doğru dizine yükleyin. Güncellemede kaybolmaması için
.modosyasınıwp-content/languages/themes/temaslug-tr_TR.moyoluna koyun. - Test edin. Site dilini Ayarlar → Genel → Site Dili altında Türkçe yapın ve arayüzü kontrol edin; eksik metinleri Poedit’te düzenleyip yeniden kaydedin.
Çevirinin Tema Güncellemesinde Kaybolmaması
Çeviri dosyasını doğrudan temanın klasörüne koyarsanız, tema güncellendiğinde dosya silinebilir. İki kalıcı yöntem vardır:
- Ortak dizin:
.modosyasınıwp-content/languages/themes/altında tutun; bu dizin güncellemelerden etkilenmez. - Alt tema (child theme): Özelleştirmeleriniz varsa bir alt tema oluşturup çeviriyi onun
languagesklasöründe saklayın veload_child_theme_textdomain()ile bağlayın.
Sık Karşılaşılan Sorunlar
- Bazı metinler İngilizce kalıyor: O satırlar tema kodunda çeviri fonksiyonlarıyla sarılmamış olabilir;
.potdosyasında görünmezler ve tema geliştiricisinin düzeltmesi gerekir. - Çeviri hiç görünmüyor: Dosya adı yanlış (dil kodu
tr_TRolmalı) ya da dosya yanlış dizinde olabilir. - Türkçe karakter bozuk:
.podosyası UTF-8 kodlamayla kaydedilmelidir; Poedit bunu varsayılan yapar. - Güncelleme sonrası çeviri kayboldu: Dosya tema klasöründeydi; ortak dizine ya da alt temaya taşıyın.
Sıkça Sorulan Sorular
WordPress tema Türkçeleştirme ile eklenti Türkçeleştirme aynı şey mi?
languages klasöründe ya da wp-content/languages/themes/ altında; eklenti çevirileri eklentinin languages klasöründe ya da wp-content/languages/plugins/ altında tutulur.Çeviri dosyasını nereye koymalıyım ki tema güncellemesinde silinmesin?
.mo dosyasını temanın kendi klasörü yerine wp-content/languages/themes/ dizinine temaslug-tr_TR.mo adıyla koyun. WordPress bu dizini tema klasöründen önce okur ve bu dizin tema güncellemelerinden etkilenmez.Poedit mi yoksa Loco Translate mi kullanmalıyım?
.po/.mo dosyalarını üretir.Bazı metinler çevirdikten sonra hâlâ İngilizce kalıyor, neden?
__() / _e() gibi çeviri fonksiyonlarıyla sarılmamıştır ya da yanlış metin alanı (text domain) kullanılmıştır. Bu satırlar .pot dosyasında görünmez ve yalnızca tema geliştiricisi tarafından düzeltilebilir.
Comments are closed