Findalo

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

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. 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. 2 · Carica e installa

    Nel PrestaShop BO: Moduli → Gestore moduli → Carica un modulo. Trascina lo ZIP e premi Installa.

  3. 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. 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. 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. 1 · Scarica il plugin

    Accedi al tuo pannelloIntegrazione → tab WooCommerceScarica ZIP. Ti forniamo sempre l'ultima versione pubblicata. Se non hai ancora un account, registrati gratis.

  2. 2 · Carica e installa in WordPress

    Nel tuo WordPress admin: Plugin → Aggiungi nuovo → Carica plugin. Trascina lo ZIP e premi Installa, poi Attiva.

  3. 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_head automaticamente.

  4. 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. 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. 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. 1 · Registrati su findalo

    Registrati su findalo.io (il piano Free è sufficiente per testare). Annota il tuo slug — ti servirà nell'ultimo passaggio.

  2. 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. 3 · Abilita gli scope

    All'interno dell'app: Configuration → Admin API integration → Configure. Seleziona:

    • read_products
    • read_product_listings
    • read_collections
    • read_inventory

    Save in basso a destra.

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

  6. 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_SLUG con 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. 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. 1 · Scarica il modulo

    Accedi al tuo pannelloIntegrazione → tab MagentoScarica ZIP. Ti forniamo sempre l'ultima versione pubblicata. Se non hai ancora un account, registrati gratis.

  2. 2 · Carica il modulo sul tuo Magento

    Decomprimi lo ZIP e copia la cartella in app/code/Findalo/Search del tuo Magento. Via SSH:

    mkdir -p app/code/Findalo/Search
    unzip findalo-magento-*.zip -d app/code/Findalo/Search
  3. 3 · Abilita il modulo

    Dalla root del tuo Magento:

    bin/magento module:enable Findalo_Search
    bin/magento setup:upgrade
    bin/magento cache:flush

    In produzione aggiungi bin/magento setup:di:compile e bin/magento setup:static-content:deploy se il tuo pipeline lo richiede.

  4. 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. 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. 1 · Scarica il plugin

    Accedi al tuo pannelloIntegrazione → tab ShopwareScarica ZIP. Ti forniamo sempre l'ultima versione pubblicata. Se non hai ancora un account, registrati gratis.

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