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
- Verfügbar
PrestaShop 1.7 / 8.x / 9.x
Natives Modul. Kompatibel mit Classic-, Hummingbird- und Custom-Themes.
- Beta — Self-Service
Shopify
Custom App + Snippet in theme.liquid. Offizielle App im Partners-Programm in Kürze.
- Verfügbar
WooCommerce
Offizielles WordPress-Plugin. Kompatibel mit WPML/Polylang und WP-Caches.
- Verfügbar
Magento 2 / Adobe Commerce
Natives Modul. Aus deinem Dashboard herunterladbar. PHP 8.2/8.3/8.4. Kompatibel mit Hyvä und PWA Studio.
- Verfügbar
Shopware 6
Natives Plugin. Aus deinem Dashboard herunterladbar. Kompatibel mit Shopware 6.6+ und Storefront / Headless.
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 · 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 · Hochladen und installieren
Im PrestaShop-BO: Module → Modulverwaltung → Modul hochladen. Ziehe die ZIP-Datei hinein und klicke auf Installieren.
- 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 · 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 · 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/feedalle 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 · Plugin herunterladen
Melde dich in deinem Dashboard an → Integration → WooCommerce-Tab → ZIP herunterladen. Wir liefern immer die neueste veröffentlichte Version. Hast du noch kein Konto, registriere dich kostenlos.
- 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 · 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 · 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 · Prüfen
Auf findalo.io → deine Suchmaschine → Synchronisierung: du solltest Produkte mit
sync_source: pushsehen. Ö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 · 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 · findalo-Konto anlegen
Registriere dich auf findalo.io (der Free-Plan reicht zum Testen). Notiere deinen Slug — du brauchst ihn im letzten Schritt.
- 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 · Scopes aktivieren
In der App: Configuration → Admin API integration → Configure. Hake an:
read_productsread_product_listingsread_collectionsread_inventory
Save unten rechts.
- 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 · 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". - Domain:
- 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_SLUGdurch 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 · 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 · Modul herunterladen
Melde dich in deinem Dashboard an → Integration → Magento-Tab → ZIP herunterladen. Wir liefern immer die neueste veröffentlichte Version. Hast du noch kein Konto, registriere dich kostenlos.
- 2 · Modul auf deinen Magento-Server hochladen
Entpacke die ZIP-Datei und kopiere den Ordner nach
app/code/Findalo/Searchin deinem Magento. Per SSH:mkdir -p app/code/Findalo/Search unzip findalo-magento-*.zip -d app/code/Findalo/Search - 3 · Modul aktivieren
Aus dem Stammverzeichnis deines Magento:
bin/magento module:enable Findalo_Search bin/magento setup:upgrade bin/magento cache:flushIn der Produktion ergänze
bin/magento setup:di:compileundbin/magento setup:static-content:deploy, wenn deine Pipeline das erfordert. - 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 · 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_codeidentifiziert. 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 · Plugin herunterladen
Melde dich in deinem Dashboard an → Integration → Shopware-Tab → ZIP herunterladen. Wir liefern immer die neueste veröffentlichte Version. Hast du noch kein Konto, registriere dich kostenlos.
- 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 · 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 · 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_domainsdeiner 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.