Module UltimateMarketPlace DE
Modul UltimateMarketPlace
Übersicht
Das Modul UltimateMarketPlace ist eine Erweiterung für Dolibarr ERP/CRM, veröffentlicht von Atoo-Net.
Es stellt alle Funktionen bereit, um einen Online-Marktplatz mit einem einzigen Verkäufer zu betreiben: eine einsatzbereite Website-Vorlage (Produktkatalog, Warenkorb, Bestellstrecke, Kundenkonten), nutzbar mit dem Website-Modul von Dolibarr, um Ihre eigenen Produkte und Dienstleistungen direkt online zu verkaufen.
Es handelt sich um einen vereinfachten Fork des Dolibarr-Moduls „Marketplace" (verwendet für dolistore.com), aus dem alles entfernt wurde, was spezifisch für die Dolibarr-Vereinigung ist, sowie der Multi-Verkäufer-Ablauf mit Einreichung und Prüfung von Modulen durch Drittentwickler.
| Eigenschaft | Wert |
|---|---|
| Autor | Philippe Grand — Atoo-Net |
| Version | 1.0 |
| Lizenz | GNU GPL v3+ |
| Dolibarr minimum | v24.0 |
| PHP minimum | v8.0 |
Warum UltimateMarketPlace verwenden?
UltimateMarketPlace verwandelt Ihre Dolibarr-Installation in einen eigenständigen Online-Shop, ohne von einem CMS oder einer Drittanbieter-E-Commerce-Plattform (wie PrestaShop, WooCommerce …) abhängig zu sein. Katalog, Bestellungen, Rechnungen und Kunden bleiben nativ in Dolibarr.
Anwendungsfälle
Verkauf physischer oder dematerialisierter Produkte
Veröffentlichen Sie Ihren Produkt- oder Dienstleistungskatalog direkt aus den Dolibarr-Produktdatenblättern. Das Modul verwaltet sowohl physische Güter (mit Versandkosten) als auch dematerialisierte Artikel (Downloads, Lizenzen, Dienstleistungen).
Kundenbindung für Geschäftskunden
Dank automatischer Rabatte für „bevorzugte Kunden" (dedizierte Drittkategorie) bieten Sie Ihren besten Kunden einen ausgehandelten Vorzugspreis, mit der Möglichkeit, bestimmte Produkte vom Rabatt auszuschließen.
Verkaufsaktionen und Gutscheincodes
Erstellen Sie Rabattcodes (Prozentsatz oder Festbetrag), zeitlich oder in der Anzahl der Verwendungen begrenzt, gegebenenfalls auf ein bestimmtes Produkt beschränkt, um Ihre Online-Verkäufe zu beleben.
Zusatzverkauf (Upselling) im Warenkorb
Bieten Sie automatisch ein ergänzendes Produkt im Warenkorb an (z. B. Versicherung, Garantie, Umweltabgabe), berechnet als Prozentsatz der Gesamtsumme und auf ausgewählte Länder beschränkt.
Online-Zahlung
Verbinden Sie die Bestellstrecke mit den bereits in Dolibarr konfigurierten Zahlungsarten (Stripe, PayPal, Überweisung …), entweder über eine klassische Weiterleitung zu Ihrem Backoffice oder als integrierten Frame im Shop.
Besucherstatistik
Integrieren Sie Matomo Analytics, um Besucherverkehr und Kaufverhalten in Ihrem Shop zu verfolgen, ohne von Google Analytics abhängig zu sein.
Installation
Voraussetzungen: Das Modul benötigt folgende aktivierte Dolibarr-Module (sie werden bei Bedarf automatisch aktiviert): Kunden/Lieferanten, Produkte, Dienstleistungen, Kategorien, Bestellungen, Rechnungen, Bank, Mailing und Website.
- Das Modul von DoliStore herunterladen oder das Git-Repository nach
htdocs/custom/ultimatemarketplaceklonen - Zu Home → Konfiguration → Module/Anwendungen gehen
- UltimateMarketPlace im Bereich AtooNet suchen
- Das Modul über die Schaltfläche in der Spalte Aktiviert aktivieren
Bei der Aktivierung führt das Modul automatisch mehrere Aktionen aus:
- Erstellung einer eigenen Website (Referenz
ultimatemarketplace) mit der importierten Website-Vorlage "website_template-ultimatemarketplace" - Erstellung einer Produkt-Stammkategorie für die auf dem Marktplatz sichtbaren Artikel
- Erstellung einer Kundenkategorie für Kunden/Interessenten, die über die Shop-Website angelegt werden
- Hinzufügen von 3 Produkt-Zusatzfeldern: Trenner "Marketplace", Kommentar nach dem Preis (
PriceComment) und öffentlicher Warnhinweis (DisclaimerMessage)
Konfiguration
Die Konfiguration des Moduls erfolgt unter Home → Konfiguration → Module/Anwendungen → UltimateMarketPlace, aufgeteilt auf mehrere Reiter.
Allgemein: Produkte und Kunden
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_NAME |
Name des Marktplatzes |
ULTIMATEMARKETPLACE_EMAIL |
Kontakt-E-Mail des Marktplatzes |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID |
Stammkategorie der auf dem Marktplatz verkauften Produkte |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS |
Kategorie, die im zentralen Block der Startseite hervorgehoben wird |
ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID |
Kategorie, die vom Widget "Version" der Startseite verwendet wird |
ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID |
Kategorie, die vom Widget "Aktionen" der Startseite verwendet wird |
ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE |
Mindestpreis eines Produkts (falls dieses nicht kostenlos ist) |
ULTIMATEMARKETPLACE_DELAY_FOR_NEW |
Maximales Alter (in Tagen), damit ein Produkt im Bereich "Neuheiten" erscheint |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID |
Kategorie, die allen über die Shop-Website angelegten Interessenten/Kunden zugewiesen wird |
Rabatte für bevorzugte Kunden
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID |
Kategorie der als "bevorzugt" gekennzeichneten Kunden, die für den Rabatt berechtigt sind |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT |
Rabattprozentsatz, der diesen Kunden gewährt wird |
ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID |
Kategorie der von diesem Rabatt ausgeschlossenen Produkte |
Website
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_URL_FOR_LOGO |
URL des Marktplatz-Logos |
ULTIMATEMARKETPLACE_THEME_COLOR |
Hauptfarbe des Themes (Schaltflächen, Banner, hervorgehobene Elemente) |
ULTIMATEMARKETPLACE_WEBSITE_ID |
Von Dolibarr für den Marktplatz verwendete Website |
ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE |
Technischer Benutzer, der berechtigt ist, die Aktionen der Website auszuführen (Produkte hinzufügen, Kunden verwalten, Bestellungen anlegen) |
Wichtig: Wenn Sie die zugeordnete Website ändern (ULTIMATEMARKETPLACE_WEBSITE_ID), bleiben bereits angelegte Benutzer, Kunden und Bestellungen mit der alten Website verknüpft und werden nicht automatisch migriert.
E-Mail-Vorlagen
Drei Dolibarr-E-Mail-Vorlagen können angepasst werden:
- Willkommens-E-Mail, die bei der Erstellung des Kundenkontos gesendet wird
- "Passwort vergessen"-E-Mail
- Bestellbestätigungs-E-Mail, die an den Käufer gesendet wird
Zusatzprodukt im Warenkorb
Ermöglicht das automatische Hinzufügen eines ergänzenden Produkts (Versicherung, Garantie, Umweltabgabe …) zum Warenkorb:
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID |
Hinzuzufügendes Zusatzprodukt |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT |
Preis des Zusatzprodukts, ausgedrückt in % der Warenkorbsumme |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES |
Ländercodes, für die dieses Zusatzprodukt gilt |
Versandkosten
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT / ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID |
Dolibarr-Produkt, das zur Abrechnung der Versandkosten verwendet wird |
Registrierung: Google reCAPTCHA
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM |
Aktiviert Google Captcha im Registrierungsformular |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY |
Von Google bereitgestellter öffentlicher reCAPTCHA-Schlüssel |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY |
Privater reCAPTCHA-Schlüssel (vertraulich zu behandeln) |
Zahlung
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_BLOCK_SALES |
Blockiert vorübergehend die Verkäufe auf dem Marktplatz |
ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT |
Schließt die Bestellung automatisch nach erfolgreicher Zahlung ab |
ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD |
Zu verwendende Zahlungsart |
Es gibt zwei mögliche Arten der Zahlungsintegration:
- Separate Seite (Standard): keine besondere Konfiguration nötig, der Kunde wird zu den öffentlichen Zahlungsseiten Ihres Dolibarr-Backoffice weitergeleitet. Nachteil: Die Domain des Backoffice ist für den Kunden sichtbar.
- Frame (für fortgeschrittene Benutzer): Die Zahlungsseite des Backoffice wird über eine URL des Marktplatz-Shops selbst aufgerufen. Erfordert eine Proxy-Konfiguration auf dem Webserver des Marktplatzes, um Anfragen an das Dolibarr-Backoffice weiterzuleiten. Vorteil: Die Domain des Backoffice bleibt verborgen.
API
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_PUBLIC_API_KEY |
Öffentlicher Schlüssel für den Zugriff auf die Produkt-/Kategorien-API |
Die API liefert einen XML-Feed der Produkte und Kategorien, mit den Parametern categorieid, limit, page, search und lang. Ein Proxy-Routing kann eingerichtet werden, um die tatsächliche API-URL hinter der Domain des Shops zu verbergen.
Matomo
| Konstante | Beschreibung |
|---|---|
ULTIMATEMARKETPLACE_ENABLE_MATOMO |
Aktiviert Matomo Analytics auf der Marktplatz-Website |
ULTIMATEMARKETPLACE_MATOMO_SITE_KEY |
Matomo Site-ID |
ULTIMATEMARKETPLACE_MATOMO_SERVER_URL |
Vollständige URL des Matomo-Servers |
Gutscheincodes (Coupons)
Ein eigener Reiter Gutscheincodes ermöglicht das Erstellen von Rabattcodes:
- Rabattart: Prozentsatz oder fester Nettobetrag
- Maximale Anzahl von Verwendungen (leer lassen für unbegrenzte Nutzung)
- Mögliche Beschränkung auf ein bestimmtes Produkt
- Verfolgung der bereits erfolgten Verwendungen
Der Code wird bei seiner Anwendung im Warenkorb geprüft: Ein nicht vorhandener, abgelaufener oder bereits vollständig verwendeter Code wird abgelehnt (Meldung "Dieser Gutscheincode ist ungültig, abgelaufen oder bereits verwendet").
Verwendung
Online-Shop (Frontend)
Die vom Modul generierte Website übernimmt das in der Konfiguration festgelegte Erscheinungsbild (Logo, Hauptfarbe) und bietet:
- Einen nach Kategorien gegliederten Produktkatalog, mit Hervorhebung von Neuheiten und Aktionen
- Ein Produktdatenblatt mit Preis, freiem Kommentar nach dem Preis und öffentlichem Warnhinweis, sofern konfiguriert
- Einen Warenkorb mit Anwendung von Gutscheincodes, automatischer Berechnung der Rabatte für "bevorzugte Kunden" und Hinzufügen des eventuellen Zusatzprodukts
- Eine mit den in Dolibarr konfigurierten Zahlungsarten verbundene Bestellstrecke
- Einen Kundenbereich (Registrierung, Anmeldung, Bestellhistorie), geschützt durch Google reCAPTCHA, sofern aktiviert
Verwaltung der Produkt-Tags
Das Menü UltimateMarketPlace → Produkte ohne Tags listet die Produkte/Dienstleistungen des Marktplatzes auf, die noch keiner Kategorie/keinem Tag zugeordnet wurden, um ihnen im Batch einen oder mehrere Tags (Kategorien) zuzuweisen.
Statistiken
Das Modul fügt dem Marktplatz gewidmete Statistikseiten hinzu:
- Statistiken zu Rechnungen und Verkäufen (Gruppierung nach Land/MwSt.-Satz oder nach Zone/MwSt.-Satz)
- Kunden-Statistiken (zuletzt angelegte Kunden, zuletzt angelegte "bevorzugte" Kunden)
- Produkt-/Dienstleistungs-Statistiken (Rangliste nach Beliebtheit)
Nachverfolgung von Bestellungen und Rechnungen
Zwei Menüeinträge ermöglichen es, schnell die vom Marktplatz stammenden Bestellungen und Rechnungen wiederzufinden (gefiltert nach module_source = ultimatemarketplace).
FAQ
Die Marktplatz-Website wurde nicht automatisch erstellt
Prüfen Sie, ob das Website-Modul von Dolibarr aktiviert ist. Existiert die Website nach der Aktivierung des Moduls immer noch nicht, deaktivieren und reaktivieren Sie UltimateMarketPlace.
Wie ändere ich die verwendete Website, ohne die bestehenden Bestellungen zu verlieren?
Das wird nicht empfohlen: Das Ändern von ULTIMATEMARKETPLACE_WEBSITE_ID migriert bereits angelegte Benutzer, Kunden und Bestellungen nicht zur neuen Website. Sie bleiben mit der alten Website verknüpft.
Kann ich den Rabatt für "bevorzugte Kunden" auf bestimmte Produkte beschränken?
Ja, indem Sie ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID mit einer Kategorie konfigurieren, die die vom Rabatt auszuschließenden Produkte zusammenfasst.
Ist die Zahlung per Frame verpflichtend?
Nein, das ist eine Option für fortgeschrittene Benutzer. Standardmäßig leitet die Zahlung einfach zu den öffentlichen Zahlungsseiten Ihres Dolibarr-Backoffice weiter, ohne besondere Serverkonfiguration.
Welche Zahlungsmittel werden unterstützt?
Alle bereits nativ von Dolibarr unterstützten Zahlungsarten (Stripe, PayPal, Überweisung usw.), ausgewählt über ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD.