Kamu sedang menulis tutorial di WordPress dan ingin menyisipkan kotak catatan dengan desain konsisten di setiap artikel. Menempel HTML yang sama berulang kali melelahkan, apalagi kalau nanti desainnya harus diubah. Shortcode menyelesaikan masalah ini: kamu menulis potongan pendek seperti [catatan], dan WordPress menggantinya dengan HTML lengkap saat halaman dirender.
Membuat shortcode sendiri tidak memerlukan plugin. Semua bisa dikerjakan lewat fungsi kecil di child theme, asalkan kamu memahami cara mendaftarkannya agar tidak memicu error.
Apa yang Perlu Disiapkan Sebelum Menulis Shortcode
Shortcode adalah fungsi PHP yang didaftarkan dengan add_shortcode(). Fungsi ini menerima dua parameter: nama tag yang akan kamu tulis di editor, dan nama fungsi callback yang menghasilkan output.
Letakkan kode di functions.php milik child theme, bukan tema induk. Kalau kamu belum punya child theme, buat dulu supaya perubahan tidak hilang saat tema diperbarui. Saat menempel kode, ikuti prinsip dasar cara menulis kode di functions.php tanpa merusak situs agar satu kesalahan sintaks tidak membuat halaman putih.
Sebelum mulai, siapkan akses ke file via FTP atau File Manager hosting. Kalau situs error setelah menyimpan kode, kamu bisa langsung memperbaikinya tanpa menunggu dashboard WordPress terbuka.
Langkah 1: Daftarkan Shortcode Sederhana
Mulai dari yang paling dasar, shortcode tanpa atribut. Contoh berikut menghasilkan kotak catatan dengan teks tetap.
function webdeki_shortcode_catatan() {
return '<div class="kotak-catatan">Ini catatan penting.</div>';
}
add_shortcode( 'catatan', 'webdeki_shortcode_catatan' );
Fungsi callback mengembalikan string, bukan mencetaknya dengan echo. Kalau kamu memakai echo, shortcode akan tampil di posisi yang salah, biasanya meloncat ke atas konten. Ini kesalahan paling sering terjadi saat pertama kali membuat shortcode.
Setelah disimpan, buka editor blok, tambahkan blok Shortcode, dan tulis [catatan]. Pratinjau di frontend akan menampilkan div dengan kelas kotak-catatan. Tambahkan CSS-nya di child theme supaya tampilannya sesuai keinginan.
Langkah 2: Tambahkan Atribut agar Isi Bisa Berubah
Shortcode statis jarang dipakai lebih dari sekali. Shortcode yang menerima parameter, misalnya teks dan jenis kotak, jauh lebih berguna.
function webdeki_shortcode_catatan( $atts ) {
$atts = shortcode_atts( array(
'tipe' => 'info',
'judul' => '',
), $atts, 'catatan' );
$judul = $atts['judul'] ? '<strong>' . esc_html( $atts['judul'] ) . '</strong><br>' : '';
$isi = $atts['isi'] ?? '';
return '<div class="kotak-catatan kotak-' . esc_attr( $atts['tipe'] ) . '">'
. $judul . do_shortcode( $isi )
. '</div>';
}
add_shortcode( 'catatan', 'webdeki_shortcode_catatan' );
shortcode_atts() memberi nilai default saat atribut tidak diisi. Pemakaian di editor jadi seperti ini:
[catatan tipe="peringatan" judul="Jangan dilewati"]Backup dulu sebelum mengubah tema.[/catatan]
Isi di antara tag pembuka dan penutup ditangani lewat parameter ketiga callback, yaitu $content. Untuk menangkapnya, tambahkan parameter tersebut di definisi fungsi: function webdeki_shortcode_catatan( $atts, $content = null ). Tanpa parameter itu, teks di dalam shortcode akan hilang.
Perhatikan juga penggunaan esc_html() dan esc_attr(). Setiap atribut yang berasal dari input penulis harus disanitasi. Shortcode yang tidak membersihkan output membuka celah penyisipan skrip kalau suatu saat akun dengan hak terbatas ikut mengedit artikel.
Langkah 3: Uji di Berbagai Konteks
Shortcode tidak hanya berjalan di konten postingan. Widget teks, blok reusabel, dan beberapa kolom page builder juga memprosesnya. Cek tampilan di halaman statis dan di arsip. Kalau kamu menaruh shortcode di sidebar, pahami dulu perbandingan cara menampilkan konten di sidebar WordPress karena tidak semua metode widget menjalankan shortcode secara default.
Perhatikan juga excerpt dan hasil pencarian. Shortcode yang menghasilkan markup panjang bisa merusak ringkasan otomatis. Solusinya, daftarkan filter pada get_the_excerpt atau batasi shortcode tertentu hanya tampil di halaman tunggal dengan pengecekan is_singular().
Membangun fitur yang rapi di WordPress punya kemiripan dengan membangun aplikasi di platform lain: struktur kode dan pemisahan tanggung jawab menentukan seberapa mudah proyek dirawat. Kalau kamu ingin melihat pendekatan serupa di ekosistem mobile, panduan 7 langkah membangun aplikasi iOS dengan SwiftUI untuk pemula memperlihatkan bagaimana komponen kecil disusun menjadi layar utuh.
Langkah 4: Kelompokkan Shortcode di Satu File
Menaruh semua shortcode di functions.php membuat file itu cepat membengkak. Setelah punya tiga atau empat shortcode, pindahkan ke file terpisah, misalnya inc/shortcodes.php, lalu panggil dari functions.php:
require_once get_stylesheet_directory() . '/inc/shortcodes.php';
Gunakan get_stylesheet_directory() untuk child theme dan get_template_directory() kalau kode memang berada di tema induk. Membedakan keduanya penting ketika tema induk diperbarui.
Beri awalan unik pada nama fungsi, misalnya webdeki_, untuk menghindari bentrok dengan plugin lain. Nama fungsi PHP bersifat global, jadi dua plugin yang memakai nama shortcode_catatan() akan memicu fatal error.
Di sisi server, kerapian struktur proyek juga berpengaruh pada kemudahan deployment. Contoh penerapannya bisa dilihat pada panduan langkah demi langkah menyusun struktur proyek Java intranet yang membagi kode berdasarkan lapisan aplikasi.
Kesalahan yang Sering Terjadi
- Memakai
echodi dalam callback sehingga output muncul di luar area konten. - Lupa menambahkan parameter
$contentpadahal shortcode ditulis berpasangan. - Tidak memakai
shortcode_atts(), sehingga atribut kosong memicu peringatan PHP. - Menulis shortcode di dalam blok HTML kustom tanpa blok Shortcode, sehingga tag tampil sebagai teks biasa.
- Menaruh kode di tema induk, lalu kehilangan semuanya setelah pembaruan tema.
Untuk shortcode yang menghasilkan banyak elemen berulang, pertimbangkan pendekatan lain seperti menampilkan data custom post type lewat loop. Shortcode cocok untuk sisipan kecil, sedangkan daftar panjang lebih baik dikelola sebagai template.
Saat mencari referensi tambahan di internet, pilih sumber yang jelas proses editorialnya. Situs seperti indowarta menerbitkan berita dengan penulis yang tercatat dan menyandarkan tulisan pada fakta, bukan opini sepihak, sehingga lebih aman dijadikan bahan pembanding.
Ringkasan
Membuat shortcode WordPress tanpa plugin terdiri dari empat langkah: daftarkan fungsi dengan add_shortcode(), kembalikan output sebagai string, tambahkan atribut lewat shortcode_atts(), dan sanitasi setiap nilai yang masuk. Simpan kode di child theme, beri awalan unik pada nama fungsi, dan uji di halaman maupun arsip sebelum dipakai di banyak artikel.
Pertanyaan yang Sering Diajukan
Apakah shortcode bisa dipakai di dalam widget?
Bisa, asalkan widget atau blok yang kamu pakai menjalankan shortcode. Blok Shortcode dan widget Teks klasik umumnya memprosesnya, sedangkan beberapa widget khusus perlu filter tambahan pada widget_text.
Kenapa shortcode saya tampil sebagai teks biasa?
Biasanya karena tag ditulis di dalam blok HTML kustom atau paragraf yang di-escape. Ganti ke blok Shortcode, dan pastikan nama tag di editor sama persis dengan nama yang didaftarkan, termasuk huruf kecilnya.
Apa shortcode tetap bekerja setelah ganti tema?
Selama kode dipindahkan ke tema baru atau dijadikan plugin kecil, shortcode tetap berfungsi. Kalau kode hanya ada di tema lama, tag akan tampil mentah di halaman setelah tema diganti.


