Jak používat Hallwil Filters

Hallwil Filters přidává do vašeho Shopify storefrontu rychlé filtry kolekcí, vyhledávání a objevování produktů. Tato příručka vás provede od instalace až po živou integraci do šablony.

1. Instalace a otevření aplikace

Nainstalujte Hallwil Filters z Shopify App Store a schvalte požadovaná oprávnění. Otevřete aplikaci v Shopify Admin → Apps.

Domovská obrazovka zobrazuje stav indexace katalogu, váš aktuální plán a kontrolní seznam nastavení. Dokončete kontrolní seznam, abyste připravili storefront.

  • Nainstalujte aplikaci do vývojového nebo produkčního obchodu.
  • Otevřete Hallwil Filters z postranního panelu Shopify admin.
  • Ověřte, že indexace katalogu se po instalaci spustí automaticky.

2. Indexace katalogu

Aplikace indexuje vaše produkty do vyhledávače (Typesense), aby filtry a vyhledávání reagovaly během milisekund. Indexace běží na pozadí po instalaci nebo při spuštění reindexace.

Během indexace mohou být počty filtrů neúplné. Počkejte, dokud stav na domovské stránce nebo v Nastavení nezobrazí Ready.

  • Pending / Indexing — synchronizace katalogu probíhá.
  • Ready — storefront API může vracet kompletní data filtrů a produktů.
  • Error — zkontrolujte připojení Redis a použijte Reindex catalog v Nastavení.

3. Vytváření sad filtrů

Přejděte na Filters v navigaci aplikace. Sada filtrů určuje, které filtry se zobrazí na konkrétních stránkách kolekcí nebo vyhledávání.

Přidejte filtry ze zdrojů jako produktové možnosti, vendor, type, tags, cena, dostupnost nebo metafields. Nastavte typy zobrazení (checkbox, swatch, range) a pořadí.

  • Vytvořte sadu filtrů a přiřaďte handles kolekcí nebo ji použijte jako výchozí pro vyhledávání.
  • Přidejte filtry a mapujte každý na atribut produktu.
  • Náhled počtů facet v editoru sady filtrů, když je index připraven.

4. Integrace storefrontu

Vaše šablona volá Discovery API přes Shopify App Proxy na https://{your-store}.myshopify.com/apps/discovery/v1/*. Shopify automaticky podepisuje každý storefront požadavek — nepřidávejte podpis ani časové razítko do kódu šablony.

Použijte URL App Proxy z Nastavení nebo ze stránky Documentation v aplikaci. Typické endpointy: /v1/filters, /v1/products, /v1/search/suggest.

Pro příklady Liquid a JavaScript otevřete Documentation v embedded aplikaci (URL proxy specifická pro obchod a ukázky kódu).

5. Fakturace a plány

Předplatné se spravuje přes Shopify Billing. Otevřete Billing v aplikaci pro zobrazení plánu, upgrade nebo zrušení.

Limity plánu (sady filtrů, trhy, objem indexace) platí podle úrovně zobrazené na stránce Billing.

6. Migrace a nástroje katalogu

Použijte Migration pro export nebo import produktových atributů sladěných s vašimi filtry (vendor, tags, možnosti, metafields) přes Excel.

Použijte Catalog overview na domovské stránce pro kontrolu indexovaných produktů a pokrytí facet.

7. Podpora a zdroje

Embedded Documentation (Shopify admin → Hallwil Filters → Documentation) obsahuje příklady API a kód integrace šablony pro váš obchod.

Interaktivní OpenAPI dokumentace je k dispozici u služby Discovery API po nasazení.

  • Dokumentace v aplikaci — příklady API a úryvky šablony.
  • Referenční dokumentace API (Swagger) — kompletní schémata požadavků a odpovědí.
  • Nastavení — jazyk, reindexace, URL App Proxy, právní odkazy.