Dokumentasi Aplikasi Shopify
Semua yang Anda butuhkan untuk mengatur dan menyesuaikan konversi mata uang di toko Shopify Anda
Daftar Isi
1 Instalasi
Instal dari Shopify App Store
- Kunjungi halaman aplikasi Currency.Wiki di Shopify App Store
- Klik 'Add app' dan otorisasi instalasi
- Aplikasi akan terbuka dan membimbing Anda melalui setup wizard
- Selesaikan setup wizard untuk mulai mengonversi harga
Tips: Setup wizard hanya memakan waktu sekitar 2 menit dan membimbing Anda di setiap langkah.
2 Setup Wizard
Setup wizard membantu Anda mengonfigurasi aplikasi dengan benar. Membimbing Anda memperbarui format mata uang dan mengaktifkan app embed.
Langkah 1: Selamat Datang
Tinjau proses setup dan klik 'Let's Get Started'.
Langkah 2: Perbarui Format Mata Uang
Buka Shopify Admin → Settings → General → Store defaults. Temukan mata uang Anda dan klik menu tiga titik → 'Change currency formatting'. Perbarui field HTML dengan class wrapper kami:
HTML dengan mata uang:
<span class="cwiki">${{amount}} USD</span>
HTML tanpa mata uang:
<span class="cwiki">${{amount}}</span>
Penting: Class wrapper cwiki sangat penting. Ini memberi tahu aplikasi kami elemen mana di halaman Anda yang merupakan harga, sehingga kami hanya mengonversi harga sebenarnya dan bukan nomor telepon atau ID pesanan.
Langkah 3: Aktifkan App Embed
Aktifkan aplikasi di bagian app embeds tema Anda:
- Buka Online Store → Themes → Customize
- Cari 'App embeds' di sidebar kiri
- Temukan 'Currency.Wiki App' dan aktifkan
- Klik Save di editor tema
Langkah 4: Verifikasi Pengaturan
Klik 'Scan My Store' untuk memverifikasi pengaturan sudah lengkap. Wizard akan memeriksa class wrapper cwiki dan app embed. Jika berhasil, Anda siap digunakan!
3 Gaya Widget
Pilih dari 6 gaya widget agar sesuai dengan desain toko Anda. Setiap gaya dapat disesuaikan dengan warna brand Anda.
Dropdown Minimal
Integrasi header ringkas dengan daftar dropdown sederhana. Terbaik untuk penempatan di kanan atas header.
Floating Pill
Tombol mengambang ramah seluler dengan panel yang dapat diperluas. Cocok untuk toko mobile-first. Ditempatkan di sudut.
Sidebar Drawer
Panel slide-out penuh dengan fungsi pencarian. Ideal untuk toko dengan banyak mata uang.
Popup Modal
Overlay terpusat dengan tata letak grid. Membuat pemilihan mata uang lebih fokus.
Tab Inline
Tab horizontal untuk mata uang populer. Beralih cepat tanpa membuka menu.
Corner Badge
Ikon sudut minimalis yang membesar saat diklik. Paling tidak mengganggu untuk desain bersih.
Tips: Gunakan halaman Pengaturan Widget di admin aplikasi Anda untuk melihat pratinjau semua gaya dengan warna toko Anda.
4 Dashboard Admin
Dashboard admin memberi Anda kontrol penuh atas cara kerja konversi mata uang di toko Anda.
Beranda Dashboard
Aktifkan/matikan widget, lihat statistik konversi, dan lihat pratinjau langsung widget Anda.
Pengaturan Widget
Pilih gaya widget, posisi, warna, ukuran, radius border, dan opsi tampilan bendera.
Manajemen Mata Uang
Aktifkan/nonaktifkan mata uang, atur ulang daftar, atur perilaku deteksi otomatis, dan atur preferensi kurs.
Analitik
Lihat grafik konversi, mata uang teratas yang digunakan, dan distribusi pelanggan internasional Anda.
Tema & Tampilan
Pilih mode tema (auto, light, dark, custom), atur warna, aktifkan efek glassmorphism, dan atur perilaku mode gelap.
Pesan Checkout
Aktifkan pesan di halaman keranjang/checkout untuk memberi tahu pelanggan tentang mata uang checkout.
5 Pengaturan Lanjutan
Pengaturan lanjutan memberi pengguna Pro kontrol lebih atas format harga dan perilaku konversi.
Format Harga (Pro)
- Jumlah Desimal - Atur berapa banyak angka desimal yang ditampilkan (0-6).
- Format Angka - Pilih gaya format (Auto, US, EU, India, Spasi•Titik, Spasi•Koma).
- Posisi Simbol - Tempatkan simbol mata uang sebelum atau sesudah jumlah, atau otomatis per mata uang.
- Pembulatan - Standar, selalu naik, selalu turun, atau tanpa pembulatan. Opsi pembulatan ke .99 terdekat.
Integrasi Tema (Pro)
Embed widget atau pemberitahuan keranjang secara manual di mana saja di tema Anda menggunakan snippet HTML berikut:
Embed widget (tambahkan ke header.liquid atau bagian mana saja):
<div class="cwiki-widget"></div>
Embed pemberitahuan keranjang (tambahkan ke cart.liquid):
<div class="cwiki-banner"></div>
Opsi Pengembang (Pro)
- Override Gaya - Sisipkan CSS kustom untuk menyesuaikan tampilan widget.
- Click Listeners - Konversi ulang harga saat elemen tertentu diklik (misal: pemilih ukuran, opsi produk).
- Elemen Harga Tambahan - Target elemen harga tambahan di luar .cwiki wrapper default.
- Pola URL - Pindai ulang harga saat URL mengandung string tertentu (untuk konten AJAX, endless scroll).
- Delay Konversi - Tunggu sebelum mengonversi harga (untuk konten yang dimuat setelah halaman siap).
Perhatian: Opsi ini untuk pengguna tingkat lanjut. Uji di tema pratinjau sebelum dipublikasikan.
6 Pemecahan Masalah
Harga tidak terkonversi?
Pastikan class wrapper cwiki ada di pengaturan format mata uang Anda. Buka Settings → General → Store defaults dan cek format HTML. Juga pastikan app embed aktif di theme customizer Anda.
Widget tidak tampil?
Periksa apakah app embed aktif di bagian App Embeds tema Anda. Coba buka theme customizer, cari App Embeds, dan pastikan Currency.Wiki aktif. Simpan dan refresh toko Anda.
Harga berkedip saat dimuat?
Aplikasi kami dirancang untuk loading tanpa flicker. Jika Anda melihat flicker, periksa apakah ada plugin cache yang mengganggu. Pastikan juga app embed dimuat di bagian head tema Anda.
Mata uang terdeteksi salah?
Deteksi geo berdasarkan alamat IP pengunjung. VPN atau jaringan kantor dapat memengaruhi deteksi. Pengunjung selalu dapat memilih mata uang secara manual. Anda juga dapat mengatur fallback currency default di pengaturan.
Widget tidak sesuai tema saya?
Gunakan pengaturan Tema & Tampilan untuk menyesuaikan warna, atau aktifkan mode Auto untuk mendeteksi warna tema Anda secara otomatis. Anda juga dapat menggunakan CSS Kustom di Pengaturan Lanjutan untuk penyesuaian detail.
Butuh Bantuan?
Tim dukungan kami siap membantu pertanyaan seputar pengaturan atau konfigurasi.
