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.
- Verfügbar
Shopify
Öffentliche App: Shop mit einem Klick aus dem Panel verbinden, Suche im Theme aktivieren, ohne Code anzufassen. Kein Modul, keine Tokens.
- 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
Native App (ohne PHP). Aus deinem Dashboard herunterladbar. Kompatibel mit Shopware 6.6 und 6.7, 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.9.11 Aktualisiert 30. Okt. 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.5.2 Eintrag auf WordPress.org ↗ Aktualisiert 31. Okt. 2026 | WordPress 6.0+ WooCommerce 7.0+ (probado hasta WP 7.1 y WC 11.1) en el directorio de WordPress.org | 7.4+ | WPML o Polylang autodetectados · compatible con WP Rocket / LiteSpeed Cache · temas Storefront / Hello Elementor / Astra / Blocksy verificados |
| Magento | v1.3.8 Eintrag auf Adobe Commerce Marketplace ↗ Aktualisiert 11. Sept. 2026 | Magento 2.4 Adobe Commerce (Open Source, on-premise y cloud) en Adobe Commerce Marketplace | 8.2 / 8.3 / 8.4 / 8.5 | Módulos estándar: Magento_Catalog, Magento_Config, Magento_Backend · Composer recomendado |
| Shopify | App pública Se conecta desde tu panel (Conectar con Shopify) | Cualquier plan Shopify (incl. Basic, Shopify, Advanced, Plus) | — | Acceso al admin de Shopify con permiso para instalar apps · la app pide leer el catálogo y el inventario (read_products, read_inventory), los eventos de compra para la analítica (write_pixels, read_customer_events) y las páginas y políticas de la tienda para el asistente (read_content, read_legal_policies) · cualquier tema: el buscador se activa como incrustación de app en el editor de temas, sin tocar código |
| Shopware | v0.8.3 App nativa (sin PHP) Aktualisiert 8. Sept. 2026 | Shopware 6.4 – 6.7+ (App nativa, Storefront) | — | App de Shopware (sin PHP, resiliente a versiones) · instalar vía Extensiones → Subir extensión · Admin API accesible para la sincronización (pull del catálogo) · cualquier tema |
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
Natives Modul für PrestaShop 1.7.6 – 9.x, Multishop inklusive. ~10 Minuten. Der Shop wird mit einem Klick direkt aus dem Modul verbunden: keine Tokens kopieren, keine URLs anpassen.
- 1 · Modul installieren
Melden Sie sich in Ihrem Kundenkonto an (oder registrieren Sie sich kostenlos) → Integration → Tab PrestaShop → ZIP herunterladen: immer die zuletzt veröffentlichte Version. In Ihrem Back-Office: Module → Modulverwaltung → Modul hochladen, ZIP ablegen und auf Installieren klicken.
- 2 · Verbindung herstellen
Suchen Sie unter Module → Modulverwaltung (①) Findalo und klicken Sie auf Konfigurieren. Klicken Sie im Tab Konfiguration auf Connect with findalo (②). panel.findalo.io öffnet sich: Melden Sie sich mit Ihrem Findalo-Konto an (oder legen Sie es direkt dort an), wählen Sie die Suche und klicken Sie auf Diesen Shop verbinden. Sie kehren bereits verbunden ins Modul zurück: Die Zugangsdaten gehen von Server zu Server — Sie sehen und kopieren sie nie.
- 3 · Prüfen, ob alles ankommt
Das Modul zeigt ✓ Connected · ihre-suche. Der Katalog wird von selbst übertragen: In Ihrem Panel → Synchronisierung erscheinen Ihre Produkte innerhalb weniger Minuten, und ab dann kommt jede Produkt-, Preis- oder Bestandsänderung automatisch an. Übertragung erzwingen: Tab Status im Modul → Mark as pending (force next rebuild) oder Jetzt synchronisieren im Panel. Laden Sie Ihren Shop neu und klicken Sie auf die Lupe: Die Suche öffnet sich mit Ihren Produkten.
Wenn Sie die Schaltfläche nicht nutzen können
Öffnet sich das Panel-Fenster nicht oder bricht der Rückweg ins Modul ab (Pop-up-Blocker, vom Hosting unterbrochene Weiterleitung), verbinden Sie von Hand: Kopieren Sie in Ihrem Panel → Integration → Tab PrestaShop die ID der Suche und das Synchronisierungs-Token; klappen Sie im Modul Connection not working? Connect manually auf, fügen Sie beide Werte ein und klicken Sie auf Save manual connection. Das Ergebnis ist dasselbe wie mit der Schaltfläche.
WooCommerce — wesentliche Schritte
Offizielles WordPress-Plugin für WooCommerce. ~10 Minuten. WPML und Polylang werden automatisch erkannt; kompatibel mit WP Rocket und LiteSpeed Cache. Live-Demo: woocommerce.findalo.io/shop.
- 1 · Plugin installieren
In Ihrem WordPress: Plugins → Installieren, nach „Findalo“ suchen, Jetzt installieren und dann Aktivieren. Alternativ laden Sie das ZIP aus Ihrem Panel (Integration → Tab WooCommerce) oder von WordPress.org herunter und laden es über Plugin hochladen hoch. Nach der Aktivierung öffnet sich ein kurzer Assistent; Sie müssen ihn nicht abschließen: Die Verbindung in Schritt 2 erledigt alles. Noch kein Konto? Kostenlos registrieren — oder legen Sie es während der Verbindung an.
- 2 · Verbindung herstellen
Im Seitenmenü WooCommerce → Findalo (①), Tab General, Karte Connection: Klicken Sie auf Connect with Findalo (②). panel.findalo.io öffnet sich: Melden Sie sich mit Ihrem Findalo-Konto an (oder legen Sie es direkt dort an), wählen Sie die Suche und klicken Sie auf Diesen Shop verbinden. Sie kehren bereits verbunden ins Plugin zurück; Tokens sehen oder kopieren Sie nie.
- 3 · Prüfen, ob alles ankommt
In der Karte Connection sehen Sie ✓ Connected · ihre-suche und die Schaltfläche Verify connection, um die Verbindung jederzeit zu prüfen. Das Plugin veröffentlicht den Katalog von selbst und hält ihn bei jeder Produkt-, Preis- oder Bestandsänderung aktuell; in Ihrem Panel → Synchronisierung erscheinen die Produkte innerhalb weniger Minuten. Übertragung erzwingen: Tab Status im Plugin → Mark as pending (force next rebuild) oder Jetzt synchronisieren im Panel. Öffnen Sie Ihren Shop und klicken Sie auf die Lupe.
Wenn Sie die Schaltfläche nicht nutzen können
Öffnet sich das Panel-Fenster nicht oder bricht der Rückweg ins Plugin ab (Pop-up-Blocker, vom Hosting unterbrochene Weiterleitung), verbinden Sie von Hand: Kopieren Sie in Ihrem Panel → Integration → Tab WooCommerce die ID der Suche und das Synchronisierungs-Token; klappen Sie im Plugin Connection not working? Connect manually auf, fügen Sie beide Werte ein und klicken Sie auf Save manual connection. Das Ergebnis ist dasselbe wie mit der Schaltfläche.
Shopify — wesentliche Schritte
Öffentliche Shopify-App. ~5 Minuten. Nichts auf einem Server zu installieren, keine Tokens, kein Code: Sie verbinden den Shop mit einem Klick aus Ihrem Findalo-Panel.
- 1 · Shop verbinden
Melden Sie sich in Ihrem Kundenkonto an (oder registrieren Sie sich kostenlos) → Integration → Tab Shopify. Geben Sie die Domain Ihres Shops ein (
ihr-shop.myshopify.com) und klicken Sie auf Mit Shopify verbinden. - 2 · App in Shopify autorisieren
Der Admin Ihres Shops öffnet sich und Shopify zeigt die Berechtigungen der App (Katalog und Bestand, Kaufereignisse für die Analytik sowie Shop-Seiten für den Assistenten): Bestätigen Sie mit Installieren. Sie kehren mit verbundenem Shop ins Panel zurück und der Katalog wird automatisch über die Shopify-API synchronisiert. Ab dann finden Sie Findalo auch unter Apps → Findalo, direkt im Shopify-Admin und bereits angemeldet.
- 3 · Suche im Theme aktivieren
Onlineshop → Themes → Anpassen → App-Einbettungen (die Schaltfläche Theme-Editor öffnen im Panel führt direkt dorthin), Findalo aktivieren und speichern. Klicken Sie im Shop auf die Lupe: Die Suche öffnet sich mit Ihren Produkten. Produkt-, Preis- und Bestandsänderungen kommen von selbst an; Synchronisierung erzwingen: Panel → Synchronisierung → Jetzt synchronisieren.
Wenn etwas nicht passt
Die App nutzt weder Tokens noch Verbindungscodes. Erscheint die Suche nicht im Shop, prüfen Sie, ob die Einbettung Findalo im Theme aktiv ist und die App unter Apps weiterhin installiert ist. Beim Deinstallieren der App wird der Shop automatisch getrennt.
Magento — wesentliche Schritte
Natives Modul für Magento 2.4 und Adobe Commerce, veröffentlicht im Adobe Commerce Marketplace. ~10 Minuten. PHP 8.2 – 8.5. Kompatibel mit Hyvä und Headless-Storefronts.
- 1 · Modul installieren
Aus dem Adobe Commerce Marketplace per Composer (die Schlüssel für repo.magento.com finden Sie in Ihrem Adobe-Konto):
composer require findalo/magento-search bin/magento module:enable Findalo_Search bin/magento setup:upgrade bin/magento cache:flushIn Produktion ergänzen Sie
bin/magento setup:di:compileundbin/magento setup:static-content:deploy, falls Ihre Pipeline es verlangt. Ohne Composer: Laden Sie das ZIP aus Ihrem Panel (Integration → Tab Magento) herunter und entpacken Sie es nachapp/code/Findalo/Search— einer der beiden Wege, nie beide zugleich. - 2 · Verbindung herstellen
Im Magento-Admin, Seitenmenü Findalo → Configuration (①). Klicken Sie im Tab Configuration auf Connect with findalo (②). panel.findalo.io öffnet sich: Melden Sie sich mit Ihrem Findalo-Konto an (oder legen Sie es direkt dort an), wählen Sie die Suche und klicken Sie auf Diesen Shop verbinden. Sie kehren bereits verbunden ins Modul zurück: Die Zugangsdaten gehen von Server zu Server — Sie sehen und kopieren sie nie.
- 3 · Prüfen, ob alles ankommt
Neben der Schaltfläche steht ✓ Connected · ihre-suche. Das Modul überträgt den Katalog von selbst (bei Multi-Store jede Store-View getrennt) und hält ihn aktuell; in Ihrem Panel → Synchronisierung erscheinen die Produkte innerhalb weniger Minuten. Übertragung erzwingen: Tab Status → Mark as pending (force next rebuild) oder Jetzt synchronisieren im Panel. Erscheint das Widget nicht im Shop, leeren Sie die Caches:
bin/magento cache:flush.
Wenn Sie die Schaltfläche nicht nutzen können
Öffnet sich das Panel-Fenster nicht oder bricht der Rückweg ins Modul ab (Pop-up-Blocker, vom Hosting unterbrochene Weiterleitung), verbinden Sie von Hand: Kopieren Sie in Ihrem Panel → Integration → Tab Magento die ID der Suche und das Synchronisierungs-Token; klappen Sie im Modul Connection not working? Connect manually auf, fügen Sie beide Werte in ihre Felder ein und klicken Sie auf Save. Das Ergebnis ist dasselbe wie mit der Schaltfläche.
Shopware — wesentliche Schritte
Native Shopware-App (ohne PHP) für 6.6 und 6.7. ~10 Minuten. Der Shop wird direkt im Admin mit einem Code per E-Mail mit Ihrem Findalo-Konto verknüpft: keine Tokens.
- 1 · App installieren
Melden Sie sich in Ihrem Kundenkonto an (oder registrieren Sie sich kostenlos) → Integration → Tab Shopware → ZIP herunterladen. In Ihrem Shopware-Admin: Erweiterungen → Meine Erweiterungen → Erweiterung hochladen, installieren und aktivieren, Berechtigungen bestätigen (Lesen von Katalog und Konfiguration). Per CLI:
bin/console app:install --activate FindaloSearch bin/console cache:clearBei der Aktivierung registriert sich die App automatisch bei Findalo. Voraussetzung: Der Shop muss per HTTPS aus dem Internet erreichbar sein (Findalo liest den Katalog über die Admin API).
- 2 · Shop mit Ihrem Konto verknüpfen
Öffnen Sie Erweiterungen → Findalo. Geben Sie die E-Mail-Adresse Ihres Findalo-Kontos ein und klicken Sie auf Enviar código (Code senden); geben Sie den erhaltenen 6-stelligen Code ein und klicken Sie auf Verificar y vincular (prüfen und verknüpfen). Ordnen Sie in der Kanaltabelle jeden Storefront-Sales-Channel einer Suche Ihres Kontos zu (Spalte Buscador): Nur der zugeordnete Kanal wird verbunden und indexiert. Weitere Suche nötig? Legen Sie sie im Panel an und klicken Sie in der App auf ↻ Refrescar (aktualisieren).
- 3 · Prüfen, ob alles ankommt
Sie sehen Conectado a Findalo (mit Findalo verbunden) und pro Kanal Produkte und letzte Synchronisierung. Der Katalog wird über die Admin API synchronisiert, Änderungen kommen von selbst an; Re-sincronizar erzwingt eine Übertragung und Gestionar buscadores ↗ öffnet Ihr Panel. Das Widget wird automatisch in den Storefront eingebunden: Laden Sie Ihren Shop neu und klicken Sie auf die Lupe.
Wenn der Code nicht ankommt oder etwas nicht passt
Prüfen Sie den Spam-Ordner und ob die Adresse die Ihres Findalo-Kontos ist; mit Enviar código fordern Sie einen neuen Code an. Desconectar pausiert die Suchen, ohne etwas zu löschen: Sie verbinden mit einem Klick neu, ohne Neuinstallation. Lässt Ihr Shopware keinen Upload von Erweiterungen im Admin zu, nutzen Sie den CLI-Befehl aus Schritt 1.
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.