Cómo usar Hallwil Filters
Hallwil Filters añade filtros de colección rápidos, búsqueda y descubrimiento de productos a su storefront de Shopify. Esta guía le acompaña desde la instalación hasta la integración en vivo con el tema.
1. Instalar y abrir la app
Instale Hallwil Filters desde la Shopify App Store y apruebe los permisos solicitados. Abra la app desde Shopify Admin → Apps.
La pantalla de inicio muestra el estado de indexación del catálogo, su plan actual y una lista de verificación de configuración. Complete la lista para preparar su storefront.
- Instale la app en su tienda de desarrollo o producción.
- Abra Hallwil Filters desde la barra lateral de Shopify admin.
- Confirme que la indexación del catálogo comienza automáticamente tras la instalación.
2. Indexación del catálogo
La app indexa sus productos en un motor de búsqueda (Typesense) para que los filtros y la búsqueda respondan en milisegundos. La indexación se ejecuta en segundo plano tras la instalación o cuando active una reindexación.
Mientras la indexación está en curso, los recuentos de filtros pueden estar incompletos. Espere hasta que el estado muestre Ready en la página de inicio o en Configuración.
- Pending / Indexing — la sincronización del catálogo está en curso.
- Ready — la API del storefront puede devolver datos completos de filtros y productos.
- Error — compruebe la conectividad de Redis y use Reindex catalog en Configuración.
3. Crear conjuntos de filtros
Vaya a Filters en la navegación de la app. Un conjunto de filtros define qué filtros aparecen en páginas de colección o búsqueda específicas.
Añada filtros basados en opciones de producto, vendor, type, tags, precio, disponibilidad o metafields. Configure tipos de visualización (checkbox, swatch, range) y el orden.
- Cree un conjunto de filtros y asigne handles de colección o úselo como predeterminado para búsqueda.
- Añada filtros y asigne cada uno a un atributo de producto.
- Previsualice recuentos de facetas desde el editor del conjunto de filtros cuando el índice esté listo.
4. Integración con el storefront
Su tema llama a la Discovery API a través de Shopify App Proxy en https://{your-store}.myshopify.com/apps/discovery/v1/*. Shopify firma automáticamente cada solicitud del storefront — no añada firma ni marca de tiempo en el código del tema.
Use la URL de App Proxy mostrada en Configuración o en la página Documentation de la app. Endpoints típicos: /v1/filters, /v1/products, /v1/search/suggest.
Para ejemplos en Liquid y JavaScript, abra Documentation dentro de la app embebida (URL de proxy específica de la tienda y muestras de código).
5. Facturación y planes
Los planes de suscripción se gestionan a través de Shopify Billing. Abra Billing en la app para ver su plan, actualizar o cancelar.
Los límites del plan (conjuntos de filtros, mercados, volumen de indexación) se aplican según el nivel mostrado en la página Billing.
6. Migración y herramientas de catálogo
Use Migration para exportar o importar atributos de producto alineados con sus filtros (vendor, tags, opciones, metafields) mediante Excel.
Use Catalog overview en la página de inicio para inspeccionar productos indexados y cobertura de facetas.
7. Soporte y recursos
La Documentation embebida (Shopify admin → Hallwil Filters → Documentation) incluye ejemplos de API y código de integración con el tema para su tienda.
La documentación OpenAPI interactiva está disponible en el servicio Discovery API cuando está desplegado.
- Documentation en la app — ejemplos de API y fragmentos de tema.
- Referencia de API (Swagger) — esquemas completos de solicitud/respuesta.
- Configuración — idioma, reindexación, URL de App Proxy, enlaces legales.