Solusi Cepat Kendala Windows di CuanAff ​

Panduan ringkas, empatik, dan bebas istilah teknis rumit untuk mengatasi 5 kendala paling umum saat menjalankan CuanAff di laptop atau komputer berbasis Windows.

Tautan Cepat untuk Bantuan WhatsApp / CS

Jika Anda menerima tautan halaman ini dari tim bantuan pelanggan (Customer Support), langsung lompat ke solusi yang sesuai dengan kendala Anda melalui daftar di bawah ini!

🧭 Daftar Kendala & Solusi Cepat ​

NoGejala yang Anda AlamiSolusi CepatWaktu
1Jendela Layar Hitam (CMD) Muncul Sekejap Lalu Hilang / MentalEkstrak ZIP utuh (Extract All...) & gunakan peluncur anti-mental30 Detik
2Bingung Buka Terminal & Cara Jalankan Perintah CLITrik address bar cmd & gunakan perintah instan cuanaff tanpa awalan php10 Detik
3Muncul Pesan "PHP Belum Terpasang" di LaptopPasang Laravel Herd for Windows (Otomatis tanpa setting PATH)2 Menit
4Ingin Hubungkan Cloudflare & Troubleshooting KredensialGunakan Menu [5], auto-fallback transparan, atau isi file .env1 Menit
5Ingin Buat Website Baru Tanpa Hafal Perintah TerminalPilih Menu [7] di jalankan.bat (Panduan tanya-jawab interaktif)1 Menit

🗺️ Alur Diagnostik Mandiri Cepat ​

Berikut 5 langkah diagnostik mandiri untuk mengatasi kendala dan memulai CuanAff di Windows:

Tahap 1
Ekstraksi ZIP Utuh
Jika CMD mental/hilang, klik kanan berkas ZIP lalu pilih Extract All... ke folder kerja.
→
Tahap 2
Kesiapan PHP
Jika PHP belum ada, pasang 1-klik Laravel Herd for Windows tanpa utak-atik PATH.
→
Tahap 3
Hubungkan Cloudflare
Pilih Menu [5] di jalankan.bat dengan proteksi fallback kredensial otomatis.
→
Tahap 4
Buat Situs Baru
Pilih Menu [7] atau ketik cuanaff site:create untuk inisialisasi instan.
→
Tahap 5
Website Siap Online
Situs ulasan langsung aktif global di Cloudflare Pages dengan hosting gratis $0/bulan.

Solusi 1: Jendela CMD Langsung Hilang atau Mental ​

Gejala Masalah ​

Saat Anda mengklik ganda file jalankan.bat, sebuah jendela hitam (Command Prompt) sempat muncul selama sepersekian detik, lalu langsung tertutup sendiri tanpa menampilkan menu atau pesan apa pun (flash and close).

Mengapa Ini Terjadi? ​

Windows memiliki fitur bawaan yang memungkinkan kita mengintip isi berkas .zip seolah-olah folder biasa. Ketika Anda langsung mengklik jalankan.bat dari dalam tampilan tersebut, Windows sebenarnya mengeksekusi berkas batch di folder sementara rahasia (%TEMP% atau AppData\Local\Temp).

Pada folder sementara tersebut, berkas program inti CuanAff (cuanaff, data, themes, vendor) tidak ikut terbawa. Akibatnya, sistem berhenti mendadak demi keamanan.

Proteksi Anti-Flash-and-Close Bawaan CuanAff ​

Mulai rilis terbaru, peluncur jalankan.bat telah dilengkapi proteksi dini anti-flash-and-close. Jika Anda tidak sengaja mengklik file dari dalam arsip ZIP yang belum diekstrak, jendela Command Prompt tidak akan langsung menutup sendiri. Sistem akan menampilkan layar peringatan ramah dan menahan jendela dengan jeda baca (pause) agar Anda mengetahui instruksi perbaikannya.

Cara Mengatasi (Langkah 30 Detik): ​

  1. Buka folder tempat berkas ZIP berada (biasanya di folder Downloads laptop Anda).
  2. Klik kanan pada berkas cuanaff-1.0.0.zip.
  3. Pilih menu Extract All... (atau Ekstrak Semua... jika Windows Anda berbahasa Indonesia).
  4. Sebuah jendela kecil akan muncul. Pastikan opsi centang "Show extracted files when complete" aktif, lalu klik tombol Extract.
  5. Tunggu proses ekstraksi selesai hingga folder baru bernama cuanaff-1.0.0 atau cuanaff terbuka.
  6. Masuk ke dalam folder hasil ekstraksi tersebut, lalu klik ganda kembali file jalankan.bat.

Tanda Ekstraksi Berhasil

Jika berkas sudah diekstrak dengan benar, jendela jalankan.bat akan tetap terbuka menampilkan menu warna-warni yang ramah dan siap menerima pilihan Anda!

Solusi 2: Cara Buka Terminal (CMD) & Native CLI Wrapper (cuanaff.bat) ​

Gejala Masalah ​

Banyak panduan affiliate atau tutorial tingkat lanjut menyebutkan "buka terminal Command Prompt di folder proyek". Bagi pemula:

  1. Mencari aplikasi CMD di Start Menu lalu berpindah folder menggunakan perintah cd C:\Users\... sangat membingungkan.
  2. Saat mencoba mengetik perintah seperti cuanaff site:create, Windows menampilkan pesan error:
    text
    'cuanaff' is not recognized as an internal or external command, operable program or batch file.

Bagian A: Trik Rahasia 2 Detik (Address Bar File Explorer) ​

Anda tidak perlu mencari terminal atau mengetik perintah cd manual sama sekali:

  1. Buka folder kerja CuanAff hasil ekstraksi di File Explorer biasa.
  2. Klik satu kali pada bilah alamat (address bar) di bagian atas jendela (area yang menampilkan teks lokasi folder, misalnya This PC > Downloads > cuanaff).
  3. Seluruh teks alamat akan terseleksi. Langsung ketik 3 huruf ini:
    text
    cmd
  4. Tekan tombol Enter di keyboard Anda!
  5. Selesai! Jendela hitam Command Prompt akan langsung terbuka tepat di dalam folder CuanAff Anda.

Bagian B: Menjalankan Perintah Langsung via cuanaff.bat (Tanpa Awalan php) ​

Pada sistem operasi Windows, skrip program standar tanpa ekstensi file tidak dapat dieksekusi langsung oleh cmd.exe. Oleh karena itu, CuanAff kini menyertakan wrapper resmi cuanaff.bat tepat di folder utama (root) proyek.

Artinya, Anda sekarang bisa mengetik perintah CuanAff langsung seperti layaknya aplikasi Windows native:

cmd
cuanaff site:create alatmasak --niche=alat-masak --name="Dapur Pilihan"
cuanaff site:publish tas
cuanaff auth status
cuanaff --help

Fleksibilitas Penuh

Bagi Anda yang sudah terbiasa mengetik perintah lengkap dengan awalan php (misalnya php cuanaff site:publish tas), sintaks tersebut tetap didukung 100%. Wrapper cuanaff.bat hadir untuk menghemat waktu dan mencegah kesalahan ketik bagi pengguna Windows!

Solusi 3: Pasang Runtime PHP Gratis 1-Klik via Laravel Herd ​

Gejala Masalah ​

Saat membuka jalankan.bat atau mengetik cuanaff di terminal, Anda menemui pesan:

  • [x] PHP: BELUM TERPASANG DI LAPTOP ANDA
  • Atau: 'php' is not recognized as an internal or external command, operable program or batch file.

Mengapa CuanAff Butuh PHP? ​

CuanAff menggunakan mesin generator berbasis PHP modern yang super ringan untuk merakit ratusan halaman situs affiliate Anda menjadi file statis dalam hitungan detik. CuanAff membutuhkan PHP versi 8.2 atau lebih baru.

Solusi Resmi Paling Mudah: Laravel Herd for Windows (100% Gratis) ​

Dahulu, memasang PHP di Windows mengharuskan Anda mengunduh file zip manual, mengekstrak ke folder C:\php, dan menyunting Environment Variables (System PATH) yang rumit.

Sekarang, ada Laravel Herd yang mengurus segalanya secara otomatis sekali klik:

  1. Kunjungi situs resmi: https://herd.laravel.com
  2. Klik tombol Download for Windows (aplikasi ini gratis dan bebas virus/malware).
  3. Setelah unduhan selesai, jalankan file installer tersebut.
  4. Ikuti instruksi di layar (cukup klik Next hingga selesai).
  5. Selesai! Laravel Herd otomatis memasang PHP versi terbaru (PHP 8.2+) dan langsung menyambungkannya ke sistem Windows Anda tanpa perlu mengubah pengaturan PATH manual.
  6. Tutup jendela jalankan.bat atau CMD yang sedang terbuka, lalu buka kembali jalankan.bat.
  7. Pilih Menu [1] Cek Kesiapan Laptop — Anda akan melihat status hijau [v] Runtime PHP aktif. Siap digunakan! 🚀

Solusi 4: Hubungkan Akun Cloudflare & Troubleshooting Kredensial ​

Gejala Masalah ​

Untuk menerbitkan website ke Cloudflare Pages gratis ($0/bulan), Anda perlu mendaftarkan Cloudflare Account ID dan API Token. Beberapa kendala yang sering dialami pengguna:

  • Bingung cara mengisi token tanpa membuka terminal.
  • Muncul kendala penyimpanan kredensial native di Windows akibat proteksi antivirus atau kebijakan keamanan laptop kantor.

Solusi Praktis: Gunakan Menu [5] di jalankan.bat ​

Anda tidak perlu membuka terminal atau mengetik perintah panjang! Cukup gunakan peluncur interaktif:

  1. Klik ganda file jalankan.bat.
  2. Ketik angka 5 lalu tekan Enter untuk memilih menu:
    text
    [5] Hubungkan Akun Cloudflare (Cloudflare Auth)
  3. Layar akan meminta Cloudflare Account ID:
    • Salin Account ID Anda (32 karakter), klik kanan di layar CMD untuk menempelkan (paste), lalu tekan Enter.
  4. Layar akan meminta Cloudflare API Token:
    • Salin API Token Anda, klik kanan untuk menempelkan, lalu tekan Enter.
  5. CuanAff akan langsung menguji koneksi ke Cloudflare di balik layar.
  6. Jika berhasil, Anda akan melihat pesan sukses berwarna hijau:
    text
    [v] SUKSES! AKUN CLOUDFLARE BERHASIL TERHUBUNG
    Status: Akun Anda valid dan siap mempublikasikan website.

Belum Punya Account ID atau Token Cloudflare?

Ikuti panduan visual bergambar langkah demi langkah dalam 2 menit di Panduan Mandiri Pembuatan Token Cloudflare Pages.

Troubleshooting Kredensial Windows (Arsitektur Resilient) ​

CuanAff dirancang dengan arsitektur penyimpanan kredensial berlapis untuk memastikan kelancaran operasional di seluruh varian Windows:

  1. Penyimpanan Native Windows Credential Manager:
    • Secara default, CuanAff menyimpan token Cloudflare Anda ke dalam sistem pengelola kredensial resmi Windows (Windows Credential Manager). Token tersimpan secara terenkripsi di level sistem operasi.
  2. Auto-Fallback Transparan ke credentials.json (FileCredentialStore):
    • Pada beberapa kondisi (misalnya Windows Defender atau antivirus pihak ketiga membatasi skrip PowerShell membaca Windows Credential Manager, atau hak akses akun pengguna Windows terbatas), CuanAff tidak akan mogok atau crash.
    • Sistem secara cerdas dan transparan melakukan auto-fallback ke penyimpanan berkas lokal terproteksi (credentials.json) di folder konfigurasi pengguna.
    • Anda tidak perlu mengubah pengaturan apa pun; proses build dan publikasi akan tetap berjalan normal!
  3. Opsi Konfigurasi Manual via File .env:
    • Jika Anda lebih menyukai konfigurasi sederhana berbasis file teks (misalnya untuk kebutuhan otomasi atau server), cukup buat berkas bernama .env di folder root CuanAff:
      ini
      CLOUDFLARE_ACCOUNT_ID=account_id_32_karakter_anda
CLOUDFLARE_API_TOKEN=api_token_cloudflare_anda
    • CuanAff akan langsung membaca kredensial dari file .env tersebut sebagai prioritas utama saat proses validasi dan deployment.

Solusi 5: Buat Website Baru Instan via Menu [7] di jalankan.bat ​

Gejala Masalah ​

Banyak pengguna pemula ingin membuat website affiliate kedua, ketiga, atau website dengan kategori produk baru, namun belum hafal perintah CLI site:create beserta parameter opsionalnya.

Solusi Praktis: Gunakan Menu [7] Pembuat Situs Interaktif ​

Anda cukup membuka peluncur interaktif CuanAff:

  1. Klik ganda file jalankan.bat.
  2. Ketik angka 7 lalu tekan Enter untuk memilih menu:
    text
    [7] Buat Website Baru (site:create)
  3. Peluncur akan memandu Anda melalui 3 pertanyaan ramah:
    • Nama slug situs: Ketik nama unik folder situs Anda (huruf kecil & angka tanpa spasi), misalnya alatmasak atau sepatu-lari.
    • Niche pilihan: Ketik niche yang relevan (misalnya alat-masak, tas-travel, atau smart-security). CuanAff akan otomatis menyiapkan deklarasi niche scaffolding (niches/<niche>/niche.yaml) jika niche tersebut baru.
    • Nama brand situs: Ketik nama tampilan toko Anda, misalnya Dapur Pilihan atau Sepatu Mantap.
  4. Tekan Enter — CuanAff akan otomatis membuat folder data/<slug>, merakit berkas config.yaml, dan menyiapkan struktur kategori ulasan!
  5. Setelah selesai, Anda langsung siap:
    • Mengimpor produk dari CSV via Menu [3].
    • Meninjau tampilan website di browser lokal via Menu [4].
    • Menayangkan website ke Cloudflare Pages via Menu [6]!

Opsi CLI Terminal (Bagi Praktisi yang Suka Mengetik Perintah) ​

Jika Anda sedang membuka terminal CMD atau PowerShell, Anda juga bisa langsung mengeksekusi perintah pembuatan situs baru dalam satu baris menggunakan cuanaff.bat:

cmd
cuanaff site:create alatmasak --niche=alat-masak --name="Dapur Pilihan"

💡 Tips Tambahan untuk Pengguna Windows ​

  1. Cara Paste (Tempel) di Command Prompt:
    • Di Windows 10 & 11, Anda cukup menekan tombol Ctrl + V atau klik kanan sekali di dalam jendela Command Prompt untuk menempelkan teks/token yang sudah disalin.
  2. Menjalankan CLI CuanAff dari Mana Saja:
    • Dengan adanya cuanaff.bat, Anda cukup mengetik cuanaff <perintah> di folder proyek tanpa perlu mengetik panjang php cuanaff <perintah>.
  3. Jangan Pindahkan Folder CuanAff ke Tempat Aneh:
    • Tempatkan folder hasil ekstraksi di lokasi yang mudah ditemukan, misalnya di C:\cuanaff atau di folder Documents / Downloads Anda. Hindari menyimpannya di folder sistem seperti C:\Windows\System32.
  4. Bantuan Tim Support Dojo:
    • Jika Anda masih menemui kendala setelah mengikuti panduan di atas, jangan ragu untuk menghubungi tim bantuan via WhatsApp dengan melampirkan foto layar (screenshot) pesan error yang tampil.

Langkah Selanjutnya ​

Setelah kendala di atas teratasi dan kesiapan sistem sudah centang hijau, Anda siap melanjutkan ke langkah pembuatan website afiliasi:

👉 Buka Panduan Ekstraksi & Instalasi Lengkap
👉 Mulai Bangun Website Pertama (Panduan 4 Langkah)