Menyisipkan Kode Saat Baris Record Ditampilkan di Aplikasi Web dari PHPMaker

Sudah banyak kemudahan yang dapat digunakan oleh Web Developer ketika membuat Aplikasi Web dengan menggunakan PHPMaker seperti yang sudah diuraikan di artikel-artikel saya sebelumnya. Rasanya sayang sekali jika kemudahan yang sudah tersedia itu tidak dioptimalkan. Apalagi jika ternyata masih ada kemudahan-kemudahan lainnya yang perlu diketahui oleh Web Developer. Di antaranya, PHPMaker memberi kesempatan kepada Web Developer untuk menambahkan kode tertentu sebelum sistem mengeluarkan kode HTML untuk sebuah Record atau kumpulan beberapa Record ke browser Pengguna.

PHPMaker sudah menyediakan sebuah server event yang bernama Row_Rendering yang lokasinya berada di bawah Server Events -> Table-Specific -> Common pada project PHPMaker Anda. Pastikan sebelumnya Anda sudah memilih salah satu Table yang Anda inginkan dari panel Database di sebelah kiri dari project PHPMaker Anda, untuk memastikan Anda menambahkan kode di server event pada Table yang tepat.

Sesuai dengan namanya, server event ini akan dipanggil sebelum sistem me-render atau mengeluarkan tampilan sebuah Record ke browser Pengguna. Dengan kata lain, server event ini berguna untuk menerapkan pengaturan View Tag atau Edit Tag tanpa melalui pengaturan manual yang Anda lakukan pada fitur Fields setup di project PHPMaker Anda.

Jika Anda masih ingat dengan pengaturan yang bisa Anda tentukan melalui Fields setup, maka untuk setiap Field pada suatu Table, PHPMaker sudah menyediakan di bagian View Tag dan Edit Tag. Anda sebagai Web Developer bisa mengeset pengaturan-pengaturan di kedua bagian itu sebelum men-generate file script dengan menggunakan PHPMaker.

Nah, kode yang Anda tulis di server event Row_Rendering berguna jika Anda sebagai Web Developer ingin menerapkan pengaturan-pengaturan yang terdapat di bagian View Tag dan Edit Tag dalam Fields setup project PHPMaker tersebut berdasarkan kondisi tertentu.

Mari kita lihat contoh di bawah ini. Katakanlah kita ingin melihat properties apa saja yang dimiliki oleh field yang bernama NamaFieldKu, maka cukup tambahkan kode var_dump($this->NamaFieldKu); ke dalam server event Row_Rendering sehingga akan kelihatan kode selengkapnya menjadi seperti ini:

// Row Rendering event
function Row_Rendering() {
	// Enter your code here	
	var_dump($this->NamaFieldKu);
}

Jangan lupa untuk men-generate ulang file script Aplikasi Web tersebut dengan menggunakan PHPMaker, lalu jalankan Aplikasi Web tersebut dari browser untuk melihat output dari properties field NamaFieldKu tadi.

Setelah kita mengetahui properties apa saja (beserta nilainya) yang dimiliki oleh field NamaFieldKu, maka kita bisa menggunakan kode berikut ini untuk membuat tampilan teks di field tersebut menjadi cetak tebal (Bold):

// Row Rendering event
function Row_Rendering() {
	// Enter your code here	
	$this->NamaFieldKu->ViewAttrs["style"] = "font-weight: bold;";
}

Perlu diketahui, bahwa server event Row_Rendering akan dipanggil di semua halaman (List, Add, Edit, Delete, View, Update, Search). Oleh karena itu, jika Anda hanya ingin menerapkan kode yang Anda inginkan hanya pada halaman tertentu, Anda bisa menggunakan Global Function CurrentPageID() untuk memeriksa ID halaman yang bertalian. Contoh, dari kode di atas tadi, kita hanya ingin menerapkannya pada halaman View saja, maka kode di atas cukup kita ubah menjadi seperti di bawah ini:

// Row Rendering event
function Row_Rendering() {
        // Enter your code here	
        if (CurrentPageID() == "view") 
            $this->NamaFieldKu->ViewAttrs["style"] = "font-weight: bold;";
}

Jika kita tidak menambahkan pemeriksaan kondisi untuk halaman View, maka kode di atas akan diterapkan juga di halaman lainnya yang menggunakan property ViewAttrs, yaitu halaman List.

Wouw! Betapa mudahnya bukan? 🙂