Sorun giderme
5 dk okuma
İlk adımlar
- Şunları açın:
WP_DEBUGveWP_DEBUG_LOG, dosya:wp-config.php. Başarısız olan her ifade şuraya kaydedilir:wp-content/debug.log:
[wpmcf] Variable resolution failed — "{{ 1 + 2 }}" — Unexpected character: +Hatalar ziyaretçiler ve editörler için sessizdir; hata ayıklama olmadan blok yalnızca boş görünür.
- İfadeyi bir şablonda veya WP-CLI ile tek başına test edin:
wp eval 'echo wpmcf_resolve_variables( "{{ glb.phone | default(\"missing\") }}" );'- Motorun bildiklerini listeleyin (adlar küçük harftir):
$registry = wpmcf_variable_registry();
var_dump( $registry->getRegisteredNamespaces(), $registry->getRegisteredFilters(), $registry->getRegisteredFunctions() );İfade hiçbir şey yazdırmıyor
Neden | Denetim | Çözüm |
|---|---|---|
Söz dizimi hatası |
| Bkz. Syntax. Yaygın olanlar: aritmetik ( |
Blokta başıboş fazladan sözcükler |
| Bloğun tamamı boş görünür. Fazladan sözcükleri kaldırın. |
Bilinmeyen anahtar | Anahtarı kontrol edin. Bilinmeyen adlar tasarım gereği boştur; yedek değeri görmek için | |
Tire içeren veya rakamla başlayan eski bir anahtar |
| Bu tür anahtarların yeni kayıtları reddedilir ( |
Değer bir parola | Bir Password alanı veya parola türünde bir Global Data değişkeni | Şablonda asla kullanılamaz. Bkz. Security. |
Nesne yok |
| Bir bağlam iletin: |
| WooCommerce etkin değil veya nesne bir ürün değil | Yalnızca ürün bağlamlarında kullanın. |
Blok çok uzun veya çok derin | 1000'den fazla karakter, 5 iç içe blok veya 32 düzey | Birkaç bloğa bölün ya da mantığı PHP'ye taşıyın. |
Bir işlev başka bir ad alanı üzerinden çağrıldı |
| İşlevler şu biçimde çağrılır: |
Süslü parantezler sayfada görünüyor
Metin saklandığı gibi yazdırıldı: değer değerlendirilmedi.
Neden | Çözüm |
|---|---|
Yazının yazarında | Güvenilir bir kullanıcının değeri kaydetmesini sağlayın ya da |
Değer bir yorum alanı | Asla değerlendirilmez. Bir yazı, terim, kullanıcı veya seçenek değeri kullanın. |
Metin bir Group, Repeater veya Flexible content alanının içinde | Yalnızca üst düzey metin değerleri değerlendirilir. İfadeyi grubun kendi şablon metnine koyun ya da alt değeri |
Metin yazı içeriği veya bir başlık | Çekirdek içerik değerlendirilmez. Bunun yerine |
Metin REST, GraphQL, bir dışa aktarma dosyası veya bir yönetim listesi sütunu üzerinden okunuyor | Bunlar saklanan metni gösterir. |
Süslü parantezler bir değişkenin içinden geliyor | Kendisi |
Elementor widget'ı düzenleyicide gösteriliyor | Elementor'ın JavaScript şablonlarıyla önizlediği widget'lar (Heading, Button) düzenleyicide ham metni gösterir. Canlı sayfa bunu çözer. |
Bir blok hiç kapatılmadı ( | Kapanış |
Çıktı yanlış değer
Belirti | Neden | Çözüm |
|---|---|---|
Bir sayı biçimlendirilmiyor | Değer sayısal değil ( | Düz sayılar saklayın; şununla biçimlendirin: |
|
| Değeri metin olarak saklayın (bir Text alanı, bir Global Data metin değişkeni) |
| Şuna benzer bir değer: | Tarihleri şu biçimde saklayın: |
|
| Şunu kullanın: |
| Yalnızca ilk karşılaştırma veya üçlü işleç okunur | Şunu kullanın: |
|
| İhtiyacınız olanı |
| Değer bir terim değeri değil ve hiçbir | Bir terim alanı değerinde kullanın ya da |
| Her seferinde değerlendirilirler | Bunları önbelleğe alınan sayfalarda kullanmayın |
Bir tarih İngilizce | Tarihler site dilini kullanır (Settings › General) | Site dilini değiştirin |
| Listeler şu ayraçla birleştirilerek yazdırılır: |
|
Çıktı HTML içeriyor veya işaretlememi bozuyor
Değişken sonuçları kaçışlanmaz. Bir şablonda çıktıda kaçışlayın:
echo esc_html( wpmcf_resolve_variables( '' ) );wpmcf_the_field() ve [wpmcf_field] sizin yerinize kaçışlar. Bir ifadede şunları kullanın: \| escape, \| esc_attr veya \| strip_tags. Bkz. Security.
Bir sayfa bir kişinin adını herkese gösteriyor
Sayfa önbelleğe alınmamalıdır. Eklenti, bir wp.user_* değişkeni yazdıran ön yüz sayfasını zaten önbelleğe alınamaz olarak işaretler (DONOTCACHEPAGE ve no-cache başlıkları). Önbellek katmanınız ikisini de yok sayıyorsa (bir CDN veya sunucu düzeyinde önbellek), o URL'yi önbellekten hariç tutun ya da sayfadan wp.user_* değişkenini kaldırın.
Özel ad alanım, filtrem veya işlevim hiçbir şey yapmıyor
Neden | Çözüm |
|---|---|
Şu dinleyici: | Eklenti dosyanız yüklenirken veya |
Çözümleyici şunu döndürüyor: |
|
Ad kullanımda veya ayrılmış |
|
Adda tire var veya rakamla başlıyor | Adlar harflerden, rakamlardan ve alt çizgilerden oluşur ve bir harfle başlar. |
fn.option() hiçbir şey döndürmüyor
Seçenek izin listesinde değil. Bkz. Filters and functions. Güvenli bir herkese açık seçeneği wpmcf/variables/allowed_options ile ekleyin.
Bir hook tetiklenmiyor
Neden | Çözüm |
|---|---|
Yanlış bağımsız değişken sayısı | Şunun dördüncü bağımsız değişkenini iletin: |
Dinleyici çok geç eklendi | Kayıt hook'ları ( |
Hook, Pro olmayan bir sürümde veya lisanssız bir sitede bir Pro hook'u | Başvuruda Pro olarak işaretlenen hook'lar yalnızca Pro koduyla ve bir lisans ya da denemeyle bulunur. |
Hook adı zamanlanmış bir eylem |
|
| Bu, sizin tetiklediğiniz bir hook'tur; eklenti yalnızca dinler. |
Filtre hiçbir şey döndürmüyor | Bir filtre değeri döndürmelidir. Eksik bir |
Hata ayıklarken bir istek sırasında tetiklenen her wpmcf/ hook'unu görmek için:
add_action( 'all', function ( $hook ) {
if ( str_starts_with( $hook, 'wpmcf/' ) ) {
error_log( 'hook: ' . $hook );
}
} );Hâlâ çözemediniz mi
Eklentide Settings › Health sayfasını açın: eklentinin yakaladığı hataları modül, dosya ve satırla birlikte listeler. Bkz. Health and troubleshooting.
Hâlâ takıldınız mı? Destek ile iletişime geçin