DataFirefly Dealer Locator: Katalogmodus und Händlerkarte

Dieses Modul macht einen PrestaShop-8- oder -9-Shop zum Markenschaufenster: Es deaktiviert den Online-Verkauf für den ganzen Katalog oder einen Teil davon, fügt auf den Produktseiten einen Wo-kaufen-Button hinzu und veröffentlicht ein Händlerverzeichnis mit Karte, Öffnungszeiten, Kontaktformular und einer Seite pro Händler.

Installation

1. Klicken Sie unter Module > Modul-Manager auf Modul hochladen und wählen Sie die ZIP-Datei.
2. Das Modul legt das Menü Verkauf > Händlernetz mit drei Einträgen an: Händler, Kontaktanfragen und Einstellungen.
3. Die Verzeichnisseite wird automatisch mit einer pro Sprache übersetzten URL angelegt: /wo-kaufen, /where-to-buy, /ou-acheter, /donde-comprar usw.

Für ein Update laden Sie einfach die neue ZIP-Datei hoch: Die Upgrade-Skripte ergänzen fehlende Spalten und Hooks. Liefern das Verzeichnis oder die Händlerseiten einen 404-Fehler, speichern Sie einmal Shop-Parameter > Traffic & SEO, um die .htaccess neu zu erzeugen.

Kompatibilität: PrestaShop 8.0 bis 9.x, Multishop, keine Composer-Abhängigkeit. Übersetzungen auf Englisch, Französisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch enthalten.

Katalogmodus einrichten

Öffnen Sie Händlernetz > Einstellungen, Block Katalogmodus. Der Katalogmodus wird zur Laufzeit angewendet: Die native PrestaShop-Einstellung wird nie geändert, und nach dem Deaktivieren des Moduls ist alles wieder normal.

Online-Verkauf

• Aktiviert: Der Katalogmodus ist aus, das Modul dient nur als Verzeichnis.
• Deaktiviert für den gesamten Katalog: Kein Produkt kann mehr in den Warenkorb gelegt werden.
• Nur für die Auswahl deaktiviert: Nur die unten gewählten Kategorien, Marken und Produkte wechseln in den Katalogmodus.
• Für alles außer der Auswahl deaktiviert: Die Auswahl wird weiter online verkauft, der Rest wechselt in den Katalogmodus.

Preise, Hinweis und Warenkorb

• Preise ausblenden: Wenn deaktiviert, bleiben die Preise sichtbar. Sie können dann einen Hinweis unter dem Preis anzeigen, standardmäßig Unverbindliche Preisempfehlung.
• Hinweis auf der Produktseite: Text über dem Button, zum Beispiel Dieses Produkt ist ausschließlich bei unseren autorisierten Fachhändlern erhältlich. Leer lassen, um ihn auszublenden.
• Warenkorb und Bestellung zum Händlerverzeichnis umleiten: Im vollständigen Katalogmodus leiten Warenkorb- und Bestellseite zum Verzeichnis um.

Der Warenkorb wird serverseitig gesperrt: Ein über eine URL erzwungenes Hinzufügen wird abgelehnt.

Ausgenommene Kundengruppen

Haken Sie die Gruppen an, die weiterhin online bestellen dürfen. Beispiel: eine Kundengruppe Händler, die ihre Ware im Shop bestellt, während die Öffentlichkeit nur den Katalog sieht.

Der Wo-kaufen-Button

Block Wo-kaufen-Button der Einstellungen:

• Betroffene Produkte: nur Produkte, die nicht online gekauft werden können, oder alle Produkte.
• Button-Text, übersetzbar.
• Beim Klick: ein Fenster mit Karte und Händlern des Produkts öffnen oder zum nach dem Produkt gefilterten Verzeichnis wechseln.
• Verfügbarkeit unter dem Button anzeigen: Erhältlich bei 14 Händlern, danach der nächste Händler, sobald der Besucher bereits einen Ort gesucht hat.
• Online-Händler auflisten: Händler vom Typ Online-Händler erscheinen separat, mit einem Button zum Produkt in ihrem Shop.

Der Button zeigt nur Händler, die das Produkt führen (Reiter Verkaufte Produkte des Händlers). Das Fenster öffnet sich mit dem zuletzt gesuchten Ort des Besuchers.

Verzeichnis und Karte

Block Händlerverzeichnis und Karte:

• Einleitungstext über der Suche und Akzentfarbe für Buttons, Markierungen und Cluster.
• Standard-Kartenmitte und Zoom, Entfernungseinheit (km oder Meilen), Auswahl der Suchradien, Standard-Umkreis (0 = keine Grenze) und maximale Anzahl an Ergebnissen.
• Kartenstil: CARTO Voyager, CARTO Positron, OpenStreetMap oder eigener Kachelserver (https-URL mit {z}, {x} und {y}).
• Vor dem Laden der Karte fragen: Für die DSGVO erhält der Kachelserver die IP-Adresse des Besuchers erst nach einem Klick.
• Nahe Markierungen gruppieren und eine Markierungsfarbe pro Händlertyp, mit Legende auf der Karte.
• Vollständige Händlerliste nach Ländern unter der Karte, für Suchmaschinen lesbar.
• Eine Seite pro Händler: siehe unten.

Besucher suchen nach Ort oder PLZ oder nutzen ihren Standort. Sie können nach Händlertyp filtern und Jetzt geöffnet anhaken. Auf dem Smartphone wechselt ein Button zwischen Liste und Karte. Die Leaflet-Karte ist im Modul gehostet: Es ist kein API-Schlüssel nötig.

Geokodierung

Die Geokodierung wandelt eine Adresse oder einen Ort in Koordinaten um. Die Ergebnisse werden in der Datenbank zwischengespeichert.

• OpenStreetMap Nominatim: kostenlos, auf eine Anfrage pro Sekunde begrenzt. Tragen Sie die Kontakt-E-Mail ein, die von den Nutzungsrichtlinien von Nominatim empfohlen wird.
• Google Geocoding API: erfordert einen Google-API-Schlüssel.
• Suche auf diese Länder beschränken: ISO-Codes durch Kommas getrennt, zum Beispiel de,at,ch.

Händler verwalten

Menü Händlernetz > Händler. Das Händlerformular hat vier Reiter.

Allgemein

• Name, Typ (Fachhändler, Großhändler, Showroom, Servicecenter, Online-Händler), Logo (JPG, PNG, WebP oder GIF, maximal 2 MB).
• Partner: Abzeichen Offizieller Partner, steht oben, wenn kein Standort angegeben ist.
• Telefon, Website und E-Mail: Die E-Mail erhält die Kontaktanfragen und wird bei aktivem Kontaktformular nie angezeigt.
• Produktlink im Shop des Händlers: optional, fügt einen Button Online kaufen hinzu. Verfügbare Platzhalter: {reference} {ean13} {upc} {mpn} {name} {id_product}. Beispiel: https://shop.example.com/search?q={ean13}
• Zugang zum Händlerbereich: E-Mail eines bestehenden Kundenkontos (siehe Händlerbereich).

Adresse und Karte

Der Händler wird beim Speichern automatisch auf der Karte platziert. Der Button Position aus der Adresse ermitteln startet die Geokodierung erneut, und Sie können auf die Karte klicken oder die Markierung verschieben, um die Position anzupassen.

Beschreibung und Öffnungszeiten

Mehrsprachige Beschreibung, Öffnungszeiten-Raster über 7 Tage mit zwei Zeitfenstern pro Tag (das zweite für die Mittagspause), Buttons zum Kopieren des Montags auf die anderen Tage und Feld Gut zu wissen für Feiertage oder saisonale Schließungen. Ein leerer Tag bedeutet geschlossen. Die Öffnungszeiten steuern das Abzeichen und den Filter Jetzt geöffnet, berechnet in der Zeitzone des Shops.

Verkaufte Produkte

Wählen Sie Das gesamte Sortiment oder eine Auswahl von Kategorien, Marken und Produkten. Nur Händler, die ein Produkt führen, erscheinen in dessen Wo-kaufen-Button.

CSV-Import und -Export

Button CSV importieren der Händlerliste. Format: UTF-8, Semikolon als Trennzeichen, erste Zeile mit den Spaltennamen. Am einfachsten exportieren Sie zuerst Ihre Händler, um eine fertige Datei zu erhalten.

Spalten: id;name;type;active;featured;address1;address2;postcode;city;country_iso;phone;email;website;product_url;latitude;longitude;scope;categories;manufacturers;products;description;hours;opening

• Nur name ist Pflicht. Lassen Sie id leer, um einen Händler anzulegen, oder haken Sie die Aktualisierung bestehender Händler an.
• type: retailer, distributor, showroom, service oder online. country_iso: zweistelliger Code.
• scope: 0 für das gesamte Sortiment, 1 für die aufgeführten Kategorien, Marken und Produkte, getrennt durch einen senkrechten Strich: 3|8|12.
• opening: Nummer des Tages (1 = Montag), dann Zeitfenster, Tage durch einen Schrägstrich getrennt: 1=09:00-12:00,14:00-19:00/2=09:00-19:00/6=10:00-18:00

Klicken Sie nach einem Import ohne Koordinaten auf Importierte Händler auf der Karte platzieren: Die Geokodierung läuft im Stapel, eine Adresse pro Sekunde. Lassen Sie die Seite während des Vorgangs geöffnet.

Kontaktanfragen

Block Kontaktanfragen der Einstellungen: Aktivieren Sie das Formular bei jedem Händler, den E-Mail-Versand an den Händler, eine Kopie an Ihre Adresse, den Text der Einwilligungs-Checkbox und die Seite der Datenschutzerklärung.

Das Formular ist gegen Spam geschützt (Fallenfeld, Mindestdauer, fünf Sendungen pro Stunde und IP-Adresse). Die Anfragen stehen unter Händlernetz > Kontaktanfragen, mit Filtern, Detailansicht, Status bearbeitet oder offen und CSV-Export.

Händlerbereich

Aktivieren Sie Händlerbereich im Kundenkonto und tragen Sie im Händlerformular die E-Mail eines bestehenden Kundenkontos ein. Nach der Anmeldung sieht dieser Kunde unter Mein Konto die Kachel Händlerbereich. Dort kann er:

• Telefon, Website, Öffnungszeiten, Gut zu wissen und Beschreibung in seiner Sprache ändern;
• seine Kontaktanfragen lesen und als bearbeitet markieren;
• seine Statistiken der letzten 30 Tage sehen: Website-Besuche, Klicks auf die Telefonnummer, Routen, Anfragen.

Adresse und Kartenposition verwaltet weiterhin die Marke. Ein Konto kann mehrere Händler verwalten.

Händlerseiten und SEO

Mit der Option Eine Seite pro Händler erhält jeder Händler (außer Online-Händlern) eine Seite wie /wo-kaufen/12/lumiere-co-lyon: Adresse, Karte, Öffnungszeiten, Beschreibung, Kontaktformular und Händler in der Nähe. Die Seiten enthalten strukturierte Daten Store mit schema.org-Öffnungszeiten und eine kanonische URL und leiten per 301 weiter, wenn sich Name oder Ort ändern. Sie werden automatisch in die Sitemap aufgenommen, wenn das Google-Sitemap-Modul (gsitemap) installiert ist.

Statistiken

Die Konfigurationsseite zeigt die Aktivität der letzten 30 Tage: meistkontaktierte Händler mit den Klicks im Detail (Website, Telefon, Route, Online-Kauf, Anfragen) und Produkte mit den meisten Wo-kaufen-Klicks.

Theme-Integration

Der Button wird automatisch über den Hook displayProductAdditionalInfo angezeigt. Um ihn an anderer Stelle zu platzieren, nutzen Sie das Widget:

• Händlersuchfeld: {widget name='dfdealerlocator'}
• Wo-kaufen-Button eines Produkts: {widget name='dfdealerlocator' id_product=$product.id}

Fehlerbehebung

Die Karte bleibt grau

Der Kachelserver wird vermutlich durch eine Sicherheitsrichtlinie (CSP) oder eine Firewall blockiert. Erlauben Sie die Domain des gewählten Stils (basemaps.cartocdn.com oder tile.openstreetmap.org) oder nutzen Sie einen eigenen Server.

Der Wo-kaufen-Button erscheint nicht

Prüfen Sie, ob Ihr Theme den Hook displayProductAdditionalInfo auf der Produktseite aufruft und ob die Einstellung Betroffene Produkte zum getesteten Produkt passt. Andernfalls fügen Sie das Widget in das Produkt-Template ein.

Eine Adresse wird nicht gefunden

Geben Sie mindestens Ort oder PLZ und Land an und klicken Sie auf Position aus der Adresse ermitteln. Wird die Adresse weiterhin nicht gefunden, setzen Sie die Markierung von Hand auf die Karte.

404-Fehler im Verzeichnis oder auf einer Händlerseite

Erzeugen Sie die .htaccess neu, indem Sie Traffic & SEO speichern, und prüfen Sie, ob die einfache URL der Seite module-dfdealerlocator-directory in jeder Sprache ausgefüllt ist.