Dokumentasyon ng Shopify App
Lahat ng kailangan mo para i-setup at i-customize ang currency conversion sa iyong Shopify store
Talaan ng Nilalaman
1 Pag-install
Mag-install mula sa Shopify App Store
- Bisitahin ang Currency.Wiki app page sa Shopify App Store
- I-click ang 'Add app' at pahintulutan ang pag-install
- Awtomatikong magbubukas ang app at gagabayan ka sa setup wizard
- Kumpletuhin ang setup wizard para masimulan ang pag-convert ng presyo
Tip: Tumatagal lamang ng mga 2 minuto ang setup wizard at gagabayan ka sa bawat hakbang.
2 Setup Wizard
Tinutulungan ka ng setup wizard na tama ang pagkaka-configure ng app. Gagabayan ka nito sa pag-update ng currency format at pag-enable ng app embed.
Hakbang 1: Welcome
Suriin kung ano ang kasama sa proseso ng setup at i-click ang 'Let's Get Started'.
Hakbang 2: I-update ang Currency Format
Pumunta sa Shopify Admin → Settings → General → Store defaults. Hanapin ang iyong currency at i-click ang three dots menu → 'Change currency formatting'. I-update ang HTML fields gamit ang aming wrapper class:
HTML na may currency:
<span class="cwiki">${{amount}} USD</span>
HTML na walang currency:
<span class="cwiki">${{amount}}</span>
Mahalaga: Mahalaga ang cwiki wrapper class. Sinasabi nito sa aming app kung aling elemento sa iyong page ang mga presyo, kaya tanging aktwal na presyo lang ang kino-convert at hindi phone number o order ID.
Hakbang 3: I-enable ang App Embed
I-enable ang app sa app embeds section ng iyong tema:
- Pumunta sa Online Store → Themes → Customize
- Hanapin ang 'App embeds' sa kaliwang sidebar
- Hanapin ang 'Currency.Wiki App' at i-toggle ito sa ON
- I-click ang Save sa theme editor
Hakbang 4: I-verify ang Setup
I-click ang 'Scan My Store' para i-verify na kumpleto na ang setup. Titingnan ng wizard ang cwiki wrapper class at app embed. Kung matagumpay, handa ka nang magsimula!
3 Mga Estilo ng Widget
Pumili mula sa 6 na widget style para bumagay sa disenyo ng iyong store. Maaaring i-customize ang bawat style gamit ang kulay ng iyong brand.
Minimal Dropdown
Compact na integration sa header na may simpleng dropdown list. Pinakamainam para sa top-right header placement.
Floating Pill
Mobile-friendly na floating button na may expandable panel. Maganda para sa mobile-first na stores. Nakapuwesto sa mga sulok.
Sidebar Drawer
Full-height na slide-out panel na may search functionality. Mainam para sa stores na maraming currency.
Modal Popup
Centered overlay na may grid layout. Ginagawang pokus ang pagpili ng currency.
Inline Tab Switcher
Horizontal na tabs para sa popular na currency. Mabilis na switching nang hindi nagbubukas ng menu.
Corner Badge
Minimalist na corner icon na lumalawak kapag na-click. Pinaka-hindi nakakaabala para sa malilinis na disenyo.
Tip: Gamitin ang Widget Settings page sa iyong app admin para makita ang preview ng lahat ng style gamit ang kulay ng iyong store.
4 Admin Dashboard
Ang admin dashboard ay nagbibigay ng buong kontrol kung paano gumagana ang currency conversion sa iyong store.
Dashboard Home
I-toggle ang widget on/off, tingnan ang conversion stats, at makita ang live preview ng iyong widget.
Mga Setting ng Widget
Pumili ng widget style, posisyon, kulay, laki, border radius, at flag display options.
Pamamahala ng Currency
I-enable/disable ang currency, ayusin ang pagkakasunod-sunod, i-configure ang auto-detection, at itakda ang exchange rate preferences.
Analytics
Tingnan ang conversion charts, top currency na ginagamit, at unawain ang distribusyon ng iyong international na customer.
Tema at Itsura
Pumili ng tema mode (auto, light, dark, custom), itakda ang kulay, i-enable ang glassmorphism effects, at i-configure ang dark mode behavior.
Checkout Message
I-enable ang mensahe sa cart/checkout pages para ipaalam sa customer ang tungkol sa checkout currency.
5 Advanced na Mga Setting
Ang advanced settings ay nagbibigay sa Pro users ng mas maraming kontrol sa price formatting at conversion behavior.
Price Formatting (Pro)
- Decimal Places - Kontrolin kung ilang decimal places ang ipapakita (0-6).
- Format ng Numero - Pumili ng format style (Auto, US, EU, Indian, Space•Dot, Space•Comma).
- Posisyon ng Simbolo - Ilagay ang currency symbol bago o pagkatapos ng halaga, o auto per currency.
- Pag-round - Standard, laging pataas, laging pababa, o walang rounding. May opsyon na i-round sa pinakamalapit na .99.
Theme Integration (Pro)
Manu-manong i-embed ang widget o cart notice kahit saan sa iyong tema gamit ang mga HTML snippet na ito:
Widget embed (idagdag sa header.liquid o anumang section):
<div class="cwiki-widget"></div>
Cart notice embed (idagdag sa cart.liquid):
<div class="cwiki-banner"></div>
Developer Options (Pro)
- Style Overrides - Mag-inject ng custom CSS para i-tweak ang widget styling.
- Click Listeners - I-reconvert ang presyo kapag may na-click na partikular na elemento (hal. size pickers, product options).
- Extra Price Elements - I-target ang karagdagang price elements bukod sa default na .cwiki wrapper.
- URL Patterns - Muling i-scan ang presyo kapag ang URL ay may partikular na string (para sa AJAX content, endless scroll).
- Conversion Delay - Maghintay bago i-convert ang presyo (para sa content na naglo-load pagkatapos ng page ready).
Paalala: Ang mga opsyong ito ay para sa advanced users. Subukan muna sa preview theme bago i-publish.
6 Pagsasaayos ng Problema
Hindi nagko-convert ang mga presyo?
Siguraduhing nasa currency format settings mo ang cwiki wrapper class. Pumunta sa Settings → General → Store defaults at tingnan ang HTML formatting. I-verify din na naka-enable ang app embed sa iyong theme customizer.
Hindi lumalabas ang widget?
Tingnan kung naka-enable ang app embed sa App Embeds section ng iyong tema. Subukang buksan ang theme customizer, hanapin ang App Embeds, at siguraduhing naka-ON ang Currency.Wiki. I-save at i-refresh ang iyong store.
Nagfi-flicker ang presyo sa pag-load?
Dinisenyo ang aming app para sa zero-flicker loading. Kung may flicker, tingnan kung may caching plugins na nakakaapekto. Siguraduhin ding naglo-load ang app embed sa head section ng iyong tema.
Maling currency ang natutukoy?
Batay sa IP address ng bisita ang geo-detection. Maaaring makaapekto ang VPNs o corporate networks. Laging maaaring manu-manong pumili ng preferred currency ang bisita. Maaari ka ring magtakda ng default fallback currency sa settings.
Hindi bumabagay ang widget sa tema ko?
Gamitin ang Theme & Appearance settings para i-customize ang kulay, o i-enable ang Auto mode para awtomatikong matukoy ang kulay ng iyong tema. Maaari ka ring gumamit ng Custom CSS sa Advanced Settings para sa mas detalyadong styling.
Kailangan ng Tulong?
Handa ang aming support team na tumulong sa anumang tanong tungkol sa setup o configuration.
