Dokumentasi Plugin AgenWebsite Shipping

Pengenalan AgenWebsite Shipping

AgenWebsite Shipping adalah plugin WordPress/WooCommerce yang menyediakan integrasi lengkap dengan berbagai kurir pengiriman di Indonesia. Plugin ini dirancang khusus untuk toko online Indonesia dan terintegrasi dengan berbagai API kurir untuk menghitung biaya pengiriman secara real-time.

Fitur Utama

Persyaratan Sistem

• WordPress 5.0 atau lebih tinggi
• WooCommerce 9.0.0 - 9.4.3
• PHP 7.4 atau lebih tinggi
• Koneksi internet untuk API calls
• SSL Certificate (disarankan untuk keamanan)

Persyaratan Tambahan untuk Fitur Premium

• Kurir Instan: Google Maps API Key
• Pelacakan: Akses ke sistem tracking kurir

Instalasi Plugin

Metode 1: Upload melalui WordPress Admin

1. 1Login ke WordPress Admin Dashboard
2. 2Navigasi ke Plugins → Add New
3. 3Klik tombol Upload Plugin
4. 4Pilih file agenwebsite-shipping.zip
5. 5Klik Install Now dan tunggu hingga selesai
6. 6Klik Activate Plugin

Metode 2: Upload via FTP

1. 1Extract file agenwebsite-shipping.zip
2. 2Upload folder agenwebsite-shipping ke /wp-content/plugins/
3. 3Login ke WordPress Admin
4. 4Navigasi ke Plugins
5. 5Cari AgenWebsite Shipping dan klik Activate

Setup Awal dengan Wizard

Setelah aktivasi plugin, Setup Wizard akan otomatis muncul. Wizard ini memandu Anda melalui 3 langkah konfigurasi dasar:

Langkah 1: Welcome

Halaman selamat datang yang menjelaskan fitur-fitur plugin. Klik Next untuk melanjutkan.

Langkah 2: Pemilihan Lisensi

Untuk versi PRO, Anda perlu memasukkan:

• License Key: Kode lisensi dari pembelian
• Email: Email yang digunakan saat pembelian

Langkah 3: Setup & Aktivasi

Pengaturan Asal Pengiriman:

1. 1Pilih Kota Asal dari dropdown
2. 2Masukkan Kode Pos (opsional)

Pemilihan Kurir:

• Versi Free: Pilih 1 kurir
• Versi PRO: Pilih multiple kurir dengan checkbox

Konfigurasi Umum

Setelah setup wizard, Anda dapat mengakses pengaturan lengkap di WooCommerce → Settings → Shipping → AgenWebsite Shipping

Tab General Settings

Pengaturan Dasar:

• Enable/Disable: Aktifkan atau nonaktifkan plugin
• Title: Judul metode pengiriman (default: "AgenWebsite Shipping")
• API Endpoint: URL API (default: https://api-v2.agenwebsite.com/v2)

Pengaturan Asal:

• Origin City: Kota asal pengiriman
• ZIP Code: Kode pos asal

Pengaturan Berat:

• Default Weight: Berat default untuk produk tanpa berat (dalam gram)
• Show Total Weight: Tampilkan total berat di checkout

Pengaturan Kurir:

• Domestic Couriers: Pilih kurir domestik yang aktif
• Instant Couriers (PRO): Aktifkan kurir instan
• International Shipping (PRO): Aktifkan pengiriman internasional

Pengaturan Lanjutan

Opsi Debug:

• Debug Mode: Aktifkan untuk troubleshooting
• Log API Calls: Catat semua API request/response

Cache Settings:

• Enable Cache: Cache hasil API untuk performa
• Cache Duration: Durasi cache (default: 12 jam)

Pengaturan Kurir

Setiap kurir memiliki tab pengaturan tersendiri untuk konfigurasi detail layanan.

Konfigurasi Per Kurir

JNE Settings:

• Enable JNE: Aktifkan kurir JNE
• Services: Pilih layanan yang tersedia:
  • OKE - Ongkos Kirim Ekonomis
  • REG - Regular Service
  • YES - Yakin Esok Sampai
  • SPS - Super Speed
  • JTR - JNE Trucking
• Extra Cost: Biaya tambahan per layanan (Rp atau %)

Kurir Lainnya:

Pengaturan serupa tersedia untuk:

• POS Indonesia: Pos Reguler, Pos Kilat Khusus, Express Next Day
• TIKI: ECO, REG, ONS
• SiCepat: REG, BEST, HALU
• J&T Express: EZ, REG
• AnterAja: Same Day, Next Day, Regular
• Paxel: Small, Medium, Large

Tips Konfigurasi Kurir

Kurir Instan (PRO)

Fitur kurir instan memungkinkan pengiriman same-day dengan integrasi Google Maps untuk perhitungan jarak.

Setup Google Maps API

1. 1Dapatkan Google Maps API Key dari Google Cloud Console
2. 2Aktifkan APIs berikut:
   • Maps JavaScript API
   • Places API
   • Geocoding API
   • Distance Matrix API
3. 3Masukkan API Key di pengaturan plugin
4. 4Klik Validate API Key

Konfigurasi Maps

Pengaturan Lokasi Toko:

• Store Latitude: Koordinat latitude toko
• Store Longitude: Koordinat longitude toko
• Use Map Selector: Gunakan peta interaktif untuk memilih lokasi

Pengaturan Regional:

• Language: Bahasa peta (ID, EN, MS, TH, VI)
• Region: Wilayah fokus (ID, MY, SG, TH, VN)
• Country Restriction: Batasi pencarian ke negara tertentu

Pengaturan UI:

• Default Zoom: Level zoom awal peta (10-18)
• Map Height: Tinggi peta dalam pixel
• Enable Search Box: Tampilkan kotak pencarian

Kurir yang Didukung

Fitur Asuransi (PRO)

Fitur asuransi memungkinkan perlindungan tambahan untuk produk yang dikirim.

Pengaturan Asuransi

Opsi Dasar:

• Enable Insurance: Aktifkan fitur asuransi
• Insurance Type:
  • Optional: Pelanggan bisa memilih
  • Mandatory: Wajib untuk semua pesanan

Formula Perhitungan:

• Insurance Percentage: Persentase dari nilai produk
• Fixed Amount: Biaya tetap tambahan
• Formula: (Nilai Produk × %) + Biaya Tetap

Kustomisasi Label:

• Insurance Label: Text yang ditampilkan di checkout
• Insurance Description: Penjelasan detail asuransi

Pengaturan Per Produk

Anda dapat mengatur asuransi per produk di halaman edit produk:

• Override pengaturan global
• Set asuransi wajib untuk produk high-value
• Nonaktifkan asuransi untuk produk tertentu

Fitur Cek Ongkir (PRO)

Widget cek ongkir memungkinkan pelanggan memeriksa biaya pengiriman sebelum menambahkan produk ke keranjang.

Aktivasi Widget

• 1Aktifkan Enable Check Shipping Cost di settings
• 2Widget otomatis muncul di halaman produk
• 3Kustomisasi tampilan di tab UI Settings

Cara Penggunaan (Frontend)

1. Pelanggan membuka halaman produk
2. Klik tombol "Cek Ongkir"
3. Masukkan informasi pengiriman:
   • Provinsi tujuan
   • Kota/Kabupaten tujuan
   • Kecamatan (jika tersedia)
4. Sistem menampilkan opsi pengiriman dan biaya

Kustomisasi Tampilan

Opsi Style:

• Button Style: Rounded, Square, Pill, Modern, Minimal
• Primary Color: Warna utama tombol dan elemen
• Modal Size: Small, Medium, Large, Fullscreen
• Animation: Enable/disable animasi transisi

Custom CSS:

Tambahkan CSS kustom untuk styling lebih detail:

.awshipping-check-button {
    /* Custom button styles */
}
.awshipping-modal {
    /* Custom modal styles */
}

Pelacakan Paket (PRO)

Fitur tracking memungkinkan pelanggan melacak status pengiriman paket mereka.

Setup Tracking

Pengaturan Dasar:

• Enable Tracking: Aktifkan fitur pelacakan
• Tracking Page: Pilih halaman untuk tracking
• Show in My Account: Tampilkan di area akun pelanggan
• Show in Emails: Sertakan info tracking di email

Kustomisasi Pesan:

• Tracking Button Text: Label tombol tracking
• No Tracking Message: Pesan jika tracking belum tersedia
• Tracking Found Message: Pesan sukses tracking

Cara Kerja Tracking

1. 1Admin memasukkan nomor resi di order details
2. 2Sistem otomatis mendeteksi kurir dari order
3. 3Pelanggan dapat tracking melalui:
   • Link di email konfirmasi
   • My Account → Orders
   • Halaman tracking dedicated
4. 4Status real-time dari API kurir ditampilkan

Shortcode Tracking

Gunakan shortcode untuk menampilkan form tracking di halaman manapun:

[agenwebsite_tracking]

Parameter Shortcode:

• title="Track Your Order" - Judul form
• button_text="Track" - Text tombol
• placeholder="Enter tracking number" - Placeholder input

Proses Checkout

Plugin ini memodifikasi proses checkout WooCommerce untuk integrasi dengan sistem pengiriman Indonesia.

Perubahan di Checkout

Field Alamat Kustom:

• Provinsi: Dropdown provinsi Indonesia
• Kota/Kabupaten: Dropdown dinamis berdasarkan provinsi
• Kecamatan: Dropdown untuk kurir yang support
• Kode Pos: Auto-complete berdasarkan kecamatan

Proses Pemilihan Pengiriman:

1. 1Pelanggan mengisi alamat lengkap
2. 2Sistem menghitung berat total pesanan
3. 3API call ke kurir untuk mendapat tarif
4. 4Opsi pengiriman ditampilkan dengan:
   • Nama kurir dan layanan
   • Estimasi waktu pengiriman
   • Biaya pengiriman
5. 5Pelanggan memilih opsi pengiriman
6. 6Total order diupdate dengan ongkir

Integrasi WooCommerce Blocks

Plugin kompatibel dengan WooCommerce block-based checkout:

• Field kustom terintegrasi dengan Checkout Block
• Real-time calculation tetap berfungsi
• UI responsive untuk mobile

Tips Optimasi Checkout

Troubleshooting

Masalah Umum dan Solusi

1. Tidak Ada Opsi Pengiriman Muncul

• Penyebab: API tidak merespons atau konfigurasi salah
• Solusi:
  • Cek koneksi internet
  • Verifikasi API endpoint benar
  • Pastikan minimal 1 kurir aktif
  • Cek origin city sudah diset
  • Aktifkan debug mode untuk melihat error

2. Harga Pengiriman Tidak Akurat

• Penyebab: Berat produk tidak diset atau salah
• Solusi:
  • Set berat untuk semua produk (dalam gram)
  • Gunakan default weight untuk produk tanpa berat
  • Verifikasi extra cost setting
  • Test dengan clear cache

3. Dropdown Kota Tidak Muncul

• Penyebab: JavaScript error atau conflict
• Solusi:
  • Cek browser console untuk error
  • Disable plugin lain untuk test conflict
  • Clear browser cache
  • Pastikan jQuery loaded

4. Google Maps Tidak Tampil (Kurir Instan)

• Penyebab: API key invalid atau quota exceeded
• Solusi:
  • Validate API key di settings
  • Cek billing aktif di Google Cloud
  • Verifikasi APIs yang required sudah aktif
  • Cek domain restriction di API key

5. Tracking Tidak Berfungsi

• Penyebab: Nomor resi salah atau API kurir down
• Solusi:
  • Verifikasi nomor resi benar
  • Cek format nomor resi sesuai kurir
  • Test tracking di website kurir langsung
  • Tunggu beberapa jam setelah pengiriman

Debug Mode

Untuk troubleshooting lebih detail:

1. Aktifkan Debug Mode di settings
2. Reproduce masalah yang terjadi
3. Cek log file di /wp-content/uploads/wc-logs/
4. Cari file dengan prefix agenwebsite-shipping

Mendapatkan Support

Frequently Asked Questions (FAQ)

Umum

Q: Apakah plugin ini gratis?

A: Ya, tersedia versi gratis dengan fitur dasar (1 kurir domestik). Untuk fitur lengkap dan multiple kurir, diperlukan lisensi PRO.

Q: Bagaimana cara upgrade ke PRO?

A: Beli lisensi di website AgenWebsite, kemudian masukkan license key di plugin settings. Semua fitur PRO akan otomatis aktif.

Q: Apakah support WooCommerce terbaru?

A: Ya, plugin di-update regular untuk kompatibilitas dengan WooCommerce versi terbaru. Check changelog untuk detail.

Teknis

Q: Bisakah menggunakan plugin ini dengan shipping plugin lain?

A: Ya, plugin ini bisa bekerja bersama shipping method lain. Anda bisa mengatur zone dan rules di WooCommerce shipping settings.

Q: Bagaimana cara menambah kurir baru?

A: Kurir baru ditambahkan melalui update plugin. Request kurir baru bisa dikirim ke team development.

Q: Apakah data pelanggan aman?

A: Ya, semua komunikasi API menggunakan HTTPS. Data pelanggan tidak disimpan di server eksternal, hanya digunakan untuk kalkulasi shipping.

Lisensi

Q: Berapa lama masa aktif lisensi PRO?

A: Lisensi PRO berlaku lifetime untuk domain yang didaftarkan. Update dan support tersedia selama 1 tahun, bisa diperpanjang.

Q: Bisakah pindah domain?

A: Ya, lisensi bisa dipindah ke domain lain. Hubungi support untuk proses transfer lisensi.

Q: Ada diskon untuk multiple lisensi?

A: Ya, tersedia paket bundle untuk pembelian multiple lisensi. Check pricing page untuk detail.

Performa

Q: Apakah plugin ini mempengaruhi kecepatan website?

A: Impact minimal. Plugin menggunakan AJAX untuk kalkulasi shipping dan cache untuk optimasi. API calls hanya dilakukan saat diperlukan.

Q: Bagaimana cara optimasi untuk traffic tinggi?

A:

• Aktifkan cache dengan durasi lebih lama
• Gunakan CDN untuk asset files
• Limit jumlah kurir aktif
• Gunakan object cache seperti Redis