Kategori digunakan untuk mengorganisasikan konten Knowledge Base dalam struktur hierarkis (pohon). Setiap kategori dapat memiliki sub-kategori tanpa batas kedalaman.
Kategori disusun dalam bentuk pohon (tree) yang mendukung hubungan induk-anak (parent-child). Berikut contoh struktur kategori:
Pada halaman daftar kategori, klik tombol + Tambah Kategori untuk membuka formulir.
Masukkan nama, deskripsi, pilih induk kategori (jika sub-kategori), ikon, dan warna.
Klik Simpan untuk membuat kategori baru. Kategori akan langsung muncul di pohon hierarki.
| Field | Tipe | Wajib | Keterangan |
|---|---|---|---|
| name | Text | Ya | Nama kategori yang ditampilkan di navigasi dan daftar. |
| slug | Text | Auto | URL-friendly identifier. Dibuat otomatis dari nama. |
| parent_id | Select | Tidak | Kategori induk untuk membuat hierarki. Kosongkan untuk kategori root (utama). |
| description | Text | Tidak | Deskripsi singkat kategori yang ditampilkan di halaman kategori. |
| icon | Text | Tidak | Nama ikon yang ditampilkan di samping nama kategori. |
| color | Color | Tidak | Warna identitas kategori dalam format hex (contoh: #2563eb). |
| image | File | Tidak | Gambar representatif kategori. Format: JPG, PNG, WebP. |
| is_featured | Toggle | Tidak | Tandai sebagai kategori unggulan untuk ditampilkan di halaman utama. |
| is_active | Toggle | Tidak | Status aktif/nonaktif. Kategori nonaktif tidak ditampilkan ke publik. |
| order | Integer | Tidak | Urutan tampil kategori. Angka lebih kecil ditampilkan lebih dahulu. |
Anda dapat mengubah urutan tampil kategori dengan drag-and-drop atau menggunakan endpoint API:
/knowledgebase/categories/update-order
{ "order": [3, 1, 4, 2, 5] }
Pindahkan kategori ke bawah induk yang berbeda:
Klik pada kategori yang ingin dipindahkan, lalu pilih aksi Pindahkan.
Pilih kategori induk baru sebagai tujuan. Semua sub-kategori dan konten akan ikut berpindah.
Konfirmasi pemindahan. Full path kategori akan diperbarui secara otomatis.
Aktifkan atau nonaktifkan kategori tanpa menghapusnya:
Buat salinan kategori beserta pengaturannya (tanpa menyalin konten di dalamnya). Berguna untuk membuat struktur kategori yang serupa.
GET /knowledgebase/api/categories/hierarchy untuk mendapatkan seluruh struktur hierarki kategori dalam format JSON. Endpoint ini bersifat publik dan dapat digunakan untuk membuat navigasi kategori di frontend.