Dokumentasi Aplikasi Shopify
Segala yang anda perlukan untuk memasang dan menyesuaikan penukaran mata wang di kedai Shopify anda
Kandungan
1 Pemasangan
Pasang dari Shopify App Store
- Lawati halaman aplikasi Currency.Wiki di Shopify App Store
- Klik 'Add app' dan benarkan pemasangan
- Aplikasi akan dibuka dan membimbing anda melalui wizard pemasangan
- Lengkapkan wizard pemasangan untuk mula menukar harga
Petua: Wizard pemasangan mengambil masa kira-kira 2 minit dan membimbing anda setiap langkah.
2 Wizard Pemasangan
Wizard pemasangan membantu anda mengkonfigurasi aplikasi dengan betul. Ia membimbing anda mengemas kini format mata wang dan mengaktifkan app embed.
Langkah 1: Selamat Datang
Semak apa yang terlibat dalam proses pemasangan dan klik 'Let's Get Started'.
Langkah 2: Kemas Kini Format Mata Wang
Pergi ke Shopify Admin → Settings → General → Store defaults. Cari mata wang anda dan klik menu tiga titik → 'Change currency formatting'. Kemas kini medan HTML dengan kelas pembalut kami:
HTML dengan mata wang:
<span class="cwiki">${{amount}} USD</span>
HTML tanpa mata wang:
<span class="cwiki">${{amount}}</span>
Penting: Kelas pembalut cwiki adalah penting. Ia memberitahu aplikasi kami elemen mana di halaman anda adalah harga, jadi kami hanya menukar harga sebenar dan bukan nombor telefon atau ID pesanan.
Langkah 3: Aktifkan App Embed
Aktifkan aplikasi dalam bahagian app embeds tema anda:
- Pergi ke Online Store → Themes → Customize
- Cari 'App embeds' di bar sisi kiri
- Cari 'Currency.Wiki App' dan aktifkan
- Klik Save dalam editor tema
Langkah 4: Sahkan Pemasangan
Klik 'Scan My Store' untuk mengesahkan pemasangan lengkap. Wizard akan memeriksa kelas pembalut cwiki dan app embed. Jika berjaya, anda sudah sedia!
3 Gaya Widget
Pilih daripada 6 gaya widget untuk dipadankan dengan reka bentuk kedai anda. Setiap gaya boleh disesuaikan dengan warna jenama anda.
Dropdown Minimal
Integrasi header padat dengan senarai dropdown ringkas. Terbaik untuk penempatan header kanan atas.
Butang Terapung
Butang terapung mesra mudah alih dengan panel boleh kembang. Sesuai untuk kedai berfokus mudah alih. Diletakkan di penjuru.
Laci Sidebar
Panel keluar penuh dengan fungsi carian. Ideal untuk kedai yang menawarkan banyak mata wang.
Popup Modal
Lapisan tengah dengan susun atur grid. Menjadikan pemilihan mata wang lebih fokus.
Penukar Tab Inline
Tab mendatar untuk mata wang popular. Tukar dengan cepat tanpa buka menu.
Lencana Penjuru
Ikon penjuru minimalis yang mengembang apabila diklik. Paling tidak mengganggu untuk reka bentuk bersih.
Petua: Gunakan halaman Tetapan Widget dalam admin aplikasi anda untuk pratonton semua gaya dengan warna kedai anda.
4 Papan Pemuka Admin
Papan pemuka admin memberi anda kawalan penuh ke atas cara penukaran mata wang berfungsi di kedai anda.
Laman Utama Papan Pemuka
Togol widget hidup/mati, lihat statistik penukaran, dan lihat pratonton langsung widget anda.
Tetapan Widget
Pilih gaya widget anda, kedudukan, warna, saiz, radius sempadan, dan pilihan paparan bendera.
Pengurusan Mata Wang
Aktif/tidak aktifkan mata wang, susun semula senarai, konfigurasikan tingkah laku auto-detect, dan tetapkan keutamaan kadar tukaran.
Analitik
Lihat carta penukaran, lihat mata wang teratas yang digunakan, dan fahami taburan pelanggan antarabangsa anda.
Tema & Penampilan
Pilih mod tema (auto, cerah, gelap, tersuai), tetapkan warna, aktifkan kesan glassmorphism, dan konfigurasikan tingkah laku mod gelap.
Mesej Semasa Checkout
Aktifkan mesej di halaman troli/checkout untuk memaklumkan pelanggan tentang mata wang semasa pembayaran.
5 Tetapan Lanjutan
Tetapan lanjutan memberi pengguna Pro lebih kawalan ke atas format harga dan tingkah laku penukaran.
Format Harga (Pro)
- Tempat Perpuluhan - Kawal bilangan tempat perpuluhan yang dipaparkan (0-6).
- Format Nombor - Pilih gaya format (Auto, US, EU, India, Space•Dot, Space•Comma).
- Kedudukan Simbol - Letak simbol mata wang sebelum atau selepas amaun, atau auto mengikut mata wang.
- Pembundaran - Standard, sentiasa naik, sentiasa turun, atau tiada pembundaran. Pilihan untuk bundar ke .99 terdekat.
Integrasi Tema (Pro)
Embed widget atau notis troli secara manual di mana-mana dalam tema anda menggunakan snippet HTML berikut:
Embed widget (tambah ke header.liquid atau mana-mana bahagian):
<div class="cwiki-widget"></div>
Embed notis troli (tambah ke cart.liquid):
<div class="cwiki-banner"></div>
Pilihan Pembangun (Pro)
- Gaya Tertindih - Suntik CSS tersuai untuk melaras gaya widget.
- Pendengar Klik - Tukar harga semula apabila elemen tertentu diklik (cth: pemilih saiz, pilihan produk).
- Elemen Harga Tambahan - Sasar elemen harga tambahan selain pembalut .cwiki lalai.
- Corak URL - Imbas semula harga apabila URL mengandungi rentetan tertentu (untuk kandungan AJAX, skrol tanpa henti).
- Kelewatan Penukaran - Tunggu sebelum menukar harga (untuk kandungan yang dimuatkan selepas halaman sedia).
Perhatian: Pilihan ini untuk pengguna lanjutan. Uji pada tema pratonton sebelum diterbitkan.
6 Penyelesaian Masalah
Harga tidak ditukar?
Pastikan kelas pembalut cwiki ada dalam tetapan format mata wang anda. Pergi ke Settings → General → Store defaults dan semak format HTML. Juga pastikan app embed diaktifkan dalam penyesuai tema anda.
Widget tidak dipaparkan?
Pastikan app embed diaktifkan dalam bahagian App Embeds tema anda. Cuba buka penyesuai tema, cari App Embeds, dan pastikan Currency.Wiki diaktifkan. Simpan dan muat semula kedai anda.
Harga berkelip semasa dimuatkan?
Aplikasi kami direka untuk pemuatan tanpa flicker. Jika anda lihat flicker, semak jika ada plugin cache yang mungkin mengganggu. Pastikan juga app embed dimuatkan di bahagian head tema anda.
Mata wang salah dikesan?
Geo-detect berdasarkan alamat IP pelawat. VPN atau rangkaian korporat boleh menjejaskan pengesanan. Pelawat sentiasa boleh pilih mata wang pilihan secara manual. Anda juga boleh tetapkan mata wang fallback lalai dalam tetapan.
Widget tidak sepadan dengan tema saya?
Gunakan tetapan Tema & Penampilan untuk sesuaikan warna, atau aktifkan mod Auto untuk mengesan warna tema anda secara automatik. Anda juga boleh gunakan CSS tersuai dalam Tetapan Lanjutan untuk pelarasan terperinci.
Perlukan Bantuan?
Pasukan sokongan kami sedia membantu dengan sebarang soalan tentang pemasangan atau konfigurasi.
