Bir eklentinin Türkçe görünmesi için iki şart var: metinlerinin translate.wordpress.org üzerinde Türkçeye çevrilmiş ve onaylanmış olması, ardından WordPress.org’un bu çevirilerden bir dil paketi üretmesi. Sitenize inen şey çevirinin kendisi değil, bu pakettir. Paket yoksa translate.wordpress.org’da yüzlerce dize çevrilmiş olsa bile eklentinin ekranları İngilizce kalır.
Bu yazıda paketin hangi koşulda doğduğunu, sitenize hangi yoldan ve ne kadar sürede geldiğini, hangi metinlerin hesaba katılmadığını resmî belgelere dayanarak anlatıyoruz.
Eşik %90 ve yalnızca kararlı sürüme bakılır
WordPress çeviri ekiplerinin el kitabı kuralı açık yazıyor: bir eklentinin bir dilde paketi olması için dizelerin en az %90’ının “Current” yani onaylanmış durumda olması gerekir ve eklentilerde bu oran Stable alt projesine göre hesaplanır.
translate.wordpress.org’da her eklentinin dört alt projesi vardır:
- Stable (latest release): eklentinin yayımlanmış son sürümündeki metinler. Sitenize kurulan sürüm budur.
- Development (trunk): geliştiricinin henüz yayımlamadığı koddaki metinler. El kitabı bu dizelerin “değişebileceğini ya da kaldırılabileceğini” belirtiyor.
- Stable Readme ve Development Readme: eklentinin WordPress.org dizinindeki tanıtım sayfası.
Paket eşiğinde yalnızca Stable sayılır. Development tarafında yapılan bir çeviri boşa gitmez: el kitabına göre 2016 Nisan ortasından beri onaylı çeviriler dev ile stable arasında iki yönlü eşleşiyor ve eklenti yeni sürüm yayımladığında tüm çeviriler dev’den stable’a kopyalanıyor. Ama eşiğin hesabı yapılırken bakılan yer yine kararlı sürümdür.
Readme çevirisi neden sayılmaz
Readme dizeleri, eklentinin wordpress.org/plugins sayfasında görünen tanıtım metinleridir. Polyglots SSS sayfası, readme dizelerinin %90 eşiğine dahil edilmediğini ve onaylandıkları anda hemen yayına alındığını söylüyor. Yani bir eklentinin tanıtım sayfası Türkçe olup panel ekranları İngilizce kalabilir ya da tersi. Sitenizde gördüğünüz arayüzü belirleyen yalnızca Stable alt projesidir.
Eşik aşıldıktan sonra ne olur
SSS sayfası iki süre veriyor:
- Eklentinin kararlı sürüm dizeleri eşiğe ulaştıktan sonra, bir çeviri güncellendiğinde paket yaklaşık 30 dakika sonra üretilir.
- O dili kullanan siteler paketi sonraki saatler içinde alır. Saat başı çalışan çizelge çekirdek (WordPress’in kendisi) paketleri içindir; eklentiler için kesin bir saat verilmiyor.
Sitenizde paketin inmesi için bir şey kurmanız gerekmez. WordPress, eklenti güncellemelerini denetlerken çeviri güncellemelerini de sorar ve Başlangıç › Güncellemeler sayfasında “Çevirileri güncelle” düğmesi çıkar. Otomatik güncellemeler açıksa çeviriler bu düğmeye basmadan da iner.
Paket hangi dosyalardan oluşur
Paket bir zip dosyasıdır ve wp-content/languages/plugins/ klasörüne açılır. İçinde .po ve .mo dosyaları bulunur; WordPress 6.5’ten beri .l10n.php uzantılı bir dosya da eklenir. Bu dosyaların nerede durduğunu ve hangisinin önce yüklendiğini ayrı bir yazıda ele aldık. Dosya adı eklentinin kısa adını ve dil kodunu taşır, ör. wordpress-seo-tr_TR.mo.
Geliştiricinin yapması gerekenler
Paketin çalışması için eklentinin “çeviriye hazır” yazılmış olması gerekir. WordPress’in eklenti el kitabı iki kuralı vurguluyor:
- Metin alanı (text domain) eklentinin kısa adıyla aynı olmalı. WordPress.org’daki eklentilerde bu, eklenti adresindeki kısa ad demektir. Küçük harf, tire kullanılır, alt çizgi ve boşluk olmaz.
- WordPress 4.6’dan beri translate.wordpress.org üzerinden çevrilen eklentiler
load_plugin_textdomain()çağrısına ihtiyaç duymaz; bunun için readme dosyasındaki “Requires at least” alanının 4.6 ya da üstü olması yeterlidir.
Metin alanı kısa adla eşleşmiyorsa çeviri yapılsa da paket eklentinin dizeleriyle eşleşmez. Bir eklentinin oranı yüksek görünüp ekranı İngilizce kalıyorsa geliştiricinin destek forumunda bu noktayı sormak işe yarayabilir.
Verimize göre tablo
translate.wordpress.org’un Türkçe istatistik sayfasında görünen 474 popüler eklentiyi her gece ölçüyoruz. 20 Ekim 2026 ölçümüne göre:
| Durum | Eklenti sayısı |
|---|---|
| Türkçe paketi olan | 136 |
| Oranı %90 ve üzeri | 61 |
| Paketi var ama oranı %90’ın altında | 75 |
| Türkçe çevirisine hiç başlanmamış | 195 |
İlk göze çarpan, oranı %90’ı geçip paketi olmayan eklenti bulunmaması. Eşik aşıldığında paket gerçekten hızlı üretiliyor. İkinci dikkat çeken nokta, paketi olan eklentilerin yarıdan fazlasının bugün eşiğin altında olması. Bunun nedeni paketin bir kez oluştuktan sonra kaybolmaması, eklentinin ise her sürümde yeni metin eklemesi. Bu durumu paket var ama İngilizce görünüyor yazısında ayrıntılı inceledik; tüm liste paketi var, eksik sayfasında.
Eşiğe yakın ama henüz paketi olmayan eklentileri eşiğe yakın sayfasında, kalan dize sayısına göre sıraladık. Orada bazı eklentilerde birkaç düzine dizenin paketi doğuracağını görebilirsiniz.
Paketi kendiniz sorgulamak
WordPress’in paket olup olmadığını öğrenmek için kullandığı servis herkese açık. Tarayıcınıza api.wordpress.org/translations/plugins/1.0/?slug=wordpress-seo yazarsanız, Yoast SEO için yayımlanmış bütün dil paketlerinin listesini görürsünüz. Listede tr_TR satırı varsa Türkçe paket yayında demektir; satırdaki version paketin hangi eklenti sürümü için üretildiğini, updated ise son üretim zamanını gösterir. Bu satırdaki sürüm, eklentinin kurulu sürümünüzden eskiyse yeni sürümle gelen metinler paketin içinde yoktur.
Bizim her gece yaptığımız da bu sorgudur. 20 Ekim ölçümünde Yoast SEO için 63 dilde paket listeleniyordu ve Türkçe paket 28.7 sürümü için 19 Ekim’de üretilmişti. Sorgu yalnızca eklentinin en son sürümüne bakar; eski bir sürümü kullanıyorsanız sonuç sizin kurulumunuzla birebir örtüşmeyebilir.
Sık karşılaşılan üç yanlış anlama
“Çeviriyi yaptım ama sitemde görünmüyor.” Önerdiğiniz çeviri bir çeviri editörü onaylayana kadar “Waiting” durumunda bekler ve oranı yükseltmez. Onaylanıp eşik aşılsa bile paketin üretilmesi ve sitenize inmesi saatler sürebilir. Hiç paket yoksa, oran %90’a ulaşana kadar çeviri sitenize gelmez.
“Eklenti %95 Türkçe, ama bazı ekranlar İngilizce.” Kalan %5 çoğu zaman yeni eklenen ayar ekranlarıdır. Ayrıca bazı eklentiler metinlerin bir kısmını kendi sunucularından çeker (ör. bildirim panelleri, kurulum sihirbazları); bu metinler translate.wordpress.org’da hiç bulunmaz.
“Pro sürümü aldım, çevirisi yok.” Ücretli sürümle gelen ek özellikler WordPress.org dizininde olmadığı için translate.wordpress.org’da da yoktur. Bu metinlerin çevirisini geliştiricinin kendisi dağıtmak zorundadır. Bir eklentinin WordPress.org’da “ticari” iş modeliyle işaretlenip işaretlenmediğini her eklenti karnesinde gösteriyoruz.
Kendi eklentinizi kontrol etmek için
- Tüm eklentiler listesinde eklentiyi bulun; satırdaki yüzde kararlı sürüm oranı, “Paket var” etiketi WordPress.org çeviri servisinin bugünkü cevabıdır.
- Paket varsa Başlangıç › Güncellemeler sayfasında bekleyen çeviri güncellemesi olup olmadığına bakın.
- Paket yoksa ve oran %90’a yakınsa eksik dizeleri çevirmek, paketi doğurmanın en kısa yoludur. Nasıl başlanacağını katkı rehberinde adım adım anlattık.