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.
- Beta — self-service
Shopify
Custom App + snippet in theme.liquid. App ufficiale su Partners in arrivo.
- 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
Plugin nativo. Scaricabile dal tuo pannello. Compatibile con Shopware 6.6+ e 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.6.14 Aggiornato 9 giu 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 Aggiornato 4 giu 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 Aggiornato 8 giu 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 Aggiornato 8 giu 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+ |
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
- 1 · Download
Accedi al tuo pannello cliente e apri Integrazioni → Modulo PrestaShop. Premi Scarica ZIP — ti forniamo sempre l'ultima versione pubblicata. Non hai ancora un account? Registrati gratis.
- 2 · Carica e installa
Nel PrestaShop BO: Moduli → Gestore moduli → Carica un modulo. Trascina lo ZIP e premi Installa.
- 3 · Configura
Premi Configura sul modulo Findalo. Compila:
- URL del motore di ricerca: lo slug che hai nel tuo pannello findalo.io (lo vedi non appena ti registri).
- Feed token: lascialo vuoto per generarne uno sicuro in automatico. Copialo poi nel tuo pannello findalo.io.
- Trigger selector: lascialo al valore predefinito (copre il tema Classic e la maggior parte). Cambialo solo se il tuo tema usa selettori custom.
- 4 · Attiva
Spunta "Carica il bundle del motore di ricerca su tutte le pagine" e salva. Ricarica il tuo storefront, clicca sulla lente di ingrandimento del tema — il widget apre un modal a schermo intero e i prodotti appaiono all'istante.
- 5 · Verifica la sincronizzazione
Su findalo.io → il tuo motore di ricerca → Stato del catalogo: dovresti vedere i tuoi prodotti indicizzati in meno di 5 minuti. In caso contrario, verifica che il tuo PrestaShop sia raggiungibile da internet (la sincronizzazione fa polling ogni 5 min all'endpoint
/module/findalo/feed).
WooCommerce — passi essenziali
Plugin WordPress standard. ~10 minuti. Compatibile con WPML, Polylang, WP Rocket, LiteSpeed Cache e i temi Storefront / Hello Elementor / Astra / Blocksy. Demo live: woocommerce.findalo.io/shop.
- 1 · Scarica il plugin
Accedi al tuo pannello → Integrazione → tab WooCommerce → Scarica ZIP. Ti forniamo sempre l'ultima versione pubblicata. Se non hai ancora un account, registrati gratis.
- 2 · Carica e installa in WordPress
Nel tuo WordPress admin: Plugin → Aggiungi nuovo → Carica plugin. Trascina lo ZIP e premi Installa, poi Attiva.
- 3 · Configura il plugin
Nel menu WooCommerce → Findalo. Compila:
- Your search URL: lo slug che vedi nel tuo pannello findalo.io (lo scegli alla registrazione).
- Feed token (Bearer): quello che appare nel pannello findalo — copialo e incollalo qui. Se è vuoto, il plugin ne genera uno e poi lo copi nel pannello.
- Trigger selector: lascialo al valore predefinito — copre il blocco di ricerca Gutenberg, il search-field classico e il form di ricerca prodotti.
Salva. Il plugin inietta il widget in
wp_headautomaticamente. - 4 · Forza la prima sincronizzazione
Nella stessa pagina delle impostazioni del plugin, premi "Mark as pending (force next rebuild)". Attendi 5–10 secondi. Il plugin costruisce il JSON del catalogo e lo invia a findalo.io (push asincrono — la pagina ritorna senza aspettare il caricamento).
- 5 · Verifica
Su findalo.io → il tuo motore di ricerca → Sincronizzazione: dovresti vedere i prodotti sincronizzati con
sync_source: push. Apri il tuo storefront, clicca sulla lente — il modal findalo si apre con i tuoi prodotti. Da ora in poi qualsiasi modifica a prodotto, stock o prezzo si rifletterà in ≤10 min (throttle anti-spam sullo stock). - 6 · Supporto multilingua (opzionale)
Se usi WPML o Polylang, il plugin li rileva automaticamente e pubblica ogni prodotto tradotto sotto la propria locale (ISO 2 lettere). Nessuna configurazione aggiuntiva.
Shopify — passi essenziali
In attesa che l'app ufficiale raggiunga lo Shopify App Store, il connettore funziona
in modalità Custom App. ~10 minuti da capo a piedi. Usa la
dev store di demo (pass 1234)
come riferimento per il risultato finale.
- 1 · Registrati su findalo
Registrati su findalo.io (il piano Free è sufficiente per testare). Annota il tuo slug — ti servirà nell'ultimo passaggio.
- 2 · Crea una Custom App in Shopify
Nel tuo Shopify Admin: Settings → Apps and sales channels → Develop apps → Create an app. Scegli un nome qualsiasi (es. "findalo-search").
- 3 · Abilita gli scope
All'interno dell'app: Configuration → Admin API integration → Configure. Seleziona:
read_productsread_product_listingsread_collectionsread_inventory
Save in basso a destra.
- 4 · Installa l'app e copia il token
Premi Install app in alto a destra. Approdi su API credentials: copia l'Admin API access token (inizia con
shpat_e ha 38 caratteri).⚠ Shopify mostra il token una sola volta. Se commetti un errore o chiudi la scheda, dovrai ruotare le credenziali e generarne uno nuovo.
- 5 · Connetti findalo nel pannello
Nel tuo pannello findalo: Integrazione → tab Shopify. Incolla:
- Dominio:
il-tuo-negozio.myshopify.com - Admin API access token: il
shpat_…del passo 4
Premi Connetti e sincronizza. Validiamo le credenziali con Shopify e importiamo il tuo catalogo in pochi secondi. Vedrai "Connesso a
il-tuo-negozio.myshopify.com". - Dominio:
- 6 · Incolla lo snippet nel tema
Nel Shopify Admin: Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Appena prima di
</body>:<script src="https://widget.findalo.io/widget.js" data-tenant="IL_TUO_SLUG" defer></script>Sostituisci
IL_TUO_SLUGcon lo slug del passo 1. Salva. Ricarica il tuo storefront e clicca sulla lente — il widget findalo apre il modal con i tuoi prodotti. - 7 · Sincronizzazione continua automatica
Da qui in avanti: il cron di findalo fa pull ogni 5 min. Modifichi prezzi, stock o prodotti in Shopify → findalo reindicizza automaticamente in meno di 5 minuti. Zero infrastruttura da parte tua. Per forzare una sincronizzazione manuale: pannello → Sincronizzazione → Sincronizza ora.
Magento — passi essenziali
Modulo nativo per Magento 2 e Adobe Commerce. ~10 minuti. Richiede PHP 8.2, 8.3 o 8.4. Compatibile con Hyvä Themes e storefront PWA Studio / headless.
- 1 · Scarica il modulo
Accedi al tuo pannello → Integrazione → tab Magento → Scarica ZIP. Ti forniamo sempre l'ultima versione pubblicata. Se non hai ancora un account, registrati gratis.
- 2 · Carica il modulo sul tuo Magento
Decomprimi lo ZIP e copia la cartella in
app/code/Findalo/Searchdel tuo Magento. Via SSH:mkdir -p app/code/Findalo/Search unzip findalo-magento-*.zip -d app/code/Findalo/Search - 3 · Abilita il modulo
Dalla root del tuo Magento:
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 il tuo pipeline lo richiede. - 4 · Configura
Nel Magento Admin: Stores → Configuration → Findalo → General. Compila:
- Search URL: lo slug che vedi nel tuo pannello findalo.io.
- Feed token: copialo dal pannello findalo e incollalo qui, oppure lascialo vuoto per generarlo automaticamente.
- Trigger selector: lascialo al valore predefinito — copre i temi Luma, Blank e Hyvä.
Salva e svuota le cache:
bin/magento cache:flush. - 5 · Verifica la sincronizzazione
Su findalo.io → il tuo motore di ricerca → Stato del catalogo: dovresti vedere i tuoi prodotti indicizzati in meno di 5 minuti. Se usi multi-store o multi-website, ogni vista viene indicizzata separatamente e identificata dal suo
store_code. Ricarica il tuo storefront, clicca sulla lente — il widget apre il modal con i tuoi prodotti.
Shopware — passi essenziali
Plugin nativo per Shopware 6.6 e versioni successive. ~10 minuti. Compatibile con Storefront classico e storefront headless.
- 1 · Scarica il plugin
Accedi al tuo pannello → Integrazione → tab Shopware → Scarica ZIP. Ti forniamo sempre l'ultima versione pubblicata. Se non hai ancora un account, registrati gratis.
- 2 · Carica il plugin su Shopware
Nel tuo Shopware Admin: Estensioni → Le mie estensioni → Carica estensione. Trascina lo ZIP. Via CLI:
bin/console plugin:refresh bin/console plugin:install --activate FindaloSearch bin/console cache:clear - 3 · Configura
Nel Shopware Admin: Estensioni → Findalo Search → Configura. Compila:
- Search URL: lo slug che vedi nel tuo pannello findalo.io.
- Feed token: copialo dal pannello findalo e incollalo qui, oppure lascialo vuoto per generarlo automaticamente.
- Trigger selector: lascialo al valore predefinito — copre i temi Storefront predefiniti.
Salva. Il plugin inietta il widget nel Storefront automaticamente.
- 4 · Verifica la sincronizzazione
Su findalo.io → il tuo motore di ricerca → Stato del catalogo: dovresti vedere i tuoi prodotti indicizzati in meno di 5 minuti. Se usi multi-sales-channel, ognuno viene indicizzato separatamente. Ricarica il tuo Storefront, clicca sulla lente — il widget apre il modal con i tuoi prodotti.
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.