Документація додатка Shopify
Все, що потрібно для налаштування та кастомізації конвертації валют у вашому магазині Shopify
Зміст
1 Встановлення
Встановити з магазину додатків Shopify
- Відвідайте сторінку додатка Currency.Wiki у магазині Shopify
- Натисніть 'Додати додаток' і підтвердьте встановлення
- Додаток відкриється і проведе вас через майстер налаштування
- Завершіть майстер налаштування, щоб почати конвертацію цін
Порада: Майстер налаштування займає близько 2 хвилин і проведе вас через усі кроки.
2 Майстер налаштування
Майстер налаштування допоможе правильно налаштувати додаток. Він проведе вас через оновлення формату валюти та увімкнення вставки додатка.
Крок 1: Вітання
Ознайомтеся з етапами налаштування і натисніть 'Почати'.
Крок 2: Оновіть формат валюти
Перейдіть у Shopify Admin → Налаштування → Загальні → Стандартні налаштування магазину. Знайдіть свою валюту, натисніть меню з трьома крапками → 'Змінити форматування валюти'. Оновіть HTML-поля з нашим класом-обгорткою:
HTML з валютою:
<span class="cwiki">${{amount}} USD</span>
HTML без валюти:
<span class="cwiki">${{amount}}</span>
Важливо: Клас-обгортка cwiki є обов'язковим. Він вказує додатку, які елементи на сторінці є цінами, щоб конвертувати лише ціни, а не телефонні номери чи номери замовлень.
Крок 3: Увімкніть вставку додатка
Увімкніть додаток у розділі вставок додатків вашої теми:
- Перейдіть у Онлайн-магазин → Теми → Налаштувати
- Знайдіть 'App embeds' у лівій панелі
- Знайдіть 'Currency.Wiki App' і увімкніть його
- Натисніть Зберегти у редакторі теми
Крок 4: Перевірте налаштування
Натисніть 'Сканувати мій магазин', щоб перевірити завершення налаштування. Майстер перевірить наявність класу-обгортки cwiki та вставки додатка. Якщо все гаразд — ви готові до роботи!
3 Стилі віджетів
Оберіть один із 6 стилів віджетів, щоб відповідати дизайну магазину. Кожен стиль можна налаштувати під кольори вашого бренду.
Мінімалістичний випадаючий список
Компактна інтеграція у шапку з простим списком. Найкраще для розміщення у верхньому правому куті.
Плаваюча кнопка
Мобільна плаваюча кнопка з розширюваною панеллю. Чудово для mobile-first магазинів. Розміщується у кутах.
Бічна панель
Панель на всю висоту з пошуком. Ідеально для магазинів із багатьма валютами.
Модальне вікно
Центроване накладання з сіткою валют. Робить вибір валюти зручним.
Перемикач вкладок
Горизонтальні вкладки для популярних валют. Швидке перемикання без меню.
Кутовий бейдж
Мінімалістична іконка в куті, що розгортається при натисканні. Найменш нав'язливий варіант.
Порада: Використовуйте сторінку налаштувань віджетів у панелі адміністратора додатка, щоб переглянути всі стилі з кольорами вашого магазину.
4 Панель адміністратора
Панель адміністратора дає повний контроль над конвертацією валют у магазині.
Головна панель
Увімкніть/вимкніть віджет, переглядайте статистику конверсій і живий попередній перегляд віджета.
Налаштування віджета
Оберіть стиль, позицію, кольори, розмір, радіус кутів і відображення прапорців.
Управління валютами
Увімкніть/вимкніть валюти, змініть порядок, налаштуйте автодетекцію та параметри курсів.
Аналітика
Переглядайте графіки конверсій, топ-валюти та розподіл міжнародних клієнтів.
Тема та вигляд
Оберіть режим теми (авто, світлий, темний, кастом), налаштуйте кольори, увімкніть ефекти скляності та поведінку темної теми.
Повідомлення при оформленні
Увімкніть повідомлення на сторінках кошика/оформлення, щоб інформувати клієнтів про валюту оплати.
5 Розширені налаштування
Розширені налаштування дають користувачам Pro більше контролю над форматуванням цін і поведінкою конвертації.
Форматування цін (Pro)
- Десяткові знаки - Керуйте кількістю десяткових знаків (0-6).
- Формат числа - Оберіть стиль формату (Авто, US, EU, Індійський, Пробіл•Крапка, Пробіл•Кома).
- Позиція символу - Розміщуйте символ валюти до або після суми, або авто для кожної валюти.
- Округлення - Стандартне, завжди вгору, завжди вниз або без округлення. Можливість округлення до .99.
Інтеграція з темою (Pro)
Вставте віджет або повідомлення кошика вручну у будь-яке місце теми за допомогою цих HTML-фрагментів:
Вставка віджета (додайте у header.liquid або будь-який розділ):
<div class="cwiki-widget"></div>
Вставка повідомлення кошика (додайте у cart.liquid):
<div class="cwiki-banner"></div>
Опції для розробників (Pro)
- Перевизначення стилів - Додавайте власний CSS для налаштування вигляду віджета.
- Слухачі кліків - Повторна конвертація цін при натисканні на певні елементи (наприклад, вибір розміру, опції товару).
- Додаткові елементи цін - Вибір додаткових елементів цін, окрім стандартної обгортки .cwiki.
- Патерни URL - Повторне сканування цін, якщо URL містить певні рядки (для AJAX-контенту, нескінченного скролу).
- Затримка конвертації - Затримка перед конвертацією цін (для контенту, що завантажується після готовності сторінки).
Зверніть увагу: Ці опції для досвідчених користувачів. Тестуйте на попередньому перегляді теми перед публікацією.
6 Вирішення проблем
Ціни не конвертуються?
Переконайтеся, що клас-обгортка cwiki доданий у налаштування формату валюти. Перейдіть у Налаштування → Загальні → Стандартні налаштування магазину та перевірте HTML-форматування. Також переконайтеся, що вставка додатка увімкнена у налаштуваннях теми.
Віджет не відображається?
Перевірте, чи увімкнена вставка додатка у розділі App Embeds вашої теми. Відкрийте налаштування теми, знайдіть App Embeds і переконайтеся, що Currency.Wiki увімкнено. Збережіть і оновіть магазин.
Ціни мерехтять при завантаженні?
Наш додаток розроблений для завантаження без миготіння. Якщо бачите миготіння, перевірте, чи не заважають кешуючі плагіни. Також переконайтеся, що вставка додатка завантажується у head вашої теми.
Визначається неправильна валюта?
Геовизначення базується на IP-адресі відвідувача. VPN або корпоративні мережі можуть впливати на визначення. Відвідувачі завжди можуть вибрати валюту вручну. Ви також можете встановити валюту за замовчуванням у налаштуваннях.
Віджет не відповідає темі?
Використовуйте налаштування Теми та вигляду для кастомізації кольорів або увімкніть Авто-режим для автоматичного визначення кольорів теми. Також можна додати власний CSS у розширених налаштуваннях.
Потрібна допомога?
Наша команда підтримки готова допомогти з будь-якими питаннями щодо налаштування чи конфігурації.
