Panduan Subdomain Lapak

Tujuan
Subdomain lapak membuat link toko terlihat lebih profesional. Contoh:
hana.libaza.id
mentor-hana.libaza.id

URL lama tetap aman:
libaza.id/a/lapak-hana

1. Syarat sebelum mulai
- Domain utama sudah aktif, contoh libaza.id.
- Website LIBAZA sudah terpasang di hosting/server.
- Hosting menerima semua subdomain wildcard ke aplikasi yang sama.
- SSL/HTTPS mendukung wildcard atau otomatis untuk subdomain.
- Akses DNS domain tersedia, misalnya Cloudflare, cPanel Zone Editor, Niagahoster, Rumahweb, Hostinger, atau provider lain.

2. Pengaturan DNS
Buat record wildcard:

Type: A
Name: *
Value: IP server hosting
Proxy: sesuai kebutuhan hosting
TTL: Auto

Jika hosting memakai CNAME, gunakan:

Type: CNAME
Name: *
Target: domain hosting atau root domain yang diminta provider
TTL: Auto

Catatan:
- Jangan hapus record utama libaza.id.
- Jangan hapus www jika masih dipakai.
- Pastikan subdomain seperti hana.libaza.id mengarah ke server yang sama dengan libaza.id.

3. Pengaturan Cloudflare
Jika memakai Cloudflare:
- Masuk ke DNS.
- Tambahkan record A dengan name * dan value IP server.
- Jika SSL di server belum wildcard, gunakan SSL mode Full atau Full strict sesuai sertifikat server.
- Aktifkan Always Use HTTPS jika semua halaman sudah siap HTTPS.

Jika wildcard tidak berjalan saat proxy aktif, coba ubah proxy menjadi DNS only dulu untuk testing.

4. Pengaturan cPanel atau hosting
Di beberapa hosting, DNS wildcard saja belum cukup. Anda perlu membuat wildcard subdomain.

Langkah umum cPanel:
- Masuk cPanel.
- Buka Domains atau Subdomains.
- Tambahkan subdomain: *
- Arahkan document root ke folder public Laravel.
- Pastikan folder mengarah ke aplikasi LIBAZA yang sama, bukan folder kosong.

Jika hosting tidak mengizinkan wildcard subdomain, buat subdomain satu per satu, misalnya hana.libaza.id, lalu arahkan ke aplikasi yang sama.

5. Pengaturan SSL
Subdomain harus HTTPS.

Pilihan yang disarankan:
- Cloudflare Universal SSL untuk *.libaza.id.
- Let's Encrypt wildcard SSL.
- AutoSSL cPanel jika mendukung wildcard.

Jika SSL belum siap, browser bisa menampilkan Not Secure atau gagal membuka subdomain.

6. Pengaturan Laravel
Di file .env hosting, isi:

APP_URL=https://libaza.id
STOREFRONT_BASE_DOMAIN=libaza.id

Setelah mengubah .env, jalankan:

php artisan config:clear
php artisan cache:clear
php artisan route:clear

Jika memakai cache production:

php artisan config:cache
php artisan route:cache

7. Mengisi subdomain di dashboard
Untuk mitra:
- Masuk dashboard admin.
- Buka menu Mitra.
- Edit mitra.
- Isi Subdomain lapak, contoh: hana.
- Simpan.

Untuk mentor direct selling:
- Masuk dashboard admin.
- Buka menu Mentor.
- Edit mentor.
- Aktifkan Lapak jual langsung mentor.
- Isi Subdomain lapak mentor, contoh: mentor-hana.
- Simpan.

8. Aturan nama subdomain
Boleh:
- hana
- hana-fashion
- mentor-hana
- toko-bandung

Tidak disarankan:
- Nama terlalu panjang.
- Nama dengan spasi.
- Nama dengan karakter aneh.

Dicadangkan untuk sistem dan tidak boleh dipakai:
admin, api, app, assets, cdn, dashboard, help, mail, payment, static, support, www

9. Cara test
Setelah DNS aktif, buka:

https://hana.libaza.id

Jika berhasil, halaman lapak Hana akan muncul.

Jika masih gagal:
- Tunggu propagasi DNS 5 menit sampai 24 jam.
- Cek apakah wildcard DNS sudah benar.
- Cek apakah wildcard subdomain di hosting sudah diarahkan ke public Laravel.
- Cek SSL sudah aktif.
- Cek .env STOREFRONT_BASE_DOMAIN sudah libaza.id.
- Jalankan php artisan config:clear.

10. Fallback jika subdomain belum aktif
Selama DNS belum siap, lapak tetap bisa dibuka lewat:

https://libaza.id/a/slug-lapak

Jadi tidak ada link lama yang rusak.

11. Rekomendasi implementasi bertahap
Tahap 1:
Gunakan URL /a/slug-lapak untuk semua mitra.

Tahap 2:
Aktifkan custom_subdomain di dashboard untuk mitra pilihan.

Tahap 3:
Aktifkan wildcard DNS dan SSL.

Tahap 4:
Mulai promosikan link cantik seperti hana.libaza.id.

12. Checklist akhir
- DNS wildcard sudah dibuat.
- Hosting menerima wildcard subdomain.
- SSL wildcard aktif.
- APP_URL benar.
- STOREFRONT_BASE_DOMAIN benar.
- Cache Laravel sudah dibersihkan.
- Subdomain lapak sudah diisi di dashboard.
- Link subdomain berhasil membuka lapak yang benar.