Jenis kolom form kategori
From Joomla! Documentation
Jenis kolom form kategori menyediakan sebuah daftar dropdown dari semua kategori yang diterbitkan untuk ekstensi-ekstensi tertentu. Bila parameternya memiliki sebuah nilai yang disimpan maka ia yang akan dimuat pertama kali pada saat muat halaman. Jika tidak, maka nilai standarnya (kalau ada) yang akan dipilih. Bila atribut show_root adalah 1, opsi pertama pada daftar akan berupa string yang mewakili kategori pangkal (yang dapat diterjemahkan sebagai string) dan 0 adalah nilai yang diberikan.
- type (wajib) harus berupa category.
- name (wajib) adalah nama unik dari parameternya.
- label (wajib) (dapat diterjemahkan) adalah judul dari kolom tersebut.
- extension (wajib) adalah nama ekstensinya dimana kategori-kategori tersebut akan ditarik. Contoh, untuk membuat daftar kategori konten, gunakan nilai 'com_content'.
- scope (opsional) adalah alias untuk ekstensi.
- show_root (opsional) adalah, yang menentukan apakah pilihan yang mewakili pangkat kategori akan ditampilkan atau tidak.
- default (opsional) adalah nomor ID kategori standar.
- description (opsional) (dapat diterjemahkan) adalah tulisan yang ditampilkan di tooltip ketika pengguna menggerakkan mouse mereka keatas kotak dropdown.
- class (opsional) adalah nama kelas CSS untuk HTML kolom form. Jika tidak ada atau dihilangkan, maka standarnya akan ke 'inputbox'.
- published (opsional) (1/0/2/-2) adalah, yang menentukan apakah dropdown akan menampilkan kategori-kategori yang diterbitkan (1) saja, atau yang tidak diterbitkan (0), atau yang diarsipkan (2), atau sampah (-2). Disarankan untuk menerbitkan penggabungan status penerbitan yang berbeda-beda dengan memasukkan nomor-nomor terkait dipisahkan tanda koma (misal, "0,2,-2" akan menampilkan yang tidak diterbitkan saja, diarsipkan dan sampah didalam dropdown).
- multiple (opsional) (true/false) adalah kemampuan untuk menambahkan lebih dari 1 kategori ke kolom form.
Diimplementasikan oleh libraries/legacy/form/field/category.php.
Contoh definisi parameter XML:
<field name="mycategory" type="category" extension="com_content" label="Select a category" description="" />