2. INSTALASI PLUGIN, LISENSI KRIPTOGRAFI & SELF-HEALING SYNC

Bagian ini ditujukan bagi Administrator atau pemilik website WordPress.

Syarat Server

• WordPress 5.8 sampai versi terbaru (6.7+).
• PHP 7.4, 8.0, 8.1, 8.2, atau 8.3+.
• Ekstensi PHP: libsodium (aktif bawaan di cPanel/hosting modern), cURL, dan OpenSSL.
• Wajib SSL (HTTPS): Browser memblokir kamera pemindai jika website dibuka lewat HTTP biasa.

Langkah 1: Memasang Plugin di WordPress

1. Masuk ke halaman admin WordPress (wp-admin).
2. Buka menu Plugins > Add New (Tambah Baru).
3. Klik tombol Upload Plugin di bagian atas.
4. Klik Choose File, pilih berkas adk-buku-tamu.zip, lalu klik Install Now.
5. Setelah selesai diunggah, klik Activate Plugin.

Setelah aktif, menu baru bernama ADK Buku Tamu lengkap dengan ikon resmi Adek Kreatif akan muncul pada bilah menu samping (sidebar) WordPress.

Langkah 2: Mengaktifkan Lisensi Resmi

1. Buka menu ADK Buku Tamu > Pengaturan.
2. Klik tab Lisensi Plugin (tab paling kanan).
3. Buka dashboard member area Anda di https://adekkreatif.com dan salin kunci lisensi Anda (format: ADK-BUKTAM-XXXX-XXXX-XXXX).
4. Tempelkan kunci lisensi ke kolom Kunci Lisensi.
5. Klik tombol Aktifkan Lisensi.
6. Status akan langsung berubah menjadi hijau: Lisensi Online Terverifikasi.

Catatan Uji Coba (Localhost):
Jika Anda menguji di komputer lokal (localhost, 127.0.0.1, atau domain .test), semua fitur otomatis terbuka penuh agar proses pembuatan tema dan uji coba berjalan lancar.

Langkah 3: Sistem Kriptografi Offline & Self-Healing Sync (Fitur v1.0.13)

Plugin ADK Buku Tamu menggunakan sistem verifikasi lisensi kriptografi Ed25519 tingkat lanjut yang berjalan secara lokal di server Anda:

1. Verifikasi Offline Tanpa Lag (Zero-Latency):
   Website Anda tidak perlu memanggil server pusat setiap kali halaman dibuka. Hal ini memastikan halaman undangan dan meja scanner terbuka secepat kilat tanpa jeda jaringan.
2. Grace Period 48 Jam & Toleransi Transisi Paket:
   Ketika masa trial (misal 3 hari) berakhir dan Anda memperpanjang ke paket bulanan, sistem memberikan masa tenggang (grace period) 48 jam serta toleransi zona waktu (WIB vs UTC). Lisensi tidak akan mati mendadak di tengah jalan saat jeda pembaruan sertifikat.
3. Self-Healing Sync di Latar Belakang:
   Jika sertifikat lokal kedaluwarsa, plugin akan secara otomatis menyinkronkan sertifikat baru langsung ke server Adek Kreatif di latar belakang saat ada kunjungan ke frontend website, tanpa perlu admin membuka wp-admin terlebih dahulu.
4. Pembersihan Normalisasi Domain Otomatis:
   Sistem secara otomatis membersihkan port (:8080, :443), protokol URL (http/https), tanda garis miring (/), dan awalan www. agar validasi domain selalu akurat.

Langkah 4: Webhook Pencabutan Lisensi Real-Time (Remote Revoke)

Jika lisensi dinonaktifkan atau dibatalkan dari Member Area Adek Kreatif:

• Server pusat mengirimkan Webhook aman ke endpoint resmi:
  https://domain-anda.com/wp-json/adk-buku-tamu/v1/license/revoke
• Webhook diproteksi dengan validasi ketat identitas produk (product_slug: adk-buku-tamu) dan kecocokan kunci lisensi aktif, sehingga pencabutan webhook dari produk plugin lain tidak akan salah menghapus lisensi buku tamu.
• Begitu sinyal diterima, sertifikat lokal dihapus seketika dan fitur plugin terkunci.

Langkah 5: Menjalankan Pembaruan Otomatis (Auto-Update)

Plugin ini mendukung sistem pembaruan resmi WordPress Core:

1. Saat rilis baru tersedia di Adek Kreatif, banner notifikasi akan muncul di menu Plugins dan Dashboard > Updates.
2. Klik tautan Tampilkan rincian versi X.X.X untuk melihat daftar fitur baru dan perbaikan (telah dikelompokkan rapi ke dalam Fitur Baru dan Perbaikan).
3. Klik Perbarui Sekarang untuk memperbarui plugin secara langsung dengan sekali klik.

Jika Muncul Tulisan: "Pembaruan otomatis tidak tersedia untuk plugin ini":
Pesan ini muncul jika website belum diaktivasi lisensinya atau domain belum terdaftar di server Adek Kreatif. Pastikan lisensi sudah aktif di tab Lisensi Plugin, lalu klik tombol Periksa Lagi di menu Dashboard > Updates.

Langkah 6: Memindahkan Lisensi ke Domain Baru

Jika Anda berganti domain atau memindahkan website ke klien:

1. Buka tab Lisensi Plugin di website lama.
2. Klik tombol Nonaktifkan Lisensi.
3. Pasang dan masukkan kunci lisensi yang sama di website domain baru.
4. Jika website lama sudah terlanjur dihapus/mati, reset domain aktivasi secara mandiri melalui member area di https://adekkreatif.com.