Player tidak muncul di halaman depan

4 mnt membaca

Audio berhasil dibuat di admin, tetapi saat Anda membuka posting di situs, tidak ada player audio. Halaman ini membahas penyebab umum yang sering terjadi.

Daftar periksa cepat

Sebelum menggali lebih dalam:

  1. Muat ulang halaman dengan Ctrl+Shift+R (hard-refresh melewati cache)
  2. Pastikan posting memiliki audio di kolom TTS admin
  3. Pastikan Anda tidak dalam kondisi logout (beberapa tema menyembunyikan elemen khusus admin)

Penyebab 1: Jenis posting belum diaktifkan

Gejala: Audio ada di admin, tetapi tidak ada player di halaman depan. Berfungsi pada beberapa jenis posting tetapi tidak pada yang lain.

Perbaikan:

  1. Buka Teks ke Ucapan → Konten.
  2. Pastikan jenis posting saat ini sudah diaktifkan (Posts, Pages, Products, dll.).
  3. Simpan.
  4. Muat ulang posting di halaman depan.

Penyebab 2: Konflik tema

Gejala: Player muncul di beberapa tema tetapi tidak di tema Anda, atau muncul tetapi tidak terlihat atau rusak.

Alasan umum:

  • Tema Anda menghapus filter the_content tempat TTSWP menyuntikkan player
  • Tema Anda menggunakan template khusus yang melewati hook konten default WordPress
  • CSS dari tema Anda menyembunyikan player (display: none di suatu tempat)

Perbaikan:

  1. Sementara beralih ke tema WordPress default (Twenty Twenty-Four).
  2. Muat ulang posting.
  3. Jika player muncul di tema default, masalahnya ada pada tema Anda.

Solusi alternatif:

  • Gunakan shortcode [mementor-tts] di dalam posting untuk memaksa penempatan
  • Gunakan shortcode [tts_player id="123"] di template tema khusus
  • Tambahkan CSS khusus agar player terlihat jika sedang disembunyikan

Penyebab 3: Penempatan diatur ke tampilan yang tidak muncul

Gejala: Player muncul di beberapa halaman tetapi tidak di halaman lain.

Contoh: Jika penempatan diatur ke Sebelum kutipan, player hanya muncul di halaman arsip dan daftar blog, bukan di posting tunggal.

Perbaikan:

  1. Buka Teks ke Ucapan → Player.
  2. Periksa dropdown Penempatan.
  3. Ganti ke Setelah judul atau Setelah konten untuk penempatan yang paling universal.
  4. Simpan.

Penyebab 4: Cache menyajikan versi lama

Gejala: Player muncul di jendela incognito baru tetapi tidak di browser biasa Anda.

Perbaikan:

  1. Bersihkan cache browser Anda (Ctrl+Shift+Delete).
  2. Jika Anda menggunakan plugin caching (WP Rocket, LiteSpeed, dll.), bersihkan cachenya.
  3. Jika Anda menggunakan CDN (Cloudflare, dll.), purge cachenya.

Lihat Plugin caching.

Penyebab 5: JavaScript diblokir

Gejala: HTML player ada (lihat sumber halaman), tetapi tampilannya rusak atau statis.

Mengapa: Player menggunakan JavaScript untuk kontrol. Jika JS diblokir, player tampil sebagai HTML tanpa gaya.

Perbaikan:

  • Periksa konsol browser Anda untuk error JS
  • Nonaktifkan pemblokir iklan atau pemblokir konten di situs Anda
  • Pastikan tidak ada plugin lain yang menghapus antrean mementor-tts-public.js

Penyebab 6: Masalah routing Weglot atau WPML

Gejala: Player berfungsi di bahasa asli tetapi tidak di halaman terjemahan (atau sebaliknya).

Perbaikan: Pastikan toggle integrasi Weglot atau WPML sudah aktif. Buka Teks ke Ucapan → Ikhtisar → Pengaturan Cepat. Lihat Integrasi WPML dan Integrasi Weglot.

Penyebab 7: Versi AMP dari halaman

Gejala: Player muncul di versi biasa tetapi tidak di AMP.

Mengapa: AMP memiliki aturan ketat tentang JavaScript. Player TTSWP tidak berjalan di dalam halaman AMP.

Solusi alternatif: Arahkan pengunjung ke versi non-AMP, atau gunakan pendekatan berbeda untuk audio di halaman AMP.

Masih terkendala?

Jika tidak ada langkah di atas yang berhasil:

  1. Periksa Teks ke Ucapan → PRO Support atau halaman dukungan
  2. Sertakan: nama tema, versi WordPress, versi plugin, browser, tangkapan layar posting dan kolom TTS admin