Klien menelepon karena tampilan situsnya berubah sendiri setelah memperbarui tema. Ternyata semua perubahan warna dan jarak yang ia tulis langsung di file tema hilang tertimpa update. Kejadian ini berulang hampir setiap minggu pada pengguna WordPress baru. Tujuh kesalahan di bawah ini menjelaskan penyebabnya dan cara memperbaikinya sebelum situs rusak.
1. Mengedit File Tema Induk Langsung
Menu Appearance > Theme File Editor di dasbor WordPress memang memudahkan. Klik satu file, simpan, perubahan langsung terlihat. Masalahnya, folder tema di server akan ditimpa seluruhnya saat tema diperbarui. Semua baris kode yang kamu tambahkan hilang tanpa peringatan.
Solusinya memakai child theme. Folder kecil berisi file style.css dengan keterangan template induk, plus file functions.php untuk menampung fungsi tambahan. WordPress akan membaca child theme lebih dulu, lalu menimpa induknya saat ada perubahan pada tema utama. Kalau belum terbiasa dengan alur kerja ini, mulailah dari panduan belajar WordPress untuk pemula supaya urutan konsepnya tidak terbalik.
2. Menaruh Semua Kode di functions.php
functions.php sering dianggap tempat sampah serbaguna. Potongan CSS, skrip pelacak, ukuran gambar, dan pengaturan lainnya ditumpuk jadi satu file. Akibatnya, situs jadi lambat dimuat karena browser harus mengunduh file PHP yang isinya campur aduk, dan kamu sulit mencari baris yang bermasalah ketika terjadi error.
Pisahkan berdasarkan jenisnya:
- Aturan tampilan seperti warna, ukuran font, dan jarak masuk ke style.css child theme.
- Fungsi PHP seperti menambah ukuran gambar atau mendaftarkan menu masuk ke functions.php.
- Skrip JavaScript pihak ketiga idealkan lewat plugin atau dimuat kondisional hanya di halaman tertentu.
Kalau kamu perlu memodifikasi perilaku tema di luar tampilan, misalnya menambah kolom pada halaman admin, pahami dulu cara kerja hook WordPress. Tanpa memahami hook, banyak pemula menempel kode di tempat yang salah dan fungsi tidak pernah dieksekusi.
3. Menyalin Kode dari Internet Tanpa Membaca
Potongan kode dari forum sering ditulis untuk versi WordPress lama atau tema yang berbeda. Menempel mentah-mentah ke functions.php bisa memicu fatal error, dan yang muncul di layar hanya halaman putih polos. Pemulihan lewat FTP atau file manager hosting jadi satu-satunya jalan masuk kembali.
Sebelum menempel, cek tiga hal: apakah kode memakai fungsi yang masih berlaku, apakah ia diberi nama dengan prefix unik agar tidak bentrok dengan plugin lain, dan apakah ada dokumentasi yang menjelaskan efek sampingnya. Nama fungsi seperti my_theme_setup() lebih aman daripada setup() karena plugin lain mungkin memakai nama yang sama.
4. Lupa Menguji Tampilan di Perangkat Lain
Perubahan yang terlihat rapi di layar laptop bisa berantakan di ponsel. Menu navigasi yang panjang, judul yang terlalu besar, dan tabel yang melebar melewati lebar layar adalah gejala umum. Browser desktop memberi ruang yang cukup, sementara layar ponsel memaksa setiap elemen menyesuaikan diri.
Gunakan mode responsif di developer tools browser untuk memeriksa lebar 375 piksel sampai 768 piksel. Perhatikan apakah teks masih nyaman dibaca, apakah tombol cukup besar untuk disentuh, dan apakah gambar tidak memaksa halaman menggulir ke samping. Uji juga dengan mengecilkan ukuran font di pengaturan browser, karena sebagian pengunjung memang melakukannya.
5. Mengubah Tema di Situs yang Sudah Live
Mengaktifkan tema baru secara langsung di situs produksi berisiko besar. Widget bisa berpindah posisi, menu hilang, dan pengaturan kustomizer dari tema lama tidak terbaca. Pengunjung yang sedang membuka halaman mungkin melihat situs setengah jadi selama beberapa menit.
Alur yang lebih aman:
- Buat salinan situs di server lokal atau subdomain staging.
- Aktifkan tema baru di sana dan sesuaikan sampai semua halaman penting tampil benar.
- Ekspor pengaturan kustomizer jika tema mendukung, lalu impor di situs utama.
- Terapkan di jam sepi dan pastikan kamu punya cadangan terbaru.
Beberapa penyedia hosting menyediakan fitur staging bawaan yang membuat proses ini hanya perlu beberapa klik.
6. Mengabaikan Struktur CSS dan Spesifisitas
Pemula sering menambahkan !important setiap kali perubahan tidak terlihat. Cara ini memang cepat, tapi lama kelamaan kode jadi penuh paksaan yang saling bertabrakan. Ketika satu aturan dihapus, muncul masalah baru di tempat lain karena ketergantungan yang tidak disadari.
Pahami dulu urutan prioritas: selector elemen paling lemah, diikuti kelas, baru ID. Kalau perubahanmu tidak berpengaruh, periksa apakah tema memakai selector yang lebih spesifik atau memuat stylesheet setelah milikmu. Susun aturan dari yang umum ke yang khusus, dan simpan !important hanya untuk kasus yang benar-benar memaksa, misalnya menimpa gaya inline dari plugin pihak ketiga. Kalau kamu sering terjebak di berkas CSS yang panjang, pilihan editor dengan fitur pencarian dan pelipatan kode membantu melacaknya lebih cepat, seperti yang dibahas di perbandingan editor kode untuk WordPress.
7. Tidak Memakai Versioning atau Cadangan
Perubahan pada tema adalah kode, dan kode perlu riwayat. Tanpa versioning, kamu tidak bisa kembali ke kondisi yang berfungsi saat ada yang rusak. Tanpa cadangan, satu kesalahan kecil bisa menghapus pekerjaan berhari-hari.
Setidaknya simpan salinan file child theme ke layanan penyimpanan awan setiap kali selesai sesi kerja. Kalau terbiasa memakai Git, jadikan folder child theme sebagai repositori lokal. Sistem kontrol versi juga memudahkan kolaborasi kalau nanti ada orang lain yang membantu mengurus tampilan situs.
Menghindari Kebiasaan yang Sama Berulang
Kesalahan kustomisasi tema WordPress pemula umumnya berasal dari satu akar: mengubah sesuatu tanpa menyiapkan jalan pulang. Child theme, staging, dan pencatatan perubahan menutup sebagian besar celah itu. Mulai dari satu perubahan kecil, uji di beberapa perangkat, lalu simpan salinannya sebelum lanjut ke perubahan berikutnya.
Sempatkan juga mempelajari struktur folder tema yang kamu pakai. Setiap tema punya susunan file yang berbeda, dan mengenali di mana header, footer, serta template halaman berada akan menghemat waktu saat melacak sumber masalah.
Pertanyaan yang Sering Diajukan
Apakah wajib memakai child theme?
Kalau kamu hanya ingin mengubah beberapa warna lewat menu Kustomisasi, child theme belum diperlukan karena pengaturan itu tersimpan di basis data, bukan di file tema. Begitu kamu mulai mengedit file CSS atau PHP, child theme jadi wajib supaya perubahan tidak hilang saat tema diperbarui.
Bagaimana cara memperbaiki situs yang menampilkan halaman putih setelah mengedit functions.php?
Masuk ke hosting lewat FTP atau file manager, lalu ganti nama folder child theme sehingga WordPress otomatis beralih ke tema bawaan. Setelah situs bisa diakses lagi, perbaiki baris kode yang bermasalah atau hapus fungsi tersebut. Menyalakan mode debug di file wp-config.php juga membantu melihat pesan error yang sebenarnya.
Apakah perubahan di kustomizer ikut hilang saat ganti tema?
Pengaturan kustomizer disimpan per tema, jadi tema baru akan memakai nilai bawaannya sendiri. Sebagian tema menyediakan opsi ekspor dan impor pengaturan, tapi tidak semua. Karena itu, catat nilai penting seperti kode warna dan ukuran font di dokumen terpisah sebelum berpindah tema.
