Як використовувати Hallwil Filters

Hallwil Filters додає швидкі фільтри колекцій, пошук і discovery на вітрину Shopify. Цей посібник охоплює налаштування від установлення до інтеграції в тему.

1. Установлення та відкриття додатку

Установіть Hallwil Filters з Shopify App Store і підтвердьте запитані дозволи. Відкрийте додаток через Shopify Admin → Apps.

На домашній сторінці відображаються статус індексації каталогу, поточний план і чекліст налаштування.

  • Установіть додаток на dev або production store.
  • Відкрийте Hallwil Filters у бічній панелі Shopify admin.
  • Переконайтеся, що індексація каталогу запускається автоматично після установлення.

2. Індексація каталогу

Додаток індексує товари в пошуковий індекс (Typesense), щоб фільтри та пошук відповідали за мілісекунди. Індексація працює у фоні після установлення або при ручному reindex.

Поки індексація триває, кількість фасетів може бути неповною. Дочекайтеся статусу Готово на домашній сторінці або в Налаштуваннях.

  • Pending / Indexing — синхронізація каталогу виконується.
  • Ready — API вітрини може повертати повні дані фільтрів і товарів.
  • Error — перевірте Redis і використайте Reindex catalog у Налаштуваннях.

3. Создання наборів фільтрів

Перейдіть до Filters у навігації додатку. Набір фільтрів визначає, які фільтри показувати на конкретних колекціях або пошуку.

Додайте фільтри з опцій товару, vendor, type, tags, price, availability або metafields. Налаштуйте тип відображення (checkbox, swatch, range) і порядок.

  • Создайте набір фільтрів і призначте handles колекцій або використайте як default для пошуку.
  • Додайте фільтри та зіставте їх з атрибутами товару.
  • Переглядайте preview фасетів у редакторі, коли індекс готовий.

4. Інтеграція з вітриною

Тема викликає Discovery API через Shopify App Proxy на /apps/discovery/v1/*. Shopify підписує кожен запит з вітрини автоматично — не додавайте signature або timestamp у код теми.

Використайте App Proxy URL з Налаштувань або з вбудованої Documentation. Типові endpoints: /v1/filters, /v1/products, /v1/search/suggest.

Примери Liquid і JavaScript — у Documentation в embedded app (URL proxy та code samples для вашого магазину).

5. Тарифи та оплата

Підписки управляються через Shopify Billing. Відкрийте Billing у додатку, щоб переглянути план, оновити або скасувати.

Ліміти плану (набори фільтрів, markets, обсяг індексації) залежать від tier на сторінці Billing.

6. Міграція та інструменти каталогу

Migration дозволяє експортувати або імпортувати атрибути товарів (vendor, tags, options, metafields) через Excel.

Catalog overview на домашній сторінці показує індексовані товари та покриття фасетів.

7. Підтримка та ресурси

Вбудована Documentation (Shopify admin → Hallwil Filters → Documentation) містить API examples і код інтеграції теми для вашого store.

Інтерактивна OpenAPI документація доступна на сервісі Discovery API.

  • Documentation у додатку — примери API і snippets для теми.
  • API reference (Swagger) — схеми запитів і відповідей.
  • Налаштування — мова, reindex, App Proxy URL, legal links.