Notes, tips, and tricks with CodeIgniter 2: Helper

Tampilkan postingan dengan label Helper. Tampilkan semua postingan

Rabu, 18 Juli 2012

Konfigurasi Autoload

CI menganjurkan untuk melakukan pemuatan (load) suatu helper atau librari class dilakukan pada saat akan digunakan. Cara ini dilakukan agar tidak terlalu banyak baris program yang harus dimuat dan diinterpretasi oleh PHP di server.

Dalam kondisi tertentu beberapa helper dan librari class banyak digunakan atau hampir selalu digunakan dalam suatu program yang dibuat; seperti helper HTML, URL, dan FORM hampir selalu digunakan oleh program untuk menghasilkan suatu tampilan entri,

Jika kita dapat mengidentifikasi bahwa heper dan librari ini ada hampir pada setiap controller dan fungsi-fungsinya, model, atau viewnya, maka kita bisa membuat agar pemuatan dilakukan secara otomatis oleh CodeIgniter, yang dilakukan dengan menspesifikasikannya dalam file konfigurasi autoload.php.

File autoload.php berada di bawah direktori application/config.

Dalam file autoload.php ini, kita mendefinisikan pemuatan secara otomatis semua helper yang paling sering digunakan, librari class mana yang sering digunakan, dan bisa jadi file model mana saja yang digunakan.

Berikut adalah item-item yang dapat dimuat secara otomatis:

Semua librari class yang ada di bawah folder "libraries"
Semua file helper yang ada di bawah folder "helpers"
File config tambahan yang ditemukan di bawah folder "config"
File-file bahasa yang ada di bawah folder "system/language"
Model-model yang ditemukan dalam folder "models"

Dengan didefinisikan di dalam file autoload.php ini, maka pemrogram tidak perlu melakukan pemuatan lagi di dalam setiap controller, model, atau view yang akan menggunakannya.

Kamis, 12 Juli 2012

Helper HTML: doc_type()

Salah satu luaran yang harus dihasilkan aplikasi yang dikembangkan dengan menggunakan PHP atau framework CodeIgniter adalah dokumen HTML.

Suatu dokumen dinyatakan sebagai dokumen HTML yang benar adalah apabila isi dari dokumen memiliki spesikasi dokumen HTML yang ditandai dengan adanya tag-tag HTML, diawali dengan deklarasi jenis dokumen HTML, kemudian diikuti dengan tag <html>, dan diakhiri dengan </html>. Di antara tag <html> dan </html>, didefinisikan tag dengan struktur yang benar.

Kita dapat memvalidasi apakah dokumen web yang kita susun, secara struktur sudah valid atau belum, dengan menaruh link berikut http://validator.w3.org/check?uri=referer dalam halaman web. Jika link diklik, maka halaman web tersebut akan divalidasi, apakah halaman web tersebut valid sebagai dokumen HTML atau tidak, sesuai dengan standar dokumen HTML atau belum. Jika link validator pada halaman ini diklik, maka akan ditampilkan banyak pesan kesalahan dan peringatan. Karena hasil dari CMS dari blogspot yang digunakan penulis memang belum valid secara dokumen, bisa dikatakan lebih mengutamakan tampilan dan fungsionalitas penampilan.

CI menyediakan fungsi untuk mendeklarasikan halaman web yang dihasilkan menjadi dokumen web dengan standar HTML yang diinginkan, dengan menggunakan fungsi doc_type().

Sintaks:

echo doc_type(opsi);

opsi adalah parameter dari fungsi doc_type() yang mendefinisikan jenis dokumen HTML versi berapa yang diinginkan.

Nilai opsi yang bisa dijadikan parameter adalah sebagai berikut:

Doctype	opsi	Hasil
XHTML 1.1	doctype('xhtml11')	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
XHTML 1.0 Strict	doctype('xhtml1-strict')	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
XHTML 1.0 Transitional	doctype('xhtml1-trans')	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
XHTML 1.0 Frameset	doctype('xhtml1-frame')	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
HTML 5	doctype('html5')	<!DOCTYPE html>
HTML 4 Strict	doctype('html4-strict')	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
HTML 4 Transitional	doctype('html4-trans')	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
HTML 4 Frameset	doctype('html4-frame')	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">

Senin, 09 Juli 2012

Helper Form : form_dropdown()

Helper form form_dropdown() sangat memudahkan pemrogram web untuk melakukan pengeditan data. Jika kita tidak menggunakan helper ini, maka pemrogram harus menambahkan kode tambahan untuk bisa menampilkan data combobox dengan default pilihannya; jika combobox harus dihasilkan secara dinamik.

Jika kita menggunakan HTML statik, maka mendefinisikan item pilihan tidaklah menjadi masalah, karena kita bisa menuliskan selected pada item pilihan tersebut.

Berikut adalah kode HTML statik;

<select id="kodekota" name="kodekota">
<option value="bdg">Bandung</option>
<option value="crb" selected>Cirebon</option>
<option value="jkt">Jakarta</option>
</select>

Jika kita menggunakan PHP standar, maka kita akan membuat program seperti berikut:

<?php
$akodekota=array(
"bdg"=>"Bandung"
,"crb"=>"Cirebon"
,"jkt"=>"Jakarta"
);
$dipilih="crb";
$pilihan="";
foreach($akodekota as $kodekota => $namakota){
$pilihan.="<option value='".$kodekota."' ".(($kodekota==$dipilih)?"selected":"").">";
$pilihan.=$namakota;
$pilihan.="</option>";
}
?>
<select id="" name=""><?=$pilihan;?></select>

Jika kita menggunakan CodeIgniter dan menggunakan helper form form_dropdown(), maka kita bisa dengan sangat mudah. Berikut adalah kodenya:

<?php

$akodekota=array(

"bdg"=>"Bandung"

,"crb"=>"Cirebon"

,"jkt"=>"Jakarta"

);

$dipilih="crb";

echo form_dropdown("kodekota",$akodekota,$dipilih);

Sabtu, 07 Juli 2012

Helper Form: form_label()

Jika kita membuat form untuk input, maka kita akan memberikan teks atau prompt di sebelah kiri atau di atas dari elemen inputnya. Teks atau prompt ini digunakan untuk memberikan keterangan kepada pengguna aplikasi tentang data apa yang harus dimasukkan ke dalam elemen input yang disajikan tersebut.

Bentuk form entri secara umum:

Login
Nama user : |___________|
Password : |___________|

|Login| |Cancel|

Kita bisa menggunakan elemen tabel agar tampilannya lebih rapi atau menggunakan CSS untuk mengatur letak dari elemen input.

Kita dapat menggunakan CSS untuk dapat merapikan tampilan, sehingga antara prompt dan elemen input dapat ditampilkan berdampingan seperti menggunakan tabel, atau pun berbeda baris.

Untuk menampilkan prompt untuk suatu elemen, maka prompt ditampilkan dengan menggunakan teks biasa.

Jika kita melihat pada pemrograman di lingkungan dengan antarmuka grafikal, maka kita sering disediakan fitur, jika kita klik promptnya, maka kita akan mendapatkan kursor kita pada elemen input. Fitur mengklik pada prompt atau pun nilai dari suatu pilihan itu sama dengan mengklik pada elemen inputnya; sehingga pengguna bisa lebih dimudahkan.

Elemen form HTML pun telah dilengkapi untuk memudahkan pengguna bisa mengklik prompt atau nilainya saja, tidak perlu mengklik elemen inputnya untuk bisa membuat kursor fokus pada elemen inputnya.

Elemen HTML yang digunakan untuk membuat kemudahan ini adalah elemen label, dengan tag <label> Teks </label>.

Contoh:

<label for="idelemeninput">Teks/Prompt</label>
<input type="text" id="idelemen" name="idelemen" value="">

Tag label jika ingin dapat berfungsi untuk memudahkan pemfokusan kepada elemen input, maka tag label selalu dipasangkan dengan elemen inputnya. Di dalam tag label kita harus menambahkan atribut for yang diisi dengan idelemen yang akan diberi fokus, jika teks atau prompt dari label diklik.

Jika kita menggunakan CodeIgniter, maka kita dapat dengan mudah untuk menyatakan label untuk suatu elemen input.

Untuk contoh di atas, maka kita dapat menyatakan dengan cara berikut:

<?php
echo form_label("Teks/Prompt","idelemen");
echo form_input("idelemen");
?>

Elemen atau tag label ini jarang digunakan oleh pemrogram aplikasi web, apalagi jika pemrogram lebih banyak menggunakan tabel untuk membuat layout dari form entrinya.

Rabu, 04 Juli 2012

Membuat Form Dengan Helper Form

Form adalah elemen dalam elemen dalam suatu halaman web yang digunakan untuk menerima input dari pengguna aplikasi atau pengunjung halaman web kita.

Dalam pemrograman web tanpa framework, kita akan menyusun form dengan menuliskan tag-tag elemen input form secara manual, seperti berikut:

<form action="simpankomentar.php" method="post">
<label>Nama :</label>
<input type="text" name="namapengunjung" size="50" maxlength="75">
<br />
<label>Email :</label>
<input type="text" name="email" size="50" maxlength="75">
<br />
<label>Komentar :</label>
<textarea rows="5" cols="40" name="komentar"></textarea>
<br />
<button type="submit">Kirim</button>
</form>

Form dinyatakan di dalam file view.

Jika kita menggunakan CodeIgniter, maka kita dimudahkan untuk bisa menampilkan form, dengan menggunakan helper form. Setiap elemen input dari form dinyatakan terlebih dahulu dengan menggunakan array asosiatif, kemudian menggunakan fungsi helper untuk setiap elemen input, untuk menghasilkan tag elemen input form.

Berikut adalah kode yang sama, yang akan menghasilkan form yang sama:

<?php
$aksi="simpankomentar";
$namapengunjung=array(
"name"=>"namapengunjung"
,"size"=>"50"
,"maxlength"=>"100"
);
$email=array(
"name"=>"email"
,"size"=>"50"
,"maxlength"=>"100"
);
$komentar=array(
"name"=>"komentar"
,"rows"=>"5"
,"cols"=>"40"
);
echo form_open($aksi);
echo form_label("Nama : ").form_input($namapengunjung);
echo br();
echo form_label("Email : ").form_input($email);
echo br();
echo form_label("Komentar : ").form_textarea($komentar);
echo br();
echo form_close();
?>

CodeIgniter mendefinisikan setiap elemen form secara default akan memiliki method post, karenanya fungsi form_open() hanya membutuhkan parameter nama script aksi, yang akan memroses data yang akan dikirimkan oleh browser.

Minggu, 01 Juli 2012

Helper HTML : br()

Helper HTML CI br() digunakan untuk menghasilkan elemen ganti baris, yaitu <br />

Fungsi helper br() ini ternyata dapat memiliki parameter berupa nilai integer yang digunakan untuk menghasilkan berapa kali <br /> harus dihasilkan.

Dengan parameter ini, maka kita tidak perlu menulis echo br(); berkali-kali untuk menghasilkan sejumlah <br />, tetapi cukup dengan echo br(5); untuk menghasilkan <br /> sejumlah 5 kali.

Berikut adalah contoh view yang digunakan untuk menunjukkan penggunaan br():

<?php
$this->load->helper("html");
echo doctype("html");
?>
<html>
<head>
<title>Demo Menggunakan br()</title>
</head>
<body>
<?php
echo heading("Demo Menggunakan br()",1);
echo "<p>Baris pertama dalam paragraf";
echo br(5);
echo "Baris ketujuh dalam paragraf";
?>
</body>
</html>
?>

View di atas, digunakan untuk menampilkan satu paragraf, tetapi baris pertama dan ketujuh terpisah dengan baris kosong. Baris kosong dihasilkan oleh fungsi br();

Sabtu, 30 Juni 2012

Helper CI

Helper dalam CI adalah kumpulan fungsi yang disediakan oleh CI untuk memudahkan pengembang aplikasi web. CI mengelompokkan fungsi-fungsi ke dalam beberapa kelompok fungsi sesuai dengan peruntukkannya.

Helper CI dikelompokkan menjadi:

Array
Captcha
Cookie
Date
Directory
Download
Email
File
Form
HTML
Inflector
Language
Number
Patch
Security
Smiley
String
Text
Typography
URL
XML

Pemuatan Helper

Agar kita bisa menggunakan helper, maka kita harus melakukan pemuatan (loading) terlebih dahulu. Pemuatan helper ini dilakukan pada file yang akan menggunakan fungsi.

Perintah pemuatan:

$this->load->helper("namakelompokhelper");

Contoh Penggunaan Helper

Salah satu kelompok helper adalah HTML, kita bisa menggunakan helper ini untuk memudahkan menghasilkan elemen HTML utama, beberapa di antaranya adalah:

heading
Digunakan untuk menghasilkan elemen <h1> sampai dengan <h6>
img
Digunakan untuk menuliskan elemen image yang akan ditampilkan <img>
ol dan ul
Digunakan untuk memudahkan menghasilkan daftar item, dengan nomor atau dengan bullet
doctype
Digunakan untuk mendefinisikan jenis dokumen HTML yang dihasilkan
meta
Digunakan untuk menuliskan data deskripsi tentang dokumen HTML

Helper HTML lebih cocok untuk dimuat pada file view, karena peruntukannya untuk menuliskan elemen HTML.

Berikut adalah contoh file view yang menggunakan helper HTML:

<?php
$this->load->helper("html");
echo doctype("html");
?>
<html>
<head>
<title>Demo Menggunakan Helper</title>
</head>
<body>
<?php
echo heading("Demo Menggunakan Helper",1);
echo heading("Beberapa helper",2);
$daftarhelper=array("html","url","string");
echo ul($daftarhelper);
?>
</body>
</html>
?>

Jika kita tidak menggunakan view, makan kita bisa menggunakannya di dalam controller yang memang tidak memerlukan view.