Findalo

Documentation

Activate Findalo on your store in 10 minutes.

Step-by-step guides for every platform, the API and the panel. If you get stuck, email us at hola@findalo.io — we read everything.

Installation by platform

Minimum technical requirements

What your store needs to install the Findalo module. If your stack falls below this, let us know at hola@findalo.io and we'll see what we can do.

Platform Module Compatible platform PHP Other requirements
PrestaShop v1.6.14
Updated Jun 9, 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
Updated Jun 4, 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
Updated Jun 8, 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
Updated Jun 8, 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+

The browser widget works on current Chrome, Firefox, Safari and Edge and the two previous versions. No jQuery or theme dependencies.

PrestaShop — essential steps

  1. 1 · Download

    Go to your customer panel and open Integrations → PrestaShop Module. Click Download ZIP — we always give you the latest published version. Don't have an account yet? Sign up for free.

  2. 2 · Upload and install

    In PrestaShop BO: Modules → Module Manager → Upload a module. Drag the ZIP and click Install.

  3. 3 · Configure

    Click Configure on the Findalo module. Fill in:

    • Search URL: the slug you have in your findalo.io panel (visible as soon as you register).
    • Feed token: leave it empty to auto-generate a strong one. Copy it afterwards to your findalo.io panel.
    • Trigger selector: leave it as default (covers the Classic theme and the majority). Only change it if your theme uses custom selectors.
  4. 4 · Activate

    Check "Load the search bundle on all pages" and save. Reload your storefront, click the theme's magnifying glass — the widget opens a full-screen modal and products appear instantly.

  5. 5 · Verify the sync

    In findalo.io → your search engine → Catalog status: you should see your products indexed in under 5 minutes. If not, check that your PrestaShop is reachable from the internet (sync polls every 5 min at the endpoint /module/findalo/feed).

WooCommerce — essential steps

Standard WordPress plugin. ~10 minutes. Compatible with WPML, Polylang, WP Rocket, LiteSpeed Cache and Storefront / Hello Elementor / Astra / Blocksy themes. Live demo: woocommerce.findalo.io/shop.

  1. 1 · Download the plugin

    Go to your panelIntegration → WooCommerce tabDownload ZIP. We always give you the latest published version. If you don't have an account yet, sign up for free.

  2. 2 · Upload and install in WordPress

    In your WordPress admin: Plugins → Add new → Upload plugin. Drag the ZIP and click Install, then Activate.

  3. 3 · Configure the plugin

    In the WooCommerce → Findalo menu. Fill in:

    • Your search URL: the slug you see in your findalo.io panel (you choose it at sign-up).
    • Feed token (Bearer): the one shown in the findalo panel — copy and paste it here. If it's empty, the plugin generates one and you copy it to the panel afterwards.
    • Trigger selector: leave it as default — covers the Gutenberg search block, classic search-field and the product search form.

    Save. The plugin injects the widget into wp_head automatically.

  4. 4 · Force the first sync

    On the same plugin settings page, click "Mark as pending (force next rebuild)". Wait 5–10 seconds. The plugin builds the catalog JSON and posts it to findalo.io (async push — the page returns without waiting for the upload).

  5. 5 · Verify

    In findalo.io → your search engine → Synchronisation: you should see products synced with sync_source: push. Open your storefront, click the magnifying glass — the findalo modal opens with your products. From now on any change in product, stock or price will be reflected in ≤10 min (stock throttle anti-spam).

  6. 6 · Multi-language support (optional)

    If you use WPML or Polylang, the plugin detects them automatically and publishes each translated product under its locale (2-letter ISO). No extra configuration.

Shopify — essential steps

While the official app reaches the Shopify App Store, the connector works in Custom App mode. ~10 minutes end to end. Use the demo dev store (pass 1234) as a reference for how it looks.

  1. 1 · Sign up for findalo

    Register at findalo.io (Free plan is enough to test). Note your slug — you'll need it in the last step.

  2. 2 · Create a Custom App in Shopify

    In your Shopify Admin: Settings → Apps and sales channels → Develop apps → Create an app. Give it any name (e.g. "findalo-search").

  3. 3 · Enable the scopes

    Inside the app: Configuration → Admin API integration → Configure. Check:

    • read_products
    • read_product_listings
    • read_collections
    • read_inventory

    Save at the bottom right.

  4. 4 · Install the app and copy the token

    Click Install app at the top right. You'll land on API credentials: copy the Admin API access token (starts with shpat_ and is 38 characters long).

    ⚠ Shopify shows the token only once. If you make a mistake or close the tab, you'll need to rotate credentials and generate a new one.

  5. 5 · Connect findalo in the panel

    In your findalo panel: Integration → Shopify tab. Paste:

    • Domain: your-store.myshopify.com
    • Admin API access token: the shpat_… from step 4

    Click Connect and sync. We validate credentials against Shopify and pull your catalog in seconds. You'll see "Connected to your-store.myshopify.com".

  6. 6 · Paste the snippet into the theme

    In Shopify Admin: Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Just before </body>:

    <script src="https://widget.findalo.io/widget.js" data-tenant="YOUR_SLUG" defer></script>

    Replace YOUR_SLUG with the slug from step 1. Save. Reload your storefront and click the magnifying glass — the findalo widget opens the modal with your products.

  7. 7 · Continuous automatic sync

    From here on: the findalo cron pulls every 5 min. You change prices, stock or products in Shopify → findalo re-indexes automatically in under 5 minutes. Zero infrastructure on your end. To force a manual sync: panel → Synchronisation → Sync now.

Magento — essential steps

Native module for Magento 2 and Adobe Commerce. ~10 minutes. Requires PHP 8.2, 8.3 or 8.4. Compatible with Hyvä Themes and PWA Studio / headless storefronts.

  1. 1 · Download the module

    Go to your panelIntegration → Magento tabDownload ZIP. We always give you the latest published version. If you don't have an account yet, sign up for free.

  2. 2 · Upload the module to your Magento

    Unzip and copy the folder to app/code/Findalo/Search in your Magento. Via SSH:

    mkdir -p app/code/Findalo/Search
    unzip findalo-magento-*.zip -d app/code/Findalo/Search
  3. 3 · Enable the module

    From the root of your Magento:

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

    In production add bin/magento setup:di:compile and bin/magento setup:static-content:deploy if your pipeline requires it.

  4. 4 · Configure

    In Magento Admin: Stores → Configuration → Findalo → General. Fill in:

    • Search URL: the slug you see in your findalo.io panel.
    • Feed token: copy it from the findalo panel and paste it here, or leave empty to auto-generate it.
    • Trigger selector: leave as default — covers Luma, Blank and Hyvä themes.

    Save and flush caches: bin/magento cache:flush.

  5. 5 · Verify the sync

    In findalo.io → your search engine → Catalog status: you should see your products indexed in under 5 minutes. If you run multi-store or multi-website, each view is indexed separately and identified by its store_code. Reload your storefront, click the magnifying glass — the widget opens the modal with your products.

Shopware — essential steps

Native plugin for Shopware 6.6 and above. ~10 minutes. Compatible with classic Storefront and headless storefronts.

  1. 1 · Download the plugin

    Go to your panelIntegration → Shopware tabDownload ZIP. We always give you the latest published version. If you don't have an account yet, sign up for free.

  2. 2 · Upload the plugin to Shopware

    In your Shopware Admin: Extensions → My extensions → Upload extension. Drag the ZIP. Via CLI:

    bin/console plugin:refresh
    bin/console plugin:install --activate FindaloSearch
    bin/console cache:clear
  3. 3 · Configure

    In Shopware Admin: Extensions → Findalo Search → Configure. Fill in:

    • Search URL: the slug you see in your findalo.io panel.
    • Feed token: copy it from the findalo panel and paste it here, or leave empty to auto-generate it.
    • Trigger selector: leave as default — covers the default Storefront themes.

    Save. The plugin injects the widget into the Storefront automatically.

  4. 4 · Verify the sync

    In findalo.io → your search engine → Catalog status: you should see your products indexed in under 5 minutes. If you run multi-sales-channel, each one is indexed separately. Reload your Storefront, click the magnifying glass — the widget opens the modal with your products.

Quick resources

API and endpoints

Public base URL: https://api.findalo.io

GET /api/<search-engine>/search?q=<query>
Main search. Returns hits, facets and total. Origin must be in allowed_domains of your search engine.
GET /api/<search-engine>/suggest?q=<query>
Autocomplete. Call it at typing speed; it has a more generous rate limit than /search.
GET /api/public-config/<search-engine>
Public config of your search engine: theme, layout, plan. What the widget uses at boot.
POST /api/<search-engine>/track
Event tracking (clicks, adds-to-cart, conversions). JSON body.

Detailed documentation with cURL examples and SDKs coming soon. Need something specific now? Write to us.

Recommendations (Pro+ plan)

Suggested product blocks on product pages, cart and homepage — without the shopper making any search. The engine aggregates your view/add-to-cart events with 30-day decay and materialises three indices: co-visited, co-added-to-cart and bestsellers.

Auto-inject (PrestaShop)

The module already includes the displayFooterProduct, displayShoppingCartFooter and displayHome hooks. Configure the back office and activate the slots — zero code.

Custom integration (other platforms)

// On the product page:
findalo.reco({
  context: 'similar',
  productId: '123',
  target: '#findalo-similar-slot',
  title: 'You might also like',
});

// When the product page loads:
findalo.trackView('123');

// When adding to cart:
findalo.trackAddToCart('123');

// Recently viewed (client-side, no backend traffic):
findalo.recentlyViewed();  // → ['123', '456', ...]

Endpoint

GET /api/<search-engine>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · plan ≥ Pro or returns 402.

Something not working?

Send us an email at hola@findalo.io with your store URL and what's failing. We reply personally during business hours.