So verwenden Sie Hallwil Filters

1. App installieren und öffnen

Installieren Sie Hallwil Filters aus dem Shopify App Store und genehmigen Sie die angeforderten Berechtigungen. Öffnen Sie die App über Shopify Admin → Apps.

Der Startbildschirm zeigt den Status der Katalogindizierung, Ihren aktuellen Plan und eine Einrichtungs-Checkliste. Schließen Sie die Checkliste ab, um Ihre Storefront vorzubereiten.

• Installieren Sie die App in Ihrem Entwicklungs- oder Produktions-Shop.
• Öffnen Sie Hallwil Filters über die Shopify-Admin-Seitenleiste.
• Stellen Sie sicher, dass die Katalogindizierung nach der Installation automatisch startet.

2. Katalogindizierung

Die App indiziert Ihre Produkte in einer Suchmaschine (Typesense), damit Filter und Suche in Millisekunden antworten. Die Indizierung läuft im Hintergrund nach der Installation oder wenn Sie eine Neuindizierung auslösen.

Während die Indizierung läuft, können Filterzähler unvollständig sein. Warten Sie, bis der Status auf der Startseite oder in den Einstellungen Bereit anzeigt.

• Pending / Indexing — Katalogsynchronisierung läuft.
• Ready — Storefront-API kann vollständige Filter- und Produktdaten zurückgeben.
• Error — prüfen Sie die Redis-Verbindung und verwenden Sie Reindex catalog in den Einstellungen.

3. Filtersets erstellen

Gehen Sie in der App-Navigation zu Filters. Ein Filterset legt fest, welche Filter auf bestimmten Kollektions- oder Suchseiten angezeigt werden.

Fügen Sie Filter aus Produktoptionen, Vendor, Type, Tags, Preis, Verfügbarkeit oder Metafields hinzu. Konfigurieren Sie Anzeigetypen (Checkbox, Swatch, Bereich) und Sortierreihenfolge.

• Erstellen Sie ein Filterset und weisen Sie Kollektions-Handles zu oder verwenden Sie es als Standard für die Suche.
• Fügen Sie Filter hinzu und ordnen Sie jeden einem Produktattribut zu.
• Sehen Sie Facettenzähler im Filterset-Editor, wenn der Index bereit ist.

4. Storefront-Integration

Ihr Theme ruft die Discovery API über Shopify App Proxy unter https://{your-store}.myshopify.com/apps/discovery/v1/* auf. Shopify signiert jede Storefront-Anfrage automatisch — fügen Sie keine Signatur oder keinen Zeitstempel im Theme-Code hinzu.

Verwenden Sie die App-Proxy-URL aus den Einstellungen oder der In-App-Dokumentation. Typische Endpunkte: /v1/filters, /v1/products, /v1/search/suggest.

Liquid- und JavaScript-Beispiele finden Sie in der Dokumentation in der eingebetteten App (shop-spezifische Proxy-URL und Codebeispiele).

5. Abrechnung und Pläne

Abonnementpläne werden über Shopify Billing verwaltet. Öffnen Sie Billing in der App, um Ihren Plan anzuzeigen, ein Upgrade durchzuführen oder zu kündigen.

Planlimits (Filtersets, Märkte, Indizierungsvolumen) gelten gemäß der auf der Billing-Seite angezeigten Stufe.

6. Migration und Katalogtools

Verwenden Sie Migration, um Produktattribute, die mit Ihren Filtern übereinstimmen (Vendor, Tags, Optionen, Metafields), per Excel zu exportieren oder zu importieren.

Nutzen Sie die Katalogübersicht auf der Startseite, um indizierte Produkte und Facettenabdeckung zu prüfen.

7. Support und Ressourcen

Die eingebettete Dokumentation (Shopify Admin → Hallwil Filters → Documentation) enthält API-Beispiele und Theme-Integrationscode für Ihren Shop.

Interaktive OpenAPI-Dokumentation ist verfügbar, wenn der Discovery-API-Dienst bereitgestellt ist.

• In-App-Dokumentation — API-Beispiele und Theme-Snippets.
• API-Referenz (Swagger) — vollständige Request-/Response-Schemas.
• Einstellungen — Sprache, Neuindizierung, App-Proxy-URL, rechtliche Links.