Masalah instalasi atau aktivasi

4 mnt membaca

Anda mencoba menginstal atau mengaktifkan TTSWP dan ada yang tidak beres. Mungkin instalasi gagal, plugin menampilkan error fatal, atau menu tidak muncul setelah aktivasi. Halaman ini membahas penyebab paling umum, dari yang paling sering hingga paling jarang terjadi.

Penyebab 1: Versi PHP terlalu lama

Gejala: WordPress menolak mengaktifkan plugin dengan pesan error seperti "Plugin ini membutuhkan PHP 7.2 atau lebih tinggi" atau menampilkan layar putih tepat setelah aktivasi.

Mengapa: TTSWP membutuhkan PHP 7.2 atau lebih baru. Banyak hosting masih menjalankan PHP 7.0 atau 7.1 secara default pada akun lama.

Solusi:

  1. Buka panel kontrol hosting Anda (cPanel, Plesk, SiteGround, Kinsta, WP Engine, dll.).
  2. Temukan pemilih versi PHP (biasanya di bawah "PHP Selector" atau "Site Tools -> PHP Manager").
  3. Ganti ke PHP 8.0 atau lebih tinggi. PHP 8.2 adalah versi yang direkomendasikan saat ini.
  4. Coba aktifkan plugin lagi.

Jika Anda tidak dapat mengubah PHP dari panel kontrol, hubungi hosting Anda. Hampir semua hosting mendukung PHP 8.x di tahun 2026.

Penyebab 2: Izin file memblokir unggahan

Gejala: "Instalasi plugin gagal" atau "Tidak dapat membuat direktori" saat mengunggah file zip atau menginstal dari direktori.

Mengapa: Direktori wp-content/plugins/ Anda tidak dapat ditulis oleh server web.

Solusi:

  1. Hubungkan ke situs Anda melalui SFTP atau file manager hosting Anda.
  2. Atur wp-content/plugins/ ke izin 755 (atau 775 di beberapa hosting).
  3. Atur file di dalamnya ke 644.
  4. Coba instal lagi.

Pada banyak hosting terkelola (Kinsta, WP Engine, Pressable) file manager menangani ini secara otomatis. Jika Anda kesulitan, minta hosting Anda untuk memperbaiki izin direktori plugin.

Penyebab 3: Konflik plugin saat aktivasi

Gejala: Aktivasi memunculkan error fatal yang menyebutkan nama fungsi, nama kelas, atau "Cannot redeclare". Situs mungkin down sampai plugin dinonaktifkan.

Mengapa: Plugin aktif lain mendefinisikan fungsi atau kelas dengan nama yang sama (jarang tapi mungkin terjadi), atau plugin keamanan memblokir aktivasi.

Solusi:

  1. Ganti nama wp-content/plugins/text-to-speech-tts/ menjadi text-to-speech-tts.off melalui SFTP. Situs akan kembali aktif.
  2. Nonaktifkan semua plugin lain dari Plugin -> Plugin Terinstal.
  3. Ganti nama folder TTSWP kembali ke nama aslinya.
  4. Aktifkan TTSWP terlebih dahulu, lalu aktifkan kembali plugin lain satu per satu. Plugin yang gagal saat TTSWP aktif adalah sumber konflik.
  5. Hubungi dukungan dengan nama plugin yang berkonflik. Kami akan membantu menemukan solusinya.

Penyebab 4: Menu Teks ke Ucapan hilang setelah aktivasi

Gejala: Plugin ditampilkan sebagai Aktif di Plugin -> Plugin Terinstal, tetapi tidak ada entri Teks ke Ucapan di sidebar admin.

Mengapa: Peran pengguna Anda tidak memiliki kemampuan manage_options, atau plugin keamanan menghapus menu tersebut.

Solusi:

  • Masuk sebagai Administrator. Peran Editor dan yang lebih rendah tidak dapat melihat menu TTSWP secara default.
  • Jika Anda sudah menjadi Administrator, periksa Pengguna -> Profil dan konfirmasi peran Anda adalah Administrator.
  • Nonaktifkan plugin keamanan seperti iThemes Security, penyembunyian menu admin Wordfence, atau Hide My WP satu per satu dan muat ulang admin. Jika menu muncul kembali, konfigurasikan plugin tersebut untuk mengizinkan text-to-speech-tts-settings.

Penyebab 5: Kolom TTS hilang dari daftar postingan

Gejala: Plugin berfungsi, tetapi kolom TTS tidak muncul di Postingan -> Semua Postingan.

Solusi:

  1. Buka Postingan -> Semua Postingan.
  2. Klik Opsi Layar di pojok kanan atas layar.
  3. Centang kotak TTS.
  4. Kolom akan muncul.

Jika kotak centang sama sekali tidak ada, tema atau plugin lain memfilternya. Ganti ke tema bawaan (Twenty Twenty-Five) untuk memastikan.

Penyebab 6: Versi WordPress terlalu lama

Gejala: Instalasi plugin gagal dengan pesan "Situs Anda tidak memenuhi persyaratan minimum".

Mengapa: TTSWP membutuhkan WordPress 6.0 atau lebih baru.

Solusi: Perbarui WordPress dari Dasbor -> Pembaruan. Jika Anda tidak dapat memperbarui, hosting Anda mungkin menahan Anda pada versi lama - minta mereka untuk memperbarui.

Penyebab 7: HTTPS keluar diblokir

Gejala: Plugin terinstal dan diaktifkan dengan baik, tetapi halaman Ikhtisar menampilkan "Tidak dapat menjangkau server TTSWP" atau tombol Hubungkan tidak berfungsi.

Mengapa: Hosting Anda memblokir permintaan HTTPS keluar dari PHP ke domain eksternal. Ini jarang terjadi pada hosting nyata tetapi umum pada pengaturan dev lokal.

Solusi:

  • Di localhost, periksa firewall atau VPN Anda.
  • Pada hosting nyata, tambahkan app.ttswp.com dan *.ttswp.com ke daftar izin untuk HTTPS keluar.
  • Lihat Pemecahan masalah koneksi untuk pemeriksaan jaringan lebih mendalam.

Masih mengalami masalah?

Jika tidak ada solusi di atas yang berhasil, kumpulkan informasi ini dan hubungi dukungan:

  • Versi WordPress (dari Dasbor -> Sekilas)
  • Versi PHP (dari Alat -> Kesehatan Situs -> Info -> Server)
  • Nama dan versi tema aktif
  • Daftar plugin aktif lainnya
  • Pesan error yang Anda lihat, dengan tangkapan layar jika memungkinkan