Mengalami error setelah memperbarui (update) plugin di WordPress biasanya disebabkan oleh konflik kode, inkompatibilitas versi PHP, atau bentrok dengan plugin/tema lain. Langkah penanganan tercepat adalah menonaktifkan plugin yang bermasalah melalui File Manager hosting atau akses FTP, lalu mengembalikan (rollback) ke versi sebelumnya.
Jika situs Anda mengalami White Screen of Death (layar putih total) atau pesan Critical Error tepat setelah tombol update diklik, Anda tidak perlu panik. Ikuti panduan pemulihan teknis di bawah ini untuk mengembalikan situs web Anda agar bisa diakses kembali secara normal.
Langkah Pemulihan Cepat (Troubleshooting)
| Metode | Tingkat Kesulitan | Kondisi Penggunaan |
|---|---|---|
| Nonaktifkan via File Manager/FTP | Menengah | Admin WordPress terkunci / tidak bisa login |
| Rollback Versi Plugin | Mudah | Plugin baru menyebabkan bug fatal |
| Aktifkan WP_DEBUG | Menengah | Mencari baris kode penyebab error |
1. Menonaktifkan Plugin Bermasalah via File Manager
Jika Anda tidak dapat mengakses dashboard admin WordPress, Anda harus mematikan plugin langsung dari direktori server hosting Anda:
- Login ke cPanel atau panel hosting Anda, lalu buka File Manager.
- Navigasi ke direktori instalasi WordPress Anda (biasanya di
public_html), lalu masuk ke folderwp-content/plugins/. - Cari folder yang sesuai dengan nama plugin yang baru saja Anda update.
- Ubah nama (rename) folder plugin tersebut (contoh: dari
nama-pluginmenjadinama-plugin-old). Tindakan ini secara otomatis akan menonaktifkan plugin tersebut. - Coba akses kembali website dan dashboard WordPress Anda.
2. Mengaktifkan WP_DEBUG untuk Mengetahui Sumber Error
Untuk melihat pesan error yang spesifik di layar website, aktifkan mode debug dengan mengedit file wp-config.php di root direktori Anda.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );Dengan mengaktifkan baris kode di atas, pesan error PHP akan muncul secara detail dan menunjukkan baris kode mana dari plugin yang mengalami kerusakan.
3. Melakukan Rollback ke Versi Sebelumnya
Setelah Anda berhasil masuk kembali ke dashboard, gunakan plugin seperti WP Rollback untuk menginstal ulang versi stabil sebelumnya dari plugin yang error tersebut, sambil menunggu pengembang merilis patch pembaruan baru.
Tips Pencegahan di Masa Depan
Selalu lakukan backup penuh (database dan file) menggunakan plugin backup atau fitur hosting sebelum melakukan pembaruan massal. Uji pembaruan pada lingkungan staging (jika tersedia) sebelum menerapkannya di situs produksi utama.