Documentació
Activa Findalo a la teva botiga en 10 minuts.
Les guies pas a pas per a cada plataforma, l'API i el panell. Si t'encalles, escriu-nos a hola@findalo.io — llegim tot.
Instal·lació per plataforma
- Disponible
PrestaShop 1.7 / 8.x / 9.x
Mòdul natiu. Compatible amb el tema Classic, Hummingbird i custom.
- Beta — autoservei
Shopify
Custom App + snippet a theme.liquid. App oficial a Partners en camí.
- Disponible
WooCommerce
Connector WordPress oficial. Compatible amb WPML/Polylang i caches WP.
- Disponible
Magento 2 / Adobe Commerce
Mòdul natiu. Descarregable des del teu panell. PHP 8.2/8.3/8.4. Compatible amb Hyvä i PWA Studio.
- Disponible
Shopware 6
Connector natiu. Descarregable des del teu panell. Compatible amb Shopware 6.6+ i Storefront / Headless.
Requisits tècnics mínims
El que necessita la teva botiga per instal·lar el mòdul Findalo. Si el teu stack és per sota, digues-nos-ho a hola@findalo.io i veiem què fer.
| Plataforma | Mòdul | Plataforma compatible | PHP | Altres requisits |
|---|---|---|---|---|
| PrestaShop | v1.6.14 Actualitzat 9 de juny del 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 Actualitzat 4 de juny del 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 Actualitzat 8 de juny del 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 Actualitzat 8 de juny del 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 al navegador funciona a Chrome, Firefox, Safari i Edge actuals i a les dues versions anteriors. Sense dependències de jQuery ni del teu tema.
PrestaShop — passos essencials
- 1 · Descàrrega
Entra al teu panell de client i obre Integracions → Mòdul PrestaShop. Prem Descarregar ZIP — sempre et donem l'última versió publicada. Encara no tens compte? Dona't d'alta gratis.
- 2 · Puja i instal·la
Al PrestaShop BO: Mòduls → Gestor de mòduls → Pujar un mòdul. Arrossega el ZIP i prem Instal·lar.
- 3 · Configura
Prem Configurar sobre el mòdul Findalo. Omple:
- URL del cercador: el slug que tens al teu panell de findalo.io (el veus en cuant et registres).
- Feed token: deixa'l buit per autogenerar-ne un de fort. Copia'l després al teu panell a findalo.io.
- Trigger selector: deixa'l per defecte (cobreix el tema Classic i la majoria). Canvia'l només si el teu tema fa servir selectors custom.
- 4 · Activa
Marca "Carregar el bundle del cercador a totes les pàgines" i desa. Recarrega el teu storefront, prem la lupa del tema — el widget obre un modal de pantalla completa i els productes apareixen a l'instant.
- 5 · Verifica el sync
A findalo.io → el teu cercador → Estat del catàleg: hauries de veure els teus productes indexats en menys de 5 minuts. Si no, comprova que el teu PrestaShop sigui accessible des d'internet (el sync fa polling cada 5 min a l'endpoint
/module/findalo/feed).
WooCommerce — passos essencials
Connector WordPress estàndard. ~10 minuts. Compatible amb WPML, Polylang, WP Rocket, LiteSpeed Cache i els temes Storefront / Hello Elementor / Astra / Blocksy. Demo en viu: woocommerce.findalo.io/shop.
- 1 · Descarrega el connector
Entra al teu panell → Integració → pestanya WooCommerce → Descarregar ZIP. Sempre et donem l'última versió publicada. Si encara no tens compte, dona't d'alta gratis.
- 2 · Puja i instal·la a WordPress
Al teu WordPress admin: Connectors → Afegir nou → Pujar connector. Arrossega el ZIP i prem Instal·lar, després Activar.
- 3 · Configura el connector
Al menú WooCommerce → Findalo. Omple:
- Your search URL: el slug que veus al teu panell de findalo.io (el tries en donar-te d'alta).
- Feed token (Bearer): el que apareix al panell de findalo — copia'l i enganxa'l aquí. Si és buit, el connector en genera un i després el copies al panell.
- Trigger selector: deixa'l per defecte — cobreix el bloc de cerca de Gutenberg, el search-field clàssic i el formulari de cerca de productes.
Desa. El connector injecta el widget a
wp_headautomàticament. - 4 · Força el primer sync
A la mateixa pàgina de configuració del connector, prem "Mark as pending (force next rebuild)". Espera 5-10 segons. El connector construeix el JSON del catàleg i el posta a findalo.io (push asíncron — la pàgina torna sense esperar la pujada).
- 5 · Verifica
A findalo.io → el teu cercador → Sincronització: hauries de veure els productes sincronitzats amb
sync_source: push. Obre el teu storefront, prem la lupa — el modal de findalo s'obre amb els teus productes. A partir d'ara qualsevol canvi en producte, estoc o preu es reflectirà en ≤10 min (stock throttle anti-spam). - 6 · Suport multiidioma (opcional)
Si fas servir WPML o Polylang, el connector els detecta automàticament i publica cada producte traduït sota el seu locale (ISO 2 lletres). Sense configuració extra.
Shopify — passos essencials
Mentre l'app oficial arriba al Shopify App Store, el connector funciona
en mode Custom App. ~10 minuts de punta a punta. Tens la
dev store de demo (pass 1234)
com a referència de com queda.
- 1 · Dona't d'alta a findalo
Registra't a findalo.io (el pla Free és suficient per provar). Apunta el teu slug — el necessitaràs a l'últim pas.
- 2 · Crea una Custom App a Shopify
Al teu Shopify Admin: Settings → Apps and sales channels → Develop apps → Create an app. Posa-li qualsevol nom (ex. "findalo-search").
- 3 · Activa els scopes
Dins de l'app: Configuration → Admin API integration → Configure. Marca:
read_productsread_product_listingsread_collectionsread_inventory
Save a baix a la dreta.
- 4 · Instal·la l'app i copia el token
Prem Install app a dalt a la dreta. Et porta a API credentials: copia l'Admin API access token (comença per
shpat_i té 38 caràcters).⚠ Shopify mostra el token una sola vegada. Si t'equivoques o tanques la pestanya, hauràs de rotar credencials i generar-ne un de nou.
- 5 · Connecta findalo al panell
Al teu panell de findalo: Integració → pestanya Shopify. Enganxa:
- Domini:
la-teva-botiga.myshopify.com - Admin API access token: el
shpat_…del pas 4
Prem Connectar i sincronitzar. Validem les credencials contra Shopify i pugem el teu catàleg en segons. Veuràs "Connectat a
la-teva-botiga.myshopify.com". - Domini:
- 6 · Enganxa el snippet al tema
Al Shopify Admin: Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Just before
</body>:<script src="https://widget.findalo.io/widget.js" data-tenant="EL_TEU_SLUG" defer></script>Substitueix
EL_TEU_SLUGpel slug del pas 1. Desa. Recarrega el teu storefront i prem la lupa — el widget findalo obre el modal amb els teus productes. - 7 · Sync continu automàtic
A partir d'aquí: el cron de findalo fa pull cada 5 min. Canvies preus, estoc o productes a Shopify → findalo reindexa sol en menys de 5 minuts. Zero infraestructura teva. Per forçar un sync manual: panell → Sincronització → Sincronitzar ara.
Magento — passos essencials
Mòdul natiu per a Magento 2 i Adobe Commerce. ~10 minuts. Requereix PHP 8.2, 8.3 o 8.4. Compatible amb Hyvä Themes i storefronts PWA Studio / headless.
- 1 · Descarrega el mòdul
Entra al teu panell → Integració → pestanya Magento → Descarregar ZIP. Sempre et donem l'última versió publicada. Si encara no tens compte, dona't d'alta gratis.
- 2 · Puja el mòdul al teu Magento
Descomprimeix el ZIP i copia la carpeta a
app/code/Findalo/Searchdel teu Magento. Per SSH:mkdir -p app/code/Findalo/Search unzip findalo-magento-*.zip -d app/code/Findalo/Search - 3 · Habilita el mòdul
Des de l'arrel del teu Magento:
bin/magento module:enable Findalo_Search bin/magento setup:upgrade bin/magento cache:flushEn producció afegeix
bin/magento setup:di:compileibin/magento setup:static-content:deploysi el teu pipeline ho requereix. - 4 · Configura
Al Magento Admin: Stores → Configuration → Findalo → General. Omple:
- Search URL: el slug que veus al teu panell de findalo.io.
- Feed token: copia'l des del panell de findalo i enganxa'l aquí, o deixa'l buit per autogenerar-lo.
- Trigger selector: deixa'l per defecte — cobreix els temes Luma, Blank i Hyvä.
Desa i buida caches:
bin/magento cache:flush. - 5 · Verifica el sync
A findalo.io → el teu cercador → Estat del catàleg: hauries de veure els teus productes indexats en menys de 5 minuts. Si tens multi-store o multi-website, cada vista s'indexa per separat i s'identifica pel seu
store_code. Recarrega el teu storefront, prem la lupa — el widget obre el modal amb els teus productes.
Shopware — passos essencials
Connector natiu per a Shopware 6.6 i superiors. ~10 minuts. Compatible amb Storefront clàssic i storefronts headless.
- 1 · Descarrega el connector
Entra al teu panell → Integració → pestanya Shopware → Descarregar ZIP. Sempre et donem l'última versió publicada. Si encara no tens compte, dona't d'alta gratis.
- 2 · Puja el connector a Shopware
Al teu Shopware Admin: Extensions → Les meves extensions → Pujar extensió. Arrossega el ZIP. Per CLI:
bin/console plugin:refresh bin/console plugin:install --activate FindaloSearch bin/console cache:clear - 3 · Configura
Al Shopware Admin: Extensions → Findalo Search → Configurar. Omple:
- Search URL: el slug que veus al teu panell de findalo.io.
- Feed token: copia'l des del panell de findalo i enganxa'l aquí, o deixa'l buit per autogenerar-lo.
- Trigger selector: deixa'l per defecte — cobreix els temes Storefront per defecte.
Desa. El connector injecta el widget al Storefront automàticament.
- 4 · Verifica el sync
A findalo.io → el teu cercador → Estat del catàleg: hauries de veure els teus productes indexats en menys de 5 minuts. Si tens multi-sales-channel, cadascun s'indexa per separat. Recarrega el teu Storefront, prem la lupa — el widget obre el modal amb els teus productes.
Recursos ràpids
API i endpoints
URL base pública: https://api.findalo.io
GET /api/<cercador>/search?q=<query>- Cerca principal. Retorna hits, facetes i total. L'origen ha d'estar a
allowed_domainsdel teu cercador. GET /api/<cercador>/suggest?q=<query>- Autocompletar. Crida'l a velocitat de teclat; té un rate limit més generós que /search.
GET /api/public-config/<cercador>- Config pública del teu cercador: theme, layout, pla. El que fa servir el widget en arrencar.
POST /api/<cercador>/track- Track d'esdeveniments (clics, add-to-carts, conversions). Body JSON.
Documentació detallada amb exemples cURL i SDKs en camí. Necessites alguna cosa concreta ara? Escriu-nos.
Recomanacions (pla Pro+)
Blocs de productes suggerits a la fitxa, al carret i a la home — sense que el comprador faci cap cerca. El motor agrega els teus esdeveniments de view/add-to-cart amb decay de 30 dies i materialitza tres índexs: co-visitats, co-afegits al carret i bestsellers.
Auto-inject (PrestaShop)
El mòdul ja incorpora els hooks displayFooterProduct, displayShoppingCartFooter i displayHome. Configura el back office i activa els slots — zero codi.
Integració custom (altres plataformes)
// A la fitxa de producte:
findalo.reco({
context: 'similar',
productId: '123',
target: '#findalo-similar-slot',
title: 'També et pot agradar',
});
// En carregar la fitxa:
findalo.trackView('123');
// En afegir al carret:
findalo.trackAddToCart('123');
// Recently viewed (client, sense tràfic al backend):
findalo.recentlyViewed(); // → ['123', '456', ...] Endpoint
GET /api/<cercador>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · pla ≥ Pro o retorna 402.
Alguna cosa no funciona?
Envia'ns un email a hola@findalo.io amb la URL de la teva botiga i què falla. Et responem personalment en horari laboral.