Satırları sitenizde gösterin

Son güncelleme 3 Eki 20265 dk okuma

Bir liste, bir veri tablosunun satırlarını sayfada tablo veya kart olarak yazdırır. Eklemenin aynı çıktıyı veren iki yolu vardır:

shortcode: [wpmcf_table_rows];
blok: Data table list (kategori: Widgets).

Pro Elementor entegrasyonunda aynı altyapıyı kullanan bir Data table list widget'ı da vardır (bkz. Sayfa oluşturucular).

1. adım: sütunları herkese açık yapın

Liste yalnızca tablonun herkese açık sütunlarını gösterir; filtreleme ve sıralama da yalnızca herkese açık sütunlarla yapılır. Varsayılan olarak hiçbir sütun herkese açık değildir:

Tabloyu açın ve Settings sekmesine gidin.
Sitenin gösterebileceği sütunları Public columns altında işaretleyin (Password sütunları işaretlenemez).
Şuna tıklayın: Save settings.

Geri kalan her şey yönetim panelinde kalır: bir ziyaretçi, herkese açık olmayan bir sütunu asla okuyamaz; sütun adını shortcode içinde tahmin etse bile.

Shortcode

[wpmcf_table_rows table="cities" columns="name,country,population" orderby="population" order="desc" per_page="20"]

Öznitelik	Varsayılan	Ne yapar
`table`	yok (zorunlu)	Veri tablosunun anahtarı.
`columns`	tüm herkese açık sütunlar	Gösterilecek sırayla, virgülle ayrılmış sütun anahtarları. Bilinmeyen veya herkese açık olmayan anahtarlar yok sayılır. Sütun listeler ve hiçbiri herkese açık değilse hiçbir şey gösterilmez.
`filter`	yok	Hangi satırların gösterileceği. Bkz. Filtreler.
`orderby`	`id`	Herkese açık bir sütun anahtarı veya `id` (en eskiden başlar). Başka her değer `id` değerine döner.
`order`	`asc`	`asc` veya `desc`.
`per_page`	`10`	Sayfa başına satır sayısı, 1 ile 50 arasında (daha büyük sayılar 50 olur).
`limit`	`0`	Listenin tüm sayfalar boyunca gösterdiği en fazla satır sayısı. `0` sınır yok demektir (kesin üst sınır 10.000'dir).
`layout`	`table`	`table` veya `cards`.
`empty`	`Nothing to show yet.`	Hiçbir satır eşleşmediğinde gösterilen metin.
`id`	tablo anahtarı	Listenin sayfa bağlantılarındaki adı ve HTML çapası. Aynı tabloyu bir sayfada iki kez gösterdiğinizde bunu ayarlayın.

Başlıktaki sütun etiketleri tablonun sütun etiketlerinden gelir (etiket boşsa anahtar kullanılır).

Filtreler

filter, sütun:operatör:değer biçiminde yazılan ve noktalı virgülle ayrılan koşulların listesidir. Tüm koşulların doğru olması gerekir.

filter="price:gte:10;price:lt:25;country:eq:Norway"

Operatör	Eşleşen
`eq`	değere eşit (operatör yazılmazsa varsayılan budur)
`neq`	eşit değil
`gt`, `gte`, `lt`, `lte`	büyük, büyük veya eşit, küçük, küçük veya eşit (sayılar sayı olarak karşılaştırılır)
`like`	sütun değeri içerir (kısmi eşleşme)
`not_like`	sütun değeri içermez
`empty`	sütunun değeri yoktur (üçüncü bölüm gerekmez: `site:empty`)
`not_empty`	sütunun değeri vardır

Kurallar:

Sütun herkese açık olmalıdır. Başka bir sütundaki koşul, yanlış yazılmış bir operatör veya desteklenmeyen bir operatör (örneğin in) sessizce yok sayılır; bu yüzden liste beklediğinizden fazla satır gösterebilir. Bir filtre hiçbir şey yapmıyor gibi görünüyorsa sütunun herkese açık olup olmadığını kontrol edin.
En fazla on koşul. Değer iki nokta üst üste içerebilir ancak noktalı virgül içeremez.
Select ve Radio sütunları seçimin değerini tutar: etikete göre değil, level:eq:a gibi değere göre filtreleyin.
True / false sütunları 1 veya 0 tutar: active:eq:1.

Sayfalama

Satır sayısı per_page değerini aştığında liste bir gezintiyle biter: Previous, Page 1 of 4 ve Next. Sayfa numarası adreste ?wpmcf_rows_{id}=2 olarak taşınır (burada {id} listenin id değeri veya tablo anahtarıdır) ve bağlantı #wpmcf-rows-{id} ile biter; böylece ziyaretçi listede kalır. Son sayfadan büyük bir sayfa numarası son sayfayı gösterir. Bir sayfadaki iki liste, farklı id değerlerine sahipse birbirinden bağımsız sayfalanır.

Düzenler

table (varsayılan): başlık satırlı bir tablo; kaydırılabilir bir kapsayıcıya sarılır ve dar ekranlarda her hücre kendi sütun etiketini gösterir.
cards: her satır için bir kart; sütun etiketi ve değer bir tanım listesi olarak gösterilir.

CSS, yalnızca liste içeren sayfalarda yüklenen küçük bir stil dosyasından gelir. Stillendirebileceğiniz sınıflar: wpmcf-rows, wpmcf-rows--table, wpmcf-rows--cards, wpmcf-rows__scroll, wpmcf-rows__table, wpmcf-rows__cards, wpmcf-rows__card, wpmcf-rows__empty, wpmcf-rows__pages, wpmcf-rows__page-link, wpmcf-rows__page. Blok ayrıca her zamanki wp-block-wpmcf-table-rows sarmalayıcısını ekler.

Blok

Düzenleyicide + simgesine tıklayın ve Data table list araması yapın (veya "table", "rows", "list", "data").
Tabloyu Data table › Table bölümünden seçin. Hiç tablo yoksa panelde "No data tables available. Create one under WPM Fields › Data Tables." yazar.
Seçenekleri ayarlayın:

Panel	Ayar	Shortcode karşılığı
Data table	Table	`table`
Data table	Columns (her herkese açık sütun için bir onay kutusu; hepsi işaretliyse tüm sütunlar demektir)	`columns`
Data table	Filter (yardım: `column:operator:value; ...`)	`filter`
Display	Order by (ID veya herkese açık bir sütun), Order (Ascending, Descending)	`orderby`, `order`
Display	Rows per page, Maximum rows (yardım: "0 shows all rows.")	`per_page`, `limit`
Display	Layout (Table, Cards), Empty text	`layout`, `empty`

Blok, düzenleyicide canlı önizleme gösterir. Tablo seçilmeden önce Data table list: "Choose a data table in the block settings." yazar. Blokta id ayarı yoktur; bu yüzden aynı tablo için bir sayfadaki iki blok sayfalamayı paylaşır. Bu durumda id özniteliğiyle shortcode kullanın. Blok geniş ve tam genişlik hizalamayı, kenar boşluğunu (margin) ve iç boşluğu (padding) destekler.

Listenin yazdırdıkları

Satırlar ziyaretçilerden gelebileceği için (formlar, bağlantılar) değerler güvenli biçimde yazdırılır:

Sütun türü	Çıktı
Text, Text area, Email, URL, Select, Radio, Button group, Color, Range, Number	Kaçışlanmış (escaped) metin. Select, etiketini yazdırır. Number, sondaki sıfırlar olmadan yazdırılır (`10.000000` yerine `10`). URL bağlantı olarak değil, metin olarak yazdırılır.
True / false	Yes; değer boşsa boş.
Date, Date and time, Time	Sitenizin tarih ve saat biçiminde (`January 31, 2024`).
WYSIWYG editor	Temizlenmiş HTML: betikler (script) ve shortcode'lar kaldırılır.
Image, File	Alan türünün olağan görsel veya dosya çıktısı.
Post object, Page link, Programmatic SEO page	Bağlantı; yalnızca yazı yayımlanmış, herkese açık ve parola korumalı değilse yazdırılır, aksi halde boştur.
Icon picker	Simge.

Boş bir değer, boş bir hücredir.

Önbellek

Her liste sayfasının hazır HTML'i önbelleğe alınır (nesne önbelleği, en fazla bir saat) ve tablo değiştiği anda yenilenir: satır ekleme, düzenleme veya silme, içe aktarma, eşitleme ya da sütunlarda değişiklik. Hiçbir şeyi temizlemeniz gerekmez. Önünde bir sayfa önbelleği eklentisi varsa satırları değiştirdikten sonra önbelleğe alınmış sayfanın da temizlenmesi gerektiğini unutmayın; önbellek eklentinize bakın.

Bir şey ters gittiğinde ziyaretçilerin ve editörlerin gördükleri

Durum	Ziyaretçiler	Editörler (yazı düzenleyebilen herkes)
Tablo anahtarı eksik veya bilinmiyor	hiçbir şey	"Choose an existing data table for this list."
Gösterilecek herkese açık sütun yok	hiçbir şey	"This list has no column to show. Mark columns as public under Data Tables › Settings."
Veri tablosu olmayan bir site (ücretsiz eklenti veya sona ermiş bir deneme)	hiçbir şey	"Data table lists need a plan that includes data tables."
Süresi dolmuş ücretli lisans	liste eskisi gibi yazdırılmaya devam eder	liste
Filtre hiçbir satırla eşleşmiyor	ayarlanan `empty` metni	ayarlanan `empty` metni

Sayfa oluşturucular

Pro Elementor entegrasyonunda aynı listeyi yazdıran bir Data table list widget'ı vardır (kontroller: Data table, Columns, Filter, Order by column, Order, Rows per page, Most rows (0 = all), Layout, Text when empty, ayrıca stil seçenekleri). Aynı herkese açık sütun kurallarına uyar. Bkz. Pro alanlar, yönetim sütunları ve sayfa oluşturucular.

Programatik SEO

Bir sayfada listelediğiniz tablo, oluşturulan sayfaların kaynağı da olabilir: bkz. Programatik SEO. Aynı herkese açık sütun kuralı Programatik SEO için geçerli değildir: sayfalar sunucuda oluşturulduğu için bir görev, kaynağındaki tüm sütunları okur.

Bu sayfa yardımcı oldu mu?

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