Troubleshooting#
Menu NexaPress tidak lengkap#
Aktifkan license key dari menu NexaPress lalu muat ulang WordPress Admin. Jika gagal, periksa expiry, domain, batas aktivasi, HTTPS, koneksi keluar, firewall, dan waktu server.
Tombol Generate tidak aktif#
Pastikan lisensi aktif, status plugin Active, kuota tersedia, serta terdapat campaign dan keyword yang dapat diproses.
Artikel tidak dibuat#
Periksa:
- Campaign aktif dan memiliki keyword Not generated.
- Kuota masih tersedia.
- AI engine dan credential benar.
- Server dapat mengakses API melalui HTTPS.
- WP-Cron berjalan.
- WordPress dapat menulis ke Media Library.
- Activity log dan status keyword tidak menampilkan error.
Campaign tampak berhenti#
Background job tetap dapat berjalan setelah halaman ditutup. Periksa NexaPress > Keywords atau Posts > All Posts. Jika status lama tidak berubah, periksa WP-Cron.
Scheduler tidak membuat artikel#
Pastikan NexaPress dan campaign berstatus Active, lisensi serta kuota tersedia, ada keyword belum diproses, dan WP-Cron atau cron server berjalan. Pada website sepi traffic, panggil wp-cron.php secara berkala melalui cron server.
Impor XLSX gagal#
Aktifkan ekstensi PHP Zip dan SimpleXML, atau simpan file sebagai CSV. Pastikan ukuran tidak melebihi 5 MB.
Gambar tidak muncul#
Pastikan Maximum Images bukan 0, file tidak melewati Maximum Download Size, server dapat mengunduh gambar eksternal, direktori upload dapat ditulis, MIME diterima WordPress, dan Content API mengembalikan data gambar.
Jika WebP tidak dibuat, periksa dukungan image editor PHP. NexaPress tetap menggunakan format sumber teroptimasi ketika WebP tidak didukung. GIF yang melebihi batas dimensi ditolak untuk melindungi animasi. Satu gambar gagal tidak selalu menggagalkan artikel.
Image detail atau IndexNow key 404#
- Buka Settings > Permalinks.
- Klik Save Changes.
- Bersihkan cache WordPress, server, dan CDN.
- Coba URL kembali.
Indexing gagal#
Untuk IndexNow, periksa format key dan URL file verifikasi. Untuk Google, pastikan OpenSSL aktif, JSON valid, API aktif, dan service account memiliki akses ke property Search Console.
Status kuota tidak tersedia#
Status lokal dapat tidak tersedia ketika layanan kuota tidak dapat dijangkau. Server tetap menentukan izin generate. Periksa koneksi, lisensi, lalu coba kembali.
Content Refresh gagal membuat preview#
Setelah tombol Generate AI Refresh Preview ditekan, proses berjalan melalui antrean background. Anda tidak perlu menunggu di halaman yang sama. Periksa NexaPress > Logs dan cari kode content_refresh; status success menyediakan tautan View refresh preview. Jika status terus queued atau processing, pastikan WP-Cron dapat berjalan dan tidak diblokir DISABLE_WP_CRON, firewall, atau Basic Auth.
Jika URL berubah menjadi refresh_error=1, halaman menampilkan notice kegagalan. Periksa:
- Artikel masih berstatus publish dan URL-nya dapat dibuka tanpa login.
- Content API dapat mengakses domain artikel dan tidak diblokir firewall, maintenance mode, Basic Auth, atau allowlist IP.
- Lisensi mempunyai capability Content Refresh dan scope AI yang sesuai.
- Token belum kedaluwarsa; refresh atau aktivasi ulang lisensi bila perlu.
- Kuota Default AI masih tersedia, atau credential BYOK valid.
- Endpoint produksi memakai HTTPS dan tidak mengarah ke IP privat.
- Content API tidak menerima redirect ke login, localhost, domain development yang tidak diizinkan, atau URL berbeda.
Pada environment Docker development, WordPress dan Content API harus memakai development token yang sama, produk nexapress-plugin harus berada dalam article rewrite allowlist, dan canonical origin WordPress harus dipetakan ke host gateway.
Jika Apply Refresh & Update Published Post mengatakan artikel berubah setelah preview, itu adalah proteksi stale-source. Seseorang atau proses lain telah mengedit artikel; buat preview baru dan tinjau ulang.
Default AI memakai satu kuota untuk setiap preview yang berhasil, termasuk preview baru untuk artikel yang sama. BYOK tidak memakai kuota Default AI. Tombol Apply tidak meminta AI lagi dan tidak memakai kuota tambahan.
Daftar atau pagination tidak tampil benar#
- Pastikan JavaScript tidak diblokir oleh plugin optimasi/admin security.
- Bersihkan browser cache setelah update plugin.
- Periksa URL halaman dan hapus parameter
nexa_list_*untuk kembali ke halaman pertama. - Campaign, Keyword, Research History, dan Logs memakai pagination server-side; list Premium dan Indexing Logs memakai paginator admin 20 item per halaman.
- Content Audit memeriksa maksimum 500 konten NexaPress terbaru per pemuatan.
Menu Premium tidak terlihat setelah upgrade#
- Buka halaman Status/License.
- Refresh atau verifikasi lisensi.
- Pastikan respons Authority memuat capability fitur.
- Muat ulang WordPress Admin.
- Periksa bahwa user mempunyai
manage_optionsatau capability editorial yang diperlukan.
Menyimpan konfigurasi Premium sebelum downgrade tidak menjamin menu tetap terlihat. Data dipertahankan, tetapi runtime fitur dinonaktifkan sampai capability kembali tersedia.
Saat meminta bantuan#
Sertakan versi WordPress, PHP, dan NexaPress; waktu beserta zona waktu; langkah yang dijalankan; pesan error; status keyword/campaign; jenis proses; dan status WP-Cron.
Jangan pernah mengirim license key lengkap, API key, access token, private key, Google Service Account JSON, atau konfigurasi WordPress berisi credential.