Grandoc at 08:49, 12 October 2026

2026-10-12T08:49:19Z

Grandoc at 20:35, 6 October 2026

2026-10-06T20:35:58Z

Grandoc: /* Andere Sprachen */

2026-07-10T10:11:14Z

Andere Sprachen

← Older revision		Revision as of 10:11, 10 July 2026
Line 283:		Line 283:
	==Andere Sprachen==		==Andere Sprachen==

			* [[Module_UltimateMarketPlace_FR\|Documentation en français du module UltimateMarketPlace]]
	* [[Module_UltimateMarketPlace_EN\|English documentation for the UltimateMarketPlace module]]		* [[Module_UltimateMarketPlace_EN\|English documentation for the UltimateMarketPlace module]]
			* [[Module_UltimateMarketPlace_ES\|Documentación en español del módulo UltimateMarketPlace]]
			* [[Module_UltimateMarketPlace_IT\|Documentazione in italiano del modulo UltimateMarketPlace]]

			[[fr:Module_UltimateMarketPlace_FR]]
	[[en:Module_UltimateMarketPlace_EN]]		[[en:Module_UltimateMarketPlace_EN]]
			[[es:Module_UltimateMarketPlace_ES]]
			[[it:Module_UltimateMarketPlace_IT]]

Grandoc: Created page with "Category:Modules Category:AtooNet =Modul UltimateMarketPlace= ==Übersicht== Das Modul '''UltimateMarketPlace''' ist eine Erweiterung für Dolibarr ERP/CRM, veröff..."

2026-07-10T09:59:00Z

Created page with "Category:Modules Category:AtooNet =Modul UltimateMarketPlace= ==Übersicht== Das Modul '''UltimateMarketPlace''' ist eine Erweiterung für Dolibarr ERP/CRM, veröff..."

New page

[[Category:Modules]]
[[Category:AtooNet]]

=Modul UltimateMarketPlace=

==Übersicht==

Das Modul '''UltimateMarketPlace''' ist eine Erweiterung für Dolibarr ERP/CRM, veröffentlicht von [https://www.atoo-net.com 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.

{| class="wikitable"
|-
!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 [https://www.dolistore.com DoliStore] herunterladen oder das Git-Repository nach <code>htdocs/custom/ultimatemarketplace</code> klonen
#Zu '''Home → Konfiguration → Module/Anwendungen''' gehen
#'''UltimateMarketPlace''' im Bereich '''AtooNet''' suchen
#Das Modul über die Schaltfläche in der Spalte ''Aktiviert'' aktivieren

[[File:ultimatemarketplace_activation.png|center|thumb|800px|Aktivierung des Moduls UltimateMarketPlace im Bereich AtooNet]]

Bei der Aktivierung führt das Modul automatisch mehrere Aktionen aus:

*Erstellung einer '''eigenen Website''' (Referenz <code>ultimatemarketplace</code>) 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 (<code>PriceComment</code>) und öffentlicher Warnhinweis (<code>DisclaimerMessage</code>)

==Konfiguration==

Die Konfiguration des Moduls erfolgt unter '''Home → Konfiguration → Module/Anwendungen → UltimateMarketPlace''', aufgeteilt auf mehrere Reiter.

===Allgemein: Produkte und Kunden===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_NAME</code>||Name des Marktplatzes
|-
|<code>ULTIMATEMARKETPLACE_EMAIL</code>||Kontakt-E-Mail des Marktplatzes
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID</code>||Stammkategorie der auf dem Marktplatz verkauften Produkte
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS</code>||Kategorie, die im zentralen Block der Startseite hervorgehoben wird
|-
|<code>ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID</code>||Kategorie, die vom Widget "Version" der Startseite verwendet wird
|-
|<code>ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID</code>||Kategorie, die vom Widget "Aktionen" der Startseite verwendet wird
|-
|<code>ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE</code>||Mindestpreis eines Produkts (falls dieses nicht kostenlos ist)
|-
|<code>ULTIMATEMARKETPLACE_DELAY_FOR_NEW</code>||Maximales Alter (in Tagen), damit ein Produkt im Bereich "Neuheiten" erscheint
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID</code>||Kategorie, die allen über die Shop-Website angelegten Interessenten/Kunden zugewiesen wird
|}

===Rabatte für bevorzugte Kunden===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID</code>||Kategorie der als "bevorzugt" gekennzeichneten Kunden, die für den Rabatt berechtigt sind
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT</code>||Rabattprozentsatz, der diesen Kunden gewährt wird
|-
|<code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code>||Kategorie der von diesem Rabatt ausgeschlossenen Produkte
|}

===Website===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_URL_FOR_LOGO</code>||URL des Marktplatz-Logos
|-
|<code>ULTIMATEMARKETPLACE_THEME_COLOR</code>||Hauptfarbe des Themes (Schaltflächen, Banner, hervorgehobene Elemente)
|-
|<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>||Von Dolibarr für den Marktplatz verwendete Website
|-
|<code>ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE</code>||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 (<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>), 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:

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID</code>||Hinzuzufügendes Zusatzprodukt
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT</code>||Preis des Zusatzprodukts, ausgedrückt in % der Warenkorbsumme
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES</code>||Ländercodes, für die dieses Zusatzprodukt gilt
|}

===Versandkosten===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT</code> / <code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID</code>||Dolibarr-Produkt, das zur Abrechnung der Versandkosten verwendet wird
|}

===Registrierung: Google reCAPTCHA===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM</code>||Aktiviert Google Captcha im Registrierungsformular
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY</code>||Von Google bereitgestellter öffentlicher reCAPTCHA-Schlüssel
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY</code>||Privater reCAPTCHA-Schlüssel (vertraulich zu behandeln)
|}

===Zahlung===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_BLOCK_SALES</code>||Blockiert vorübergehend die Verkäufe auf dem Marktplatz
|-
|<code>ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT</code>||Schließt die Bestellung automatisch nach erfolgreicher Zahlung ab
|-
|<code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>||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===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_PUBLIC_API_KEY</code>||Ö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 <code>categorieid</code>, <code>limit</code>, <code>page</code>, <code>search</code> und <code>lang</code>. Ein Proxy-Routing kann eingerichtet werden, um die tatsächliche API-URL hinter der Domain des Shops zu verbergen.

===Matomo===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>ULTIMATEMARKETPLACE_ENABLE_MATOMO</code>||Aktiviert Matomo Analytics auf der Marktplatz-Website
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SITE_KEY</code>||Matomo Site-ID
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SERVER_URL</code>||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

[[File:ultimatemarketplace_coupons.png|center|thumb|800px|Verwaltungsreiter für Gutscheincodes]]

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

[[File:ultimatemarketplace_home.png|center|thumb|800px|Startseite des von UltimateMarketPlace generierten Shops]]

===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 <code>module_source = ultimatemarketplace</code>).

==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 <code>ULTIMATEMARKETPLACE_WEBSITE_ID</code> 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 <code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code> 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 <code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>.

==Siehe auch==

*[https://www.atoo-net.com Atoo-Net — Modul-Herausgeber]
*[https://framagit.org/grandoc/ultimatemarketplace Modul-Repository]
*[https://wiki.dolibarr.org/index.php/Module_Website Dokumentation des Dolibarr-Website-Moduls]

==Andere Sprachen==

* [[Module_UltimateMarketPlace_EN|English documentation for the UltimateMarketPlace module]]

[[en:Module_UltimateMarketPlace_EN]]

Module UltimateMarketPlace DE - Revision history

Grandoc at 08:49, 12 October 2026

Grandoc at 20:35, 6 October 2026

Grandoc: /* Andere Sprachen */

Grandoc: Created page with "Category:Modules Category:AtooNet =Modul UltimateMarketPlace= ==Übersicht== Das Modul '''UltimateMarketPlace''' ist eine Erweiterung für Dolibarr ERP/CRM, veröff..."