Hook referansı: filtreler
11 dk okuma
Filtreler bir değeri değiştirmenize olanak tanır. Her filtre bir değer return etmelidir; türü Döndürür sütununda gösterilen türde olmalıdır; eklenti çoğunda yanlış türü yok sayar veya değiştirir, ama beklenmedik bir şey döndürmek kodunuzdaki bir hatadır. Action'lar Hook referansı: action'lar sayfasındadır.
- Plan: Free filtreleri her sürümde bulunur. Pro filtreleri yalnızca Pro kodunun bulunduğu yerde vardır.
- Okuduğunuz argüman sayısını belirtin:
add_filter( 'wpmcf/...', $callback, 10, 3 ). $objectId, okunan değerin yazı, kullanıcı, terim veya yorum kimliğidir; seçenek değerlerindenullveya0olabilir.
İçindekiler
Alan değerlerini okuma ve yazdırma · Global Data çıktısı · Değişkenler · Alan grupları, konum kuralları ve depolama · Kısa kodlar, sorgular ve seçenek sayfaları · Yönetim ekranları · Yönetim sütunları · Yazı türleri ve taksonomiler · Local JSON · Arka plan işleri ve veritabanı · Sayfa önbelleği · Sayfa oluşturucular · Lisanslama (Pro) · Yapay zekâ (Pro) · Veri tabloları (Pro) · Formlar (Pro) · Programatik SEO (Pro)
Alan değerlerini okuma ve yazdırma
Bir alan okumasının sırası şöyledir: saklanan değer → wpmcf/field/value → {{ }} değerlendirmesi (izin verilmişse) → çıktı biçimi için escape → wpmcf/field/the_escaped → işaretleme → wpmcf/field/the_html.
wpmcf/field/value
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan | Saklanan değer (boşsa |
Çalışma | Şu yollarla her okumada: |
add_filter( 'wpmcf/field/value', function ( $value, $group, $field ) {
if ( $group === 'product' && $field === 'price' && is_numeric( $value ) ) {
return $value * 1.2; // show prices with tax
}
return $value;
}, 10, 3 );wpmcf/field/the_escaped
Plan | Free |
Argümanlar |
|
Döndürür |
|
Çalışma | Şurada: |
Döndürdüğünüz şeyin güvenliğinden siz sorumlusunuz. Eklediğiniz her şeyi escape edin.
wpmcf/field/the_html
Plan | Free |
Argümanlar |
|
Döndürür |
|
Çalışma | Şunun son adımı: |
add_filter( 'wpmcf/field/the_html', function ( $markup, $group, $field ) {
return $group === 'product' && $field === 'badge' ? '<strong>' . $markup . '</strong>' : $markup;
}, 10, 3 );wpmcf/field/the_password
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Eklenti, bir parola alanının şablon yolu üzerinden veritabanından çıkıp çıkamayacağına her karar verdiğinde. Karma (hash) depolama modu ne olursa olsun asla gösterilmez. |
add_filter( 'wpmcf/field/the_password', '__return_true' ); // the site accepts printing stored passwordswpmcf/field/resolve_variables
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan | Yazı: yazının yazarında |
Çalışma | Alan çalışma zamanı üzerinden okunan ve |
Örnekler ve gerekçe Güvenlik sayfasındadır.
wpmcf/field/repeater_html
Plan | Free |
Argümanlar |
|
Döndürür |
|
Çalışma | Bir Repeater değeri varsayılan liste işaretlemesine dönüştürüldüğünde ( |
wpmcf/field/flexible_content_html
Plan | Pro |
Argümanlar |
|
Döndürür |
|
Çalışma | Bir Flexible content değeri varsayılan işaretlemeye dönüştürüldüğünde ( |
Global Data çıktısı
Alan filtreleriyle aynı yapı, Global Data için.
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Free |
|
| Her okumada ( |
| Free |
|
| Şurada: |
| Free |
|
| Yazdırmanın son adımı; |
| Free |
|
| Bir parola değişkeninin yazdırılıp yazdırılamayacağını veya şununla okunup okunamayacağını belirler: |
add_filter( 'wpmcf/global/value', function ( $value, $key ) {
return $key === 'phone' ? preg_replace( '/\s+/', ' ', (string) $value ) : $value;
}, 10, 2 );Değişkenler
wpmcf/variables/context
Plan | Free |
Argümanlar |
|
Döndürür |
|
Çalışma | Her üst düzey değerlendirmenin başında (iç içe bloklarda değil). İstek verisini şununla ekleyin: |
add_filter( 'wpmcf/variables/context', fn ( $ctx ) => $ctx->withMeta( 'campaign', 'spring-sale' ) );wpmcf/variables/allowed_options
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Her |
Yalnızca herkese açık bir sayfada güvenli olan seçenekleri ekleyin. Bkz. Güvenlik.
Alan grupları, konum kuralları ve depolama
wpmcf/fields/initial_values
Plan | Free (Business, çeviri ön doldurmasını ekler) |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Bir yazı düzenleme ekranında, yazının grup için henüz saklanmış satırı yoksa. Yeni bir yazıyı önceden doldurmak için kullanın (yeni bir çeviri orijinalinden bu şekilde önceden doldurulur). |
wpmcf/fields/translation_ui
Plan | Free (Business çok dilli modülü tarafından |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Alan oluşturucunun verisi hazırlanırken. |
wpmcf/fields/schema_background_rows
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Bir tablo değişikliği planlandığında. Bu değerden fazla satırı olan tablolardaki değişiklikler arka planda çalışır; saklanan değerleri yeniden yazan bir değişiklik en fazla 5.000 satırda geçiş yapar. |
wpmcf/field_groups/builder_pages
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Ekran verisi yerelleştirilirken. Listedeki sayfalar alan türü meta verisini ( |
wpmcf/field_groups/managed_by
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Bir alan grubu REST üzerinden döndürülürken. Yönetilen bir grup editörde salt okunurdur ve |
wpmcf/location/params
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Konum kuralları denetlenirken. Geçerli bağlamlar: |
wpmcf/location/actual_value
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Parametresi yerleşik olmayan her kural için. |
wpmcf/location/ui_params
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Alan oluşturucunun verisi hazırlanırken ( |
wpmcf/location/options_pages
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Kural oluşturucu hangi seçenek sayfalarının var olduğunu sorduğunda. |
Kısa kodlar, sorgular ve seçenek sayfaları
wpmcf/shortcode/can_view
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan | Yazı: ziyaretçi okuyabiliyorsa ve parola korumalı değilse (editörler her zaman okuyabilir). Kullanıcı: ziyaretçinin kendisi, görüntülenen yazının yazarı veya |
Çalışma | Bir kısa kod, blok veya oluşturucu öğesi açıkça belirtilmiş bir nesnenin değerini istediğinde ( |
Yazı içeriğindeki seçenek değerleri ayrıca denetlenir: yazının yazarı wpmcf/options/capabilities filtresinden gelen bir yetkiye sahip olmalıdır (varsayılan manage_options). Bu filtre sonra bu sonucu, bağlam options ve kimlik 0 ile alır. Herhangi bir yazının dışında şablonlar ve widget'lar güvenilirdir; REST ve ajax isteklerinin yetkiyi kendilerinin taşıması gerekir.
wpmcf/options/capabilities
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Seçenek değerleri yazı içeriğinde göründüğünde (kısa kod, blok, oluşturucu) ve yazar denetlenmesi gerektiğinde. |
add_filter( 'wpmcf/options/capabilities', fn ( $caps, $group ) => $group === 'contact' ? [ 'edit_others_posts' ] : $caps, 10, 2 );wpmcf/query/public_orderby
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Ön yüz ana sorgusunda, URL'nin kendi |
Yönetim ekranları
wpmcf/admin/localize_data
Plan | Free |
Argümanlar |
|
Döndürür |
|
Çalışma | Bir eklenti ekranının betiği yerelleştirilirken. Kendi betiğiniz için anahtarlar ekleyin; mevcut anahtarları kaldırmayın. |
wpmcf/admin/docs_links
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Yardım bağlantıları oluşturulurken. Bilinen konular: |
wpmcf/onboarding/checklist
Plan | Free |
Argümanlar |
|
Döndürür |
|
Çalışma | Pano kontrol listesi oluşturulurken. |
Yönetim sütunları
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Free |
|
| Sütunlar bir liste tablosuna eklenmeden önce. |
| Free |
|
| Oluşturulan her hücre için. |
| Pro |
|
| Bir sütun filtre denetimi alacağında. |
| Pro |
|
| Bir sütun satır içi (hızlı ve toplu) düzenleme alacağında. |
add_filter( 'wpmcf/admin_columns/editable', function ( $enabled, $column ) {
return $column['field'] === 'price' ? false : $enabled;
}, 10, 2 );Yazı türleri ve taksonomiler
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Free |
|
| Kayıttan hemen önce. |
| Free |
|
| Kayıttan hemen önce. |
| Free |
|
| Saklanan bir tanım bir callback adlandırdığında (örneğin |
| Free |
|
| Taksonomiler için aynısı. Varsayılan: WordPress'in kendi |
add_filter( 'wpmcf/post_types/register_args', function ( $args, $name ) {
if ( $name === 'book' ) {
$args['menu_icon'] = 'dashicons-book';
}
return $args;
}, 10, 2 );Local JSON
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Free |
|
| Tanımlar kaydedilirken. Varsayılan: etkin temadaki |
| Free |
|
| Tanımlar okunurken. Varsayılan: kayıt klasörü, ayrıca alt tema için ana temanın |
| Free |
|
| Local JSON'a kaydetmenin açık olup olmadığı. Varsayılan: kayıt klasörü var. Klasör olmadan açmak için |
Bkz. Local JSON ve sürüm kontrolü.
Arka plan işleri ve veritabanı
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Free |
|
| Bir arka plan toplu işlemi her başladığında. Varsayılan |
| Free |
|
| Şema yöneticisi oluşturulduğunda. Bir modül kendi migration'larını ekler; sağlayıcısının |
add_filter( 'wpmcf/jobs/batch_seconds', fn () => 10 );Sayfa önbelleği
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Free |
|
| Her temizlemeden önce. Varsayılan: Settings içindeki "clear page caches" seçeneği. |
| Free |
|
| Temizleyici hangi önbellek eklentileriyle konuşacağını belirlerken (istek başına bir kez). Yerleşik olmayan bir önbellek eklentisi için bir adaptör ekleyin. |
add_filter( 'wpmcf/cache/enabled', '__return_false' ); // never touch page cachesSayfa oluşturucular
wpmcf/integrations/elementor/widgets
Plan | Free |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Elementor widget'ları kaydedilirken. |
Lisanslama (Pro)
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Pro |
|
| Lisans süresi dolduktan sonraki ek sürenin sonu hesaplanırken. Varsayılan |
| Pro |
|
| Süre dolumu bildirimi çizilirken: sahibin hâlâ dışarı alabileceği veriler için indirme bağlantıları (veri tabloları her tablonun CSV'sini ekler). |
Yapay zekâ (Pro)
wpmcf/ai/providers
Plan | Pro |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Sağlayıcı listesine ilk kez ihtiyaç duyulduğunda. Bir sağlayıcı ekleyin veya değiştirin, örneğin testlerde bir stub. |
Veri tabloları (Pro)
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Pro |
|
| Bir CSV besleme URL'si denetlenirken. Varsayılan: |
| Pro |
|
| Bir besleme indirilmeden önce. Varsayılan 20 MB. |
| Pro |
|
| Besleme isteği başına. Varsayılan 30. |
| Pro |
|
| Yüklenen bir CSV kabul edilirken. Varsayılan 50 MB. |
| Pro |
|
| Bir CSV UTF-8 değilse: denenecek Windows kod sayfası ( |
| Pro |
|
| Veri tabloları listesi "used by" bilgisini gösterirken. Şunu ekleyin: |
add_filter( 'wpmcf/data_tables/feed_hosts', function ( $hosts ) {
$hosts[] = 'example.com';
return $hosts;
} );Formlar (Pro)
Hook | Plan | Argümanlar | Döndürür | Çalışma |
|---|---|---|---|---|
| Pro |
|
| Yerleşik denetimler geçtikten sonra. CAPTCHA veya Turnstile için kullanın. |
| Pro |
|
| Gönderim başına. Varsayılan |
| Pro |
|
| Hız sınırlayıcı için ziyaretçi IP'si okunurken. Varsayılan: |
| Pro |
|
| Her dosya alanı için. Varsayılan: sunucu yükleme sınırı ile eklenti üst sınırından küçük olanı. |
| Pro |
|
| Ziyaretçi dosya yükleyemediğinde, kendi listesi olmayan dosya alanları için. Varsayılan: |
| Pro |
|
| Bir kayıt formu atanabilir rolleri listelediğinde. Yalnızca daraltır: güçlü yetkisi olmayan rollerle başlar ve eklediğiniz güvenli olmayan roller yok sayılır. |
| Pro |
|
| Bir kayıt parolası denetlenirken. Varsayılan: 10 veya daha fazla karakter, 4 karakter sınıfından en az 2'si, bir harf içermesi, oturum adını içermemesi. |
| Pro |
|
| Diğer form eklentilerine bağlantılar kurulurken. Şunu uygulayan bir nesne ekleyin: |
add_filter( 'wpmcf/forms/verify_submission', function ( $ok, $form, $request ) {
if ( empty( $request['cf-turnstile-response'] ) ) {
return new WP_Error( 'captcha', 'Please complete the check.' );
}
return $ok;
}, 10, 3 );Programatik SEO (Pro)
wpmcf/pseo/conversion/skip_meta_keys
Plan | Pro |
Argümanlar |
|
Döndürür |
|
Varsayılan |
|
Çalışma | Dönüştürülen her sayfa için. |
JavaScript filtresi
wpmcf.settings.tabs (@wordpress/hooks): Settings bölüm kimliğinden React bileşenine bir eşleme; Settings ekranına sekme eklemek için wpmcf/settings/register_sections action'ıyla birlikte kullanılır.
Hâlâ takıldınız mı? Destek ile iletişime geçin