Değişkenler ve geliştirici hook'ları

Sorun giderme

Son güncelleme 3 Eki 20265 dk okuma

İlk adımlar

Şunları açın: WP_DEBUG ve WP_DEBUG_LOG (wp-config.php içinde). 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 tek başına, bir şablonda veya WP-CLI ile test edin:

bash

wp eval 'echo wpmcf_resolve_variables( "{{ glb.phone | default(\"missing\") }}" );'

Motorun bildiklerini listeleyin (adlar küçük harftir):

php

$registry = wpmcf_variable_registry();
var_dump( $registry->getRegisteredNamespaces(), $registry->getRegisteredFilters(), $registry->getRegisteredFunctions() );

İfade hiçbir şey yazdırmıyor

Neden	Kontrol	Çözüm
Sözdizimi hatası	`WP_DEBUG` günlüğü nedeni gösterir	Bkz. Sözdizimi. Sık görülenler: aritmetik (`1 + 2`), `!`, eksik tırnak veya parantez, `\|` karakterinden sonra filtre adının gelmemesi.
Negatif sayı sabiti	`fn.abs(-5)`, `fn.substr('abc', -1)`	`-` geçerli bir karakter değildir. Sayıyı bir alandan veya iç içe bir bloktan geçirin.
Bilinmeyen anahtar	`{{ glb.phon }}`	Anahtarı kontrol edin. Bilinmeyen adlar tasarım gereği boştur; yedek değeri görmek için `\| default('…')` ekleyin.
Tire içeren veya rakamla başlayan eski bir anahtar	`{{ glb.my-key }}`, `{{ glb.2fa }}`	Bu tür anahtarların yeni kayıtları reddedilir (`422`), ancak eskileri kalmış olabilir. Global Data anahtarını küçük harf, rakam ve alt çizgiden oluşacak, bir harfle başlayacak şekilde yeniden adlandırın. `wpmcf_get_global( 'my-key' )` yine de çalışır.
Değer bir parola	Bir Password alanı veya bir parola Global Data değişkeni	Şablonda asla kullanılamaz. Bkz. Güvenlik.
Nesne yok	`{{ fg.group.field }}` veya `{{ wp.post_title }}` bir yazının dışında	Bir bağlam geçirin: `wpmcf_resolve_variables( $t, wpmcf_make_context( $post_id ) )`.
`woo.*`, ürün olmayan bir nesnede	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 karakterden, 5 iç içe bloktan veya 32 düzeyden fazla	Birkaç bloğa bölün veya mantığı PHP'ye taşıyın.
Bir fonksiyon başka bir ad alanı üzerinden çağrıldı	`{{ wp.upper('a') }}`	Fonksiyonlar şöyle çağrılır: `fn.upper('a')`.

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 `unfiltered_html` yetkisi yok (author, contributor, onu içermeyen herhangi bir rol veya çoklu sitede süper yönetici olmayan herkes)	Güvenilir bir kullanıcının değeri kaydetmesini sağlayın veya `wpmcf/field/resolve_variables` filtresiyle izin verin.
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 veya alt değeri şununla okuyun: `{{ fg.group.field.sub }}`.
Metin yazı içeriği veya bir başlık	Çekirdek içerik değerlendirilmez. Bunun yerine `[wpmcf_field]`, `[wpmcf_global]` veya alan bloğunu kullanın.
Metin REST, GraphQL, bir dışa aktarma dosyası veya bir yönetim liste sütunu üzerinden okunuyor	Bunlar saklanan metni gösterir.
Süslü parantezler bir değişkenin içinden geliyor	Kendisi `{{ }}` içeren bir değer, `{{ glb.* }}` veya `{{ fg.* }}` ile okunduğunda olduğu gibi eklenir. Kendi ifadelerini bir düzey değerlendirmek için değişkeni doğrudan okuyun (`wpmcf_get_global()`).
Editörde bir Elementor widget'ı gösteriliyor	Elementor'un JavaScript şablonlarıyla önizlediği widget'lar (Heading, Button) editörde ham metni gösterir. Canlı sayfa bunu çözümler.
Bir blok hiç kapatılmadı (`{{ glb.name`)	Kapanış `}}` ekleyin.

Çıktı yanlış değer

Belirti	Neden	Çözüm
Bir sayı biçimlendirilmiyor	Değer sayısal değil (`1,234`, `12 EUR`) ve sayı filtreleri sayı olmayanları olduğu gibi geçirir	Düz sayılar saklayın; şununla biçimlendirin: `number()`
`{{ x \| length }}` bir sayı için `0` çıkıyor	`length` yalnızca metin ve listeleri sayar	Değeri metin olarak saklayın (bir Text alanı, bir Global Data metin değişkeni)
`{{ x \| date('Y') }}`, 1970 veya garip bir yıl gösteriyor	Şuna benzer bir değer: `20260517` sayısaldır, bu yüzden Unix zaman damgası olarak okunur	Tarihleri şu biçimde saklayın: `2026-05-17`
`{{ 0 \| default('n/a') }}` şunu yazdırıyor: `0`	`default` yalnızca şunların yerine geçer: hiçbir şey, `''` ve `false`	Şunu kullanın: `if_empty` (`0` değerini de değiştirir)
`{{ a < b < c }}` veya zincirleme bir üçlü operatör	Yalnızca ilk karşılaştırma veya üçlü operatör okunur	Şunu kullanın: `&&` veya `fn.if()`
`wp.post_title` bir terim, kullanıcı, yorum veya seçenek değerinde boştur	`wp.post_*` yalnızca yazı bağlamında çözümlenir	İhtiyacınız olanı şununla okuyun: `fg` veya `glb`, ya da bir yazı değeri kullanın
`wp.term_name` boştur	Değer bir terim değeri değil ve `term_id` meta değeri ayarlanmamış	Bir terim alanı değerinde kullanın veya `wpmcf_make_context( $id, 'term' )`
`fn.rand()` veya `fn.now()` her yüklemede değişiyor	Her seferinde değerlendirilirler	Önbelleğe alınan sayfalarda kullanmayın
Bir tarih İngilizce	Tarihler site dilini kullanır (Settings › General)	Site dilini değiştirin
`{{ glb.tags }}` şunu yazdırıyor: `red, green, blue`	Listeler şu ayraçla birleştirilerek yazdırılır: `,`	`\| join(' / ')`, başka bir ayraç için

Çıktı HTML içeriyor veya işaretlememi bozuyor

Değişken sonuçları escape edilmez. Bir şablonda çıktıda escape edin:

php

echo esc_html( wpmcf_resolve_variables( '{{ glb.company }}' ) );

wpmcf_the_field() ve [wpmcf_field] sizin yerinize escape eder. Bir ifadede şunları kullanın: \| escape, \| esc_attr veya \| strip_tags. Bkz. Güvenlik.

Bir sayfa herkese tek bir kişinin adını gösteriyor

Sayfa önbelleğe alınmamalıdır. Eklenti, bir wp.user_* değişkeni yazdıran bir ö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 veya sayfadan wp.user_* ifadesini kaldırın.

Özel ad alanım, filtrem veya fonksiyonum hiçbir şey yapmıyor

Neden	Çözüm
Şu dinleyici çok geç eklendi: `wpmcf/variables/register`. Kayıt defteri başlatmadan sonra oluşturulduğunda yalnızca bir kez tetiklenir.	Eklenti dosyanız yüklenirken veya `plugins_loaded` sırasında ekleyin. Bu mümkün değilse şunu doğrudan çağırın: `wpmcf_variable_registry()->registerFilter( … )`.
Çözümleyici şunu döndürüyor: `null`	`null` hiçbir şey yazdırmaz. Bir metin veya sayı döndürün.
Ad kullanımda veya ayrılmış	`fn`, `func`, `fonk`, `function` ayrılmıştır. Var olan bir adı kaydetmek onun yerini alır.
Adda tire var veya rakamla başlıyor	Adlar harf, rakam ve alt çizgiden oluşur ve bir harfle başlar.

`fn.option()` hiçbir şey döndürmüyor

Seçenek izin listesinde değil. Bkz. Filtreler ve fonksiyonlar. Herkese açık güvenli bir seçeneği şununla ekleyin: wpmcf/variables/allowed_options.

Bir hook tetiklenmiyor

Neden	Çözüm
Yanlış argüman sayısı	Şunun dördüncü argümanını geçirin: `add_action()` / `add_filter()`: `add_filter( 'wpmcf/field/value', $cb, 10, 5 )`.
Dinleyici çok geç eklendi	Kayıt hook'ları (`variables/register`, `field_types/register`, `admin/register_pages`, `builders/components`) kayıt defteri ilk kullanıldığında bir kez tetiklenir. Şurada ekleyin: `plugins_loaded` veya daha erken.
Hook, ücretsiz bir sürümde veya lisanslanmamış bir sitede bir Pro hook'u	Başvuruda Pro olarak işaretlenen hook'lar yalnızca Pro koduyla ve bir lisans ya da deneme ile vardır.
Hook adı zamanlanmış bir action	`wpmcf/tasks/run`, `wpmcf/tasks/watchdog`, `wpmcf/fields/schema_change`, `wpmcf/field_groups/code_sync` ve `wpmcf/acf/migrate` dahilidir; bunları dinlemeyin. Bunun yerine `wpmcf/tasks/finished` ve benzerlerini kullanın.
`wpmcf/fields/copy_object` hiç çağrılmıyor	Bu, eklentinin yalnızca dinlediği, sizin tetiklediğiniz bir hook'tur.
Filtre hiçbir şey döndürmüyor	Bir filtre değeri döndürmelidir. Eksik bir `return`, eklentiye `null` geçirir.

Bir istek sırasında hata ayıklarken tetiklenen her wpmcf/ hook'unu görmek için:

php

add_action( 'all', function ( $hook ) {
    if ( str_starts_with( $hook, 'wpmcf/' ) ) {
        error_log( 'hook: ' . $hook );
    }
} );

Hâlâ takıldıysanız

Eklentide Settings › Health ekranını açın: eklentinin yakaladığı hataları modül, dosya ve satır bilgisiyle listeler. Bkz. Health ve sorun giderme.

Bu sayfa yardımcı oldu mu?

Hâlâ takıldınız mı? Destek ile iletişime geçin