Konum kuralları

Son güncelleme 3 Eki 20266 dk okuma

Konum kuralları, bir alan grubunu hangi ekranların göstereceğini belirler. Bunları grup düzenleyicisinde Settings › Location rules altında ayarlarsınız.

Kurallar nasıl birleşir

Bir kural parametre + operatör + değer yapısındadır, örneğin Post type · is equal to · Page.
Tek bir Rule group içindeki kurallar AND ile birleşir: her kuralın eşleşmesi gerekir.
Kural grupları OR ile birleşir: alan grubu, herhangi bir kural grubu eşleştiğinde görünür.

Düzenleyici bunu tek satırda açıklar: All rules in a rule group must match (and); the field group shows when any rule group matches (or). Sekmelerin üstündeki Appears on: ... satırı kurallarınızı sözcüklerle özetler.

Düğme	İşlevi
+ Add rule (bir kural grubunda)	O gruba bir AND kuralı ekler.
+ Add rule group (or)	Yeni bir OR dalı ekler.
Remove rule (satırdaki düğme)	Kuralı siler; boş kalan kural grubu kaybolur.

Operatörler. Yalnızca iki tane vardır: is equal to ve is not equal to.

Kural yoksa ekran yok. Kuralı olmayan bir grup hiçbir yerde gösterilmez (No location rules yet. The field group is not shown anywhere until you add a rule.). Tablosunda ayrıca henüz mid ve mtype sütunları da yoktur; bunlar, kuralları olan bir grubu ilk kez kaydettiğinizde eklenir.

Kural parametreleri

Parametreler açılır listede şu başlıklar altında gruplanır: Post, Page, User, Form, Options (Pro ile ayrıca WooCommerce).

Post grubu

Bunlar yazı düzenleme ekranlarında (yazılar, sayfalar, özel yazı türleri ve Media düzenleme ekranı) geçerlidir.

Parametre	Değer	Şu durumda eşleşir
Post type	Yönetim ekranı olan bir yazı türü (Posts, Pages, Media, özel türleriniz).	Düzenlenen yazı o türdedir.
Post template	Default template veya temanın bir şablonu.	Yazının sayfa şablonu o şablondur.
Post status	Published, Draft, Pending, Private, Scheduled.	Yazının kayıtlı durumu. Yeni yazılar için aşağıdaki nota bakın.
Post format	Standard, Aside, Gallery, Link, Image, Quote, Status, Video, Audio, Chat.	Yazının biçimi (hiçbiri ayarlanmamışsa `standard`).
Post category	Bir kategori (terim seçici).	Yazı tam olarak o kategoriye atanmıştır. Bir kategorinin üst veya alt kategorileri sayılmaz.
Post taxonomy (term)	Bir taksonomi artı bir terim.	Yazı, o taksonominin o terimine atanmıştır.
Post	Tek bir yazı (seçici).	Yazı kimliği seçilen yazıya eşittir.

Page grubu

Parametre	Değer	Şu durumda eşleşir
Page type	Front page, Posts page, Top level, Child page.	Öğe, o türde bir Page'dir. Front page ve Posts page, Settings › Reading ayarından gelir; Top level üst öğesi olmayan bir sayfadır; Child page bir üst öğeye sahiptir. Bir sayfa her zaman bunlardan yalnızca biridir ve bu sırayla denetlenir. Diğer yazı türlerinde değer boştur, bu yüzden yalnızca is not equal to kuralları eşleşebilir.
Page template	Default template veya bir şablon.	Sayfa şablonu o şablondur.
Page parent	Bir sayfa (seçici).	Öğenin doğrudan üst öğesi seçilen sayfadır.
Page	Tek bir sayfa (seçici).	Öğe o sayfadır. Yalnızca sayfalar eşleşebilir.

User grubu

Parametre	Değer	Şu durumda eşleşir
User role	Bir rol.	Kullanıcı ekranlarında: düzenlenen kullanıcının ilk rolü o roldür. Birden çok rolü olan bir kullanıcı yalnızca ilk rolü üzerinden eşleşir.
User form	Your profile, Edit user, Add new user.	Kullanıcı ekranı o formdur.
Current user	Bir kullanıcı (seçici).	Ekranı kullanan kişi o kullanıcıdır. Her ekranda çalışır.
Current user role	Bir rol.	Ekranı kullanan kişinin ilk rolü. Her ekranda çalışır.

Örneğin bir grubu yalnızca yöneticilere göstermek için Current user role kullanın. Yazılar, kullanıcılar, terimler, yorumlar, widget'lar, seçenek sayfaları ve siparişler için geçerlidir.

Form grubu

Parametre	Değer	Şu durumda eşleşir
Taxonomy	Bir taksonomi.	O taksonominin terim düzenleme ekranı.
Attachment	Şuna benzer bir MIME türü: `image/jpeg`, ya da herhangi biri için `*`.	O MIME türüne sahip bir dosyanın Media düzenleme ekranı. `*` herhangi bir medya dosyasıyla eşleşir, ancak yalnızca medyayla (diğer yazı ekranlarıyla asla).
Comment	Bir yorum kimliği ya da herhangi biri için `*`.	O yorumun Edit Comment ekranı (`*` = herhangi bir yorum).
Widget	Şu biçimde bir metin: `sidebar\|widget_id\|instance`, örneğin `sidebar-1\|text-2\|2`.	Tam olarak o widget'ın widget formu. Joker karakter yoktur.
Menu	Bir gezinme menüsü.	O menüye ait bir menü öğesi.
Menu item	Bir menü öğesi (seçici).	O menü öğesi.

Bu işlevler için Geliştirici API'si bölümüne bakın.

Options grubu

Parametre	Değer	Şu durumda eşleşir
Options page	Bir seçenek sayfası (seçim kutusu).	Grup o seçenek sayfasında gösterilir. Henüz hiç seçenek sayfanız yoksa seçim kutusunda şu yazar: `No options pages yet — create one first`. Bkz. Seçenek sayfaları.

Kural gruplarının tümünde bir Options page kuralı bulunan bir grup, değerlerini yalnızca paylaşılan seçenek satırında saklar.

WooCommerce grubu (Pro)

Pro ve WooCommerce etkinken iki parametre daha görünür (wc_order, wc_order_status): Order (All orders) ve Order status (tüm WooCommerce durumları). Bunlar grubu sipariş düzenleme ekranına yerleştirir (HPOS ve yazı depolaması). Bkz. WooCommerce.

Hangi kural hangi ekranda çalışır

Ekran	Eşleşebilen parametreler
Yazı, sayfa, özel yazı türü, medya	Post type, Post template, Post status, Post format, Post category, Post taxonomy (term), Post, Page type, Page template, Page parent, Page, Attachment, Menu, Menu item, Current user, Current user role
Kullanıcı profili / düzenleme / yeni kullanıcı ekleme	User role, User form, Current user, Current user role
Terim düzenleme	Taxonomy, Current user, Current user role
Yorum düzenleme	Comment, Current user, Current user role
Widget formu	Widget, Current user, Current user role
Seçenek sayfası	Options page, Current user, Current user role
WooCommerce siparişi (Pro)	Order, Order status, Current user, Current user role

Şaşırtıcı bulunabilecek noktalar

Kurallar ekran yüklenirken denetlenir. Düzenleyicide bir kategori seçmek veya durumu değiştirmek, bir grubu canlı olarak göstermez ya da gizlemez. Etkiyi görmek için yazıyı kaydedip sayfayı yeniden yükleyin.
Yeni yazıların durumu auto-draft olur. Add New ekranında Post status is equal to Draft henüz eşleşmez. Post status is not equal to Published kuralını kullanın (auto-draft ile eşleşir) ya da Post type ile birleştirin.
Uygulanmayan bir parametrede "eşit değil" kuralı başarısız olur. Örneğin normal bir yazıda Page is not equal to ... veya Attachment is not equal to ...: ekranda sayfa ya da ek olmadığından kural eşleşemez.
Terimler kaydedildiği gibi eşleştirilir. Post category ve Post taxonomy (term) yazı için saklanan terimleri okur.
Geçersiz kurallar kaydedilirken reddedilir: Unknown location parameter "x"., "post_id" rule requires a numeric value., Post taxonomy rule requires a valid taxonomy in value_meta., Post taxonomy rule requires a numeric term id., Options page rule requires the slug of an options page., Each location rule group (OR branch) must contain at least one valid rule.
REST API üzerinden bilinmeyen bir operator sessizce equal olarak saklanır.

Örnekler

Ön sayfa olmayan tüm sayfalar (tek kural grubu, AND ile birleşen iki kural)

Post type is equal to Page
Page type is not equal to Front page

"News" kategorisindeki yazılar veya "Event" özel yazı türü

Kural grubu 1	Kural grubu 2
Post category is equal to News	Post type is equal to Event

Yalnızca yöneticiler, kullanıcı profillerinde ve mağaza seçenekleri sayfasında

Kural grubu 1	Kural grubu 2
User form is equal to Edit user AND Current user role is equal to Administrator	Options page is equal to Shop settings AND Current user role is equal to Administrator

REST gösterimi

json

"location": [
  [
    { "param": "post_type", "operator": "equal", "value": "post" },
    { "param": "post_taxonomy", "operator": "equal", "value": "12", "value_meta": { "taxonomy": "post_tag" } }
  ],
  [
    { "param": "options_page", "operator": "equal", "value": "shop_settings" }
  ]
]

Geliştiriciler için

Entegrasyonlar, wpmcf/location/params filtresiyle parametre ekleyebilir ve bunları kendi ekranlarında wpmcf/location/actual_value ile çözümleyebilir (WooCommerce siparişleri bunu kullanır). Bkz. Hook'lar ve filtreler.

Sorun giderme

Sorun	Çözüm
Grup görünmüyor	Grubun Active olduğunu, en az bir kuralı bulunduğunu ve bir kural grubundaki her kuralın o ekranda eşleşebildiğini kontrol edin (yukarıdaki tabloya bakın). Terimleri veya durumu değiştirdikten sonra ekranı yeniden yükleyin.
Grup yanlış yazı türünde görünüyor	Kurallar, kural grupları arasında OR ile birleşir: fazladan kural grubunu kaldırın veya her kural grubuna Post type ekleyin.
Grup bir yazı türünde görünüyor ama değerler kaydedilmiyor	Kuralı olan bir grup kaydedilene kadar tabloda `mid`/`mtype` sütunları bulunmaz. Grubu bir kez kaydedin.
Bir kategori kuralı alt kategoriyle eşleşmiyor	Post category yalnızca atanmış terimle eşleşir. Her kategori için bir kural grubu ekleyin.
Kural listesinde şu yazıyor: `Could not load the location lists (post types, templates, …). Refresh the page to try again.`	Yardımcı REST istekleri başarısız oldu (örneğin bir güvenlik eklentisi `wpmcf/v1/location/*` adresini engelliyor). Sayfayı yeniden yükleyin; REST erişimini kontrol edin.

Bu sayfa yardımcı oldu mu?

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