Documentazione
Attiva Findalo sul tuo negozio in 10 minuti.
Le guide passo passo per ogni piattaforma, l'API e il pannello. Se rimani bloccato, scrivici a hola@findalo.io — leggiamo tutto.
Installazione per piattaforma
- Disponibile
PrestaShop 1.7 / 8.x / 9.x
Modulo nativo. Compatibile con il tema Classic, Hummingbird e custom.
- Disponibile
Shopify
App pubblica: colleghi il negozio con un clic dal pannello e attivi la ricerca nel tema senza toccare codice. Senza modulo né token.
- Disponibile
WooCommerce
Plugin WordPress ufficiale. Compatibile con WPML/Polylang e cache WP.
- Disponibile
Magento 2 / Adobe Commerce
Modulo nativo. Scaricabile dal tuo pannello. PHP 8.2/8.3/8.4. Compatibile con Hyvä e PWA Studio.
- Disponibile
Shopware 6
App nativa (senza PHP). Scaricabile dal tuo pannello. Compatibile con Shopware 6.6 e 6.7, Storefront / Headless.
- Disponibile
Odoo 18 / 19 / 20
Modulo di Odoo. Scaricabile dal tuo pannello. Community ed Enterprise, su installazioni proprie e su Odoo.sh (non su Odoo Online).
Requisiti tecnici minimi
Ciò di cui il tuo negozio ha bisogno per installare il modulo Findalo. Se il tuo stack è al di sotto, contattaci a hola@findalo.io e vediamo cosa fare.
| Piattaforma | Modulo | Piattaforma compatibile | PHP | Altri requisiti |
|---|---|---|---|---|
| PrestaShop | v1.9.13 Aggiornato 10 nov 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.5.2 Scheda su WordPress.org ↗ Aggiornato 31 ott 2026 | WordPress 6.0+ WooCommerce 7.0+ (probado hasta WP 7.1 y WC 11.1) en el directorio de WordPress.org | 7.4+ | WPML o Polylang autodetectados · compatible con WP Rocket / LiteSpeed Cache · temas Storefront / Hello Elementor / Astra / Blocksy verificados |
| Magento | v1.3.9 Scheda su Adobe Commerce Marketplace ↗ Aggiornato 8 nov 2026 | Magento 2.4 Adobe Commerce (Open Source, on-premise y cloud) en Adobe Commerce Marketplace | 8.2 / 8.3 / 8.4 / 8.5 | Módulos estándar: Magento_Catalog, Magento_Config, Magento_Backend · Composer recomendado |
| Shopify | App pública Se conecta desde tu panel (Conectar con Shopify) | Cualquier plan Shopify (incl. Basic, Shopify, Advanced, Plus) | — | Acceso al admin de Shopify con permiso para instalar apps · la app pide leer el catálogo y el inventario (read_products, read_inventory), los eventos de compra para la analítica (write_pixels, read_customer_events) y las páginas y políticas de la tienda para el asistente (read_content, read_legal_policies) · cualquier tema: el buscador se activa como incrustación de app en el editor de temas, sin tocar código |
| Shopware | v0.9.8 App nativa (sin PHP) Aggiornato 21 nov 2026 | Shopware 6.4 – 6.7+ (App nativa, Storefront) | — | App de Shopware (sin PHP, resiliente a versiones) · instalar vía Extensiones → Subir extensión · Admin API accesible para la sincronización (pull del catálogo) · cualquier tema |
| Odoo | v1.0.1 Módulo de Odoo (Python, sin PHP) Scheda su Odoo Apps Store ↗ Aggiornato 12 nov 2026 | Odoo 18, 19 y 20 (Community y Enterprise) instalaciones propias (on-premise) y Odoo.sh no funciona en Odoo Online: ahí Odoo no permite instalar módulos de terceros | — | App eCommerce de Odoo (website_sale) · con la app de Inventario viajan además cantidades y disponibilidad · se descarga desde tu panel (Integración → Odoo) o desde la Odoo Apps Store · sincroniza sin acciones planificadas (sin cron) |
Il widget nel browser funziona su Chrome, Firefox, Safari ed Edge attuali e sulle due versioni precedenti. Nessuna dipendenza da jQuery o dal tuo tema.
PrestaShop — passi essenziali
Modulo nativo per PrestaShop 1.7.6 – 9.x, multinegozio incluso. ~10 minuti. Il negozio si connette con un pulsante dal modulo stesso: nessun token da copiare, nessun URL da modificare.
- 1 · Installa il modulo
Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda PrestaShop → Scarica ZIP: sempre l'ultima versione pubblicata. Nel tuo back office: Moduli → Gestione moduli → Carica un modulo, trascina lo ZIP e premi Installa.
- 2 · Stabilisci la connessione
In Moduli → Gestione moduli (①) trova Findalo e premi Configura. Nella scheda Configurazione premi Connect with findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo (o crealo lì), scegli il motore di ricerca e premi Connetti questo negozio. Torni nel modulo già connesso: la credenziale viaggia da server a server, non la vedi né la copi mai.
- 3 · Verifica che arrivi tutto
Il modulo mostra ✓ Connected · il-tuo-motore. Il catalogo viene inviato da solo: nel tuo pannello → Sincronizzazione i prodotti compaiono in pochi minuti e, da lì in poi, ogni modifica di prodotto, prezzo o stock arriva automaticamente. Per forzare un invio: scheda Stato del modulo → Mark as pending (force next rebuild), oppure Sincronizza ora nel pannello. Ricarica il negozio e premi la lente: la ricerca si apre con i tuoi prodotti.
Se non puoi usare il pulsante
Se la finestra del pannello non si apre o il ritorno al modulo si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda PrestaShop copia l'ID del motore e il Token di sincronizzazione; nel modulo espandi Connection not working? Connect manually, incolla i due valori e premi Save manual connection. Il risultato è lo stesso del pulsante.
WooCommerce — passi essenziali
Plugin WordPress ufficiale per WooCommerce. ~10 minuti. WPML e Polylang si rilevano da soli; compatibile con WP Rocket e LiteSpeed Cache. Demo live: woocommerce.findalo.io/shop.
- 1 · Installa il plugin
Nel tuo WordPress: Plugin → Aggiungi nuovo, cerca “Findalo”, premi Installa ora e poi Attiva. Puoi anche caricare lo ZIP (Carica plugin) scaricato dal tuo pannello (Integrazione → scheda WooCommerce) o da WordPress.org. All'attivazione si apre una breve procedura guidata; non serve completarla: la connessione del passo 2 sistema tutto. Non hai ancora un account? Registrati gratis — o crealo durante la connessione.
- 2 · Stabilisci la connessione
Nel menu laterale, WooCommerce → Findalo (①), scheda General, riquadro Connection: premi Connect with Findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo (o crealo lì), scegli il motore di ricerca e premi Connetti questo negozio. Torni nel plugin già connesso; non vedi né copi mai token.
- 3 · Verifica che arrivi tutto
Nel riquadro Connection vedi ✓ Connected · il-tuo-motore e il pulsante Verify connection per verificarla quando vuoi. Il plugin pubblica il catalogo da solo e lo tiene aggiornato a ogni modifica di prodotto, prezzo o stock; nel tuo pannello → Sincronizzazione i prodotti compaiono in pochi minuti. Per forzare un invio: scheda Status del plugin → Mark as pending (force next rebuild), oppure Sincronizza ora nel pannello. Apri il negozio e premi la lente.
Se non puoi usare il pulsante
Se la finestra del pannello non si apre o il ritorno al plugin si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda WooCommerce copia l'ID del motore e il Token di sincronizzazione; nel plugin espandi Connection not working? Connect manually, incolla i due valori e premi Save manual connection. Il risultato è lo stesso del pulsante.
Shopify — passi essenziali
App pubblica di Shopify. ~5 minuti. Niente da installare su un server, né token né codice: colleghi il negozio con un clic dal tuo pannello Findalo.
- 1 · Collega il tuo negozio
Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda Shopify. Scrivi il dominio del tuo negozio (
tuo-negozio.myshopify.com) e premi Connetti a Shopify. - 2 · Autorizza l'app in Shopify
Si apre l'admin del tuo negozio e Shopify mostra i permessi richiesti dall'app (catalogo e inventario, eventi di acquisto per le statistiche e pagine del negozio per l'assistente): confermali con Installa. Torni al pannello con il negozio collegato e il catalogo si sincronizza da solo tramite l'API di Shopify. Da quel momento trovi Findalo anche in App → Findalo, dentro l'admin di Shopify e con la sessione già avviata.
- 3 · Attiva la ricerca nel tuo tema
Negozio online → Temi → Personalizza → Incorporamenti di app (il pulsante Apri l'editor del tema del pannello ti ci porta direttamente), attiva Findalo e salva. Premi la lente del tuo negozio: la ricerca si apre con i tuoi prodotti. Le modifiche di prodotto, prezzo o stock arrivano da sole; per forzare una sincronizzazione: pannello → Sincronizzazione → Sincronizza ora.
Se qualcosa non torna
L'app non usa token né codici di connessione. Se la ricerca non compare nel negozio, controlla che l'incorporamento Findalo sia attivo nel tema e che l'app sia ancora installata in App. Disinstallando l'app, il negozio si disconnette da solo.
Magento — passi essenziali
Modulo nativo per Magento 2.4 e Adobe Commerce, pubblicato sull'Adobe Commerce Marketplace. ~10 minuti. PHP 8.2 – 8.5. Compatibile con Hyvä e storefront headless.
- 1 · Installa il modulo
Dall'Adobe Commerce Marketplace, con Composer (le chiavi di repo.magento.com sono nel tuo account Adobe):
composer require findalo/magento-search bin/magento module:enable Findalo_Search bin/magento setup:upgrade bin/magento cache:flushIn produzione aggiungi
bin/magento setup:di:compileebin/magento setup:static-content:deployse la tua pipeline lo richiede. Senza Composer: scarica lo ZIP dal tuo pannello (Integrazione → scheda Magento) e scompattalo inapp/code/Findalo/Search— una delle due vie, mai entrambe insieme. - 2 · Stabilisci la connessione
Nell'admin di Magento, menu laterale Findalo → Configuration (①). Nella scheda Configuration premi Connect with findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo (o crealo lì), scegli il motore di ricerca e premi Connetti questo negozio. Torni nel modulo già connesso: la credenziale viaggia da server a server, non la vedi né la copi mai.
- 3 · Verifica che arrivi tutto
Accanto al pulsante vedi ✓ Connected · il-tuo-motore. Il modulo invia il catalogo da solo (in multi-store, ogni store view separatamente) e lo tiene aggiornato; nel tuo pannello → Sincronizzazione i prodotti compaiono in pochi minuti. Per forzare un invio: scheda Status → Mark as pending (force next rebuild), oppure Sincronizza ora nel pannello. Se il widget non compare nel negozio, svuota le cache:
bin/magento cache:flush.
Se non puoi usare il pulsante
Se la finestra del pannello non si apre o il ritorno al modulo si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda Magento copia l'ID del motore e il Token di sincronizzazione; nel modulo espandi Connection not working? Connect manually, incolla i due valori nei loro campi e premi Save. Il risultato è lo stesso del pulsante.
Shopware — passi essenziali
App nativa di Shopware (senza PHP) per 6.6 e 6.7. ~10 minuti. Il negozio si collega al tuo account Findalo dall'admin stesso con un codice via e-mail: nessun token.
- 1 · Installa l'app
Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda Shopware → Scarica ZIP. Nel tuo admin Shopware: Estensioni → Le mie estensioni → Carica estensione, installa e attiva accettando i permessi (lettura del catalogo e della configurazione). Da CLI:
bin/console app:install --activate FindaloSearch bin/console cache:clearAll'attivazione l'app si registra automaticamente su Findalo. Requisito: il negozio deve essere raggiungibile in HTTPS da Internet (Findalo legge il catalogo tramite l'Admin API).
- 2 · Collega il negozio al tuo account
Apri Estensioni → Findalo. Inserisci l'e-mail del tuo account Findalo e premi Enviar código (invia codice); digita il codice a 6 cifre ricevuto e premi Verificar y vincular (verifica e collega). Nella tabella dei canali associa ogni sales channel Storefront a un motore del tuo account (colonna Buscador): solo il canale associato viene connesso e indicizzato. Ti serve un altro motore? Crealo nel pannello e premi ↻ Refrescar (aggiorna) nell'app.
- 3 · Verifica che arrivi tutto
Vedrai Conectado a Findalo (connesso) e, per canale, prodotti e ultima sincronizzazione. Il catalogo si sincronizza tramite l'Admin API e le modifiche arrivano da sole; Re-sincronizar forza un invio e Gestionar buscadores ↗ apre il tuo pannello. Il widget viene iniettato nello Storefront automaticamente: ricarica il negozio e premi la lente.
Se il codice non arriva o qualcosa non torna
Controlla la posta indesiderata e che l'indirizzo sia quello del tuo account Findalo; puoi richiedere un altro codice con Enviar código. Desconectar mette in pausa i motori senza cancellare nulla: ti riconnetti con un clic, senza reinstallare. Se il tuo Shopware non permette di caricare estensioni dall'admin, usa il comando CLI del passo 1.
Odoo — passi essenziali
Modulo “Findalo Search” per Odoo 18, 19 e 20 (Community ed Enterprise), su installazioni proprie (on-premise) e su Odoo.sh. ~10 minuti. Richiede l'app eCommerce di Odoo. Non funziona su Odoo Online: lì Odoo non permette di installare moduli di terze parti. Demo live: odoo.findalo.io.
- 1 · Installa il modulo
Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda Odoo → Scarica ZIP. Scompatta la cartella
findalo_searchnel percorso degli addons del tuo Odoo (o aggiungila al repository di Odoo.sh). In Odoo: Applicazioni → Aggiorna elenco app, cerca Findalo Search e premi Installa. - 2 · Stabilisci la connessione
Nel back office di Odoo, Sito web → Configurazione → Findalo Search (①). Premi Connect with findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo, scegli il motore di ricerca e premi Connetti questo negozio. Torni in Odoo già connesso: la credenziale viaggia da server a server, non la vedi né la copi mai. Se il tuo Odoo gestisce più siti web, ognuno si collega al proprio motore di ricerca.
- 3 · Verifica che arrivi tutto
In quella stessa schermata, Verify connection verifica la connessione e Send catalog now invia il catalogo a mano. Non c'è nulla da programmare: il modulo non usa azioni pianificate (cron) e ogni modifica di prodotto, prezzo, categoria, attributo o stock viene inviata da sola subito dopo il salvataggio. Odoo non ha un campo marca: in Brand attribute scegli quale attributo di prodotto fa da marca. Apri il tuo negozio e premi la lente nell'header: si apre Findalo con i tuoi prodotti.
Se non puoi usare il pulsante
Se la finestra del pannello non si apre o il ritorno a Odoo si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda Odoo copia l'ID del motore e il Token di sincronizzazione; in Odoo, in quella stessa schermata (Sito web → Configurazione → Findalo Search), incollali in Search engine ID e Sync token e salva. Il risultato è lo stesso del pulsante.
Risorse rapide
API ed endpoint
URL base pubblica: https://api.findalo.io
GET /api/<motore>/search?q=<query>- Ricerca principale. Restituisce risultati, facet e totale. L'origin deve essere in
allowed_domainsdel tuo motore di ricerca. GET /api/<motore>/suggest?q=<query>- Autocompletamento. Chiamalo alla velocità di digitazione; ha un rate limit più generoso di /search.
GET /api/public-config/<motore>- Config pubblica del tuo motore di ricerca: tema, layout, piano. Quello che usa il widget all'avvio.
POST /api/<motore>/track- Tracciamento eventi (clic, aggiunte al carrello, conversioni). Body JSON.
Documentazione dettagliata con esempi cURL e SDK in arrivo. Hai bisogno di qualcosa di specifico adesso? Scrivici.
Raccomandazioni (piano Pro+)
Blocchi di prodotti suggeriti su scheda prodotto, carrello e homepage — senza che il visitatore effettui alcuna ricerca. Il motore aggrega i tuoi eventi di view/add-to-cart con decay di 30 giorni e materializza tre indici: co-visitati, co-aggiunti al carrello e bestseller.
Auto-inject (PrestaShop)
Il modulo include già gli hook displayFooterProduct, displayShoppingCartFooter e displayHome. Configura il back office e attiva gli slot — zero codice.
Integrazione custom (altre piattaforme)
// Nella scheda prodotto:
findalo.reco({
context: 'similar',
productId: '123',
target: '#findalo-similar-slot',
title: 'Potrebbe interessarti anche',
});
// Al caricamento della scheda:
findalo.trackView('123');
// All'aggiunta al carrello:
findalo.trackAddToCart('123');
// Recently viewed (lato client, senza traffico al backend):
findalo.recentlyViewed(); // → ['123', '456', ...] Endpoint
GET /api/<motore>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · piano ≥ Pro altrimenti restituisce 402.
Qualcosa non funziona?
Mandaci un'email a hola@findalo.io con l'URL del tuo negozio e cosa non va. Ti rispondiamo personalmente durante l'orario lavorativo.