Seçenek sayfaları

Bir seçenek sayfası, WordPress yönetim menüsünde yer alan bir ayar ekranıdır. Tek bir yazıya değil, sitenin tamamına ait veriler için kullanın: telefon numarası, alt bilgi metni, logo, sosyal medya bağlantıları.

Sayfanın kendisi yalnızca ekranı tanımlar (başlık, menüdeki yeri, kimlerin açabileceği). Üzerinde gösterilen alanlar, ona işaret eden Options page konum kuralına sahip alan gruplarından gelir. Değerler tüm site için bir kez kaydedilir.

Seçenek sayfaları her planda kullanılabilir.

Nerede bulunur

WPM Fields › Options Pages ekranını açın. Liste şu açıklamayla başlar: "Admin screens for site-wide settings, such as contact details or a footer text. Put field groups on a page with the location rule “Options page”."

Yeni oluşturmak için Add options page düğmesine tıklayın.

Seçenek sayfası oluşturma

1. Add options page düğmesine tıklayın.
2. Page title girin; örneğin "Site Settings". Siz düzenleyene kadar slug başlıktan otomatik doldurulur.
3. Nereye ekleneceğini Place in menu altında seçin (aşağıya bakın).
4. Create options page düğmesine tıklayın. "Options page created." mesajını görürsünüz.
5. Bir alan grubu oluşturun ve Options page is equal to sayfanız konum kuralını ekleyin. Alan grubu düzenleyicisi her seçenek sayfasını başlığıyla listeler.

Düzenleyici, zaten bağlı olan grupları listeleyen bir Field groups on this page bölümü gösterir; kapalı gruplarda "Inactive" rozeti bulunur. Hiç grup yoksa şu mesaj görünür: "None yet. In a field group, add the location rule “Options page is Site Settings”." Mesajda Field Groups bağlantısı yer alır.

Page bölümü

Slug kuralları ve göreceğiniz mesajlar:

• "The slug must start with a letter and use 2–64 lowercase letters, numbers, hyphens or underscores."
• "This slug is reserved. Choose another one." Reddedilenler: wpmcf, options, general, settings, tools, plugins, themes, users, profile ve wpmcf- ile başlayan her şey.
• "An options page with this slug already exists."

Menu bölümü

Menünün oluşturulma biçimi:

• Bir WordPress menüsü altındaki sayfa, Settings, Appearance, Tools veya Users altında alt öğe olarak görünür. URL'si options-general.php?page={slug} (veya ilgili dosya) biçimindedir; üst düzey ya da iç içe bir sayfanın URL'si ise admin.php?page={slug} olur.
• Başka bir seçenek sayfasının altındaki sayfa, onun alt öğesi olur. Üst sayfa, erişilebilir kalması için kendi adını taşıyan ilk bir alt öğe de alır.
• WordPress menüleri iki düzeylidir. A › B › C gibi bir zincir düzleştirilir: C, zincirin en üstteki sayfasının altına yerleştirilir.
• Bir sayfanın üst menüsü yoksa (örneğin içe aktarmadan geldiyse) sayfa üst düzeye döner.
• Bir seçenek sayfası kendi üst öğesi olamaz: "An options page cannot be its own parent."

Form bölümü

Değerleri girme

Sayfayı yönetim menüsünden açın (veya listedeki Open page bağlantısından). Her alan grubu, grubun başlığıyla ve grubun stil ile etiket ayarlarıyla kendi kutusunda gösterilir. Sayfadaki tüm grupları kaydetmek için kaydet düğmesine bir kez tıklayın.

• Kaydettikten sonra sayfa yeniden yüklenir ve kaydedildi mesajını gösterir. Sayfayı tekrar yenilemek veriyi yeniden göndermez.
• Zorunlu bir alan boşsa yine de kaydedilir ve şu uyarı gösterilir: "Saved, but these required fields are empty: Phone."
• Bir alan grubu başarısız olursa hatayı yalnızca o grup gösterir ("These field groups could not be saved: …"). Diğerleri kaydedilir. Ayrıntılar WPM Fields › Settings › Health altındadır.
• Veritabanı tablosu hazır olmayan bir grup şunu gösterir: "This field group cannot store values yet. Open it in Field Groups and save it again."
• Hiç grup bağlı değilse sayfa, Go to Field Groups bağlantılı bir bilgi bildirimi gösterir: "No field groups are shown on this page yet. Create a field group and set its location to this options page."

Yalnızca etkin olan ve tüm konum kuralları eşleşen gruplar gösterilir. Örneğin Current user role üzerindeki bir kural, grubu diğer rollerden gizler.

Grup başına tek değer kümesi

Değerler sayfaya değil alan grubuna aittir. Aynı grubu iki seçenek sayfasına yerleştirirseniz her iki ekran da aynı değerleri düzenler.

Değerleri okuma

Sayfa slug'ını değil, grup anahtarını ve alan anahtarını kullanın.

// Raw value, not escaped: escape it yourself.
$phone = wpmcf_get_option_field( 'site_contact', 'phone' );

// Escaped output, wrapped in <span class="wpmcf-field-value">
wpmcf_the_option_field( 'site_contact', 'phone' );

// Check before printing.
if ( wpmcf_has_option_field( 'site_contact', 'tagline' ) ) {
	wpmcf_the_option_field( 'site_contact', 'tagline', array( 'wrap' => false ) );
}

// Fallback when empty or unavailable.
$email = wpmcf_get_option_field( 'site_contact', 'email', array( 'default' => '[email protected]' ) );

Tekrarlayıcılar (repeater) ve gruplar için $args parametresi path ve sub_key kabul eder. Bkz. Template functions.

Shortcode

[wpmcf_field group="site_contact" field="phone" context="options"]
[wpmcf_field group="site_contact" field="phone" context="options" wrap="false" default="n/a"]

context="options" zorunludur. Olmadan shortcode bir yazı arar ve hiçbir şey yazdırmaz.

Shortcode yalnızca, yazarı grubu gösteren bir seçenek sayfasını açabilen içeriklerde çıktı verir. Shortcode kullanan bir katkıcının yazısı, manage_options veya edit_pages gerektiren bir seçenek sayfasındaki grup için hiçbir şey yazdırmaz. Bu, düşük yetkili yazarların site ayarlarını shortcode üzerinden yayımlamasını engeller. Tema şablonları ve widget'lar güvenilir kabul edilir ve her zaman çıktı verir. wpmcf/options/capabilities ve wpmcf/shortcode/can_view filtreleri bunu ayarlar.

Düzenleme, devre dışı bırakma ve silme

• Active kapalı: menü girdisi kaybolur; liste Open page URL'si göstermez. Değerler korunur ve tüm işlevler onları okumaya devam eder.
• Silme: yalnızca sayfa tanımını kaldırır. "Deleting a page keeps the field values (they belong to the field groups)." Alan grubunun konum kuralı bu durumda hiçbir yere işaret etmez; grubu başka yerde istiyorsanız düzenleyin.
• Capability değerini değiştirmek bir sonraki sayfa yüklemesinde etkili olur.

Hook'lar

Bkz. Hooks.

Sorun giderme

Grubum sayfada görünmüyor. Grubu Field Groups içinde açın; konum kuralının Options page is equal to sayfanız olduğunu, grubun etkin olduğunu ve başka hiçbir kuralın sizi dışarıda bırakmadığını kontrol edin.

403 hatası alıyorum veya menü girdisi yok. Kullanıcınızda sayfanın Capability yetkisi yok.

Shortcode hiçbir şey yazdırmıyor. context="options" ekleyin ve yazının yazarının sayfayı açabildiğini kontrol edin.

Değer ön yüzde güncellenmiyor. Bir sayfa önbelleği eski HTML'i sunuyor. Önbelleği wpmcf/options_pages/values_saved üzerinde temizleyin.