Findalo

Dokumentation

Findalo in deinem Shop in 10 Minuten aktivieren.

Schritt-für-Schritt-Anleitungen für jede Plattform, die API und das Dashboard. Hast du Fragen, schreib uns an hola@findalo.io — wir lesen alles.

Installation nach Plattform

Technische Mindestanforderungen

Was dein Shop für die Installation des Findalo-Moduls braucht. Liegt dein Stack darunter, schreib uns an hola@findalo.io und wir sehen, was wir tun können.

Plattform Modul Kompatible Plattform PHP Weitere Anforderungen
PrestaShop v1.6.14
Aktualisiert 9. Juni 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
Aktualisiert 4. Juni 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
Aktualisiert 8. Juni 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
Aktualisiert 8. Juni 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+

Das Browser-Widget funktioniert in aktuellen Versionen von Chrome, Firefox, Safari und Edge sowie in den zwei vorherigen Versionen. Keine jQuery- oder Theme-Abhängigkeiten.

PrestaShop — wesentliche Schritte

  1. 1 · Download

    Melde dich in deinem Kundenkonto an und öffne Integrationen → PrestaShop-Modul. Klicke auf ZIP herunterladen — wir liefern immer die neueste veröffentlichte Version. Noch kein Konto? Kostenlos registrieren.

  2. 2 · Hochladen und installieren

    Im PrestaShop-BO: Module → Modulverwaltung → Modul hochladen. Ziehe die ZIP-Datei hinein und klicke auf Installieren.

  3. 3 · Konfigurieren

    Klicke auf Konfigurieren beim Findalo-Modul. Fülle aus:

    • Suchmaschinen-URL: der Slug in deinem findalo.io-Dashboard (sichtbar sobald du dich registrierst).
    • Feed token: leer lassen, um automatisch einen sicheren Token zu generieren. Kopiere ihn danach in dein findalo.io-Dashboard.
    • Trigger-Selektor: Standardwert beibehalten (deckt das Classic-Theme und die meisten anderen ab). Nur ändern, wenn dein Theme eigene Selektoren verwendet.
  4. 4 · Aktivieren

    Hake „Such-Bundle auf allen Seiten laden" an und speichere. Lade deinen Storefront neu, klicke auf die Lupe des Themes — das Widget öffnet ein Vollbild-Modal und die Produkte erscheinen sofort.

  5. 5 · Synchronisierung prüfen

    Auf findalo.io → deine Suchmaschine → Katalogstatus: du solltest deine Produkte in weniger als 5 Minuten indexiert sehen. Falls nicht, prüfe, ob dein PrestaShop aus dem Internet erreichbar ist (die Synchronisierung pollt den Endpoint /module/findalo/feed alle 5 Min.).

WooCommerce — wesentliche Schritte

Standard-WordPress-Plugin. ~10 Minuten. Kompatibel mit WPML, Polylang, WP Rocket, LiteSpeed Cache und den Themes Storefront / Hello Elementor / Astra / Blocksy. Live-Demo: woocommerce.findalo.io/shop.

  1. 1 · Plugin herunterladen

    Melde dich in deinem Dashboard anIntegration → WooCommerce-TabZIP herunterladen. Wir liefern immer die neueste veröffentlichte Version. Hast du noch kein Konto, registriere dich kostenlos.

  2. 2 · In WordPress hochladen und installieren

    In deinem WordPress-Admin: Plugins → Neu hinzufügen → Plugin hochladen. Ziehe die ZIP-Datei hinein und klicke auf Installieren, dann Aktivieren.

  3. 3 · Plugin konfigurieren

    Im Menü WooCommerce → Findalo. Fülle aus:

    • Your search URL: der Slug in deinem findalo.io-Dashboard (du wählst ihn bei der Registrierung).
    • Feed token (Bearer): der im findalo-Dashboard angezeigte — kopiere und füge ihn hier ein. Wenn er leer ist, generiert das Plugin einen, den du dann ins Dashboard kopierst.
    • Trigger-Selektor: Standardwert beibehalten — deckt den Gutenberg-Suchblock, das klassische Suchfeld und das Produktsuchformular ab.

    Speichern. Das Plugin injiziert das Widget automatisch in wp_head.

  4. 4 · Erste Synchronisierung erzwingen

    Klicke auf derselben Plugin-Einstellungsseite auf „Mark as pending (force next rebuild)". Warte 5–10 Sekunden. Das Plugin erstellt das Katalog-JSON und sendet es an findalo.io (asynchroner Push — die Seite kehrt zurück, ohne auf den Upload zu warten).

  5. 5 · Prüfen

    Auf findalo.io → deine Suchmaschine → Synchronisierung: du solltest Produkte mit sync_source: push sehen. Öffne deinen Storefront, klicke auf die Lupe — das findalo-Modal öffnet sich mit deinen Produkten. Ab jetzt werden alle Änderungen an Produkt, Lagerbestand oder Preis in ≤10 Min. übernommen (Stock-Throttle gegen Spam).

  6. 6 · Mehrsprachigkeit (optional)

    Wenn du WPML oder Polylang verwendest, erkennt das Plugin sie automatisch und veröffentlicht jedes übersetzte Produkt unter seiner Locale (2-buchstabiger ISO-Code). Keine zusätzliche Konfiguration erforderlich.

Shopify — wesentliche Schritte

Bis die offizielle App den Shopify App Store erreicht, funktioniert der Connector im Custom-App-Modus. ~10 Minuten von Anfang bis Ende. Nutze die Demo-Dev-Store (Passwort 1234) als Referenz für das Endergebnis.

  1. 1 · findalo-Konto anlegen

    Registriere dich auf findalo.io (der Free-Plan reicht zum Testen). Notiere deinen Slug — du brauchst ihn im letzten Schritt.

  2. 2 · Custom App in Shopify erstellen

    In deinem Shopify-Admin: Settings → Apps and sales channels → Develop apps → Create an app. Gib ihr einen beliebigen Namen (z. B. „findalo-search").

  3. 3 · Scopes aktivieren

    In der App: Configuration → Admin API integration → Configure. Hake an:

    • read_products
    • read_product_listings
    • read_collections
    • read_inventory

    Save unten rechts.

  4. 4 · App installieren und Token kopieren

    Klicke oben rechts auf Install app. Du landest auf API credentials: kopiere den Admin API access token (beginnt mit shpat_ und hat 38 Zeichen).

    ⚠ Shopify zeigt den Token nur einmal. Machst du einen Fehler oder schließt du den Tab, musst du die Zugangsdaten rotieren und einen neuen Token generieren.

  5. 5 · findalo im Dashboard verbinden

    In deinem findalo-Dashboard: Integration → Shopify-Tab. Füge ein:

    • Domain: dein-shop.myshopify.com
    • Admin API access token: der shpat_… aus Schritt 4

    Klicke auf Verbinden und synchronisieren. Wir validieren die Zugangsdaten mit Shopify und laden deinen Katalog in wenigen Sekunden. Du siehst „Verbunden mit dein-shop.myshopify.com".

  6. 6 · Snippet ins Theme einfügen

    Im Shopify-Admin: Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Direkt vor </body>:

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

    Ersetze DEIN_SLUG durch den Slug aus Schritt 1. Speichern. Lade deinen Storefront neu und klicke auf die Lupe — das findalo-Widget öffnet das Modal mit deinen Produkten.

  7. 7 · Kontinuierliche automatische Synchronisierung

    Ab jetzt: der findalo-Cron führt alle 5 Min. einen Pull durch. Du änderst Preise, Lagerbestand oder Produkte in Shopify → findalo reindexiert automatisch in weniger als 5 Minuten. Keine eigene Infrastruktur erforderlich. Um eine manuelle Synchronisierung zu erzwingen: Dashboard → Synchronisierung → Jetzt synchronisieren.

Magento — wesentliche Schritte

Natives Modul für Magento 2 und Adobe Commerce. ~10 Minuten. Erfordert PHP 8.2, 8.3 oder 8.4. Kompatibel mit Hyvä Themes und PWA Studio / Headless-Storefronts.

  1. 1 · Modul herunterladen

    Melde dich in deinem Dashboard anIntegration → Magento-TabZIP herunterladen. Wir liefern immer die neueste veröffentlichte Version. Hast du noch kein Konto, registriere dich kostenlos.

  2. 2 · Modul auf deinen Magento-Server hochladen

    Entpacke die ZIP-Datei und kopiere den Ordner nach app/code/Findalo/Search in deinem Magento. Per SSH:

    mkdir -p app/code/Findalo/Search
    unzip findalo-magento-*.zip -d app/code/Findalo/Search
  3. 3 · Modul aktivieren

    Aus dem Stammverzeichnis deines Magento:

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

    In der Produktion ergänze bin/magento setup:di:compile und bin/magento setup:static-content:deploy, wenn deine Pipeline das erfordert.

  4. 4 · Konfigurieren

    Im Magento-Admin: Stores → Configuration → Findalo → General. Fülle aus:

    • Search URL: der Slug in deinem findalo.io-Dashboard.
    • Feed token: kopiere ihn aus dem findalo-Dashboard und füge ihn hier ein, oder leer lassen für automatische Generierung.
    • Trigger-Selektor: Standardwert beibehalten — deckt die Themes Luma, Blank und Hyvä ab.

    Speichern und Caches leeren: bin/magento cache:flush.

  5. 5 · Synchronisierung prüfen

    Auf findalo.io → deine Suchmaschine → Katalogstatus: du solltest deine Produkte in weniger als 5 Minuten indexiert sehen. Nutzt du Multi-Store oder Multi-Website, wird jede View separat indexiert und durch ihren store_code identifiziert. Lade deinen Storefront neu, klicke auf die Lupe — das Widget öffnet das Modal mit deinen Produkten.

Shopware — wesentliche Schritte

Natives Plugin für Shopware 6.6 und höher. ~10 Minuten. Kompatibel mit klassischem Storefront und Headless-Storefronts.

  1. 1 · Plugin herunterladen

    Melde dich in deinem Dashboard anIntegration → Shopware-TabZIP herunterladen. Wir liefern immer die neueste veröffentlichte Version. Hast du noch kein Konto, registriere dich kostenlos.

  2. 2 · Plugin auf Shopware hochladen

    In deinem Shopware-Admin: Erweiterungen → Meine Erweiterungen → Erweiterung hochladen. Ziehe die ZIP-Datei hinein. Per CLI:

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

    Im Shopware-Admin: Erweiterungen → Findalo Search → Konfigurieren. Fülle aus:

    • Search URL: der Slug in deinem findalo.io-Dashboard.
    • Feed token: kopiere ihn aus dem findalo-Dashboard und füge ihn hier ein, oder leer lassen für automatische Generierung.
    • Trigger-Selektor: Standardwert beibehalten — deckt die Standard-Storefront-Themes ab.

    Speichern. Das Plugin injiziert das Widget automatisch in den Storefront.

  4. 4 · Synchronisierung prüfen

    Auf findalo.io → deine Suchmaschine → Katalogstatus: du solltest deine Produkte in weniger als 5 Minuten indexiert sehen. Nutzt du Multi-Sales-Channel, wird jeder separat indexiert. Lade deinen Storefront neu, klicke auf die Lupe — das Widget öffnet das Modal mit deinen Produkten.

Schnelle Ressourcen

API und Endpoints

Öffentliche Basis-URL: https://api.findalo.io

GET /api/<suchmaschine>/search?q=<query>
Hauptsuche. Gibt Treffer, Facetten und Gesamtanzahl zurück. Die Origin muss in allowed_domains deiner Suchmaschine eingetragen sein.
GET /api/<suchmaschine>/suggest?q=<query>
Autovervollständigung. Bei Tippgeschwindigkeit aufrufen; hat ein großzügigeres Rate-Limit als /search.
GET /api/public-config/<suchmaschine>
Öffentliche Konfiguration deiner Suchmaschine: Theme, Layout, Plan. Was das Widget beim Start verwendet.
POST /api/<suchmaschine>/track
Event-Tracking (Klicks, In-den-Warenkorb, Conversions). JSON-Body.

Detaillierte Dokumentation mit cURL-Beispielen und SDKs folgt. Brauchst du etwas Konkretes jetzt? Schreib uns.

Empfehlungen (Pro+-Plan)

Vorgeschlagene Produktblöcke auf Produktseite, Warenkorb und Startseite — ohne dass der Besucher sucht. Die Engine aggregiert deine View/Add-to-Cart-Events mit 30-Tage-Decay und materialisiert drei Indizes: Co-Besuche, Co-Warenkorb-Hinzufügungen und Bestseller.

Auto-Inject (PrestaShop)

Das Modul enthält bereits die Hooks displayFooterProduct, displayShoppingCartFooter und displayHome. Konfiguriere das Back-Office und aktiviere die Slots — kein Code nötig.

Custom-Integration (andere Plattformen)

// Auf der Produktseite:
findalo.reco({
  context: 'similar',
  productId: '123',
  target: '#findalo-similar-slot',
  title: 'Das könnte dir auch gefallen',
});

// Beim Laden der Produktseite:
findalo.trackView('123');

// Beim Hinzufügen zum Warenkorb:
findalo.trackAddToCart('123');

// Recently viewed (clientseitig, kein Backend-Traffic):
findalo.recentlyViewed();  // → ['123', '456', ...]

Endpoint

GET /api/<suchmaschine>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · Plan ≥ Pro, sonst gibt der Endpoint 402 zurück.

Etwas funktioniert nicht?

Schick uns eine E-Mail an hola@findalo.io mit deiner Shop-URL und was nicht funktioniert. Wir antworten persönlich innerhalb der Geschäftszeiten.