Documentación
Activa Findalo en tu tienda en 10 minutos.
Las guías paso a paso para cada plataforma, la API y el panel. Si te quedas atascado, escríbenos a hola@findalo.io — leemos todo.
Instalación por plataforma
- Disponible
PrestaShop 1.7 / 8.x / 9.x
Módulo nativo. Compatible con tema Classic, Hummingbird y custom.
- Beta — autoservicio
Shopify
Custom App + snippet en theme.liquid. App oficial en Partners en camino.
- Disponible
WooCommerce
Plugin WordPress oficial. Compatible con WPML/Polylang y caches WP.
- Disponible
Magento 2 / Adobe Commerce
Módulo nativo. Descargable desde tu panel. PHP 8.2/8.3/8.4. Compatible con Hyvä y PWA Studio.
- Disponible
Shopware 6
Plugin nativo. Descargable desde tu panel. Compatible con Shopware 6.6+ y Storefront / Headless.
Requisitos técnicos mínimos
Lo que necesita tu tienda para instalar el módulo Findalo. Si tu stack está por debajo, dínoslo en hola@findalo.io y vemos qué hacer.
| Plataforma | Módulo | Plataforma compatible | PHP | Otros requisitos |
|---|---|---|---|---|
| PrestaShop | v1.6.14 Actualizado 9 jun 2026 | 1.7.6.0 – 9.x (multi-shop soportado) | 7.2+ (8.1+ recomendado) | cURL y JSON activos · URL de la tienda alcanzable públicamente para sync (endpoint /module/findalo/feed) · cualquier tema (Classic, Hummingbird, custom) |
| WooCommerce | v1.2.2 Actualizado 4 jun 2026 | WordPress 6.0+ WooCommerce 7.0+ (probado hasta WC 9.4) | 7.4+ | WPML o Polylang autodetectados · compatible con WP Rocket / LiteSpeed Cache · temas Storefront / Hello Elementor / Astra / Blocksy verificados |
| Magento | v1.1.8 Actualizado 8 jun 2026 | Magento 2 Adobe Commerce (Open Source y Commerce) | 8.2 / 8.3 / 8.4 | Módulos estándar: Magento_Catalog, Magento_Config, Magento_Backend · Composer recomendado |
| Shopify | Custom App App pública en camino | Cualquier plan Shopify (incl. Basic, Shopify, Advanced, Plus) | — | Permiso para crear Custom Apps · scopes read_products, read_product_listings, read_collections, read_inventory · acceso a theme.liquid para pegar el snippet |
| Shopware | v0.2.4 Actualizado 8 jun 2026 | Shopware 6.6+ (Storefront y Headless) | 8.2 / 8.3 | Shopware CLI o admin para subir plugin · acceso al Storefront para inyectar el snippet del widget · MySQL 8 / MariaDB 10.4+ |
El widget en navegador funciona en Chrome, Firefox, Safari y Edge actuales y en las dos versiones anteriores. Sin dependencias jQuery ni de tu tema.
PrestaShop — pasos esenciales
- 1 · Descarga
Entra a tu panel de cliente y abre Integraciones → Módulo PrestaShop. Pulsa Descargar ZIP — siempre te damos la última versión publicada. ¿Aún no tienes cuenta? Date de alta gratis.
- 2 · Sube e instala
En PrestaShop BO: Módulos → Gestor de módulos → Subir un módulo. Arrastra el ZIP y pulsa Instalar.
- 3 · Configura
Pulsa Configurar sobre el módulo Findalo. Rellena:
- URL del buscador: el slug que tienes en tu panel de findalo.io (lo ves en cuanto te registras).
- Feed token: déjalo vacío para autogenerar uno fuerte. Cópialo después a tu panel en findalo.io.
- Trigger selector: déjalo por defecto (cubre el tema Classic y la mayoría). Cámbialo solo si tu tema usa selectores custom.
- 4 · Activa
Marca "Cargar el bundle del buscador en todas las páginas" y guarda. Recarga tu storefront, pulsa la lupa del tema — el widget abre un modal full-screen y los productos aparecen al instante.
- 5 · Verifica el sync
En findalo.io → tu buscador → Estado del catálogo: deberías ver tus productos indexados en menos de 5 minutos. Si no, revisa que tu PrestaShop sea alcanzable desde internet (el sync hace polling cada 5 min al endpoint
/module/findalo/feed).
WooCommerce — pasos esenciales
Plugin WordPress estándar. ~10 minutos. Compatible con WPML, Polylang, WP Rocket, LiteSpeed Cache y temas Storefront / Hello Elementor / Astra / Blocksy. Demo en vivo: woocommerce.findalo.io/shop.
- 1 · Descarga el plugin
Entra a tu panel → Integración → tab WooCommerce → Descargar ZIP. Siempre te damos la última versión publicada. Si aún no tienes cuenta, date de alta gratis.
- 2 · Sube e instala en WordPress
En tu WordPress admin: Plugins → Añadir nuevo → Subir plugin. Arrastra el ZIP y pulsa Instalar, luego Activar.
- 3 · Configura el plugin
En el menú WooCommerce → Findalo. Rellena:
- Your search URL: el slug que ves en tu panel de findalo.io (lo eliges al alta).
- Feed token (Bearer): el que aparece en el panel findalo, copialo y pégalo aquí. Si está vacío, el plugin genera uno y luego lo copias al panel.
- Trigger selector: déjalo por defecto — cubre el bloque de búsqueda de Gutenberg, search-field clásico y el form de búsqueda de productos.
Guarda. El plugin inyecta el widget en
wp_headautomáticamente. - 4 · Fuerza el primer sync
En el mismo settings page del plugin, pulsa "Mark as pending (force next rebuild)". Espera 5-10 segundos. El plugin construye el JSON del catálogo y lo postea a findalo.io (push asíncrono — la página vuelve sin esperar al upload).
- 5 · Verifica
En findalo.io → tu buscador → Sincronización: deberías ver los productos sincronizados con
sync_source: push. Abre tu storefront, dale a la lupa — el modal findalo se abre con tus productos. A partir de ahora cualquier cambio en producto, stock o precio se reflejará en ≤10 min (stock throttle anti-spam). - 6 · Soporte multi-idioma (opcional)
Si usas WPML o Polylang, el plugin los detecta automáticamente y publica cada producto traducido bajo su locale (ISO 2-letras). Sin configuración extra.
Shopify — pasos esenciales
Mientras la app oficial llega al Shopify App Store, el conector funciona
en modo Custom App. ~10 minutos de punta a punta. Te llevas la
dev store de demo (pass 1234)
como referencia de cómo queda.
- 1 · Date de alta en findalo
Regístrate en findalo.io (plan Free es suficiente para probar). Anota tu slug — lo necesitarás en el último paso.
- 2 · Crea una Custom App en Shopify
En tu Shopify Admin: Settings → Apps and sales channels → Develop apps → Create an app. Pon nombre cualquiera (ej. "findalo-search").
- 3 · Activa los scopes
Dentro de la app: Configuration → Admin API integration → Configure. Marca:
read_productsread_product_listingsread_collectionsread_inventory
Save abajo a la derecha.
- 4 · Instala la app y copia el token
Pulsa Install app arriba a la derecha. Te lleva a API credentials: copia el Admin API access token (empieza por
shpat_y tiene 38 caracteres).⚠ Shopify enseña el token una sola vez. Si te equivocas o cierras la pestaña, tendrás que rotar credenciales y generar uno nuevo.
- 5 · Conecta findalo al panel
En tu panel de findalo: Integración → tab Shopify. Pega:
- Dominio:
tu-tienda.myshopify.com - Admin API access token: el
shpat_…del paso 4
Pulsa Conectar y sincronizar. Validamos credenciales contra Shopify y pullamos tu catálogo en segundos. Verás "Conectado a
tu-tienda.myshopify.com". - Dominio:
- 6 · Pega el snippet en el theme
En Shopify Admin: Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Justo antes de
</body>:<script src="https://widget.findalo.io/widget.js" data-tenant="TU_SLUG" defer></script>Sustituye
TU_SLUGpor el slug del paso 1. Save. Recarga tu storefront y pulsa la lupa — el widget findalo abre el modal con tus productos. - 7 · Sync continuo automático
A partir de aquí: el cron de findalo hace pull cada 5 min. Cambias precios, stock o productos en Shopify → findalo reindexa solo en menos de 5 minutos. Cero infraestructura tuya. Para forzar un sync manual: panel → Sincronización → Sincronizar ahora.
Magento — pasos esenciales
Módulo nativo para Magento 2 y Adobe Commerce. ~10 minutos. Requiere PHP 8.2, 8.3 o 8.4. Compatible con Hyvä Themes y storefronts PWA Studio / headless.
- 1 · Descarga el módulo
Entra a tu panel → Integración → tab Magento → Descargar ZIP. Siempre te damos la última versión publicada. Si aún no tienes cuenta, date de alta gratis.
- 2 · Sube el módulo a tu Magento
Descomprime el ZIP y copia la carpeta a
app/code/Findalo/Searchde tu Magento. Por SSH:mkdir -p app/code/Findalo/Search unzip findalo-magento-*.zip -d app/code/Findalo/Search - 3 · Habilita el módulo
Desde la raíz de tu Magento:
bin/magento module:enable Findalo_Search bin/magento setup:upgrade bin/magento cache:flushEn producción añade
bin/magento setup:di:compileybin/magento setup:static-content:deploysi tu pipeline lo requiere. - 4 · Configura
En Magento Admin: Stores → Configuration → Findalo → General. Rellena:
- Search URL: el slug que ves en tu panel de findalo.io.
- Feed token: cópialo desde el panel findalo y pégalo aquí, o déjalo vacío para autogenerarlo.
- Trigger selector: déjalo por defecto — cubre los temas Luma, Blank y Hyvä.
Guarda y vacía cachés:
bin/magento cache:flush. - 5 · Verifica el sync
En findalo.io → tu buscador → Estado del catálogo: deberías ver tus productos indexados en menos de 5 minutos. Si llevas multi-store o multi-website, cada vista se indexa por separado y se identifica por su
store_code. Recarga tu storefront, pulsa la lupa — el widget abre el modal con tus productos.
Shopware — pasos esenciales
Plugin nativo para Shopware 6.6 y superiores. ~10 minutos. Compatible con Storefront clásico y con storefronts headless.
- 1 · Descarga el plugin
Entra a tu panel → Integración → tab Shopware → Descargar ZIP. Siempre te damos la última versión publicada. Si aún no tienes cuenta, date de alta gratis.
- 2 · Sube el plugin a Shopware
En tu Shopware Admin: Extensiones → Mis extensiones → Subir extensión. Arrastra el ZIP. Por CLI:
bin/console plugin:refresh bin/console plugin:install --activate FindaloSearch bin/console cache:clear - 3 · Configura
En Shopware Admin: Extensiones → Findalo Search → Configurar. Rellena:
- Search URL: el slug que ves en tu panel de findalo.io.
- Feed token: cópialo desde el panel findalo y pégalo aquí, o déjalo vacío para autogenerarlo.
- Trigger selector: déjalo por defecto — cubre los temas Storefront por defecto.
Guarda. El plugin inyecta el widget en el Storefront automáticamente.
- 4 · Verifica el sync
En findalo.io → tu buscador → Estado del catálogo: deberías ver tus productos indexados en menos de 5 minutos. Si llevas multi-sales-channel, cada uno se indexa por separado. Recarga tu Storefront, pulsa la lupa — el widget abre el modal con tus productos.
Recursos rápidos
API y endpoints
Base URL pública: https://api.findalo.io
GET /api/<buscador>/search?q=<query>- Búsqueda principal. Devuelve hits, facetas y total. Origin debe estar en
allowed_domainsde tu buscador. GET /api/<buscador>/suggest?q=<query>- Autocomplete. Llámalo a typing speed; tiene rate limit más generoso que /search.
GET /api/public-config/<buscador>- Config pública de tu buscador: theme, layout, plan. Lo que el widget usa al boot.
POST /api/<buscador>/track- Track de eventos (clicks, adds-to-cart, conversions). Body JSON.
Documentación detallada con ejemplos cURL y SDKs llegando. ¿Necesitas algo en concreto ya? Escríbenos.
Recomendaciones (plan Pro+)
Bloques de productos sugeridos en ficha, carrito y home — sin que el shopper haga ninguna búsqueda. El motor agrega tus eventos de view/add-to-cart con decay 30 días y materializa tres índices: co-visitación, co-añadidos al carrito y bestsellers.
Auto-inject (PrestaShop)
El módulo ya viene con los hooks displayFooterProduct, displayShoppingCartFooter y displayHome. Configura el back office y activa los slots — cero código.
Integración custom (otras plataformas)
// En la ficha de producto:
findalo.reco({
context: 'similar',
productId: '123',
target: '#findalo-similar-slot',
title: 'También te puede gustar',
});
// Al cargar la ficha:
findalo.trackView('123');
// Al añadir al carrito:
findalo.trackAddToCart('123');
// Recently viewed (cliente, sin tráfico al backend):
findalo.recentlyViewed(); // → ['123', '456', ...] Endpoint
GET /api/<buscador>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · plan ≥ Pro o devuelve 402.
¿Algo no funciona?
Mándanos un email a hola@findalo.io con tu URL de tienda y qué falla. Te respondemos personalmente en horas laborables.