Findalo

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

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. 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. 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. 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. 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. 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. 1 · Descarrega el connector

    Entra al teu panellIntegració → pestanya WooCommerceDescarregar ZIP. Sempre et donem l'última versió publicada. Si encara no tens compte, dona't d'alta gratis.

  2. 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. 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_head automàticament.

  4. 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. 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. 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. 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. 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. 3 · Activa els scopes

    Dins de l'app: Configuration → Admin API integration → Configure. Marca:

    • read_products
    • read_product_listings
    • read_collections
    • read_inventory

    Save a baix a la dreta.

  4. 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. 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".

  6. 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_SLUG pel slug del pas 1. Desa. Recarrega el teu storefront i prem la lupa — el widget findalo obre el modal amb els teus productes.

  7. 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. 1 · Descarrega el mòdul

    Entra al teu panellIntegració → pestanya MagentoDescarregar ZIP. Sempre et donem l'última versió publicada. Si encara no tens compte, dona't d'alta gratis.

  2. 2 · Puja el mòdul al teu Magento

    Descomprimeix el ZIP i copia la carpeta a app/code/Findalo/Search del teu Magento. Per SSH:

    mkdir -p app/code/Findalo/Search
    unzip findalo-magento-*.zip -d app/code/Findalo/Search
  3. 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:flush

    En producció afegeix bin/magento setup:di:compile i bin/magento setup:static-content:deploy si el teu pipeline ho requereix.

  4. 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. 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. 1 · Descarrega el connector

    Entra al teu panellIntegració → pestanya ShopwareDescarregar ZIP. Sempre et donem l'última versió publicada. Si encara no tens compte, dona't d'alta gratis.

  2. 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. 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. 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_domains del 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.