Entri Data dengan Form

Saya sendiri amazed karena Drupal memberikan cara yang begitu mudah untuk mendayagunakan form. It's a snap!

Mari kita membuat form sederhana: entri data biodata. Tujuan tutorial
ini adalah memperkenalkan struktur kode dasar untuk mengolah form,
mulai dari mendefinisikan form, validasi, hingga submit. Supaya lebih
jelas, bisa langsung dicoba di menu sebelah kiri: Tutorial Form.

1. Struktur Dasar Form

Form di Drupal sangat sederhana. Untuk membuat form, kita tinggal
membayangkan nama form nya (misal: biodata), kemudian membuat struktur
kode dasar seperti ini:

Perhatikan dispatcher nya... Cara menampilkan form ini adalah
melalui fungsi drupal_get_form() dengan parameter nama fungsi yang
memuat definisi form.

$items[] = array(
'path' => 'dqs_form',
'title' => 'Tutorial Form',
'callback' => 'drupal_get_form',
'callback arguments' => array('dqs_form_biodata'),
'access' => user_access('dqs_form user'),
'type' => MENU_NORMAL_ITEM
);

Form ini sangat fleksibel, bisa ditampilkan dimana saja. Misalnya
untuk menampilkan form filter di setiap halaman. Caranya mudah, tinggal
dirender sebagai output seperti biasa.

$output .= drupal_get_form('dqs_form_biodata');
return $output;

2. Definisikan Form

Ini adalah bagian yang seru, karena kita bebas menempatkan elemen
form disini, seperti: textbox, select, radio. Simpelnya, tinggal copy
paste dari contoh kode nya

Dalam contoh ini saya menggunakan fieldset untuk pengelompokan
elemen. Fieldset juga akan memberikan efek collasible yang keren.
Silakan diubah kodenya untuk melihat efek perubahannya.

$form['bio'] = array(
'#type' => 'fieldset',
'#title' => 'Biodata',
'#description' => 'Mohon melengkapi biodata Anda.',
'#collapsible' => TRUE,
'#collapsed' => FALSE,
);

Perhatikan bahwa dalam definisi elemen form lainnya, saya selalu
gunakan prefix ['bio'] untuk menandai bahwa elemen-elemen ini masuk
dalam kelompok fieldset yang sama.

Untuk elemen seperti select dan radio, perhatikan atribut #options.
Ini yang akan menjadi daftar item elemen form select dan radio.
Perhatikan bahwa ini harus diisi dengan array berpasangan
key=>value. Nilai key ini yang akan kita proses jika form sudah
disubmit. Jika Anda ingin set atribut #default_value, pastikan diisi
dengan key yang sesuai.

Oh satu hal penting lagi. Jangan pernah lupa bahwa di akhir fungsi definisi form harus selalu ada:

  return $form;

Kadang kita dibikin pusing kok form tidak tampil, ternyata seringkali kita melupakan satu baris sederhana ini.

3. Validasi Form

Disini kita bebas menuliskan kode untuk validasi form, misal:
memastikan format tanggal sudah ditulis dengan benar, atau memastikan
field angka benar-benar ditulis angka (bukan huruf).

Setiap nilai elemen yang di-submit dievaluasi melalui variabel
$field_values. Untuk mendapatkan hasil form yang sudah di-submit,
tinggal akses sesuai nama elemen pada saat mendefinisikan form, contoh:

$nama = $field_values['nama'];
$kota = $field_values['kota'];

Jika validasi gagal, kita tinggal tampilkan pesan kepada user dengan menggunakan fungsi form_set_error, contohnya:

form_set_error('biodata', 'Nama Lengkap harus memuat minimal 5 karakter.');

Silakan dicoba dari menu Tutorial Form, dalam kondisi Nama Lengkap
masih kosong, coba klik submit. Pesan error yang cukup manis kan

4.Submit Form

Disini kita bisa melakukan pengolahan apapun terhadap isi variabel
$form_values, misal disimpan ke database. Jika pengolahan berhasil,
kita bisa memberi pesan kepada user, kali ini dengan fungsi drupal_set_message, contoh:

drupal_set_message("Data $nama (Kelamin: $kelamin, Kota: $kota) sudah tersimpan.");

Satu hal yang penting, dalam fungsi submit ini kita tidak bisa
menampilkan/merender output. Yang dapat kita lakukan adalah redirect ke
halaman lain. Jika biodata berhasil disimpan, mungkin kita ingin
redirect ke halaman yang memuat tabel biodata. Cara redirect:

drupal_goto('dqs_form/result');

Kode tersebut akan me-redirect ke dispatcher "dqs_form/result", jika
dilihat di daftar dispatcher, sebenarnya ini hanya memanggil fungsi
dqs_form_result().

function dqs_form_result() {
$output = theme_box('',"Halaman ini dapat disempurnakan lebih lanjut, misal dengan tabel.");
return $output;
}

5. Voila!

That's it. Sangat mudah kan... langsung saja, copy paste... selamat bermain dengan form