Ketika mengembangkan situs dengan WordPress, Anda sering perlu menyimpan informasi tambahan yang tidak disediakan editor standar. Misalnya harga produk, lokasi acara, atau tautan referensi di setiap pos. Custom field menyimpan data itu. Anda bisa membuatnya sendiri tanpa plugin, cukup dengan beberapa baris kode di tema atau plugin kustom.
Apa Itu Custom Field dan Mengapa Anda Membutuhkannya?
Custom field adalah pasangan kunci-nilai (key-value) yang disimpan di tabel wp_postmeta. Kunci adalah nama field, nilai adalah datanya. WordPress menyediakan antarmuka bawaan untuk custom field, tetapi tampilannya kurang ramah dan mudah disalahgunakan. Dengan membuat custom field sendiri, Anda bisa mengatur tampilan, validasi, dan lokasi penyimpanan data lebih rapi.
Kapan sebaiknya menggunakan custom field?
Gunakan custom field ketika Anda perlu menyimpan data terstruktur yang akan ditampilkan di halaman depan atau dipakai kode lain. Contohnya, Anda membuat tipe pos “Buku” dan ingin menyimpan nama penulis, tahun terbit, dan ISBN. Data ini tidak perlu tampil di editor konten, tetapi harus bisa diakses template.
Persiapan Sebelum Menulis Kode
Anda perlu mengakses file tema atau membuat plugin kustom. Sebaiknya gunakan child theme agar perubahan tidak hilang saat tema diperbarui. Pahami dulu cara kerja hook WordPress untuk pemula karena kita akan memakai beberapa hook.
Siapkan editor kode favorit dan backup situs sebelum melakukan perubahan.
Langkah 1: Membuat Meta Box untuk Menampilkan Field
Meta box adalah kotak yang muncul di halaman edit pos. Kita membuatnya dengan fungsi add_meta_box(). Letakkan kode berikut di functions.php child theme atau di file plugin kustom.
function wpdocs_add_custom_meta_box() {
add_meta_box(
'wpdocs_custom_meta',
'Informasi Buku',
'wpdocs_render_meta_box',
'post',
'normal',
'high'
);
}
add_action( 'add_meta_boxes', 'wpdocs_add_custom_meta_box' );
Fungsi wpdocs_render_meta_box kita definisikan pada langkah berikutnya. Parameter 'post' bisa diganti dengan tipe pos lain, misalnya 'page' atau custom post type.
Langkah 2: Menampilkan Form Field di Meta Box
Buat fungsi callback untuk merender HTML form. Di sini kita membuat field untuk penulis, tahun terbit, dan ISBN.
function wpdocs_render_meta_box( $post ) {
// Ambil nilai yang sudah ada
$penulis = get_post_meta( $post->ID, '_wpdocs_penulis', true );
$tahun = get_post_meta( $post->ID, '_wpdocs_tahun', true );
$isbn = get_post_meta( $post->ID, '_wpdocs_isbn', true );
// Tambahkan nonce untuk keamanan
wp_nonce_field( 'wpdocs_save_meta', 'wpdocs_meta_nonce' );
?>
<p>
<label for="wpdocs_penulis">Penulis:</label>
<input type="text" id="wpdocs_penulis" name="wpdocs_penulis" value="<?php echo esc_attr( $penulis ); ?>" />
</p>
<p>
<label for="wpdocs_tahun">Tahun Terbit:</label>
<input type="number" id="wpdocs_tahun" name="wpdocs_tahun" value="<?php echo esc_attr( $tahun ); ?>" />
</p>
<p>
<label for="wpdocs_isbn">ISBN:</label>
<input type="text" id="wpdocs_isbn" name="wpdocs_isbn" value="<?php echo esc_attr( $isbn ); ?>" />
</p>
<?php
}
Perhatikan penggunaan wp_nonce_field() untuk mencegah serangan CSRF. Lakukan sanitasi dan validasi saat menyimpan data.
Langkah 3: Menyimpan Nilai Custom Field
Gunakan hook save_post untuk menyimpan data ketika pos disimpan. Periksa nonce, hak akses pengguna, dan apakah ini autosave.
function wpdocs_save_meta_box( $post_id ) {
// Verifikasi nonce
if ( ! isset( $_POST['wpdocs_meta_nonce'] ) ) {
return;
}
if ( ! wp_verify_nonce( $_POST['wpdocs_meta_nonce'], 'wpdocs_save_meta' ) ) {
return;
}
// Cek autosave
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
// Cek hak akses
if ( ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
// Sanitasi dan simpan
if ( isset( $_POST['wpdocs_penulis'] ) ) {
update_post_meta( $post_id, '_wpdocs_penulis', sanitize_text_field( $_POST['wpdocs_penulis'] ) );
}
if ( isset( $_POST['wpdocs_tahun'] ) ) {
update_post_meta( $post_id, '_wpdocs_tahun', absint( $_POST['wpdocs_tahun'] ) );
}
if ( isset( $_POST['wpdocs_isbn'] ) ) {
update_post_meta( $post_id, '_wpdocs_isbn', sanitize_text_field( $_POST['wpdocs_isbn'] ) );
}
}
add_action( 'save_post', 'wpdocs_save_meta_box' );
Fungsi update_post_meta() memperbarui nilai jika sudah ada atau menambah baru jika belum ada. Anda juga bisa memakai add_post_meta() jika ingin selalu menambah baris baru, tetapi untuk custom field biasanya update lebih tepat.
Langkah 4: Menampilkan Data di Tema
Untuk menampilkan nilai custom field di halaman depan, gunakan get_post_meta() di dalam loop. Contohnya, di file single.php:
$penulis = get_post_meta( get_the_ID(), '_wpdocs_penulis', true );
if ( $penulis ) {
echo '<p>Penulis: ' . esc_html( $penulis ) . '</p>';
}
Selalu gunakan esc_html() atau esc_attr() saat menampilkan data untuk mencegah XSS.
Tips dan Praktik Terbaik
- Gunakan awalan unik (misalnya
_wpdocs_) pada nama meta key untuk menghindari konflik dengan plugin lain. - Simpan data dengan tipe yang sesuai (string, integer, array) dan sanitasi dengan fungsi yang tepat.
- Untuk field yang kompleks, pertimbangkan penggunaan custom post type daripada custom field.
- Manfaatkan shortcode WordPress untuk menampilkan data custom field di dalam konten.
Jika Anda ingin mempelajari pengelolaan data di WordPress lebih lanjut, lihat juga panduan optimasi database WordPress agar performa tetap cepat.
Untuk pengembangan aplikasi mobile, Anda bisa membaca tips menampilkan data di SwiftUI untuk pemula yang mungkin relevan dengan penyajian data.
Jika Anda bekerja dengan API, perbandingan format data untuk API internal Java bisa menjadi referensi.
Untuk berita terkini seputar teknologi dan pemrograman, kunjungi indowarta yang menyajikan informasi berdasarkan fakta dari penulis berpengalaman.
Pertanyaan yang Sering Diajukan
Apakah custom field bisa digunakan untuk menyimpan data di halaman (page)?
Bisa. Pada fungsi add_meta_box(), ganti parameter tipe pos menjadi 'page' atau tipe pos kustom yang Anda inginkan.
Bagaimana cara menampilkan custom field di editor blok (Gutenberg)?
Anda perlu mendaftarkan meta field dengan register_meta() dan menambahkan komponen di editor blok menggunakan JavaScript. Alternatifnya, gunakan plugin seperti Advanced Custom Fields untuk antarmuka yang lebih mudah.
Apakah data custom field aman jika tema diperbarui?
Data custom field disimpan di database, bukan di file tema. Memperbarui tema tidak akan menghapus data. Namun, kode untuk menampilkan dan menyimpan field harus tetap ada di child theme atau plugin kustom agar tidak hilang.


