Kısa kodlar

Son güncelleme 3 Eki 20264 dk okuma

İki kısa kod, kısa kodların çalıştığı her yerde değer yazdırır: yazı içeriği, widget'lar, sayfa oluşturucular ve do_shortcode().

`[wpmcf_field]`

Tek bir alan değerini, wpmcf_the_field() ile aynı kodla kaçışlayarak yazdırır (bkz. Çıktı biçimleri ve kaçışlama).

[wpmcf_field group="listing" field="price"]
[wpmcf_field group="listing" field="price" id="42" wrap="false"]
[wpmcf_field group="profile" field="bio" context="user" id="3"]
[wpmcf_field group="site_settings" field="company_name" context="options"]

Öznitelikler

Öznitelik	Varsayılan	Açıklama
`group`	zorunlu	Alan grubu anahtarı. Olmadan (ya da `field` olmadan) hiçbir şey yazdırılmaz.
`field`	zorunlu	Üst düzey alan anahtarı.
`id`	`0`	Nesne ID'si. `0`, boş veya sayısal olmayan değer geçerli nesne anlamına gelir (döngü içinde geçerli yazı).
`context`	`post`	`post`, `user`, `term`, `comment`, `widget` veya `options`. Bilinmeyen değerler `post` olarak okunur.
`format`	`auto`	`auto`, `html`, `attr`, `url`, `js`, `post_html`. Diğerleri `auto` değerine döner.
`path`	yok	Bir Group veya Repeater değerinin içinde noktalı yol: `path="city"`, `path="1.name"`.
`sub_key`	yok	Tek segmentli `path` kısayolu.
`default`	yok	Alanın değeri olmadığında (hiç kaydedilmemiş veya temizlenmiş) kaçışlanarak yazdırılır. Yalnızca özniteliği yazdığınızda geçerlidir: `default=""` hiçbir şey yazdırmaz.
`wrap`	`true`	`false`, `0`, `no`, `off` veya boş/bilinmeyen bir değer `<span class="wpmcf-field-value">` sarmalayıcısını ve alanın önek/sonekini kaldırır. `true`, `1`, `yes`, `on` ise korur.
`widget_sidebar`, `widget_id_base`, `widget_number`	yok	Widget'ı adlandırır: `context="widget"` olduğunda ve `id` verilmediğinde.

group, field, context, format ve sub_key değerleri sanitize_key() üzerinden geçer; bu yüzden group="LISTING" çalışır. Bilinmeyen öznitelikler yok sayılır.

Kısa kod bir id aldığı için yalnızca ID ve bağlamları kabul eder, user_3 gibi referans dizelerini değil: bunun yerine context="user" id="3" kullanın.

Örnekler (doğrulanmış)

Kısa kod	Çıktı
`[wpmcf_field group="g" field="title" id="5"]`	`<span id="…" class="wpmcf-field-value …">[Hello]</span>` (alanın görüntüleme ayarlarıyla sarmalayıcı)
`... wrap="false"`	`Hello`
`[wpmcf_field group="g" field="details" id="5" path="city"]`	Değer: `city` alt alanı
`[wpmcf_field group="g" field="items" id="5" path="1.name"]`	ikinci satırın `name`
`[wpmcf_field group="g" field="price" id="5" default="n/a"]`	`n/a` (boşsa)
`[wpmcf_field group="g" field="tags" id="5"]`	`Red, Blue` (checkbox etiketleri)
`[wpmcf_field group="g" field="site" id="5" format="url"]`	`https://example.com/a?b=1&c=2`

`{{ }}` ifadeleri

Alan değerindeki ifadeler, wpmcf_get_field() ile aynı kurala göre çözülür: yalnızca değerin yazarı filtrelenmemiş HTML kullanabiliyorsa. Bkz. Değerleri okuma.

Kim neyi görebilir

Kısa kodlar (bloklar gibi) katkıcılar tarafından yazılabilir; bu yüzden açık bir id yalnızca geçerli ziyaretçinin zaten görebileceği şeylere işaret edebilir. Başka her şey boş dize yazdırır. PHP fonksiyonları kısıtlanmamıştır, çünkü tema koduna güvenilir.

`context` ve `id`	Şu durumda yazdırılır
`post`	ziyaretçinin ona `read_post` yetkisi var veya herkese açık görüntülenebiliyor (yayımlanmış); ve parola korumalı değildir; ziyaretçi `edit_post` yetkisine sahipse bu aranmaz. Bu yüzden taslaklar ve özel yazılar başkalarından gizlenir.
`user`	geçerli kullanıcıysa, görüntülenen yazının yazarıysa (yazar kutuları) ya da ziyaretçide şu yetki varsa: `list_users`
`term`	terimin taksonomisi herkese açık görüntülenebiliyorsa
`comment`	ziyaretçi `edit_comment` yapabiliyorsa ya da yorum onaylıysa ve yazısı görüntülenebiliyorsa
`options`	aşağıya bakın
hiç `id` yok (geçerli yazı)	denetlenmez: işlenen sayfadır

Seçenek değerleri (context="options") yazı içeriğinde yalnızca yazının yazarı, grubu gösteren bir seçenek sayfasının yetkisine sahipse yazdırılır: varsayılan olarak manage_options ya da wpmcf/options/capabilities filtresinin döndürdüğü yetkiler. Bu yüzden bir katkıcı kısa kod yazarak seçenek sayfası değerlerinizi yayımlayamaz. Yazı içeriği dışında (şablon, widget) değer yazdırılır; REST ve Ajax isteklerinde (editör önizlemeleri) ise geçerli kullanıcının bu yetkiye sahip olması gerekir.

Filtre: wpmcf/shortcode/can_view (argümanlar: visible, context, nesne ID'si) yukarıdaki her kararı geçersiz kılar:

php

add_filter( 'wpmcf/shortcode/can_view', function ( bool $visible, string $context, int $id ): bool {
    return $context === 'user' ? true : $visible;   // show every user's fields
}, 10, 3 );

Doğrulanmış matris (her nesnede title alanı ayarlıyken):

Nesne	Yönetici	Abone	Oturum kapalı
yayımlanmış yazı	evet	evet	evet
özel yazı	evet	hayır	hayır
taslak	evet	hayır	hayır
parola korumalı yazı	evet	hayır	hayır
abonenin kendi kullanıcısı	evet	evet	hayır
başka bir kullanıcı	evet	hayır	hayır
terim	evet	evet	evet
onaylı yorum	evet	evet	evet
bekleyen yorum	evet	hayır	hayır

Password alanları

Bir Password alanı kısa kod üzerinden asla yazdırılmaz, hangi biçim olursa olsun; wpmcf/field/the_password filtresi izin vermedikçe. Bkz. Parola yardımcıları ve güvenlik.

`[wpmcf_global]`

Bir Global Data değişkenini, wpmcf_the_global() gibi kaçışlayarak yazdırır.

[wpmcf_global key="phone"]
[wpmcf_global key="phone" wrap="false"]
[wpmcf_global key="site_url" format="url" wrap="false"]

Öznitelik	Varsayılan	Açıklama
`key`	zorunlu	Değişken anahtarı. Büyük/küçük harfe duyarsızdır (`sanitize_key()`).
`format`	`auto`	`auto`, `html`, `attr`, `url`, `js`, `post_html`. `auto` değişken türüne göre kaçışlar (URL değişkenlerini `esc_url()` ile, diğer her şeyi `esc_html()` ile).
`wrap`	`true`	Yukarıdakiyle aynı kurallar; sarmalayıcı sınıfı `wpmcf-global-value`.
`default`	yok	Değişken eksik veya boş olduğunda kaçışlanarak yazdırılır. Değerdeki `{{ }}` ifadeleri çözülür.

Şunun için görünürlük kuralı yoktur: [wpmcf_global]. Global Data tasarım gereği site geneli ve herkese açıktır. Password değişkenleri asla yazdırılmaz.

PHP'de kısa kod kullanma

php

echo do_shortcode( '[wpmcf_field group="listing" field="price" id="' . (int) $post_id . '"]' );

Şablonlarda wpmcf_the_field() tercih edin; kısa kod ayrıştırmasından kaçınır ve referans dizelerini kabul eder.

Sorun giderme

Belirti	Neden
Hiçbir şey yazdırılmıyor	Değer boş; bir Password alanı; yukarıdaki görünürlük kuralları (özel, taslak, parola korumalı, başka bir kullanıcı); `group` veya `field` içinde yazım hatası.
Ham `[wpmcf_field ...]` metni görünüyor	Bu yer kısa kodları çalıştırmıyor. `do_shortcode()` içine alın veya bir kısa kod bloğu kullanın.
Bir `<a>` veya HTML metin olarak görünüyor	Şu alan türünü kullanın: `auto` biçimi HTML olan (Link, Image); kaçışlama yapan `format="html"` kullanmayın.
Bir özniteliğin içinde sarmalayıcı span istenmiyor	Şunu ekleyin: `wrap="false"`.

Bu sayfa yardımcı oldu mu?

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