Eklentinin Almanca PO dosyası eksiksiz görünüyor, ancak etkilenen sitede arayüz hâlâ İngilizce. Dosya sunucuda bulunsa da istek farklı bir yerel ayar kullanıyor veya WordPress başka bir kataloğu daha önce yüklüyor olabilir.
Bu rehberde eksik bir çeviriyi kaynak metinden WordPress’in yüklediği kataloğa kadar izlemeyi; PHP ve JavaScript çevirilerini ayrı doğrulamayı öğreneceksiniz.
Eklenti çevirisi neden görünmez?
Bir çevirinin görünmesi için kaynak metin, bağlam, text domain, yerel ayar ve çoğul biçimin katalogdaki kayıtla eşleşmesi gerekir. PHP metinleri çoğunlukla MO dosyasından, blok veya JavaScript arayüzleri ise ayrıca JSON kataloglarından yüklenebilir. Dosyanın varlığı, doğru istekte kullanıldığını tek başına kanıtlamaz.
- Eksik görünen tam kaynak metni, ekranı, kullanıcı dilini ve eklenti sürümünü kaydedin.
- PHP gettext metniyle JavaScript tarafından yüklenen çeviriyi birbirinden ayırın.
- Kaynak metin eklenti güncellemesinde değiştiyse eski çeviriyi zorla eşleştirmek yerine kataloğu güncelleyin.
Gerçekçi bir WordPress örneği
Aynı eklenti bir sitede Almanca, diğerinde İngilizce görünüyor. Ekip etkilenen kullanıcının wp-admin dilinin site dilinden farklı olduğunu ve eski bir özel MO dosyasının önce yüklendiğini belirliyor. PHP metni doğru MO dosyasıyla, blok düzenleyicideki metin ise eşleşen JSON kataloğuyla ayrı ayrı doğrulanıyor.
Neden önemlidir ve ne zaman kullanılır?
Sorunu yalnız önbellek temizleyerek çözmeye çalışmayın. Yanlış yerel ayar, text domain uyuşmazlığı, eski katalog, eksik MO dosyası veya JavaScript için üretilmemiş JSON dosyası aynı belirtiyi oluşturabilir.
Onarım, yalnız hangi metnin hangi katalogdan yüklenmesi gerektiği kanıtlandıktan sonra yapılmalıdır. Aksi hâlde çalışan dil paketlerini ezebilir veya eklenti güncellemesinde kaybolacak geçici bir düzeltme oluşturabilirsiniz.
Yeni başlayanlar için güvenli yöntem
- Mevcut PO, MO ve JSON dosyalarının adlarını, yollarını, tarihlerini ve geri yüklenebilir kopyalarını kaydedin.
- Site dilini, etkilenen kullanıcının profil dilini ve isteğin gerçek yerel ayarını karşılaştırın.
- Text domain değerini eklentinin kaynak kodundaki kayıtla doğrulayın; yalnız dosya adına bakarak tahmin etmeyin.
- WordPress genel dil dizininde, eklenti klasöründe ve özel dil konumlarında daha eski bir katalog olup olmadığını denetleyin.
- Onarımdan sonra ön yüzde, wp-admin içinde ve gerekiyorsa blok düzenleyicide bilinen bir metni temiz oturumda sınayın.
İleri teknik doğrulama
İleri incelemede tek bir eksik metin için yükleme izi oluşturun.
- Kaynak metni, bağlamı, text domain değerini, yerel ayarı ve beklenen katalog adını kaydedin.
- Yüklenen MO veya JSON dosyasının gerçek yolunu, hash değerini ve yükleme zamanını belirleyin.
- JavaScript çevirilerinde script handle ile JSON katalog adının eşleştiğini kontrol edin.
- Yalnız eski katalog veya kodu tutan ilgili çalışma zamanı önbelleğini temizleyip testi tekrarlayın.
Riskler, sık hatalar, yedek ve geri dönüş
En sık hatalar, dosya adından text domain tahmin etmek, kullanıcı dilini gözden kaçırmak ve eklenti güncellemesinin üzerine yazacağı kataloğu doğrudan düzenlemektir.
- PHP ve JavaScript çevirilerini aynı dosya yolu üzerinden teşhis etmeyin.
- Eski katalog kaldırılmadan yeni dosyanın yüklendiğini varsaymayın.
- Kaynak metin değişmişse yanlış çeviriyi zorla bağlamayın.
- Onarım başka dillerdeki metinleri bozarsa veya katalog yüklenmezse korunan dosyaları geri getirin.
Kayıtta eksik metni, yerel ayarı, text domain değerini, yüklenen yolu, hash değerini ve doğrulama sonucunu saklayın.
AIOWS nasıl yardımcı olur?
AIOWS Dil Derleyici
AIOWS Dil Derleyici, desteklenen WordPress dil kaynaklarını merkezî olarak incelemenize ve seçilen PO dosyasından WordPress’in kullandığı MO çıktısını üretmenize yardımcı olur. Önce etkilenen yerel ayarı, text domain değerini ve kaynak dosyanın yolunu belirleyin. Ardından mevcut MO dosyasını koruyup yalnız doğru kataloğu seçin; farklı eklenti, tema ve sürümlere ait dosyaları aynı işlemde karıştırmayın.
Katalog sorunlarını inceledikten sonra onaylanan PO dosyasını derleyin. Oluşan MO dosyasının adını, yolunu ve değişiklik zamanını doğrulayın; yeni bir istekte eksik olan metni yeniden açın. PHP metni düzelirken blok düzenleyicideki JavaScript metni değişmiyorsa ilgili JSON kataloğunu ve script handle eşleşmesini ayrıca inceleyin. Başarılı derleme iletisi tek başına doğru kataloğun yüklendiğini kanıtlamaz.
Dil Derleyici eksik çeviriyi yazmaz, kaynak koddaki yanlış text domain değerini düzeltemez ve güncelleme sırasında dosyanın ezilmesini önleyemez. Sonuç kötüleşirse yeni çıktıyı kaldırıp korunan katalogları geri getirin. Kaynağı, hedefi, yerel ayarı, text domain değerini, görünen örnek metni ve dosyanın güncellemeler sırasında üzerine yazılmayacağı konumu kaydetmek, düzeltmenin kalıcı olmasını sağlar.
AIOWS Dil Derleyici'yi inceleyinAIOWS planlarını karşılaştırın
İlgili AIOWS yazıları
- WordPress PO Dosyaları MO Dosyalarına Nasıl Derlenir?
- WordPress Dil Dosyaları Nasıl Taranır ve Yönetilir?
- Çok Dilli WordPress Sitesi İçin Önbellek Nasıl Ayarlanır?
Sonuç ve önerilen yol
Tek bir eksik metni kaynak, bağlam, text domain, yerel ayar ve yüklenen katalog boyunca izleyin. Yalnız sorumlu olduğu kanıtlanan dosyayı yeniden derleyin; PHP ile JavaScript çevirilerini ayrı ayrı test edin.
