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.
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.11 Aggiornato 30 ott 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.8 Scheda su Adobe Commerce Marketplace ↗ Aggiornato 11 set 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.8.3 App nativa (sin PHP) Aggiornato 8 set 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 |
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.
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.