Jak korzystać z Hallwil Filters

Hallwil Filters dodaje szybkie filtry kolekcji, wyszukiwanie i odkrywanie produktów do Twojego storefrontu Shopify. Ten przewodnik przeprowadzi Cię od instalacji do integracji z motywem.

1. Instalacja i otwarcie aplikacji

Zainstaluj Hallwil Filters ze Shopify App Store i zatwierdź wymagane uprawnienia. Otwórz aplikację z Shopify Admin → Apps.

Ekran główny pokazuje status indeksowania katalogu, aktualny plan i listę kontrolną konfiguracji. Ukończ listę, aby przygotować storefront.

  • Zainstaluj aplikację w sklepie deweloperskim lub produkcyjnym.
  • Otwórz Hallwil Filters z paska bocznego Shopify admin.
  • Potwierdź, że indeksowanie katalogu uruchamia się automatycznie po instalacji.

2. Indeksowanie katalogu

Aplikacja indeksuje produkty w silniku wyszukiwania (Typesense), aby filtry i wyszukiwanie odpowiadały w milisekundach. Indeksowanie działa w tle po instalacji lub po uruchomieniu reindeksacji.

Podczas indeksowania liczniki filtrów mogą być niepełne. Poczekaj, aż status na stronie głównej lub w Ustawieniach pokaże Ready.

  • Pending / Indexing — synchronizacja katalogu trwa.
  • Ready — API storefront może zwracać pełne dane filtrów i produktów.
  • Error — sprawdź połączenie Redis i użyj Reindex catalog w Ustawieniach.

3. Tworzenie zestawów filtrów

Przejdź do Filters w nawigacji aplikacji. Zestaw filtrów określa, które filtry pojawiają się na konkretnych stronach kolekcji lub wyszukiwania.

Dodaj filtry ze źródeł takich jak opcje produktu, vendor, type, tags, cena, dostępność lub metafields. Skonfiguruj typy wyświetlania (checkbox, swatch, range) i kolejność.

  • Utwórz zestaw filtrów i przypisz handles kolekcji lub użyj go domyślnie dla wyszukiwania.
  • Dodaj filtry i przypisz każdy do atrybutu produktu.
  • Podglądaj liczniki faset w edytorze zestawu filtrów, gdy indeks jest gotowy.

4. Integracja ze storefrontem

Motyw wywołuje Discovery API przez Shopify App Proxy pod https://{your-store}.myshopify.com/apps/discovery/v1/*. Shopify automatycznie podpisuje każde żądanie storefront — nie dodawaj podpisu ani znacznika czasu w kodzie motywu.

Użyj URL App Proxy z Ustawień lub strony Documentation w aplikacji. Typowe endpointy: /v1/filters, /v1/products, /v1/search/suggest.

Przykłady Liquid i JavaScript znajdziesz w Documentation w aplikacji embedded (URL proxy specyficzny dla sklepu i próbki kodu).

5. Rozliczenia i plany

Plany subskrypcji są zarządzane przez Shopify Billing. Otwórz Billing w aplikacji, aby zobaczyć plan, ulepszyć lub anulować.

Limity planu (zestawy filtrów, rynki, wolumen indeksowania) obowiązują zgodnie z poziomem pokazanym na stronie Billing.

6. Migracja i narzędzia katalogu

Użyj Migration, aby eksportować lub importować atrybuty produktów zgodne z filtrami (vendor, tags, opcje, metafields) przez Excel.

Użyj Catalog overview na stronie głównej, aby sprawdzić zindeksowane produkty i pokrycie faset.

7. Wsparcie i zasoby

Embedded Documentation (Shopify admin → Hallwil Filters → Documentation) zawiera przykłady API i kod integracji motywu dla Twojego sklepu.

Interaktywna dokumentacja OpenAPI jest dostępna w usłudze Discovery API po wdrożeniu.

  • Dokumentacja w aplikacji — przykłady API i fragmenty motywu.
  • Dokumentacja API (Swagger) — pełne schematy żądań i odpowiedzi.
  • Ustawienia — język, reindeksacja, URL App Proxy, linki prawne.