Repeater
4 dk okuma
Bir Repeater, editörlerin ihtiyaç duydukları kadar satır eklemesine izin verir; her satır aynı alt alan kümesini taşır (soru ve cevap, ad ve fotoğraf, özellik ve fiyat). Tüm satırlar tek bir JSON listesi olarak saklanır.
Tür kimliği |
|
Oluşturucu kategorisi | Düzen |
Sütun |
|
Döndürür | satır dizilerinden oluşan bir liste veya |
Yazdırır | satırların sıralı bir listesini |

Repeater alanları Group alanları gibi kurulur: alanı ekleyin, ardından satırın her sütunu için + Add sub-field düğmesine tıklayın. İçine konabilecekler (Group, Repeater, Password ve Pro türleri olmaz) ve alan anahtarları için aynı kurallar geçerlidir.
Çok sayıda kayıt için veya değerlerine göre filtreleme ve sıralama yapmak istediğinizde normal bir alan grubu ya da Pro veri tablosu kullanın; repeater, birlikte gösterilen birkaç düzine satır için tasarlanmıştır.
Tür ayarları
Ayar | Varsayılan | Etkisi |
|---|---|---|
Minimum rows | 0 | Editörler bu sayının altına inecek şekilde satır kaldıramaz (kaldır düğmesi devre dışı kalır). Onlar için boş satır eklemez ve sunucuda zorunlu tutulmaz. Maximum rows değerini aşamaz. |
Maximum rows | 0 | 0, yerleşik üst sınır olan 200 satıra kadar sınır yok demektir. Maksimuma ulaşıldığında Add row ve Duplicate row devre dışı kalır; bir betikle gönderilen fazla satırlar kaydedilirken atılır. |
Button label | Add row | Satır ekleyen düğmenin metni. Boş bırakılırsa "Add row" kullanılır. |
Düzenleme ekranı
- Bir çubuk satır sayısını ("3 rows" veya maksimum varsa "2 / 3 rows") ve Collapse all düğmesini gösterir.
- Her satırın başlığında bir sürükleme tutamacı (Drag to reorder), satır numarası (satırı daraltmak veya genişletmek için tıklayın) ve Duplicate row, Move row up, Move row down ve Remove row düğmeleri bulunur. Satır kaldırma, erişilebilir bir iletişim kutusunda onay ister. Daraltılmış satırlar kısa bir özet gösterir.
- Hiç satır yokken mesaj şöyledir: "No rows yet. Use “Add row” to add the first one." (kendi düğme etiketinizle).
- Bir satır eklemek için ekle düğmesine (varsayılan Add row) basın.
Satırlar sürükleme tutamacı veya yukarı ve aşağı düğmeleriyle yeniden sıralanır. Ön yüz formlarında (Pro) satırlarda yalın ok ve kaldır düğmeleri bulunur.
Nelerin kaydedildiği
- Satırlar gösterilen sırayla kaydedilir ve 0'dan başlayarak yeniden numaralandırılır.
- Her alt alan kendi türüne göre temizlenir.
- Boş satırlar atılır. Bir satırda tüm alt değerler boşsa satır boş sayılır; kapalı bir True / false alt alanı tek başına satırın korunmasını sağlamaz.
- Sınırı aşan satırlar atılır: Maximum rows (ilk satırlar korunur).
- Zorunlu bir Repeater en az bir dolu alt alana sahip bir satır gerektirir; zorunlu alt alanlar her satırda denetlenir ve bildirim ilk eksik olanı belirtir (
Rows › Name). - Tüm satırları silip kaydetmek alanı temizler.
- Form, sunucunun kabul ettiğinden fazla değer gönderecekse (
max_input_vars), kaydetme tarayıcıda engellenir ("Saving is blocked: this screen would send more values than the server accepts…"); yine de sunucuya ulaşırsa o kayıttaki hiçbir özel alan yazılmaz ve bir hata bildirimi şunu söyler: "Custom fields were not saved: the form sent more values than the server accepts…". Satırları kaldırın veya barındırma sağlayıcınızdan sınırı yükseltmesini isteyin.
Koddan bir satır listesi iletin. Bir satırın eksik alt alanları basitçe yer almaz:
wpmcf_update_field( 'faq', 'items', [
[ 'question' => 'What is it?', 'answer' => 'A plugin.' ],
[ 'question' => 'Is it free?' ],
], $post_id );Group alanında olduğu gibi, yazma işlemi tüm listeyi değiştirir.
Şablonda kullanım
$rows = wpmcf_get_field( 'faq', 'items' );
// [
// [ 'question' => 'What is it?', 'answer' => 'A plugin.', 'featured' => 1 ],
// [ 'question' => 'Is it free?' ],
// ]
if ( $rows ) {
foreach ( $rows as $row ) {
printf(
'<details><summary>%s</summary>%s</details>',
esc_html( $row['question'] ?? '' ),
wp_kses_post( $row['answer'] ?? '' )
);
}
}Kodda satırlar 0'dan başlayarak numaralandırılır. Alt değerler saklanan değerlerdir (True / false alt alanı 1/0, Image bir ek kimliğidir, Link bir dizidir). Bir satırın içindeki anahtarların sırası garanti edilmez ve eksik anahtarlar olabilir; bu yüzden ?? kullanın.
Tek bir satırı veya hücreyi path ile okuyun:
wpmcf_get_field( 'faq', 'items', null, [ 'path' => '0' ] ); // the first row (array)
wpmcf_get_field( 'faq', 'items', null, [ 'path' => '1.question' ] ); // "Is it free?"Yazdırma
wpmcf_the_field() ve shortcode sıralı bir liste yazdırır; her alt değer kendi türüne göre biçimlendirilir (seçimler için etiketler, ilişkiler için bağlantılı başlıklar, görseller için bir <img>). Boş alt değerler dışarıda bırakılır.
[wpmcf_field group="faq" field="items" wrap="false"]<ol class="wpmcf-repeater">
<li class="wpmcf-repeater__row">
<span class="wpmcf-repeater__value" data-field="question">What is it?</span>
<span class="wpmcf-repeater__value" data-field="answer">A plugin.</span>
</li>
<li class="wpmcf-repeater__row">
<span class="wpmcf-repeater__value" data-field="question">Is it free?</span>
</li>
</ol>- Tek bir satırı yazdırın:
path="1". Tek bir hücreyi yazdırın:path="1.question"(alt alanın türüne göre, alt alanın kendi öneki, soneki ve sarmalayıcısı kullanılarak biçimlendirilir). - Geliştiriciler tüm listeyi
wpmcf/field/repeater_htmlfiltresiyle değiştirebilir (bağımsız değişkenler: HTML, satırlar, alan tanımı). - Varsayılan olarak çıktı
<span class="wpmcf-field-value">içinde yer alır; bir span içinde liste olmaması içinwrap="false"kullanın.
Özel işaretleme için diziyi yukarıda gösterildiği gibi döngüyle işleyin. Repeater için sayfa oluşturucu widget'ları (Elementor) Pro'nun parçasıdır; bkz. Pro builder widgets.
Sınırlar
- Bir repeater için en fazla 200 satır.
- Bir Repeater, Group veya başka bir Repeater içeremez ve bir Group içinde yer alamaz.
- Tüm liste tek bir değerdir: yazıları bir satırın içindekine göre filtrelemek dizin kullanamaz ve ona göre sıralama mümkün değildir; bu yüzden sorguladığınız değerler için üst düzey alanlar kullanın.
- Bir Repeater, Programmatic SEO veri kaynağı sütunu olamaz.
Sorun giderme
- Boş satırım kaydettikten sonra kayboldu. Dolu alt alanı olmayan satırlar atılır.
- Son satırı kaldıramıyorum. Minimum rows ayarlanmış.
- 3'ten sonraki satırlar kayboluyor. Maximum rows değeri 3.
- "Custom fields were not saved: the form sent more values than the server accepts." Sunucunun
max_input_varssınırı aşıldı; satırları veya alt alanları kaldırın ya da PHP'demax_input_varsdeğerini yükseltin.
Hâlâ takıldınız mı? Destek ile iletişime geçin