Documentație Aplicație Shopify
Tot ce ai nevoie pentru a configura și personaliza conversia valutară în magazinul tău Shopify
Cuprins
1 Instalare
Instalează din Shopify App Store
- Vizitează pagina aplicației Currency.Wiki din Shopify App Store
- Apasă 'Add app' și autorizează instalarea
- Aplicația se va deschide și te va ghida prin asistentul de configurare
- Finalizează asistentul pentru a începe conversia prețurilor
Sfat: Asistentul de configurare durează aproximativ 2 minute și te ghidează la fiecare pas.
2 Asistent Configurare
Asistentul de configurare te ajută să setezi corect aplicația. Te ghidează pentru actualizarea formatului valutar și activarea embed-ului aplicației.
Pasul 1: Bun venit
Vezi ce implică procesul de configurare și apasă 'Let's Get Started'.
Pasul 2: Actualizează Formatul Monedei
Mergi la Shopify Admin → Settings → General → Store defaults. Găsește moneda ta și apasă pe meniul cu trei puncte → 'Change currency formatting'. Actualizează câmpurile HTML cu clasa noastră:
HTML cu monedă:
<span class="cwiki">${{amount}} USD</span>
HTML fără monedă:
<span class="cwiki">${{amount}}</span>
Important: Clasa cwiki este esențială. Indică aplicației noastre ce elemente de pe pagină sunt prețuri, astfel încât să convertim doar prețurile reale, nu și numerele de telefon sau ID-urile comenzilor.
Pasul 3: Activează App Embed
Activează aplicația în secțiunea App Embeds a temei:
- Mergi la Online Store → Themes → Customize
- Caută 'App embeds' în bara laterală stângă
- Găsește 'Currency.Wiki App' și activează-l
- Apasă Save în editorul de temă
Pasul 4: Verifică Configurarea
Apasă 'Scan My Store' pentru a verifica dacă totul este configurat. Asistentul va verifica existența clasei cwiki și a embed-ului aplicației. Dacă totul e ok, ești gata!
3 Stiluri Widget
Alege din 6 stiluri de widget pentru a se potrivi cu designul magazinului tău. Fiecare stil poate fi personalizat cu culorile brandului tău.
Dropdown Minimal
Integrare compactă în antet cu o listă dropdown simplă. Ideal pentru plasare în colțul din dreapta sus.
Buton Plutitor
Buton mobil prietenos cu panou extensibil. Excelent pentru magazine mobile-first. Poziționare în colțuri.
Panou Lateral
Panou glisant pe toată înălțimea cu funcție de căutare. Ideal pentru magazine cu multe monede.
Popup Modal
Suprapunere centrată cu layout tip grid. Face selecția valutară o experiență focalizată.
Comutator Taburi Inline
Taburi orizontale pentru monede populare. Comutare rapidă fără meniuri suplimentare.
Insignă Colț
Icon minimalist în colț ce se extinde la click. Cea mai puțin intruzivă pentru designuri curate.
Sfat: Folosește pagina de setări a widgetului din admin-ul aplicației pentru a previzualiza toate stilurile cu culorile magazinului tău.
4 Tablou de Bord Admin
Tabloul de bord admin îți oferă control complet asupra modului în care funcționează conversia valutară în magazinul tău.
Acasă Dashboard
Activează/dezactivează widgetul, vezi statistici de conversie și previzualizează live widgetul.
Setări Widget
Alege stilul widgetului, poziția, culorile, dimensiunea, raza colțurilor și opțiunile de afișare a steagurilor.
Gestionare Monede
Activează/dezactivează monede, reordonează lista, configurează comportamentul de detectare automată și preferințele de curs valutar.
Analitice
Vezi grafice de conversie, monedele de top folosite și distribuția clienților internaționali.
Temă & Aspect
Alege modul temei (auto, light, dark, custom), setează culori, activează efecte glassmorphism și configurează comportamentul dark mode.
Mesaj la Checkout
Activează un mesaj pe paginile de coș/checkout pentru a informa clienții despre moneda de plată.
5 Setări Avansate
Setările avansate oferă utilizatorilor Pro mai mult control asupra formatării prețurilor și comportamentului conversiei.
Formatare Preț (Pro)
- Zecimale - Controlează câte zecimale să fie afișate (0-6).
- Format Număr - Alege stilul de format (Auto, US, EU, Indian, Spațiu•Punct, Spațiu•Virgulă).
- Poziție Simbol - Plasează simbolul monedei înainte sau după sumă, sau automat în funcție de monedă.
- Rotunjire - Standard, mereu în sus, mereu în jos sau fără rotunjire. Opțiune de rotunjire la cel mai apropiat .99.
Integrare Temă (Pro)
Integrează manual widgetul sau notificarea de coș oriunde în temă folosind aceste fragmente HTML:
Integrare widget (adaugă în header.liquid sau orice secțiune):
<div class="cwiki-widget"></div>
Integrare notificare coș (adaugă în cart.liquid):
<div class="cwiki-banner"></div>
Opțiuni pentru Dezvoltatori (Pro)
- Suprascrieri CSS - Injectează CSS personalizat pentru ajustarea stilului widgetului.
- Ascultători Click - Reconvertește prețurile când anumite elemente sunt apăsate (ex: selectoare mărime, opțiuni produs).
- Elemente Preț Suplimentare - Țintește elemente de preț suplimentare dincolo de wrapperul .cwiki implicit.
- Pattern-uri URL - Reconvertește prețurile când URL-ul conține anumite șiruri (pentru conținut AJAX, scroll infinit).
- Întârziere Conversie - Așteaptă înainte de a converti prețurile (pentru conținut ce se încarcă după ready).
Atenție: Aceste opțiuni sunt pentru utilizatori avansați. Testează pe o temă de previzualizare înainte de publicare.
6 Depanare
Prețurile nu se convertesc?
Asigură-te că clasa cwiki este în setările de format valutar. Mergi la Settings → General → Store defaults și verifică formatul HTML. De asemenea, verifică dacă embed-ul aplicației este activat în personalizatorul temei.
Widgetul nu apare?
Verifică dacă embed-ul aplicației este activat în secțiunea App Embeds a temei. Deschide personalizatorul temei, găsește App Embeds și asigură-te că Currency.Wiki este activat. Salvează și reîncarcă magazinul.
Prețurile pâlpâie la încărcare?
Aplicația noastră este concepută pentru încărcare fără flicker. Dacă observi pâlpâiri, verifică dacă ai pluginuri de cache care pot interfera. Asigură-te și că embed-ul aplicației se încarcă în secțiunea head a temei.
Se detectează moneda greșită?
Detectarea geo se bazează pe adresa IP a vizitatorului. VPN-urile sau rețelele corporative pot afecta detectarea. Vizitatorii pot selecta manual moneda preferată. Poți seta și o monedă implicită de rezervă în setări.
Widgetul nu se potrivește cu tema mea?
Folosește setările Temă & Aspect pentru a personaliza culorile sau activează modul Auto pentru detectarea automată a culorilor temei. Poți folosi și CSS personalizat în Setări Avansate pentru ajustări fine.
Ai nevoie de ajutor?
Echipa noastră de suport este gata să te ajute cu orice întrebare despre configurare sau setări.
