Değer yazma
3 dk okuma
wpmcf_update_field()
wpmcf_update_field( string $group_key, string $field_key, mixed $value, mixed $object = null, array $args = [] ): boolBir değeri düzenleme ekranının yaptığı gibi saklar: alan türü değeri doğrular ve temizler, alan grubu tablosundaki satır yazılır ve yazının sayfa önbellekleri temizlenir (wpmcf/cache/purge_post). Bir yazı nesnesi için, "save terms" olarak ayarlanmış Taxonomy alanlarının terimlerini de atar.
Parametre | Açıklama |
|---|---|
| Grup ve sütunu olan bir üst düzey alan. Yerleşim alanlarının (tab, accordion) değeri yoktur. Alt alanlar kapsayıcıları üzerinden yazılır (tüm diziyi geçirin). |
| Yeni değer, |
| Okumadakiyle aynı biçimler: Object references. Nesne mevcut olmalıdır. |
|
|
Başarıda true, şu durumlarda false döndürür:
- grup, alan veya nesne mevcut değilse ya da nesne başvurusu geçersizse;
- alan türü değeri reddederse (örneğin 128 bayttan uzun bir Password alanı) veya değer alanın kurallarını (uzunluk, min/max, adım) bozarsa. Eski değer korunur ve nedeni belirten bir
_doing_it_wrong()uyarısı oluşturulur. Boş değerler yine de alanı temizler; - yazma başarısız olduysa (hata Massbase › Settings › Health bölümüne kaydedilir).
wpmcf_update_field( 'listing', 'price', 450000, $post_id );
wpmcf_update_field( 'listing', 'features', [ 'garden', 'garage' ], $post_id );
wpmcf_update_field( 'listing', 'details', [ 'city' => 'Rome' ], $post_id );
wpmcf_update_field( 'profile', 'bio', 'Hello', 'user_3' );
wpmcf_update_field( 'brand', 'color', '#ff6600', 'term_5' );
wpmcf_update_field( 'listing', 'price', null, $post_id ); // clearUygulamada "temizlenmiş" ne demektir
Türün kendi kuralları, düzenleme ekranındakiyle aynı şekilde uygulanır. Yalnızca temizlenmesi gereken ya da türün geçerli bir seçeneğe eşleyemediği değerler hata olarak bildirilmez: bırakılır ve alan boş kaydedilir, işlev yine de true döndürür. Önemli olduğunda sonucu geri okuyarak denetleyin. Doğrulanmış örnekler:
Yazdığınız | Saklanan |
|---|---|
Text |
|
Number |
|
Checkbox |
|
Seçeneklerde olmayan bir Select değeri ( |
|
URL | boş (önceki değer boşla değiştirilir) |
WYSIWYG |
|
Password | hiçbir şey değişmez, |
Her türün kuralları için Field types sayfalarına, Password alanları için Password helpers and security sayfasına bakın.
wpmcf_delete_field()
wpmcf_delete_field( string $group_key, string $field_key, mixed $object = null, array $args = [] ): boolAlanın değerini temizler (sütunu NULL yapar; satır ve diğer alanlar kalır). Değer temizlendiğinde true veya temizlenecek bir şey olmadığında da true döndürür; bilinmeyen grup, alan ya da geçersiz nesne başvurusunda false döndürür. wpmcf_update_field() işlevinden farklı olarak nesnenin var olmasını gerektirmez. wpmcf_delete_field( $g, $f, $id ) çağrısı, null değerini wpmcf_update_field() işlevine geçirmekle aynıdır.
Yetkiler: yoktur
add_action( 'wp_ajax_save_rating', function () {
check_ajax_referer( 'save_rating' );
$post_id = absint( $_POST['post_id'] ?? 0 );
if ( ! current_user_can( 'edit_post', $post_id ) ) {
wp_send_json_error( null, 403 );
}
$ok = wpmcf_update_field( 'review', 'rating', absint( $_POST['rating'] ?? 0 ), $post_id );
$ok ? wp_send_json_success() : wp_send_json_error();
} );İzin denetimini WordPress'in sizin yerinize yapmasını istiyorsanız REST API kullanın: yazı üzerinde edit_post yetkisi gerektirir.
Options pages
wpmcf_update_option_field( string $group_key, string $field_key, mixed $value ): bool
wpmcf_delete_option_field( string $group_key, string $field_key ): boolGrubun paylaşılan seçenekler satırına yazar. wpmcf_update_option_field( 'g', 'f', $v ) çağrısı wpmcf_update_field( 'g', 'f', $v, 'option' ) ile aynıdır. Yazmadan sonra, grubu gösteren her seçenekler sayfası için wpmcf/options_pages/values_saved eylemi bir kez tetiklenir; tıpkı sayfanın kendisinde yapılan bir kayıt gibi (grup için kayıtlı seçenekler sayfası yoksa tetiklenmez). Yetki denetimi yoktur.
wpmcf_update_option_field( 'site_settings', 'hours', 40 );Global Data
Global Data değişkenlerinin kendi yazma işlevi vardır: wpmcf_update_global(). Bkz. Global Data functions.
Birden fazla yazma
Her çağrı tek bir satır upsert işlemidir. Aynı nesnenin birkaç alanını yazmak için işlevi alan başına bir kez çağırın; işlem (transaction) yoktur. Sayfa önbellekleri her yazı yazımında temizlenir.
Sınırlamalar
- Yalnızca sütunu olan üst düzey alanlar yazılabilir.
'details.city'yazmak desteklenmez; grubu okuyun, diziyi değiştirin ve tüm grubu yazın. - Alan türü sitede kullanılabilir olmalıdır (örneğin etkin lisansı olmayan bir Pro türü yazılamaz).
- Yazmalar
save_posttetiklemez. Başka kodun tepki vermesi gerekiyorsa kendi hook'unuzu tetikleyin veyawpmcf/cache/purge_postkullanın. - Password alanı, Store as ayarına göre mühürlenir; bkz. Password.
Hâlâ takıldınız mı? Destek ile iletişime geçin