Blok Kueri Ketentuan

Blok Terms Query menampilkan daftar atau kisi istilah taksonomi (seperti Kategori, Tag, atau taksonomi kustom). Blok ini paling berguna dalam templat (misalnya indeks “Kategori” atau halaman direktori) ketika Anda ingin mencantumkan istilah dan mengatur tampilan setiap istilah.

Persyaratan

• WordPress 6.9 atau yang lebih baru.
• Tema blok untuk mengedit templat di Editor Situs.
• Taksonomi yang ingin Anda tampilkan harus bersifat publik dan tersedia di editor (show_in_rest diaktifkan).

Anatomi blok Terms Query

Inspektur blok memberikan gambaran umum singkat tentang struktur blok Term Query . Setiap bagian memberi Anda akses ke pengaturan yang berbeda:

• Terms Query: Konfigurasikan parameter kueri.
• Term Template: Pilih cara konten ditampilkan, baik dalam format daftar maupun kisi.
• Term Name: Tampilkan nama istilah.
• Term Description: Tampilkan deskripsi istilah.
• Term Count: Tampilkan jumlah hasil untuk setiap istilah.

Tambahkan blok Terms Query ke templat

1. Buka Tampilan > Editor.
2. Buka templat tempat Anda ingin menampilkan istilah (misalnya templat “Kategori” kustom).
3. Tempatkan kursor di lokasi yang diinginkan.
4. Buka penyisip blok (+), cari “Terms Query”, lalu pilih blok tersebut.

Konfigurasi blok

Setelah menambahkan blok Terms Query Anda akan melihat dua opsi:

Variasi ini menawarkan dua opsi tata letak yang berbeda:

• Name: hanya menampilkan nama istilah.
• Name & Count: menampilkan nama dan jumlah item dalam istilah tersebut.

Cara menyesuaikan tampilan

Ada banyak cara untuk menyesuaikan blok Term Query, sebagian karena blok ini terdiri dari blok bersarang yang dapat Anda susun ulang, tambahkan, dan lainnya. Saat Anda menyesuaikan satu blok dalam blok Term Query, perubahan akan diterapkan ke semua blok dengan jenis yang sama. Saat menyesuaikan blok ini, mungkin akan membantu jika Anda menggunakan Tampilan Daftar yang terdapat di bilah alat atas. Berikut beberapa ide penyesuaian untuk memulai:

• Anda dapat mengubah lebar berbagai aspek blok Term Query .
• Anda dapat mengubah perataan blok dalam blok Term Query .
• Anda dapat menyusun ulang blok sesuai keinginan, dengan menyeret dan melepaskan atau menggunakan penggeser untuk melakukannya.
• Anda dapat mengubah jumlah istilah yang tercantum dengan memilih blok Term Query dan menyesuaikan opsi Max Terms di pengaturan blok.
• Anda dapat mengatur berbagai opsi warna untuk blok bersarang.
• Anda dapat mengubah cara jumlah istilah ditampilkan dengan memilih blok Terms Number dan mengubah formatnya di bilah alat blok.
• Anda dapat menampilkan deskripsi istilah dengan memilih blok Term Description dan menyesuaikan gayanya sesuai kebutuhan.

Bilah alat blok

Untuk melihat bilah alat blok, klik blok tersebut dan bilah alat akan ditampilkan. Setiap blok memiliki ikon bilah alat yang unik dan kontrol pengguna khusus blok yang memungkinkan Anda memanipulasi blok langsung di editor. Blok Terms Query memiliki hal-hal berikut:

• Transformasikan menjadi.
• Ratakan: tanpa perataan, lebar lebar, lebar penuh.
• Pindahkan/seret untuk mengubah posisi dalam templat.
• Opsi lainnya (duplikat, kunci, hapus, dan lainnya).

Transformasikan menjadi

Klik tombol “Transformasikan” untuk mengubah blok Query Loop menjadi blok “Group” atau “Columns”.  

Ikon seret

Untuk menyeret dan melepaskan blok ke lokasi baru, klik dan tahan persegi panjang bertitik, lalu seret ke lokasi baru. Garis pemisah biru menunjukkan tempat blok akan ditempatkan. Lepaskan tombol kiri mouse ketika Anda menemukan lokasi baru untuk menempatkan blok.

Panah pemindahan

Ikon panah atas dan bawah dapat digunakan untuk memindahkan blok ke atas dan ke bawah halaman.

Petunjuk terperinci tentang memindahkan blok dalam editor dapat ditemukan di sini

Perataan

Gunakan alat ubah perataan untuk meratakan blok Terms Loop . Pilih salah satu opsi berikut:

• None – membiarkan blok pada ukuran saat ini.
• Wide width – menambah lebar blok melampaui ukuran konten.
• Full width – memperluas blok hingga menutupi seluruh lebar layar.

Pengaturan perataan “Wide width” dan “Full width” harus diaktifkan oleh tema WordPress Anda. 

Tampilan daftar (default)

Menampilkan istilah Anda dalam daftar bertumpuk. Pilih blok Term Template untuk mengeditnya.

Tampilan kisi

Menampilkan istilah Anda dalam tampilan kisi. Pilih blok Term Template untuk mengeditnya.

Opsi

Tombol Opsi pada bilah alat blok memberi Anda lebih banyak fitur untuk menyesuaikan blok. 

Baca tentang pengaturan ini dan pengaturan lainnya.

Pengaturan blok

Blok bagian dalam menggunakan lebar konten

Opsi ini memungkinkan Anda mengonfigurasi pengaturan perataan, konten, dan lebar lebar untuk semua blok bersarang dalam blok QueryLoop.

Urutkan berdasarkan

• Name: A > Z
• Name: Z > A
• Count: dari tinggi ke rendah
• Count: dari rendah ke tinggi

Istilah yang dipilih

Opsi ini memungkinkan Anda memilih taksonomi tertentu untuk ditampilkan. Cukup cari dan pilih yang ingin ditambahkan.

Tampilkan istilah kosong

Opsi ini memungkinkan Anda menampilkan istilah meskipun istilah tersebut kosong. Opsi ini dinonaktifkan secara default.

Tampilkan istilah bersarang

Opsi ini memungkinkan Anda menampilkan istilah bersarang. Opsi ini dinonaktifkan secara default.

Maksimal istilah

Opsi ini memungkinkan Anda membatasi jumlah istilah yang ingin ditampilkan. Untuk menampilkan semua istilah, gunakan 0 (nol).

Pengaturan lanjutan

Tab lanjutan memungkinkan Anda menambahkan kelas CSS ke blok, sehingga Anda dapat menulis CSS kustom dan menyesuaikan gaya blok sesuai keinginan. Tab ini juga memungkinkan Anda menetapkan elemen HTML.

Demo

Tips

• Gunakan List untuk taksonomi hierarkis; gunakan Grid untuk memindai banyak istilah dengan cepat.
• Buat Term Name tetap menonjol; tambahkan Term Description untuk memberikan konteks pada halaman arahan.
• Gunakan Hide empty untuk menghindari arsip kosong dan menjaga agar daftar tetap relevan.
• Simpan bagian Terms Query yang telah dikonfigurasi sebagai Pattern untuk digunakan kembali di berbagai templat.

Pertanyaan yang sering diajukan

Bisakah saya hanya menampilkan istilah tingkat teratas?

• Ya. Biarkan Parent tidak ditetapkan dan nonaktifkan Include subterms.

Bisakah saya menampilkan taksonomi kustom?

• Ya, jika taksonomi tersebut bersifat publik dan didaftarkan agar ditampilkan di editor (show_in_rest true).

Bisakah saya menautkan nama istilah ke arsipnya?

• Term Name biasanya tertaut ke arsip istilah secara default. Anda dapat mengontrol tautan tambahan (seperti Term Count) di pengaturan bloknya.