Geliştirici API'sine genel bakış

Mass Custom Fields her alan grubunu kendi veritabanı tablosunda saklar (bkz. Alan grupları). Bu sayfadaki her şey, kodunuzun bu tablolardan değerleri nasıl okuyup yazdığıyla ilgilidir. Hepsi ücretsiz eklentide yer alır.

İki anahtar

Neredeyse her fonksiyon bir grup anahtarı ve bir alan anahtarı alır: alan grubunun Key değeri ile alanın Key değeri; tam olarak WPM Fields › Field Groups ekranında göründüğü gibi. İkisi de küçük harf, rakam ve alt çizgiden oluşur. Fonksiyonlar bunlara sanitize_key() uygular; bu yüzden 'Listing' ile 'listing' aynı anahtardır.

$price = wpmcf_get_field( 'listing', 'price' );   // group "listing", field "price"

Yalnızca üst düzey alanların veritabanı sütunu vardır. Bir Group veya Repeater alanının içindeki bir değere ulaşmak için kapsayıcıyı okuyun ve bir path verin (bkz. Değerleri okuma).

Nesne

Çoğu fonksiyon isteğe bağlı bir üçüncü argüman alır: değerin ait olduğu nesne:

wpmcf_get_field( 'listing', 'price' );               // the current post (inside the loop)
wpmcf_get_field( 'listing', 'price', 42 );           // post 42
wpmcf_get_field( 'profile', 'bio', 'user_3' );       // user 3
wpmcf_get_field( 'brand',   'color', 'term_5' );     // term 5
wpmcf_get_field( 'company', 'phone', 'option' );     // the options-page row

Kabul edilen tüm biçimler için Nesne referansları bölümüne bakın.

İsteğe bağlı $args dizisi

Son argüman bir seçenekler dizisidir. En önemlileri:

Ham ve kaçışlanmış değer: tek kural

// Raw value: escape it yourself.
echo '<a href="' . esc_url( wpmcf_get_field( 'listing', 'website' ) ) . '">Website</a>';

// Printing function: already escaped.
wpmcf_the_field( 'listing', 'title' );

Hata toleransı

Şablon fonksiyonları asla istisna fırlatmaz. Eklenti henüz başlatılmadıysa, nesne geçersizse veya okuma başarısız olursa, verdiğiniz default değerini (ya da null / false) döndürürler ve hata WPM Fields › Settings › Health ekranına kaydedilir. Bozuk bir alan sayfayı bozamaz. WP_DEBUG açıkken geçersiz bir nesne argümanı ayrıca bir _doing_it_wrong() bildirimi oluşturur.

Burada ele alınmayan konular

• İfade dili {{ }}, wpmcf/... filtreleri ve eylemleri: Değişkenler ve hook'lar.
• PHP'den alan grubu kaydetme, post-meta köprüsü ve GraphQL: Alan grupları ve Entegrasyonlar.
• Elementor, Bricks, Divi, Breakdance ve Oxygen dinamik etiketleri: Entegrasyonlar.
• Her alan türünün ne döndürdüğü ve yazdırdığı: Alan türleri.

Eklentinin kendi REST ad alanı

wpmcf/v1, eklentinin yönetim ekranları için vardır. Herkese açık bir API değildir: neredeyse tüm rotalar manage_options yetkisini gerektirir (bkz. REST API). HTTP üzerinden değer okumak veya yazmak için bunun yerine çekirdek yazı uç noktalarındaki wpmcf özniteliğini kullanın.