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

Hook referansı: action'lar

Son güncelleme 3 Eki 20267 dk okuma

Tüm hook'lar wpmcf/{area}/{event} biçiminde adlandırılır. Bu sayfa action'ları listeler (gerçekleşen olaylar veya bir şey eklenebilecek yerler). Filtreler Hook referansı: filtreler sayfasındadır.

Plan, hook'u hangi sürümün tetiklediğini belirtir. Free hook'ları her sürümde bulunur. Pro hook'ları yalnızca Pro kodu içeren sürümlerde bulunur ve yalnızca lisanslı bir sitede ya da deneme döneminde tetiklenir (özellikleri planlar sayfasında anlatılır).
Argümanlar sırayla listelenir. Kullandığınız argüman sayısını her zaman belirtin: add_action( 'wpmcf/...', $callback, 10, 2 ).
Hata fırlatan bir dinleyici, eklentinin hata koruması tarafından yalnızca eklentiye ait dinleyiciler için yakalanır. Kendi callback'lerinizi savunmacı yazın: sizin bir callback'inizdeki exception, hook'u tetikleyen isteği kesebilir.
Kayıt amaçlı action'lar (register_pages, variables/register, field_types/register ...) kayıt defteri ilk kullanıldığında istek başına bir kez tetiklenir. Dinleyicinizi erken ekleyin (eklenti dosyanız yüklenirken veya plugins_loaded sırasında).

Yaşam döngüsü

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/booted`	Free	`Plugin $plugin`	Tüm modüller kaydolup başlatıldıktan sonra (`plugins_loaded` üzerinde, öncelik 10). Eklentinin servisleri hazırdır.
`wpmcf/activate`	Free	yok	Eklenti etkinleştirildiğinde, veritabanı şeması ve ayarlar kurulduktan sonra.
`wpmcf/deactivate`	Free	yok	Eklenti devre dışı bırakıldığında, zamanlanmış eylemler kaldırılıp yeniden yazma kuralları temizlendikten sonra.

php

add_action( 'wpmcf/booted', function () {
    // wpmcf_get_field() and the other functions are ready from here.
} );

Değişkenler

`wpmcf/variables/register`


Plan	Free
Argümanlar	`VariableRegistry $registry`
Tetiklenme	Bir kez, değişken kayıt defteri başlatma sonrası ilk oluşturulduğunda (kayıt defteri daha önce oluşturulmuşsa `wpmcf/booted` önceliği 99'da).
Kullanım	Ad alanları, filtreler ve fonksiyonlar ekleyin.

php

add_action( 'wpmcf/variables/register', function ( $registry ) {
    $registry->registerFilter( 'shout', fn ( $v ) => strtoupper( (string) $v ) . '!' );
} );

Tam örnek: PHP API. Kayıt defteri oluşturulduktan sonra eklenen bir dinleyici hiç çalışmaz; bunun yerine doğrudan wpmcf_variable_registry() üzerinde kaydedin.

Yönetim ekranları

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/admin/register_pages`	Free	`AdminPageRegistry $registry`	Eklenti yönetim menüsünü oluştururken. Şu şekilde ekran ekleyin: `$registry->add( new AdminPage( … ) )`. Bir kimliğin ilk kaydı geçerli olur.
`wpmcf/admin/enqueue_page`	Free	`AdminPage $page`	Bir eklenti ekranının betiği kuyruğa eklenip `wpmcfData` yerelleştirildikten sonra. O ekranı genişleten betikler ekleyin (örneğin Pro ayar sekmeleri).
`wpmcf/admin/search_sources`	Free	`SearchRegistry $registry`	Başlık aramasının her isteğinde (`GET wpmcf/v1/admin/search`). Şununla kaynak ekleyin: `$registry->add( $id, $label, callable )`; callable, `SearchItem` nesneleri (başlık, URL, meta) döndürür. Kaynak başına en fazla 5 eşleşme gösterilir.
`wpmcf/settings/register_sections`	Free	`SettingsSectionRegistry $sections`	Settings ekranının verisi oluşturulurken. `$sections->add( $id, $label, $position = 50 )` bir sekme ekler (içeriği `wpmcf.settings.tabs` JS filtresinden gelir).

php

add_action( 'wpmcf/admin/enqueue_page', function ( $page ) {
    if ( $page->id === 'settings' ) {
        wp_enqueue_script( 'my-settings-tab', plugins_url( 'tab.js', __FILE__ ), [ 'wp-hooks' ], '1.0', true );
    }
} );

Veritabanı

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/database/migration_ran`	Free	`string $id`, `int $batch`	Bir migration'ın `up()` metodu çalıştırılıp kaydedildikten sonra.
`wpmcf/database/migration_rolled_back`	Free	`string $id`	Bir migration'ın `down()` metodu çalıştırıldıktan sonra.

Alan türleri, alan grupları ve alanlar

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/field_types/register`	Free	`FieldTypeRegistry $registry`	Alan türü kayıt defteri yüklendiğinde (bir istekte ilk kullanım), yerleşik türlerden sonra. `$registry->add( $type )` veya `$registry->define( $id, fn () => $type )` (ilk kullanımda oluşturulur).
`wpmcf/field_groups/changed`	Free	`string $key`, `string $prefix`	Bir alan grubu tanımı kaydedildikten veya silindikten sonra. `$key` grup anahtarıdır; `$prefix` deponun ayar anahtarı önekidir (alan grupları için `field_group_`). Önbellekteki tanımlar zaten geçersiz kılınmıştır.
`wpmcf/field_groups/register`	Free	yok	İstek başına bir kez, kodla kaydedilen alan grupları toplanırken. İçinde şunu çağırın: `wpmcf_register_field_group( array )`.
`wpmcf/fields/copy_object`	Free	`int $from_id`, `int $to_id`	Eklenti tarafından dinlenir, tetiklenmez. Bir yazının alan satırlarını başka bir yazıya kopyalamak için bir yazı çoğaltma aracından tetikleyin.

php

// After your plugin duplicates a post:
do_action( 'wpmcf/fields/copy_object', $original_id, $copy_id );

Yazı türleri, taksonomiler ve seçenek sayfaları

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/post_types/before_register`	Free	`string $name`, `array $definition`	Kayıtlı bir yazı türü `register_post_type()` fonksiyonuna geçirilmeden hemen önce.
`wpmcf/post_types/after_register`	Free	`string $name`, `array $definition`	Kayıttan hemen sonra.
`wpmcf/post_types/changed`	Free	`string $name`	Bir yazı türü tanımı kaydedildikten veya silindikten sonra.
`wpmcf/taxonomies/before_register`	Free	`string $name`, `array $definition`	Hemen öncesinde: `register_taxonomy()`. Taksonomi zaten varsa tetiklenmez.
`wpmcf/taxonomies/after_register`	Free	`string $name`, `array $definition`	Kayıttan hemen sonra.
`wpmcf/taxonomies/changed`	Free	`string $name`	Bir taksonomi tanımı kaydedildikten veya silindikten sonra.
`wpmcf/options_pages/changed`	Free	`string $slug`	Bir seçenek sayfası tanımı kaydedildikten veya silindikten sonra.
`wpmcf/options_pages/values_saved`	Free	`string $slug`, `array $result`	Bir seçenek sayfasındaki değerler saklandıktan sonra: seçenek sayfası ekranında (en az bir grup kaydedildiğinde) ve `wpmcf_update_option_field()` tarafından (grubu gösteren sayfa başına bir kez). `$result` şudur: `['page' => string, 'saved' => int, 'failed' => string[] group labels, 'missing' => string[]]`.

php

add_action( 'wpmcf/post_types/after_register', function ( $name, $definition ) {
    if ( $name === 'book' ) {
        add_post_type_support( 'book', 'page-attributes' );
    }
}, 10, 2 );

Global Data

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/global_data/saved`	Free	`array $variables`	Global Data kendi ekranında veya `wpmcf_update_global()` ile kaydedildikten sonra. `$variables` saklandığı haliyle değişkenlerin tam listesidir (key, label, type, value, ...). Sayfa önbellekleri bu sinyalle temizlenir.

Sayfa önbelleği temizleme

Eklenti, kontrol ettiği içerik değiştikten sonra WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround Optimizer, Breeze ve WP Engine sayfa önbelleklerini temizler. Bu mekanizmayı besleyebilir veya takip edebilirsiniz.

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/cache/purge`	Free (Pro tarafından da tetiklenir)	`string\|string[] $urls`	Eklenti tarafından dinlenir ve oluşturulan sayfalar değiştiğinde Programatik SEO tarafından tetiklenir. URL'leri temizlemek için tetikleyin; liste boşsa veya argüman verilmezse her şey temizlenir. Çağrılar toplanır ve isteğin sonunda bir kez gönderilir.
`wpmcf/cache/purge_post`	Free (Pro tarafından da tetiklenir)	`int $post_id`	Eklenti tarafından dinlenir; bir yazının değeri `wpmcf_update_field()` ile yazıldıktan ve bir pSEO sayfası dönüştürüldükten sonra tetiklenir. O yazının kalıcı bağlantısını temizler.
`wpmcf/cache/purged`	Free	`string[] $urls`, `bool $all`	Sayfa önbelleklerinden temizleme istendikten sonra. `$urls` değeri, `$all` şu olduğunda boştur: `true`.

php

do_action( 'wpmcf/cache/purge', [ home_url( '/pricing/' ) ] );   // one URL
do_action( 'wpmcf/cache/purge' );                                // everything

Tüm mekanizmayı wpmcf/cache/enabled filtresiyle veya Settings seçeneğiyle kapatın.

Arka plan görevleri

Görevler, eklentinin arka plan işleridir (içe aktarmalar, şema değişiklikleri, Pro oluşturma çalıştırmaları). Her biri gerçekleştikten sonra tetiklenir; hiçbiri sonucu değiştirmez.

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/tasks/finished`	Free	`int $task_id`, `string $type`, `array $state`	Bir görev tüm toplu işlemlerini bitirdiğinde. `$state` işleyicisinin döndürdüğü son durumdur.
`wpmcf/tasks/failed`	Free	`int $task_id`, `string $type`, `string $message`, `TaskDTO $task`	Bir görev kalıcı olarak başarısız olduğunda (yeniden deneme hakkı bittiğinde). `$task` hatanın saklanmasından önceki haliyle görevdir.
`wpmcf/tasks/deleted`	Free	`int $task_id`, `string $type`, `TaskDTO $task`	Bir görev, bir çalıştırmanın ortasında bile olsa silindikten sonra. İşleyici, çalıştırmanın geride bıraktıklarını (dosyalar, çalışma tabloları) kaldırır.

Yönetim sütunları

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/admin_columns/registered`	Free	`AdminColumns $columns`, `string $kind`, `string $subtype`	Alan sütunları bir liste tablosuna eklendikten sonra. `$kind` değeri `post`, `term` veya `user`; `$subtype` yazı türü veya taksonomidir (kullanıcılar için boştur). Uzantılar kendi liste araçlarını buraya bağlar.

Sayfa oluşturucular

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/builders/components`	Free	`ComponentRegistry $registry`	Oluşturucu bileşen kayıt defteri ilk kullanıldığında. `$registry->add( $component )` desteklenen her oluşturucuya bir bileşen ekler.

Formlar (Pro)

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/forms/submitted`	Pro	`FormDTO $form`, `int $object_id`, `string $kind`	Bir ön yüz formu girdisini saklayıp bildirimini gönderdikten sonra. `$object_id` yazı, kullanıcı veya veri tablosu satırı kimliğidir. `$kind` şudur: `post`, `user_profile`, `user_register` veya `entry`.
`wpmcf/forms/connected_submission`	Pro	`ConnectionDTO $connection`, `int $row_id`, `Submission $submission`	Başka bir form eklentisinin (Gravity Forms, Contact Form 7, WPForms, Fluent Forms) gönderimi bir bağlantı üzerinden bir veri tablosunda saklandıktan sonra.

php

add_action( 'wpmcf/forms/submitted', function ( $form, $object_id, $kind ) {
    if ( $kind === 'entry' ) {
        wp_mail( get_option( 'admin_email' ), 'New entry', 'Row ' . $object_id );
    }
}, 10, 3 );

Veri tabloları (Pro)

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/data_tables/row_saved`	Pro	`string $table_key`, `int $row_id`, `string $operation`, `string $origin`	Bir satır eklendikten veya güncellendikten sonra. `$operation` değeri `insert` veya `update`; `$origin` değeri `api`, `admin`, `form`, `connection` veya `pseo`.
`wpmcf/data_tables/rows_deleted`	Pro	`string $table_key`, `int[] $ids`	Satırlar silindikten sonra. `$ids` tablo boşaltıldığında boştur.
`wpmcf/data_tables/synced`	Pro	`string $table_key`, `array $summary`	Bir CSV içe aktarması veya bir besleme senkronizasyonu bittikten sonra. `$summary` şudur: `['type' => ..., 'mode' => ..., 'rows' => int, 'failed' => int]` (besleme kendi türünü ekler, içe aktarmanın türü `import` olur). Tabloyu okuyan oluşturma görevleri sayfalarını günceller.
`wpmcf/data_tables/deleted`	Pro	`string $table_key`	Bir veri kaynağı ve tablosu silindikten sonra. Modüller onun için sakladıklarını bırakır (örneğin beslemesini).

Programatik SEO (Pro)

Hook	Plan	Argümanlar	Tetiklenme
`wpmcf/pseo/run_finished`	Pro	`int $task_id`, `array $summary`	Bir oluşturma çalıştırması tamamlandı. `$summary` şunları içerir: `created`, `updated`, `unchanged`, `conflicts`, `shadowed`, `removed`, `limited` (sayılar) ve `finished_at` (UTC). Yapay zekâ ile zenginleştirme bu sinyalle başlar.
`wpmcf/pseo/pages_changed`	Pro	`string[] $paths`	Oluşturulan sayfalar bir çalıştırmanın dışında değişti (durum, elle düzenlemeler, bir kaynak satırı, yapay zekâ metni). `$paths` değişen sayfa yollarını listeler; boş olması "bilinmiyor, her şeyi değişmiş say" anlamına gelir. Önbellekler bu sinyalle temizlenir.
`wpmcf/pseo/pages_deleted`	Pro	`int $task_id`	Bir görevin tüm oluşturulan sayfaları, görev sıfırlandığı veya kimliği değiştiği için kaldırıldı.
`wpmcf/pseo/task_deleted`	Pro	`int $task_id`	Bir görev ve sayfaları silindi.
`wpmcf/pseo/page_converted`	Pro	`int $post_id`, `int $page_id`	Oluşturulan bir sayfa normal bir yazıya dönüştü.
`wpmcf/pseo/page_served`	Pro	`VirtualPage $page`	Oluşturulan bir sayfa sunuluyor (200 durumu gönderildi). Çok dilli modül dili burada değiştirir.

php

add_action( 'wpmcf/pseo/page_converted', function ( $post_id, $page_id ) {
    update_post_meta( $post_id, '_converted_from_pseo', $page_id );
}, 10, 2 );

Dahili zamanlanmış action'lar

Bunlar, eklentinin kendi toplu işlemleri için zamanladığı Action Scheduler hook'larıdır (grup wpmcf). Aşağıdakiler, şurada tanımanız için listelenmiştir: Tools › Scheduled Actions. Bunları çağırmayın veya kaldırmayın.

Hook	Argüman	Çalışma
`wpmcf/tasks/run`	görev kimliği	Bir arka plan görevinin tek bir toplu işlemi
`wpmcf/tasks/watchdog`	yok	Her 15 dakikada bir: çalışması yarıda kesilen etkin görevleri yeniden kuyruğa alır
`wpmcf/fields/schema_change`	alan grubu anahtarı	Arka planda çalışan büyük bir tablo değişikliği
`wpmcf/field_groups/code_sync`	yok	Kodla kaydedilen alan gruplarını, karma değeri değiştiğinde içe aktarır
`wpmcf/acf/migrate`	yok	ACF taşıması

Hook değil, ama ilgili

wpmcf_fs_loaded, Freemius lisanslama katmanı yüklendikten sonra bootstrap tarafından tetiklenir (do_action( 'wpmcf_fs_loaded' )). Lisanslama katmanına ait olduğu için eğik çizgi değil alt çizgi kullanır.

Bu sayfa yardımcı oldu mu?

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