Documentación da aplicación Shopify
Todo o que necesitas para configurar e personalizar a conversión de moeda na túa tenda Shopify
Índice
1 Instalación
Instalar desde Shopify App Store
- Visita a páxina da aplicación Currency.Wiki na Shopify App Store
- Preme en 'Engadir aplicación' e autoriza a instalación
- A aplicación abrirase e guiarate polo asistente de configuración
- Completa o asistente para comezar a converter prezos
Consello: O asistente de configuración leva uns 2 minutos e guíate en cada paso.
2 Asistente de configuración
O asistente de configuración axúdache a configurar correctamente a aplicación. Guíate para actualizar o formato de moeda e activar a incrustación da aplicación.
Paso 1: Benvida
Revisa en que consiste o proceso de configuración e preme en 'Comezar'.
Paso 2: Actualizar formato de moeda
Vai a Shopify Admin → Configuración → Xeral → Predeterminados da tenda. Busca a túa moeda e preme no menú de tres puntos → 'Cambiar formato de moeda'. Actualiza os campos HTML coa nosa clase wrapper:
HTML con moeda:
<span class="cwiki">${{amount}} USD</span>
HTML sen moeda:
<span class="cwiki">${{amount}}</span>
Importante: A clase wrapper cwiki é esencial. Indícalle á nosa aplicación que elementos da páxina son prezos, para converter só prezos reais e non números de teléfono ou ID de pedidos.
Paso 3: Activar incrustación da aplicación
Activa a aplicación na sección de incrustacións do teu tema:
- Vai a Tenda en liña → Temas → Personalizar
- Busca 'App embeds' na barra lateral esquerda
- Atopa 'Currency.Wiki App' e actívao
- Preme en Gardar no editor de temas
Paso 4: Verificar configuración
Preme en 'Escanear a miña tenda' para verificar que a configuración está completa. O asistente comprobará a clase wrapper cwiki e a incrustación da aplicación. Se todo está correcto, xa podes comezar!
3 Estilos do widget
Escolle entre 6 estilos de widget para adaptar ao deseño da túa tenda. Cada estilo pode personalizarse coas cores da túa marca.
Despregable minimalista
Integración compacta na cabeceira cunha lista despregable sinxela. Ideal para situar na parte superior dereita.
Pílula flotante
Botón flotante amigable para móbiles con panel expandible. Xenial para tendas móbil-primeiro. Posiciónase nas esquinas.
Caxón lateral
Panel deslizante de altura completa con función de busca. Ideal para tendas con moitas moedas.
Xanela emerxente
Superposición centrada con disposición en grella. Fai da selección de moeda unha experiencia focalizada.
Selector de pestanas en liña
Pestanas horizontais para moedas populares. Cambio rápido sen abrir menús.
Insignia de esquina
Icona minimalista de esquina que se expande ao premer. Opción menos intrusiva para deseños limpos.
Consello: Usa a páxina de axustes do widget na administración da aplicación para previsualizar todos os estilos coas cores da túa tenda.
4 Panel de administración
O panel de administración dálle control total sobre como funciona a conversión de moeda na túa tenda.
Inicio do panel
Activa/desactiva o widget, consulta estatísticas de conversión e ve unha previsualización en tempo real do teu widget.
Axustes do widget
Escolle o estilo do widget, posición, cores, tamaño, radio de bordes e opcións de bandeira.
Xestión de moedas
Activa/desactiva moedas, reordena a lista, configura o comportamento de detección automática e establece preferencias de taxas de cambio.
Analítica
Consulta gráficas de conversión, as moedas máis usadas e comprende a distribución internacional dos teus clientes.
Tema e aparencia
Escolle o modo de tema (auto, claro, escuro, personalizado), establece cores, activa efectos glassmorphism e configura o comportamento do modo escuro.
Mensaxe en checkout
Activa unha mensaxe nas páxinas de cesta/checkout para informar aos clientes sobre a moeda de pago.
5 Axustes avanzados
Os axustes avanzados dan aos usuarios Pro máis control sobre o formato de prezos e o comportamento da conversión.
Formato de prezos (Pro)
- Decimais - Controla cantos decimais mostrar (0-6).
- Formato de número - Escolle o estilo de formato (Auto, US, EU, Indio, Espazo•Punto, Espazo•Coma).
- Posición do símbolo - Coloca o símbolo da moeda antes ou despois do importe, ou auto segundo a moeda.
- Redondeo - Estándar, sempre arriba, sempre abaixo ou sen redondeo. Opción para redondear ao máis próximo .99.
Integración co tema (Pro)
Incrusta manualmente o widget ou aviso de cesta en calquera lugar do teu tema usando estes fragmentos HTML:
Incrustación do widget (engadir a header.liquid ou calquera sección):
<div class="cwiki-widget"></div>
Incrustación de aviso de cesta (engadir a cart.liquid):
<div class="cwiki-banner"></div>
Opcións para desenvolvedores (Pro)
- Overrides de estilo - Inxecta CSS personalizado para axustar o estilo do widget.
- Listeners de clic - Reconverte prezos cando se preman elementos específicos (ex: selectores de talla, opcións de produto).
- Elementos de prezo extra - Apunta a elementos de prezo adicionais ademais do wrapper .cwiki por defecto.
- Patróns de URL - Re-escanea prezos cando a URL contén cadeas específicas (para contido AJAX, scroll infinito).
- Atraso na conversión - Espera antes de converter prezos (para contido que carga despois de que a páxina estea lista).
Atención: Estas opcións son para usuarios avanzados. Proba nun tema de previsualización antes de publicar.
6 Resolución de problemas
Os prezos non se converten?
Asegúrate de que a clase wrapper cwiki está nos axustes de formato de moeda. Vai a Configuración → Xeral → Predeterminados da tenda e revisa o formato HTML. Tamén verifica que a incrustación da aplicación está activada no personalizador de temas.
O widget non se mostra?
Comproba que a incrustación da aplicación está activada na sección App Embeds do teu tema. Proba a abrir o personalizador de temas, busca App Embeds e asegúrate de que Currency.Wiki está activado. Garda e actualiza a túa tenda.
Os prezos parpadean ao cargar?
A nosa aplicación está deseñada para carga sen parpadeos. Se ves parpadeo, comproba se tes plugins de caché que poidan interferir. Asegúrate tamén de que a incrustación da aplicación se carga na sección head do teu tema.
Detecta a moeda incorrecta?
A detección xeográfica baséase no enderezo IP do visitante. VPNs ou redes corporativas poden afectar a detección. Os visitantes sempre poden seleccionar manualmente a súa moeda preferida. Tamén podes establecer unha moeda predeterminada de respaldo nos axustes.
O widget non encaixa co meu tema?
Usa os axustes de Tema e Aparencia para personalizar as cores, ou activa o modo Auto para detectar automaticamente as cores do teu tema. Tamén podes usar CSS personalizado en Axustes Avanzados para axustar o estilo.
Precisas axuda?
O noso equipo de soporte está preparado para axudarche con calquera dúbida sobre a configuración.
