PrestaShop Kamu Blank Putih? Ini Cara Mudah Mengatasinya Tanpa Ribet.

PrestaShop Kamu Blank Putih? Ini Cara Mudah Mengatasinya Tanpa Ribet.
Photo by Detlef Hansmann/Unsplash

Pernah nggak sih kamu lagi asyik-asyiknya ngurus toko online PrestaShop, tiba-tiba layarnya cuma putih polos alias blank white screen of death (WSOD)? Rasanya pasti langsung panik, deg-degan, dan bingung harus mulai dari mana. Toko yang harusnya menghasilkan, malah nggak bisa diakses sama sekali. Ujung-ujungnya, penjualan bisa terganggu, reputasi toko jadi taruhannya. Jangan khawatir, kamu nggak sendirian kok! Masalah blank putih ini memang lumayan sering terjadi di PrestaShop, tapi untungnya, kebanyakan kasusnya bisa diatasi dengan langkah-langkah yang relatif mudah tanpa perlu pusing tujuh keliling.

Artikel ini bakal jadi panduan lengkap buat kamu yang lagi galau karena PrestaShop-nya "ngambek" cuma nampilin layar putih. Kita akan bahas penyebabnya sampai tuntas, lalu aku bakal kasih tips dan trik jitu buat mengatasinya, dari yang paling simpel sampai yang butuh sedikit utak-atik. Siap? Yuk, kita mulai petualangan jadi detektif PrestaShop!

Kenapa Sih Layar PrestaShop Bisa Tiba-Tiba Putih Polos?

Sebelum kita obrak-abrik solusinya, ada baiknya kita paham dulu kenapa sih ini bisa terjadi. Ibarat sakit, kita perlu tahu dulu penyebabnya biar nggak salah kasih obat. Nah, penyebab layar putih di PrestaShop itu bisa bermacam-macam, tapi biasanya berkutat di beberapa hal ini:

  1. Kesalahan PHP (PHP Errors): Ini adalah biang kerok paling umum. Bisa jadi ada syntax error di salah satu file, batas memori PHP yang terlampaui, atau versi PHP yang nggak kompatibel. PrestaShop itu kan dibangun pakai PHP, jadi kalau ada yang nggak beres di kodenya, ya dia nggak bisa jalan dan cuma nampilin kosong.
  2. Konflik Modul atau Tema: Kamu baru aja install modul baru? Atau update tema? Nah, ini bisa jadi pemicunya. Kadang, modul atau tema baru itu nggak cocok sama PrestaShop versi kamu atau malah konflik sama modul lain yang udah ada. Hasilnya? Blank putih.
  3. Masalah Cache: Cache itu gunanya buat mempercepat loading website. Tapi, kadang cache yang korup atau numpuk malah bikin masalah. PrestaShop jadi bingung mau nampilin apa.
  4. File Korup atau Hilang: Saat kamu upload file via FTP, update PrestaShop, atau update modul, bisa aja ada file yang nggak terunggah sempurna, korup, atau bahkan hilang. Ini bisa bikin PrestaShop nggak bisa bekerja dengan baik.
  5. Batas Memori PHP (PHP Memory Limit) Terlalu Kecil: PrestaShop itu butuh memori buat beroperasi. Kalau batas memori yang dikasih server terlalu kecil, pas dia lagi butuh banyak memori (misalnya pas ada banyak modul aktif atau lagi proses berat), dia langsung error dan bisa jadi layar putih.
  6. Izin File (File Permissions) yang Salah: Setiap file dan folder di server itu punya izin akses. Kalau izinnya salah, PrestaShop nggak bisa baca atau tulis file yang dia butuhkan, akhirnya gagal total.
  7. Server Overload atau Konfigurasi Server: Kadang-kadang, masalahnya ada di server hosting kamu. Mungkin lagi overload, atau ada konfigurasi tertentu yang nggak sesuai.

Oke, sekarang kita udah tahu beberapa biang keroknya. Yuk, kita mulai langkah-langkah penyelamatannya!

Langkah-Langkah Jitu Mengatasi PrestaShop Blank Putih

Ingat ya, selalu mulai dari langkah yang paling mudah dan umum, lalu bergerak ke yang lebih teknis. Dan satu lagi: selalu backup dulu website kamu sebelum melakukan perubahan besar! Ini penting banget biar kalau ada apa-apa, kamu bisa balik ke kondisi semula.

1. Aktifkan Mode Debug (Debug Mode): Detektif Pertama Kita

Ini adalah langkah paling krusial dan harus jadi yang pertama kamu lakukan. Kenapa? Karena mode debug ini akan memunculkan pesan kesalahan (error message) yang tersembunyi. Dari pesan error itu, kita bisa tahu persis letak masalahnya ada di mana.

  • Cara Mengaktifkan Mode Debug:

* Akses file PrestaShop kamu via FTP (FileZilla, Cyberduck, dll.) atau File Manager di cPanel. * Cari folder config/. * Di dalamnya, cari file defines.inc.php. * Download file tersebut, lalu buka dengan text editor (Notepad++, VS Code, Sublime Text, dll.). * Cari baris ini: define('PSMODEDEV', false); * Ubah false menjadi true: define('PSMODEDEV', true); * Simpan file dan upload kembali ke server, menimpa file yang lama.

Setelah itu, refresh halaman PrestaShop kamu. Kalau beruntung, sekarang kamu nggak akan lagi lihat layar putih, tapi justru pesan error yang jelas. Nah, dari pesan error itu, kamu bisa tahu:

  • Lokasi File Error: Misalnya, Fatal error: Call to undefined function some_function() in /path/to/your/prestashop/modules/namamodul/namamodul.php on line 123. Ini artinya masalahnya ada di modul namamodul.php di baris 123.
  • Jenis Error: Apakah itu Parse error, Fatal error, Memory limit error, dsb.

Jika kamu melihat pesan "Memory limit error", langsung loncat ke poin nomor 3. Jika ada pesan error terkait modul atau tema, perhatikan lokasinya, lalu loncat ke poin nomor 4 atau 5.

2. Cek Log Error Server: Lebih Dalam dari Mode Debug

Kadang, mode debug PrestaShop nggak cukup untuk menangkap semua error, terutama error level server atau PHP yang terjadi sebelum PrestaShop sempat loading. Di sinilah log error server jadi penyelamat.

  • Cara Mengecek Log Error:

* Masuk ke cPanel atau panel hosting kamu. * Cari bagian "Logs" atau "Metrics" atau "Error Logs". Biasanya ada opsi "Raw Access Logs" atau "Error Log". * Di sana kamu akan melihat daftar error yang terjadi di server kamu. Cari yang paling baru dan relevan dengan waktu kejadian layar putih. Kalau kamu nggak nemu atau bingung bacanya, jangan ragu kontak support* hosting kamu. Minta mereka untuk cek log error PHP dan server untuk domain kamu.

Log error server ini bisa memberikan petunjuk yang lebih detail, terutama jika masalahnya terkait dengan konfigurasi server atau batas sumber daya.

3. Tingkatkan Batas Memori PHP (PHP Memory Limit): Nafas Lebih Lega Buat PrestaShop

Seperti yang udah disebutin di atas, PrestaShop butuh memori. Kalau batasnya kekecilan, dia bisa kehabisan napas dan error.

  • Cara Meningkatkan Batas Memori PHP:

* Via php.ini (Jika Kamu Punya Akses): Cari file php.ini di root folder PrestaShop atau folder publichtml. Buka file tersebut dan cari baris memorylimit. Ubah nilainya menjadi lebih besar, misalnya memory_limit = 256M atau 512M. Kalau nggak ada, tambahkan aja. * Via .htaccess: Di root folder PrestaShop kamu, buka file .htaccess. Tambahkan baris ini: phpvalue memorylimit 256M. (Pastikan server kamu mengizinkan override via .htaccess). * Via config/defines.inc.php: Ini solusi alternatif kalau dua di atas nggak berhasil. Tambahkan baris ini di bagian awal file (setelah tag ): iniset('memorylimit', '256M');.

Setelah mengubah, simpan dan upload kembali file. Lalu, refresh PrestaShop kamu.

4. Bersihkan Cache PrestaShop: Reset Ulang Otak PrestaShop

Cache yang korup bisa jadi penyebab utama layar putih. Membersihkannya kadang bisa menyelesaikan masalah dengan cepat.

  • Cara Membersihkan Cache:

* Via Admin Panel (Jika Bisa Diakses): Kalau kamu masih bisa login ke backend PrestaShop, masuk ke Advanced Parameters > Performance. Di sana, ada opsi untuk "Clear cache". Klik tombolnya. * Manual via FTP/File Manager: Ini adalah cara ampuh kalau admin panel nggak bisa diakses. * Akses folder PrestaShop kamu via FTP. * Navigasi ke folder var/cache/ (untuk PrestaShop 1.7.x ke atas) atau app/cache/ (untuk PrestaShop 1.6.x). * Hapus SEMUA folder dan file di dalam var/cache/ (atau app/cache/) kecuali file index.php di setiap subfolder. Jadi, yang dihapus itu isinya, bukan folder cache-nya. Pastikan kamu hati-hati. * Refresh PrestaShop kamu.

5. Nonaktifkan Modul yang Baru Dipasang/Diupdate: Si Biang Kerok Tersembunyi

Jika layar putih muncul setelah kamu menginstal atau mengupdate modul, kemungkinan besar itu biang keroknya.

  • Cara Menonaktifkan Modul Manual:

* Akses folder modules/ via FTP. * Cari folder modul yang baru kamu instal atau update (misalnya, namamodul). * Ganti nama folder tersebut, misalnya jadi namamodulOFF atau namamodul_DISABLED. Cara ini akan membuat PrestaShop tidak bisa menemukan dan menjalankan modul tersebut. * Refresh PrestaShop kamu. Jika website kembali normal, berarti modul itu penyebabnya. Kamu bisa coba hapus modulnya atau cari versi lain yang kompatibel.

  • Via Database (Jika Tahu Nama Modul): Ini lebih teknis.

* Akses phpMyAdmin (biasanya dari cPanel). * Pilih database PrestaShop kamu. * Cari tabel psmodule (prefix ps bisa berbeda). * Cari baris yang nama modulnya jadi masalah. * Ubah nilai di kolom active dari 1 menjadi 0.

6. Ganti ke Tema Bawaan (Default Theme): Curigai Tema Custom Kamu

Sama seperti modul, tema custom yang tidak kompatibel atau punya error di kodenya juga bisa bikin layar putih.

  • Cara Mengganti Tema Manual:

* Akses folder themes/ via FTP. * Cari folder tema yang sedang kamu gunakan (misalnya mycustomtheme). * Ganti nama folder tersebut, misalnya jadi mycustomthemeOFF. * PrestaShop akan secara otomatis beralih ke tema default (biasanya classic atau default-bootstrap). * Refresh PrestaShop kamu. Jika website kembali normal, berarti temamu bermasalah.

  • Via Database:

* Akses phpMyAdmin. * Pilih database PrestaShop kamu. * Cari tabel psconfiguration (prefix ps bisa berbeda). * Cari baris dengan name = PSTHEMENAME. * Ubah nilai di kolom value menjadi nama tema default PrestaShop (misalnya classic).

7. Periksa Izin File dan Folder (File Permissions): Jangan Sampai Ada Gemboknya!

Izin yang salah bisa mencegah PrestaShop membaca atau menulis file, yang berakhir dengan layar putih.

  • Aturan Umum Izin File:

* Folder: Seharusnya 755. * File: Seharusnya 644. * Ada beberapa pengecualian untuk folder seperti img, cache, log, mails, themes, config, upload, download, sitemap yang kadang butuh 775 atau bahkan 777 di beberapa server (tapi 777 harus dihindari karena berisiko keamanan).

  • Cara Mengatur Izin File:

* Via FTP Client (misalnya FileZilla): Klik kanan pada folder/file, pilih "File permissions...". Masukkan angka izin yang benar dan centang "Recurse into subdirectories" (pilih "Apply to directories only" untuk folder, dan "Apply to files only" untuk file). * Via File Manager di cPanel: Pilih folder/file, klik "Permissions", lalu atur angkanya.

8. Periksa Versi PHP Kamu: PrestaShop Punya Pilihan

Setiap versi PrestaShop punya rekomendasi versi PHP. Pakai versi PHP yang terlalu lama atau terlalu baru kadang bisa memicu error.

  • Cara Mengecek dan Mengubah Versi PHP:

* Masuk ke cPanel atau panel hosting kamu. * Cari opsi "Select PHP Version" atau "MultiPHP Manager". * Pilih versi PHP yang direkomendasikan untuk versi PrestaShop kamu (misalnya, PrestaShop 1.7.x biasanya cocok dengan PHP 7.3, 7.4, atau 8.0. Cek dokumentasi resmi PrestaShop untuk rekomendasi paling update). * Pilih versi yang sesuai dan simpan perubahan.

9. Hapus atau Ubah Nama File .htaccess: Si Pengatur Jalan yang Bandel

File .htaccess di root folder PrestaShop itu penting untuk mengatur URL, redirect, dan keamanan. Tapi kalau ada konfigurasi yang salah di dalamnya, dia bisa bikin masalah.

  • Cara Mengecek .htaccess:

* Via FTP/File Manager, cari file .htaccess di root folder PrestaShop. * Ganti nama file tersebut, misalnya jadi htaccessOLD. * Refresh PrestaShop. Kalau website kamu kembali normal, berarti masalahnya ada di file .htaccess yang lama. * Kamu bisa coba generate ulang .htaccess dari admin panel PrestaShop di SEO & URLs.

10. Unggah Ulang File Inti PrestaShop (Core Files): Resep Terakhir

Jika semua cara di atas sudah dicoba tapi PrestaShop kamu masih blank putih, kemungkinan ada file inti yang korup atau hilang. Jangan panik dulu, kita bisa coba "menyegarkan" file intinya tanpa menghapus data kamu.

  • Cara Mengunggah Ulang Core Files:

* Download versi PrestaShop yang SAMA PERSIS dengan yang sedang kamu gunakan (sangat penting!). * Ekstrak file zip hasil download tersebut di komputer kamu. * Hapus folder install/ dari hasil ekstrak. * Lewati juga folder img/, modules/, themes/, override/, dan folder config/. Kita tidak ingin menimpa data pengguna, gambar, modul, tema, atau konfigurasi database. * Pilih semua file dan folder selain yang disebutkan di atas, lalu unggah (upload) via FTP ke root folder PrestaShop kamu di server. Pilih "Overwrite" atau "Replace" saat ada konfirmasi. * Proses ini akan menimpa semua file inti PrestaShop yang mungkin korup atau hilang dengan versi yang bersih. * Setelah selesai, coba refresh PrestaShop kamu.

Mencegah Agar PrestaShop Tidak Blank Putih Lagi

Sudah berhasil mengatasi masalahnya? Selamat! Tapi jangan senang dulu, ada baiknya kamu tahu cara mencegahnya agar tidak terulang:

  • Selalu Backup: Ini adalah kunci. Sebelum melakukan update, install modul/tema baru, atau perubahan besar lainnya, SELALU backup penuh website kamu. Ada banyak plugin backup atau fitur backup di cPanel yang bisa kamu manfaatkan.

Gunakan Staging Environment: Kalau bisa, lakukan perubahan penting di staging environment* (salinan website kamu yang terpisah) dulu, bukan langsung di website live. Setelah yakin aman, baru terapkan ke website utama.

  • Perbarui Secara Teratur: Pastikan PrestaShop, modul, dan tema selalu terupdate ke versi terbaru yang kompatibel. Update biasanya membawa perbaikan bug dan peningkatan keamanan.
  • Pilih Hosting yang Handal: Kualitas hosting sangat berpengaruh. Hosting yang bagus akan memberikan performa stabil dan dukungan teknis yang responsif saat kamu butuh bantuan.
  • Jangan Asal Install Modul: Hanya instal modul dari sumber terpercaya (resmi PrestaShop Addons atau developer ternama). Baca review dan pastikan kompatibel dengan versi PrestaShop kamu.

Kapan Saatnya Memanggil Ahli?

Kamu sudah coba semua langkah di atas tapi PrestaShop-mu masih saja blank putih? Atau kamu merasa nggak yakin buat utak-atik file server? Nggak perlu gengsi, justru itu tanda kamu tahu kapan harus menyerahkannya pada ahlinya. Masalah PrestaShop memang bisa jadi rumit, apalagi kalau kamu nggak punya pengalaman teknis yang cukup.

Kalau kamu sudah pusing tujuh keliling dan butuh bantuan ahli, Javapixa Creative Studio siap bantu kamu mengidentifikasi dan menyelesaikan masalah PrestaShop-mu. Tim kami sudah jago banget menangani berbagai isu teknis di PrestaShop, dari yang ringan sampai yang paling bikin geleng-geleng kepala. Kami akan mendiagnosis akar masalahnya, memperbaikinya dengan cepat dan profesional, sehingga toko online kamu bisa segera beroperasi normal kembali. Kamu tinggal terima beres, fokus jualan, dan biarkan kami yang mengurus keruwetan teknisnya. Jangan biarkan layar putih PrestaShop mengganggu bisnismu lebih lama lagi, segera hubungi Javapixa Creative Studio!