WooCommerce Ürün Filtresi Etiketlerini Çevirin: Polylang, WPML, Loco
Çok dilli bir mağazada ürün filtresi çoğu zaman yarım çevrilmiş kalır: renk adları dil değiştirir, ancak blok başlıkları, Filtrele (Filter) düğmesi veya Tümünü temizle (Clear All) özgün dilde kalır. Filtre birkaç kaynaktan metin gösterir ve her biri farklı bir yerde çevrilir. Bu rehber, WooCommerce ürün filtresi etiketlerini Polylang, WPML veya Loco Translate ile kaynak kaynak, eklentinin beklediği tam sözdizimiyle nasıl çevireceğinizi gösterir.
Filtredeki her metin nereden geliyor
| Filtredeki metin | Nereden geliyor | Nerede çevrilir |
|---|---|---|
| Terim adları: kategoriler, renkler, bedenler | WordPress terimleri | Çok dilli eklentiniz, her kategori veya nitelik terimi gibi |
| Özel etiketi olmayan blok başlıkları | Taksonomi adı, nitelikler için "Product Color" gibi | Çok dilli eklentiniz ya da daha iyisi özel bir etiket (aşağıda) |
| Filtre ayarlarına yazdığınız metinler: özel etiketler, düğme metinleri, yer tutucular, aç/kapat ve Daha fazla göster (Show more) metinleri, ipuçları, meta filtrelerinin başlıkları ve seçenekleri, bölüm başlıkları | HUSKY ayarları | Gelişmiş (Advanced) → Kod (Code) bölümündeki WPML taksonomi etiketi çevirileri (WPML taxonomies labels translations) |
| Yerleşik arayüz dizeleri: Filtrele (Filter), Sıfırla (Reset), Tümünü temizle (Clear All), fiyat aralığı (price range), Stokta (In stock), Ürün filtresi formunu göster (Show products filter form) | woocommerce-products-filter metin alanı | WPML String Translation, Loco Translate veya .po/.mo dosyaları |
| Filtre widget'ının başlığı | WordPress widget'ı | Çok dilli eklentinizin widget çevirisi |
Başarısız denemelerin çoğunda metin yanlış yerde çevrilir; örneğin bir nitelik başlığı Loco Translate'te ya da özel bir etiket, eklentinin hiç kaydetmediği WPML String Translation'da çevrilir.
WooCommerce ürün filtresi etiketlerini Polylang veya WPML ile çevirin
Filtre başlıkları ve eklenti ayarlarına yazılan tüm metinler, eklentideki tek bir arama tablosuyla çevrilir. WPML ve Polylang'da aynı şekilde çalışır; alan yalnızca bunlardan biri etkinken görünür.
- Bloğa sabit bir özgün metin verin. Yapı (Structure) sekmesinde taksonominin yanındaki dişli simgesine (ek seçenekler (additional options)) tıklayın ve Özel taksonomi etiketi (Taxonomy custom label) alanını doldurun, örneğin
Color. Özel etiket yoksa özgün metin, WordPress'in geçerli dilde döndürdüğü taksonomi adıdır. Nitelikler için WooCommerce bunu "Product Color" olarak oluşturur ve bir çeviri eklentisi bunu zaten değiştirmiş olabilir; bu yüzden bir biçim için yazılan satır başka bir dilde eşleşmez. - Gelişmiş (Advanced) → Kod (Code) → WPML taksonomi etiketi çevirileri (WPML taxonomies labels translations) bölümünü açın ve her etiket ile dil için bir satır ekleyin: dil, iki nokta, özgün metin, şapka işareti, çeviri.
- Doğru dil kodunu kullanın. WPML'de bu, WPML dil kodudur (
fr,de,pt-br). Polylang'da dilin yerel ayarıdır (fr_FR,en_GB,uk); Polylang dil listesindeki Yerel ayar (Locale) sütununda görünür.en_GBkullanan bir Polylang sitesindeenyazmak, hiçbir şeyin değişmemesinin en yaygın nedenidir. - Kaydedin, ardından sayfa önbelleğini temizleyin ve sayfayı diğer dilde kontrol edin.
İngilizce, Fransızca ve Almanca bir mağaza için WPML'de:
fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe
Polylang'da aynısı:
fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe
Varsayılan dil için satır gerekmez: eşleşme yoksa özgün metin gösterilir.
Arama nasıl eşleşir
- Özgün metin, bloğun çeviri olmadan göstereceği metin olmalıdır: özel etiket ya da yoksa taksonomi adı. Uçlardaki boşluklar ve harf büyüklüğü önemli değildir, her yazı sistemindeki etiketler çalışır.
- Her satırın dil öneki olmalıdır.
Containertyp^Container typegibi bir satır yok sayılır. - Özgün metin iki nokta içerebilir ancak şapka işareti içeremez: ilk
^onu sonlandırır. - Bu bir tablodur, alan başına bir ayar değildir. Tek bir satır, o metni filtreden geçtiği her yerde çevirir: blok başlığı, seçili filtreler panelindeki başlık, bir düğme veya bir yer tutucu.
Aynı tablo, ayarlara yazdığınız metinleri de çevirir: Filtre düğmesi metni (Filter button text) ve Sıfırlama düğmesi metni (Reset button text), fiyat filtresi başlığı, metin, SKU ve yazar aramasının yer tutucuları, aç/kapat metinleri, Daha fazla göster (Show more) ve Daha az göster (Show less) metinleri, ipuçları, meta ve ACF filtrelerinin başlıkları ile seçenekleri ve bölüm başlıkları. Satırı tam olarak yazdığınız metinle yazın, örneğin fr:Sort by price^Trier par prix.
Özel CSS için bir yan etki önemlidir: her blok, görüntülenen başlığından oluşturulan bir sınıf da alır; Fransızca sayfada woof_container_couleur, İngilizce sayfada woof_container_color gibi. Blokları taksonomi slug'ından oluşturulan sınıfla biçimlendirin, örneğin .woof_container_pa_color; bu sınıf her dilde aynıdır.
Arayüz dizeleri: Loco Translate, WPML String Translation ve .po dosyaları
Eklentinin yerleşik metinleri, woocommerce-products-filter metin alanındaki sıradan WordPress dizeleridir. İki ayar bunları etkiler: Filtre düğmesi metni (Filter button text) ve Sıfırlama düğmesi metni (Reset button text). Bu alanlar boşken düğmeler çevrilebilir varsayılanları Filtrele (Filter) ve Sıfırla (Reset) kullanır; kendi metninizi yazdığınızda bu bir ayar metni olur ve yukarıdaki arama tablosuna girer.
WPML. Eklentiyi WPML → Tema ve eklenti yerelleştirmesi (Theme and plugins localization) bölümünde tarayın, ardından woocommerce-products-filter metin alanının dizelerini Dize Çevirisi (String Translation) bölümünde çevirin.
Loco Translate, dize listesi eklenti dizelerini içermeyen Polylang ile de olağan seçimdir:
- Loco Translate → Eklentiler (Plugins) bölümüne gidin, HUSKY'yi açın ve yeni bir dil ekleyin.
- Özel (Custom) veya Sistem (System) konumunu seçin, eklentinin kendi
languagesklasörünü değil. Eklenti güncellemeleri bu klasörün yerini alır ve 3.4.6'da eklenti çeviri dosyalarını oradan yüklemez. - Eşitlemeden önce Loco Translate → Ayarlar (Settings) bölümünü açın ve şundan büyük PHP dosyalarını atla (Skip PHP files larger than) değerini en az 200 KB'a çıkarın. Eklentinin ana dosyası yaklaşık 145 KB'dır ve Tümünü temizle (Clear All), fiyat aralığı (price range), seçili filtreler panelindeki sıralama adları ve Ürün filtresi formunu göster (Show products filter form) gibi dizeleri içerir. Varsayılan 100 KB sınırında Loco dosyayı atlar, bu dizeler eksik kalır ve eşitleme bunları mevcut bir çeviriden siler.
- Eşitleyin, çevirin, kaydedin. Loco, .mo dosyasını .po dosyasının yanında derler.
Birçok dil için hazır çeviri dosyaları çeviriler sayfasında bulunur. Hangi aracı kullanırsanız kullanın, dosya adı sitenizin tam yerel ayarıyla bitmelidir, örneğin woocommerce-products-filter-de_DE.mo, ve dosya wp-content/languages/plugins/ klasöründe ya da Loco'nun özel klasöründe bulunmalıdır. WPML ile çalışma SSS'sinde tablo sözdiziminin kısa anlatımı vardır.
Tek tek dizeler, kanca ile ve dil bazında
Bazı metinleri kodla ayarlamak daha kolaydır, özellikle aynı metnin dile göre farklı olması gerektiğinde. 3.4.6'da şu kancalar bulunur:
- woof_filter_title: arama tablosundan geçen her metni, tablodan sonra alır; bu nedenle herhangi bir blok başlığını, düğmeyi veya yer tutucuyu değiştirebilir.
- woof_clear_all_text: seçili filtreler panelindeki Tümünü temizle (Clear All) bağlantısı.
- woof_start_filtering_btn_txt: Ürün filtresi formunu göster (Show products filter form) düğmesi.
woof_ext_custom_title_by_instock,woof_ext_custom_title_by_onsales,woof_ext_custom_title_by_featured,woof_ext_custom_title_by_backorder: Stokta, İndirimde, Öne çıkan ve ön sipariş onay kutularının etiketleri.
/*
* Product filter: per-language texts set in code.
* Child theme functions.php or a code snippets plugin.
*/
function my_filter_lang() {
if (function_exists('pll_current_language')) {
return pll_current_language(); // Polylang: language slug, e.g. "fr"
}
return apply_filters('wpml_current_language', null); // WPML: language code
}
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
$texts = array(
'en' => array('Formations' => 'Bands'),
'de' => array('Formations' => 'Besetzungen'),
);
return $texts[my_filter_lang()][$title] ?? $title;
}, 10, 3);
add_filter('woof_clear_all_text', function ($text) {
return my_filter_lang() === 'fr' ? 'Tout effacer' : $text;
});
Buradaki dilin, arama tablosunda kullanılan yerel ayar değil, Polylang slug'ı (fr) olduğuna dikkat edin.
Diğer dillerde terimler, terim sırası ve renk örnekleri
Filtre, WordPress'in döndürdüğü geçerli dildeki terimleri yazdırır. Bir değer özgün dilde görünüyorsa terimin kendisi henüz çevrilmemiştir: onu WPML'de (nitelikler WooCommerce Multilingual üzerinden) veya Polylang'da çevirin. Çevrilmiş olduğu halde eski adı gösteriyorsa sayfa önbelleğini ve eklentinin Terimleri önbelleğe al (Cache terms) önbelleğini, Gelişmiş (Advanced) → Seçenekler (Options) bölümündeki terim önbelleğini temizle (clear terms cache) düğmesiyle temizleyin.
Çevrilmiş terimler, kendi sıralarına sahip ayrı terimlerdir. Varsayılan dilin sırasını korumak için terim listesini açın (Ürünler (Products) → Kategoriler (Categories) veya Ürünler (Products) → Nitelikler (Attributes) → Terimleri yapılandır (Configure terms)), yönetim dilini değiştirin ve terimleri yeniden düzenleyin. Renk ve Görsel türlerinin renkleri ile görselleri yalnızca varsayılan dildeki terimlerde ayarlanmalıdır: kendi rengi veya görseli olmayan çevrilmiş terim, özgününkini kullanır.
Kontrol listesi
- Başlığı çevrilmesi gereken her bloğun bir Özel taksonomi etiketi (Taxonomy custom label) vardır ve WPML taksonomi etiketi çevirileri (WPML taxonomies labels translations) içindeki satırlar bu etiketi birebir tekrarlar.
- Dil öneki WPML'de WPML dil kodudur, Polylang'da tam yerel ayardır.
- Ayar alanlarına yazılan metinler arama tablosundadır; yerleşik dizeler
woocommerce-products-filtermetin alanında çevrilir. - Loco dosyaları Özel veya Sistem konumundadır ve eşitlemeden önce PHP boyut sınırı yükseltilmiştir.
- Özel CSS blokları başlıkla değil, taksonomi slug'ıyla hedefler.
- İkinci dili test etmeden önce sayfa önbelleği ve terim önbelleği temizlenmiştir.
Bir etiket hâlâ değişmiyorsa, ikinci dildeki sayfanın bağlantısını, kullandığınız çeviri eklentisini ve eklediğiniz satırları belirterek HUSKY destek forumunda bir konu açın.