Module UltimateMarketPlace DE: Difference between revisions

Jump to navigation Jump to search

Module UltimateMarketPlace DE (view source)

Revision as of 08:49, 12 October 2026

3,747 bytes added ,  10 days ago
no edit summary
VisualWikitext
No edit summary
Tag: 2017 source edit
No edit summary
Tag: 2017 source edit
 
Line 4: Line 4:
{{TemplateDocUtil}}
{{TemplateDocUtil}}


=UltimateMarketPlace module=
=Modul UltimateMarketPlace=


==Overview==
==Überblick==


The '''UltimateMarketPlace''' module is an extension for Dolibarr ERP/CRM published by [https://www.atoo-net.com Atoo-Net].
Das Modul '''UltimateMarketPlace''' ist eine Erweiterung für Dolibarr ERP/CRM, herausgegeben von [https://www.atoo-net.com Atoo-Net].


It provides everything needed to publish a '''single-vendor online marketplace''': a ready-to-use website template (product catalogue, cart, checkout, customer accounts, download area), used with the Dolibarr Website module, to sell your own products and services directly online.
Es bietet alles, was zur Veröffentlichung eines '''Online-Marktplatzes mit einem einzigen Verkäufer''' nötig ist: eine sofort einsetzbare Website-Vorlage (Produktkatalog, Warenkorb, Bestellvorgang, Kundenkonten, Download-Bereich), die mit dem Dolibarr-Modul Website genutzt wird, um Ihre eigenen Produkte und Dienstleistungen direkt online zu verkaufen.


It is a simplified fork of the Dolibarr "Marketplace" module (used for dolistore.com), from which everything specific to the Dolibarr association, as well as the multi-vendor circuit / module submission and review by third-party developers, has been removed.
Es handelt sich um einen vereinfachten Fork des Dolibarr-Moduls „Marketplace“ (für dolistore.com verwendet), aus dem alles Spezifische des Dolibarr-Vereins sowie der Ablauf für mehrere Verkäufer / Einreichung und Prüfung von Modulen durch Drittentwickler entfernt wurde.


{| class="wikitable"
{| class="wikitable"
|-
|-
!Property!!Value
!Eigenschaft!!Wert
|-
|-
|Author||Philippe Grand — Atoo-Net
|Autor||Philippe Grand — Atoo-Net
|-
|-
|Version||24.0.0
|Version||24.0.1
|-
|-
|License||GNU GPL v3+
|Lizenz||GNU GPL v3+
|-
|-
|Minimum Dolibarr||v24.0
|Dolibarr mindestens||v24.0
|-
|-
|Minimum PHP||v8.2
|PHP mindestens||v8.2
|}
|}


==Why use UltimateMarketPlace?==
==Warum UltimateMarketPlace verwenden?==


UltimateMarketPlace turns your Dolibarr installation into a standalone online shop, without relying on a CMS or a third-party e-commerce platform (PrestaShop, WooCommerce…). Catalogue, orders, invoices and customers stay natively in Dolibarr.
UltimateMarketPlace verwandelt Ihre Dolibarr-Installation in einen eigenständigen Online-Shop, ohne auf ein CMS oder eine externe E-Commerce-Plattform (PrestaShop, WooCommerce…) angewiesen zu sein. Katalog, Bestellungen, Rechnungen und Kunden bleiben nativ in Dolibarr.


===Use cases===
===Anwendungsfälle===


====Selling physical or digital products====
====Verkauf physischer oder digitaler Produkte====
Publish your catalogue of products or services directly from the Dolibarr product cards: just place them under the root category of the shop. Files attached to the product can be delivered to the customer in their download area after payment.
Veröffentlichen Sie Ihren Produkt- oder Dienstleistungskatalog direkt aus den Dolibarr-Produktkarten: Es genügt, sie unter der Stammkategorie des Shops einzuordnen. Die an das Produkt angehängten Dateien können dem Kunden nach der Zahlung in seinem Download-Bereich bereitgestellt werden.


====Subscriptions and time-limited licences====
====Abonnements und zeitlich begrenzte Lizenzen====
With the product validity duration and the Dolibarr price levels ("Multiprices"), sell the same product with several subscription durations: download links expire automatically at the end of the purchased period.
Mit der Gültigkeitsdauer der Produkte und den Preisstufen von Dolibarr („Mehrere Preise“) verkaufen Sie dasselbe Produkt mit mehreren Abonnementlaufzeiten: Die Download-Links verfallen automatisch am Ende des gekauften Zeitraums.


====Preferential prices for your best customers====
====Vorzugspreise für Ihre besten Kunden====
'''Category discounts''' link a customer category to a product category: the discounted price is displayed automatically as soon as the customer is logged in, with no code to enter.
'''Kategorierabatte''' verknüpfen eine Kundenkategorie mit einer Produktkategorie: Der rabattierte Preis wird automatisch angezeigt, sobald der Kunde angemeldet ist, ohne dass ein Code eingegeben werden muss.


====Sales campaigns and coupon codes====
====Verkaufsaktionen und Gutscheincodes====
Create discount codes (percentage or fixed amount), limited in time or in number of uses, each one reserved for a given product, to boost your online sales.
Erstellen Sie Rabattcodes (Prozentsatz oder fester Betrag), zeitlich oder in der Anzahl der Verwendungen begrenzt, jeweils einem bestimmten Produkt vorbehalten, um Ihre Online-Verkäufe anzukurbeln.


====Online payment====
====Online-Zahlung====
Connect the checkout to the online payment modules already configured in Dolibarr (Stripe, PayPal…), either with a classic redirection to the public payment pages, or embedded in a frame of the shop.
Verbinden Sie den Bestellvorgang mit den bereits in Dolibarr konfigurierten Online-Zahlungsmodulen (Stripe, PayPal…), entweder mit klassischer Weiterleitung zu den öffentlichen Zahlungsseiten oder eingebettet in einen Frame des Shops.


====SEO and audience tracking====
====Suchmaschinenoptimierung und Besucheranalyse====
Simplified URLs, automatically generated <code>sitemap.xml</code>, <code>robots.txt</code> and <code>llms.txt</code>, Schema.org markup, Google Search Console verification and Matomo Analytics integration to track traffic without relying on Google Analytics.
Vereinfachte URLs, automatisch erzeugte <code>sitemap.xml</code>, <code>robots.txt</code> und <code>llms.txt</code>, Schema.org-Auszeichnung, Google-Search-Console-Verifizierung und Matomo-Analytics-Integration, um die Besucherzahlen ohne Google Analytics zu verfolgen.


==Installation==
==Installation==


'''Requirements''':
'''Voraussetzungen''':
*Dolibarr 24.0 or later and PHP 8.2 or later;
*Dolibarr 24.0 oder höher und PHP 8.2 oder höher;
*the shop pages contain dynamic PHP code: before enabling the module, add the line <code>$dolibarr_website_allow_custom_php = '1';</code> to <code>htdocs/conf/conf.php</code> (value <code>2</code> if the PHP system functions <code>exec</code>, <code>passthru</code>, <code>shell_exec</code>, <code>system</code>, <code>popen</code> and <code>proc_open</code> are not disabled in <code>php.ini</code>). Without this line, Dolibarr refuses to import the website template and the shop remains empty;
*die Shop-Seiten enthalten dynamischen PHP-Code: Fügen Sie vor dem Aktivieren des Moduls die Zeile <code>$dolibarr_website_allow_custom_php = '1';</code> in <code>htdocs/conf/conf.php</code> ein (Wert <code>2</code>, wenn die PHP-Systemfunktionen <code>exec</code>, <code>passthru</code>, <code>shell_exec</code>, <code>system</code>, <code>popen</code> und <code>proc_open</code> in <code>php.ini</code> nicht deaktiviert sind). Ohne diese Zeile verweigert Dolibarr den Import der Website-Vorlage und der Shop bleibt leer;
*the Dolibarr modules Third parties, Products, Services, Categories, Orders, Invoices, Banks, Emailings and Website are required: they are enabled automatically with the module.
*die Dolibarr-Module Geschäftspartner, Produkte, Leistungen, Kategorien, Aufträge, Rechnungen, Banken, E-Mail-Kampagnen und Website sind erforderlich: Sie werden mit dem Modul automatisch aktiviert.


#Download the module from [https://www.dolistore.com DoliStore] or clone the Git repository into <code>htdocs/custom/ultimatemarketplace</code>
#Laden Sie das Modul von [https://www.dolistore.com DoliStore] herunter oder klonen Sie das Git-Repository nach <code>htdocs/custom/ultimatemarketplace</code>
#Go to '''Home → Setup → Modules/Applications'''
#Gehen Sie zu '''Start → Einstellungen → Module/Anwendungen'''
#Find '''Ultimate Market Place''' in the '''Websites and other frontal application''' family
#Suchen Sie '''Ultimate Market Place''' in der Familie '''Websites und weitere Frontend-Anwendungen'''
#Enable the module by clicking the button in the ''Enabled'' column
#Aktivieren Sie das Modul über die Schaltfläche in der Spalte ''Aktiviert''


[[File:Ultimatemarketplace-v25-activation-en.png|center|thumb|800px|Enabling the UltimateMarketPlace module]]
[[File:Ultimatemarketplace-v25-activation-de.png|center|thumb|800px|Aktivierung des Moduls UltimateMarketPlace]]


When enabled, the module automatically performs several actions:
Bei der Aktivierung führt das Modul automatisch mehrere Aktionen aus:


*Enables multilingual management (<code>MAIN_MULTILANGS</code>), since product cards can be translated
*Aktivierung der Mehrsprachigkeit (<code>MAIN_MULTILANGS</code>), da die Produktkarten übersetzt werden können
*Creates a '''root product category''' and a "prospect/customer" '''third-party category''' if none is configured yet
*Anlegen einer '''Stammkategorie für Produkte''' und einer '''Geschäftspartner-Kategorie''' „Interessent/Kunde“, falls noch keine konfiguriert ist
*Registers the module's own invoice PDF template
*Registrierung der modul-eigenen PDF-Rechnungsvorlage
*Creates (or re-enables) a '''dedicated website''' into which the website template provided by the module is imported
*Anlegen (oder Reaktivieren) einer '''eigenen Website''', in die die mit dem Modul gelieferte Website-Vorlage importiert wird


'''Update''': after replacing the files, disable then enable the module again (your settings are kept). To bring the website pages in line with the new version, then use the '''Reset website template''' button (see [[#Maintenance mode and template reset|Maintenance mode]]).
'''Aktualisierung''': Deaktivieren und aktivieren Sie das Modul nach dem Ersetzen der Dateien erneut (Ihre Einstellungen bleiben erhalten). Um die Seiten der Website an die neue Version anzupassen, verwenden Sie anschließend die Schaltfläche '''Website-Template zurücksetzen''' (siehe [[#Wartungsmodus und Zurücksetzen der Vorlage|Wartungsmodus]]).


The module declares no permission of its own: the administration pages are reserved for Dolibarr administrators, and the shop pages use their own customer session.
Das Modul definiert keine eigenen Berechtigungen: Die Verwaltungsseiten sind den Dolibarr-Administratoren vorbehalten, und die Shop-Seiten verwenden ihre eigene Kundensitzung.


==Configuration==
===Domain und virtueller Host===
Der Shop muss über '''eine eigene Domain''' ausgeliefert werden (zum Beispiel <code>https://shop.example.com</code>), mithilfe eines virtuellen Hosts des Webservers (Apache, Nginx…). Die Vorschauadresse von Dolibarr, <code>…/public/website/index.php?website=…</code>, dient nur zum Testen: Ohne Domain funktioniert der Shop nicht vollständig.


The module is configured in '''Home → Setup → Modules/Applications → Ultimate Market Place''', spread over several tabs: '''Settings''', '''Setup of payments''', '''Coupon codes''', '''Category discounts''', '''Security''', '''Setup of API server''' (shown only if the REST API module is enabled), '''Matomo Analytics''', '''Carousel''', '''User guide''' and '''About'''.
*Warenkorb und Downloads rufen <code>/_service_page_ajax.php</code> und <code>/_service_download.php</code> im Stammverzeichnis der Domain auf. Ohne virtuellen Host enden diese Aufrufe mit einem 404-Fehler, und der Warenkorb wird nicht mehr aktualisiert.
*In der Vorschau gibt Dolibarr vor der Seite einen HTML-Kommentar aus. Ist <code>output_buffering</code> in PHP deaktiviert, startet die Sitzung des Käufers nicht („Sitzung abgelaufen“ bei der Anmeldung).
*<code>sitemap.xml</code> und <code>robots.txt</code> werden aus dem virtuellen Host der Website erzeugt: Ist er nicht ausgefüllt, werden sie nicht erzeugt, und die Abmeldelinks der E-Mailings verweisen auf Dolibarr statt auf den Shop.


Before opening the website to the public, go through the tabs in this order: Settings (Miscellaneous, Products, Third parties, Website and Email templates sections), Setup of payments, Security, then disable maintenance mode.
Einrichtung:
#Legen Sie einen virtuellen Host an, dessen Stammverzeichnis (<code>DocumentRoot</code>) das Verzeichnis der Website ist: <code><documents>/website/<ref></code> (<code><documents>/<Mandant>/website/<ref></code> für einen anderen als den ersten Mandanten). <code><documents></code> ist das Dokumentenverzeichnis von Dolibarr, <code><ref></code> die Referenz der bei der Aktivierung angelegten Website (standardmäßig <code>ultimatemarketplace</code>, siehe die Einstellung „Für den Marktplatz zu verwendende Website“).
#PHP muss dort aktiviert sein. Der Benutzer des Webservers muss die Dateien von Dolibarr (<code>htdocs</code>) lesen und in <code><documents>/website</code> und <code><documents>/medias</code> schreiben können; wird <code>open_basedir</code> verwendet, muss es diese Verzeichnisse enthalten. Erlauben Sie symbolische Links im Verzeichnis der Website: Ihr Ordner <code>medias</code> ist ein Link auf <code><documents>/medias</code>.
#Aktivieren Sie HTTPS für diese Domain: Die Zahlungsanbieter verlangen es.
#Öffnen Sie in Dolibarr im Menü '''Websites''' die '''Website-Eigenschaften bearbeiten''' und tragen Sie die vollständige Domain, einschließlich <code>https://</code>, in das Feld '''Name des virtuellen Hosts oder der Domain''' ein.


===Settings===
Beispiel für Apache, anzupassen (Pfade eines Debian- oder Ubuntu-Pakets):
<pre>
&lt;VirtualHost *:443&gt;
    ServerName shop.example.com
    DocumentRoot "/var/lib/dolibarr/documents/website/ultimatemarketplace"


[[File:Ultimatemarketplace-v25-setup-en.png|center|thumb|800px|Settings tab of the module setup]]
    &lt;Directory "/var/lib/dolibarr/documents/website/ultimatemarketplace"&gt;
        AllowOverride FileInfo Options
        Options -Indexes -MultiViews +FollowSymLinks -ExecCGI
        Require all granted
    &lt;/Directory&gt;
    &lt;Directory "/var/lib/dolibarr/documents/medias"&gt;
        Options -Indexes -MultiViews -FollowSymLinks -ExecCGI
        Require all granted
    &lt;/Directory&gt;


====Miscellaneous====
    SSLEngine on
    SSLCertificateFile    /etc/letsencrypt/live/shop.example.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/shop.example.com/privkey.pem
&lt;/VirtualHost&gt;
</pre>
 
==Konfiguration==
 
Das Modul wird unter '''Start → Einstellungen → Module/Anwendungen → Ultimate Market Place''' konfiguriert, verteilt auf mehrere Registerkarten: '''Einstellungen''', '''Konfiguration der Zahlungen''', '''Gutscheincodes''', '''Kategorierabatte''', '''Sicherheit''', '''Konfiguration des API-Servers''' (nur angezeigt, wenn das Modul REST-API aktiviert ist), '''Matomo Analytics''', '''Karussell''', '''Benutzerhandbuch''' und '''Über'''.
 
Gehen Sie vor dem Öffnen der Website für die Öffentlichkeit die Registerkarten in dieser Reihenfolge durch: Einstellungen (Abschnitte Verschiedenes, Produkte, Geschäftspartner, Website und E-Mail-Vorlagen), Konfiguration der Zahlungen, Sicherheit, und deaktivieren Sie dann den Wartungsmodus.
 
===Einstellungen===
 
[[File:Ultimatemarketplace-v25-setup-de.png|center|thumb|800px|Registerkarte Einstellungen der Modulkonfiguration]]
 
====Verschiedenes====


{| class="wikitable"
{| class="wikitable"
|-
|-
!Setting!!Constant!!Description
!Einstellung!!Konstante!!Beschreibung
|-
|-
|Market place name||<code>ULTIMATEMARKETPLACE_NAME</code>||Name of the shop: title of the home page, title of <code>llms.txt</code>, sender name on the PDF invoice
|Name des Marktplatzes||<code>ULTIMATEMARKETPLACE_NAME</code>||Name des Shops: Titel der Startseite, Titel der <code>llms.txt</code>, Absendername auf der PDF-Rechnung
|-
|-
|Market place description / Market place keywords||<code>ULTIMATEMARKETPLACE_DESCRIPTION</code> / <code>_KEYWORDS</code>||Meta description and keywords of the home page, translatable per language
|Beschreibung des Marktplatzes / Marktplatz-Schlüsselwörter||<code>ULTIMATEMARKETPLACE_DESCRIPTION</code> / <code>_KEYWORDS</code>||Meta-Beschreibung und Schlüsselwörter der Startseite, pro Sprache übersetzbar
|-
|-
|Market place email||<code>ULTIMATEMARKETPLACE_EMAIL</code>||Public contact email displayed on the website
|E-Mail-Adresse des Marktplatzes||<code>ULTIMATEMARKETPLACE_EMAIL</code>||Auf der Website angezeigte öffentliche Kontakt-E-Mail
|-
|-
|Maintenance mode||<code>ULTIMATEMARKETPLACE_MAINTENANCE_MODE</code>||Closes the shop to the public and blocks sales
|Wartungsmodus||<code>ULTIMATEMARKETPLACE_MAINTENANCE_MODE</code>||Schließt den Shop für die Öffentlichkeit und blockiert die Verkäufe
|-
|-
|Block new registrations||<code>ULTIMATEMARKETPLACE_BLOCK_REGISTRATION</code>||Closes the creation of new customer accounts
|Neuregistrierungen blockieren||<code>ULTIMATEMARKETPLACE_BLOCK_REGISTRATION</code>||Sperrt das Anlegen neuer Kundenkonten
|-
|-
|IP addresses allowed to bypass maintenance mode and the registration block||<code>ULTIMATEMARKETPLACE_MAINTENANCE_MODE_ALLOWED_IPS</code>||Whitelist of IP addresses (for example the office one)
|IP-Adressen, die den Wartungsmodus und die Registrierungssperre umgehen dürfen||<code>ULTIMATEMARKETPLACE_MAINTENANCE_MODE_ALLOWED_IPS</code>||Positivliste von IP-Adressen (zum Beispiel die des Büros)
|-
|-
|Sidebar cache duration||<code>ULTIMATEMARKETPLACE_SIDEBAR_CACHE_ENABLED</code> / <code>_SIDEBAR_CACHE_DURATION</code>||Sidebar cache in minutes (5 by default), with a button to clear the website cache
|Cache-Dauer der Seitenleiste||<code>ULTIMATEMARKETPLACE_SIDEBAR_CACHE_ENABLED</code> / <code>_SIDEBAR_CACHE_DURATION</code>||Cache der Seitenleiste in Minuten (standardmäßig 5), mit einer Schaltfläche zum Leeren des Website-Caches
|}
|}


====Products====
====Produkte====


{| class="wikitable"
{| class="wikitable"
|-
|-
!Setting!!Constant!!Description
!Einstellung!!Konstante!!Beschreibung
|-
|-
|Root category for products to sell on the marketplace||<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID</code>||Products/services of this category and its subcategories make up the catalogue (mandatory)
|Stammkategorie für die auf dem Marktplatz zu verkaufenden Produkte||<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID</code>||Die Produkte/Leistungen dieser Kategorie und ihrer Unterkategorien bilden den Katalog (Pflichtangabe)
|-
|-
|Category featured in the central block of the home page||<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS</code>||Optional, the root category otherwise
|Kategorie, die im zentralen Block der Startseite hervorgehoben wird||<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS</code>||Optional, sonst die Stammkategorie
|-
|-
|Category for the widget "Version"||<code>ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID</code>||Products carrying version numbers (downloadable software)
|Kategorie für das Widget „Version“||<code>ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID</code>||Produkte mit Versionsnummern (herunterladbare Software)
|-
|-
|Category for the widget "Promotions"||<code>ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID</code>||Products displayed with a promotion badge
|Kategorie für das Widget „Aktionen“||<code>ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID</code>||Produkte, die mit einem Aktions-Badge angezeigt werden
|-
|-
|Minimum product price||<code>ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE</code>||Paid products below this price are excluded from the catalogue
|Mindestpreis des Produkts||<code>ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE</code>||Kostenpflichtige Produkte unter diesem Preis werden aus dem Katalog ausgeschlossen
|-
|-
|Maximum age (in days) for a product to be visible into the "New products" section||<code>ULTIMATEMARKETPLACE_DELAY_FOR_NEW</code>||30 days by default
|Maximales Alter (in Tagen), damit ein Produkt im Bereich „Neue Produkte“ sichtbar ist||<code>ULTIMATEMARKETPLACE_DELAY_FOR_NEW</code>||Standardmäßig 30 Tage
|-
|-
|Category to force the "New product" status||<code>ULTIMATEMARKETPLACE_NEW_CATEGORY_ID</code> / <code>_NEW_CATEGORY_MAX_AGE</code>||Forces the "New" badge; a daily scheduled job removes products from it after the given delay
|Kategorie zum Erzwingen des Status „Neues Produkt“||<code>ULTIMATEMARKETPLACE_NEW_CATEGORY_ID</code> / <code>_NEW_CATEGORY_MAX_AGE</code>||Erzwingt das Badge „Neu“; ein täglicher geplanter Job entfernt die Produkte nach der angegebenen Frist daraus
|-
|-
|Enable product validity duration||<code>ULTIMATEMARKETPLACE_ENABLE_PRODUCT_VALIDITY_DURATION</code>||Validity start and end dates on order lines, which drive the expiry of downloads; durations per price level if "Multiprices" are enabled
|Gültigkeitsdauer des Produkts aktivieren||<code>ULTIMATEMARKETPLACE_ENABLE_PRODUCT_VALIDITY_DURATION</code>||Beginn- und Enddatum der Gültigkeit auf den Auftragszeilen, die den Ablauf der Downloads steuern; Laufzeiten pro Preisstufe, wenn „Mehrere Preise“ aktiviert ist
|}
|}


====Third parties====
====Geschäftspartner====


{| class="wikitable"
{| class="wikitable"
|-
|-
!Setting!!Constant!!Description
!Einstellung!!Konstante!!Beschreibung
|-
|-
|Category for all prospects or customers created from the marketplace website||<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID</code>||Category assigned to every third party created by the registration form
|Kategorie für alle Interessenten oder Kunden, die über die Marktplatz-Website erstellt wurden||<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID</code>||Kategorie, die jedem über das Registrierungsformular angelegten Geschäftspartner zugewiesen wird
|-
|-
|Enable multiple addresses||<code>ULTIMATEMARKETPLACE_ENABLE_MULTI_ADDRESS</code>||"My addresses" section of the customer account (billing and shipping addresses)
|Mehrere Adressen aktivieren||<code>ULTIMATEMARKETPLACE_ENABLE_MULTI_ADDRESS</code>||Bereich „Meine Adressen“ im Kundenkonto (Rechnungs- und Lieferadressen)
|-
|-
|Convert prospect to customer on their first payment||<code>ULTIMATEMARKETPLACE_CONVERT_PROSPECT_TO_CUSTOMER_ON_FIRST_PAYMENT</code>||The prospect becomes a customer as soon as their first invoice is paid
|Interessent bei erster Zahlung zu Kunde umwandeln||<code>ULTIMATEMARKETPLACE_CONVERT_PROSPECT_TO_CUSTOMER_ON_FIRST_PAYMENT</code>||Der Interessent wird Kunde, sobald seine erste Rechnung bezahlt ist
|}
|}


Line 149: Line 184:
{| class="wikitable"
{| class="wikitable"
|-
|-
!Setting!!Constant!!Description
!Einstellung!!Konstante!!Beschreibung
|-
|-
|URL for the logo of the marketplace||<code>ULTIMATEMARKETPLACE_URL_FOR_LOGO</code>||Logo of the website header; otherwise the company logo, then a logo provided with the module
|URL des Marktplatz-Logos||<code>ULTIMATEMARKETPLACE_URL_FOR_LOGO</code>||Logo in der Kopfzeile der Website; sonst das Firmenlogo, dann ein mit dem Modul geliefertes Logo
|-
|-
|URL of the welcome image / Hide the welcome image||<code>ULTIMATEMARKETPLACE_WELCOME_IMAGE_URL</code> / <code>_WELCOME_IMAGE_HIDE</code>||Banner of the home page
|URL des Willkommensbilds / Willkommensbild ausblenden||<code>ULTIMATEMARKETPLACE_WELCOME_IMAGE_URL</code> / <code>_WELCOME_IMAGE_HIDE</code>||Banner der Startseite
|-
|-
|Main theme color / Secondary theme color||<code>ULTIMATEMARKETPLACE_THEME_COLOR</code> / <code>_SECONDARY_COLOR</code>||Theme colors (<code>#a45931</code> and <code>#333333</code> by default)
|Haupt-Themenfarbe / Sekundäre Themenfarbe||<code>ULTIMATEMARKETPLACE_THEME_COLOR</code> / <code>_SECONDARY_COLOR</code>||Farben des Themes (standardmäßig <code>#a45931</code> und <code>#333333</code>)
|-
|-
|Enable simplified URLs||<code>ULTIMATEMARKETPLACE_FRIENDLY_URLS</code>||URLs such as <code>/en/123-product-name.html</code>
|Vereinfachte URLs aktivieren||<code>ULTIMATEMARKETPLACE_FRIENDLY_URLS</code>||URLs der Form <code>/de/123-produktname.html</code>
|-
|-
|Google Search Console verification token||<code>ULTIMATEMARKETPLACE_GOOGLE_SITE_VERIFICATION</code>||Verification meta tag
|Google Search Console Verifizierungstoken||<code>ULTIMATEMARKETPLACE_GOOGLE_SITE_VERIFICATION</code>||Meta-Tag zur Verifizierung
|-
|-
|llms.txt description||<code>ULTIMATEMARKETPLACE_LLMS_DESCRIPTION</code>||Presentation sentence of the website in <code>llms.txt</code>
|Beschreibung für llms.txt||<code>ULTIMATEMARKETPLACE_LLMS_DESCRIPTION</code>||Vorstellungssatz der Website in der <code>llms.txt</code>
|-
|-
|User with permissions to perform website operations||<code>ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE</code>||Technical user used by the shop (creation of third parties, orders…)
|Benutzer mit Berechtigungen für Website-Vorgänge||<code>ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE</code>||Technischer Benutzer, den der Shop verwendet (Anlegen von Geschäftspartnern, Aufträgen…)
|-
|-
|Website to use for the marketplace||<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>||Dolibarr website managed by the module, set when the module is enabled
|Für den Marktplatz zu verwendende Website||<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>||Vom Modul verwaltete Dolibarr-Website, bei der Aktivierung festgelegt
|-
|-
|Always delete the draft order on logout||<code>ULTIMATEMARKETPLACE_DELETE_ORDER_ON_LOGOUT</code>||Empties the current cart when the customer logs out
|Vorläufige Bestellung bei Abmeldung immer löschen||<code>ULTIMATEMARKETPLACE_DELETE_ORDER_ON_LOGOUT</code>||Leert den aktuellen Warenkorb bei der Abmeldung des Kunden
|-
|-
|Show a cookie consent banner||<code>ULTIMATEMARKETPLACE_ENABLE_COOKIE_BANNER</code>||Consent banner on the website
|Cookie-Hinweis anzeigen||<code>ULTIMATEMARKETPLACE_ENABLE_COOKIE_BANNER</code>||Einwilligungsbanner auf der Website
|}
|}


'''Important''': if you change the associated website (<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>), the users, third parties and orders already created stay linked to the former website and are not migrated automatically.
'''Wichtig''': Wenn Sie die zugeordnete Website ändern (<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>), bleiben die bereits angelegten Benutzer, Geschäftspartner und Aufträge mit der alten Website verknüpft und werden nicht automatisch migriert.


====Email templates====
====E-Mail-Vorlagen====


Three drop-down lists let you choose, among the Dolibarr email templates ('''Setup → Emails → Templates'''), the one of the welcome email sent when the account is created (<code>ULTIMATEMARKETPLACE_WELCOME_EMAIL_TEMPLATE</code>), the one of the "Forgotten password" email (<code>ULTIMATEMARKETPLACE_FORGOT_PASSWORD_EMAIL_TEMPLATE</code>) and the one of the buyer's order confirmation (<code>ULTIMATEMARKETPLACE_BUYER_ORDER_CONFIRMATION_TEMPLATE</code>).
Drei Auswahllisten ermöglichen es, unter den E-Mail-Vorlagen von Dolibarr ('''Einstellungen → E-Mails → Vorlagen''') diejenige für die beim Anlegen des Kontos gesendete Willkommens-E-Mail (<code>ULTIMATEMARKETPLACE_WELCOME_EMAIL_TEMPLATE</code>), diejenige für die E-Mail „Passwort vergessen“ (<code>ULTIMATEMARKETPLACE_FORGOT_PASSWORD_EMAIL_TEMPLATE</code>) und diejenige für die Bestellbestätigung des Käufers (<code>ULTIMATEMARKETPLACE_BUYER_ORDER_CONFIRMATION_TEMPLATE</code>) auszuwählen.


===Setup of payments===
===Konfiguration der Zahlungen===


[[File:Ultimatemarketplace-v25-payment-en.png|center|thumb|800px|Setup of payments tab]]
[[File:Ultimatemarketplace-v25-payment-de.png|center|thumb|800px|Registerkarte Konfiguration der Zahlungen]]


{| class="wikitable"
{| class="wikitable"
|-
|-
!Setting!!Constant!!Description
!Einstellung!!Konstante!!Beschreibung
|-
|-
|Block sales on the marketplace||<code>ULTIMATEMARKETPLACE_BLOCK_SALES</code>||The catalogue can still be browsed but ordering is disabled; forced while maintenance mode is active
|Verkäufe auf dem Marktplatz blockieren||<code>ULTIMATEMARKETPLACE_BLOCK_SALES</code>||Der Katalog bleibt einsehbar, aber Bestellungen sind deaktiviert; erzwungen, solange der Wartungsmodus aktiv ist
|-
|-
|Auto close orders on successful payment||<code>ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT</code>||Closes the Dolibarr order once the payment is confirmed
|Bestellungen nach erfolgreicher Zahlung automatisch abschließen||<code>ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT</code>||Schließt den Dolibarr-Auftrag, sobald die Zahlung bestätigt ist
|-
|-
|Select the payment method to use||<code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>||Dolibarr online payment module used when the order is validated
|Zu verwendende Zahlungsmethode auswählen||<code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>||Online-Zahlungsmodul von Dolibarr, das bei der Bestätigung der Bestellung verwendet wird
|-
|-
|Include the payment pages provided by Dolibarr inside a frame of the market place shop (advanced users)||<code>ULTIMATEMARKETPLACE_PAYMENT_IN_FRAME</code>||Payment displayed in a frame under the shop domain
|Die von Dolibarr bereitgestellten Zahlungsseiten innerhalb eines Frames des Marktplatz-Shops einbinden (für fortgeschrittene Benutzer)||<code>ULTIMATEMARKETPLACE_PAYMENT_IN_FRAME</code>||Zahlung in einem Frame unter der Domain des Shops
|}
|}


Two payment integration modes are available:
Zwei Arten der Zahlungsintegration sind möglich:


*'''Separate page''' (default): no particular setup, the customer is redirected to the public payment pages of your Dolibarr. Drawback: the back-office domain is visible to the customer.
*'''Separate Seite''' (Standard): keine besondere Konfiguration, der Kunde wird zu den öffentlichen Zahlungsseiten Ihres Dolibarr weitergeleitet. Nachteil: Die Domain des Backoffice ist für den Kunden sichtbar.
*'''Frame''' (advanced users, Stripe and Stancer): the payment page is called through a URL of the shop itself. A reverse proxy rule is required on the shop web server; a configuration example is displayed on the page once the option is enabled.
*'''Frame''' (fortgeschrittene Benutzer, Stripe und Stancer): Die Zahlungsseite wird über eine URL des Shops selbst aufgerufen. Auf dem Webserver des Shops ist eine Reverse-Proxy-Regel erforderlich; ein Konfigurationsbeispiel wird auf der Seite angezeigt, sobald die Option aktiviert ist.


===Coupon codes===
===Gutscheincodes===


[[File:Ultimatemarketplace-v25-coupons-en.png|center|thumb|800px|Coupon codes tab]]
[[File:Ultimatemarketplace-v25-coupons-de.png|center|thumb|800px|Registerkarte Gutscheincodes]]


Each coupon code is linked to '''one given product''' and has a discount type (percentage or fixed amount), a value, optional validity dates and maximum number of uses, and an active/inactive flag. The buyer enters the code in the cart: it is accepted only if it is active, within its validity dates, under its usage limit and if the product concerned is in the cart. The usage counter is only incremented when the order is validated.
Jeder Gutscheincode ist mit '''einem bestimmten Produkt''' verknüpft und hat eine Rabattart (Prozentsatz oder fester Betrag), einen Wert, optionale Gültigkeitsdaten und eine optionale maximale Anzahl an Verwendungen sowie einen Aktiv/Inaktiv-Status. Der Käufer gibt den Code im Warenkorb ein: Er wird nur akzeptiert, wenn er aktiv ist, innerhalb seiner Gültigkeitsdaten liegt, seine Verwendungsgrenze nicht erreicht hat und das betreffende Produkt im Warenkorb liegt. Der Verwendungszähler wird erst bei der Bestätigung der Bestellung erhöht.


===Category discounts===
===Kategorierabatte===


[[File:Ultimatemarketplace-v25-discounts-en.png|center|thumb|800px|Category discounts tab]]
[[File:Ultimatemarketplace-v25-discounts-de.png|center|thumb|800px|Registerkarte Kategorierabatte]]


A category discount links a '''customer category''' to a '''product category''' with a discount percentage. For a logged-in customer belonging to this category, the discounted price is displayed directly on the product page and in the cart, with no code to enter. If several rules apply, the highest percentage wins.
Ein Kategorierabatt verknüpft eine '''Kundenkategorie''' mit einer '''Produktkategorie''' und einem Rabattsatz. Für einen angemeldeten Kunden dieser Kategorie wird der rabattierte Preis direkt auf der Produktseite und im Warenkorb angezeigt, ohne dass ein Code eingegeben werden muss. Wenn mehrere Regeln zutreffen, gilt der höchste Prozentsatz.


===Security===
===Sicherheit===


[[File:Ultimatemarketplace-v25-security-en.png|center|thumb|800px|Security tab]]
[[File:Ultimatemarketplace-v25-security-de.png|center|thumb|800px|Registerkarte Sicherheit]]


{| class="wikitable"
{| class="wikitable"
|-
|-
!Setting!!Constant!!Description
!Einstellung!!Konstante!!Beschreibung
|-
|-
|Captcha provider||<code>ULTIMATEMARKETPLACE_CAPTCHA_PROVIDER</code>||None, Google reCAPTCHA or Cloudflare Turnstile, with their site keys and secret keys
|Captcha-Anbieter||<code>ULTIMATEMARKETPLACE_CAPTCHA_PROVIDER</code>||Keiner, Google reCAPTCHA oder Cloudflare Turnstile, mit ihren Website-Schlüsseln und geheimen Schlüsseln
|-
|-
|Enable this protection||<code>ULTIMATEMARKETPLACE_LOGIN_PROTECTION_ENABLED</code>||Limits the login attempts on the shop
|Diesen Schutz aktivieren||<code>ULTIMATEMARKETPLACE_LOGIN_PROTECTION_ENABLED</code>||Begrenzung der Anmeldeversuche im Shop
|-
|-
|Number of failures before blocking / Duration before unblocking (minutes)||<code>ULTIMATEMARKETPLACE_LOGIN_MAX_ATTEMPTS</code> / <code>_LOGIN_BLOCK_DURATION</code>||5 failures and 15 minutes by default
|Anzahl Fehlversuche vor Sperrung / Dauer bis zur Entsperrung (Minuten)||<code>ULTIMATEMARKETPLACE_LOGIN_MAX_ATTEMPTS</code> / <code>_LOGIN_BLOCK_DURATION</code>||Standardmäßig 5 Fehlversuche und 15 Minuten
|-
|-
|IP addresses allowed to bypass this protection||<code>ULTIMATEMARKETPLACE_LOGIN_BYPASS_IPS</code>||Whitelist (automated tests, trusted network)
|IP-Adressen, die diesen Schutz umgehen dürfen||<code>ULTIMATEMARKETPLACE_LOGIN_BYPASS_IPS</code>||Positivliste (automatisierte Tests, vertrauenswürdiges Netzwerk)
|}
|}


The captcha and the login protection are disabled by default: configure them before opening registration to the public.
Captcha und Anmeldeschutz sind standardmäßig deaktiviert: Konfigurieren Sie sie, bevor Sie die Registrierung für die Öffentlichkeit öffnen.


===Setup of API server===
===Konfiguration des API-Servers===


This tab only appears if the Dolibarr '''REST API''' module is enabled. It contains the '''Public API key''' (<code>ULTIMATEMARKETPLACE_PUBLIC_API_KEY</code>, with a button to generate one), passed as the <code>apikey</code> parameter to the two read-only public endpoints added by the module: <code>/api/index.php/ultimatemarketplace/categories</code> and <code>/api/index.php/ultimatemarketplace/products</code>.
Diese Registerkarte erscheint nur, wenn das Dolibarr-Modul '''REST-API''' aktiviert ist. Sie enthält den '''Öffentlichen API-Schlüssel''' (<code>ULTIMATEMARKETPLACE_PUBLIC_API_KEY</code>, mit einer Schaltfläche zum Erzeugen), der als Parameter <code>apikey</code> an die beiden vom Modul hinzugefügten öffentlichen, schreibgeschützten Endpunkte übergeben wird: <code>/api/index.php/ultimatemarketplace/categories</code> und <code>/api/index.php/ultimatemarketplace/products</code>.


===Matomo Analytics===
===Matomo Analytics===


[[File:Ultimatemarketplace-v25-matomo-en.png|center|thumb|800px|Matomo Analytics tab]]
[[File:Ultimatemarketplace-v25-matomo-de.png|center|thumb|800px|Registerkarte Matomo Analytics]]


{| class="wikitable"
{| class="wikitable"
|-
|-
!Constant!!Description
!Konstante!!Beschreibung
|-
|-
|<code>ULTIMATEMARKETPLACE_ENABLE_MATOMO</code>||Enables Matomo on the website: the tracking code is injected into every page
|<code>ULTIMATEMARKETPLACE_ENABLE_MATOMO</code>||Aktiviert Matomo auf der Website: Der Tracking-Code wird in jede Seite eingefügt
|-
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SITE_KEY</code>||Matomo site ID
|<code>ULTIMATEMARKETPLACE_MATOMO_SITE_KEY</code>||Matomo-Website-ID
|-
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SERVER_URL</code>||Full URL of the Matomo server
|<code>ULTIMATEMARKETPLACE_MATOMO_SERVER_URL</code>||Vollständige URL des Matomo-Servers
|-
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_AUTH_TOKEN</code>||Optional authentication token, needed to display Matomo statistics in Dolibarr
|<code>ULTIMATEMARKETPLACE_MATOMO_AUTH_TOKEN</code>||Optionaler Authentifizierungstoken, erforderlich, um die Matomo-Statistiken in Dolibarr anzuzeigen
|}
|}


===Carousel===
===Karussell===
 
[[File:Ultimatemarketplace-v25-carousel-en.png|center|thumb|800px|Carousel tab]]


Settings of the home page carousel: transition type (none, fade, slide), speed in milliseconds, pause on mouse hover and loop. Each slide has an image, an optional link and a title; the order is changed by drag and drop and images are chosen or uploaded through an image selector.
[[File:Ultimatemarketplace-v25-carousel-de.png|center|thumb|800px|Registerkarte Karussell]]


===User guide===
Einstellungen des Karussells der Startseite: Übergangsart (keine, Überblenden, Schieben), Geschwindigkeit in Millisekunden, Pause beim Überfahren mit der Maus und Endlosschleife. Jede Folie hat ein Bild, einen optionalen Link und einen Titel; die Reihenfolge wird per Drag-and-drop geändert, und die Bilder werden über eine Bildauswahl ausgewählt oder hochgeladen.


[[File:Ultimatemarketplace-v25-guide-en.png|center|thumb|800px|User guide tab]]
===Benutzerhandbuch===


The '''User guide''' tab displays, in the user's language, a complete guide to configuring and running the module, as text only: the screenshots are on this page.
[[File:Ultimatemarketplace-v25-guide-de.png|center|thumb|800px|Registerkarte Benutzerhandbuch]]


==Usage==
Die Registerkarte '''Benutzerhandbuch''' zeigt in der Sprache des Benutzers ein vollständiges Handbuch zur Konfiguration und zum Betrieb des Moduls als reinen Text an: Die Bildschirmfotos stehen auf dieser Seite.


===Online shop===
==Verwendung==


[[File:Ultimatemarketplace-v25-shop-home-en.png|center|thumb|800px|Home page of the shop]]
===Online-Shop===


The website generated by the module uses the logo and colors defined in the setup and offers:
[[File:Ultimatemarketplace-v25-shop-home-de.png|center|thumb|800px|Startseite des Shops]]


#a catalogue organised by categories, with the "New" and "Promotions" badges and a carousel on the home page;
Die vom Modul erzeugte Website übernimmt das Logo und die Farben aus der Konfiguration und bietet:
#a product page with the price (category discount already applied) and, for products with price levels, the choice of the duration;
#a cart, kept in session until validation, with a coupon code field;
#a checkout linked to the chosen online payment module;
#a customer area: personal information, "My addresses", order history and download area.


[[File:Ultimatemarketplace-v25-shop-product-en.png|center|thumb|800px|Product page of the shop]]
#einen nach Kategorien geordneten Katalog mit den Badges „Neu“ und „Aktionen“ und einem Karussell auf der Startseite;
#eine Produktseite mit dem Preis (Kategorierabatt bereits angewendet) und, bei Produkten mit Preisstufen, der Wahl der Laufzeit;
#einen Warenkorb, der bis zur Bestätigung in der Sitzung erhalten bleibt, mit Eingabe eines Gutscheincodes;
#einen Bestellvorgang, der mit dem gewählten Online-Zahlungsmodul verbunden ist;
#einen Kundenbereich: persönliche Daten, „Meine Adressen“, Bestellhistorie und Download-Bereich.


Validating the cart creates a standard Dolibarr order; the payment produces a standard Dolibarr invoice.
[[File:Ultimatemarketplace-v25-shop-product-de.png|center|thumb|800px|Produktseite des Shops]]


===Files delivered to the customer===
Die Bestätigung des Warenkorbs erzeugt einen Standard-Auftrag in Dolibarr; die Zahlung erzeugt eine Standard-Rechnung in Dolibarr.


The '''Shop files''' tab of the product card shows, for each attached file, whether it is displayed on the public product page. A file ticked "'''Main file'''" or "'''Visible to customer'''" can be downloaded by the customer once their order is paid; a warning is displayed if no file of the product is. If the product validity duration is enabled, the download link expires at the end of the purchased period; otherwise it never expires.
===An den Kunden gelieferte Dateien===


===UltimateMarketPlace menu===
Die Registerkarte '''Shop-Dateien''' der Produktkarte zeigt für jede angehängte Datei, ob sie auf der öffentlichen Produktseite angezeigt wird. Eine als „'''Hauptdatei'''“ oder „'''Für Kunden sichtbar'''“ markierte Datei kann vom Kunden heruntergeladen werden, sobald sein Auftrag bezahlt ist; eine Warnung erscheint, wenn keine Datei des Produkts so markiert ist. Ist die Gültigkeitsdauer der Produkte aktiviert, verfällt der Download-Link am Ende des gekauften Zeitraums, andernfalls verfällt er nie.


[[File:Ultimatemarketplace-v25-statistics-en.png|center|thumb|800px|Marketplace statistics]]
===Menü UltimateMarketPlace===


The '''Marketplace''' main menu gives access to:
[[File:Ultimatemarketplace-v25-statistics-de.png|center|thumb|800px|Statistiken des Marktplatzes]]


*'''Statistics''': invoice statistics, customer statistics, product statistics, list of sales and, if Matomo is configured, Matomo statistics;
Das Hauptmenü '''Marktplatz''' bietet Zugriff auf:
*'''Products without tags''': catalogue products without keywords, to check the quality of the catalogue;
*'''Shopping carts''' and '''Invoices''': standard Dolibarr order and invoice lists, filtered on those coming from the shop.


===Maintenance mode and template reset===
*'''Statistik''': Rechnungsstatistiken, Kundenstatistiken, Produktstatistiken, Liste der Verkäufe und, wenn Matomo konfiguriert ist, Matomo-Statistiken;
*'''Produkte ohne Tag''': Katalogprodukte ohne Schlüsselwörter, um die Qualität des Katalogs zu prüfen;
*'''Warenkörbe''' und '''Rechnungen''': die Standardlisten der Aufträge und Rechnungen von Dolibarr, gefiltert auf diejenigen, die aus dem Shop stammen.


'''Maintenance mode''' closes the website to the public (except for the allowed IP addresses) and blocks sales. While it is active, the Settings tab offers two buttons:
===Wartungsmodus und Zurücksetzen der Vorlage===


*'''Generate sitemap.xml''': immediately regenerates <code>sitemap.xml</code>;
Der '''Wartungsmodus''' schließt die Website für die Öffentlichkeit (außer für die zugelassenen IP-Adressen) und blockiert die Verkäufe. Solange er aktiv ist, bietet die Registerkarte Einstellungen zwei Schaltflächen:
*'''Reset website template''': re-imports the module's website template into the existing website, '''overwriting the changes made by hand in the page editor'''. To be used after a module update.


Remember to disable maintenance mode once the checks are done: it does not turn itself off.
*'''sitemap.xml generieren''': erzeugt <code>sitemap.xml</code> sofort neu;
*'''Website-Template zurücksetzen''': importiert die Website-Vorlage des Moduls erneut in die bestehende Website, '''wobei die im Seiteneditor von Hand vorgenommenen Änderungen überschrieben werden'''. Nach einer Aktualisierung des Moduls zu verwenden.


===SEO===
Denken Sie daran, den Wartungsmodus nach den Prüfungen zu deaktivieren: Er schaltet sich nicht von selbst ab.


<code>robots.txt</code>, <code>sitemap.xml</code> and <code>llms.txt</code> are regenerated automatically when the module is enabled, when the Settings tab is opened and after a template reset. Once simplified URLs are enabled, the old URLs remain valid during the transition.
===Suchmaschinenoptimierung===


==What's new in version 24.0.0==
<code>robots.txt</code>, <code>sitemap.xml</code> und <code>llms.txt</code> werden bei der Aktivierung, beim Öffnen der Registerkarte Einstellungen und nach einem Zurücksetzen der Vorlage automatisch neu erzeugt. Nach dem Aktivieren der vereinfachten URLs bleiben die alten URLs während der Übergangszeit gültig.


===Compatibility===
==Neuerungen in Version 24.0.1==
*'''Dolibarr 24 and PHP 8.2 minimum''': the module now requires Dolibarr 24.0.0 and PHP 8.2; it is tested up to PHP 8.5. The update check reads <code>versionmodules/ultimatemarketplace/v24/ultimatemarketplace.txt</code>.
*'''Numbering aligned with Dolibarr''': after 1.0.8, the module moves straight to 24.0.0, like the other Atoo-Net modules.


===Translations===
*'''Dokumentation''': Das Benutzerhandbuch und diese Seite erklären, wie der Shop über eine eigene Domain ausgeliefert wird, mithilfe eines virtuellen Hosts, dessen Stammverzeichnis das Verzeichnis der Website ist (siehe [[#Domain und virtueller Host|Domain und virtueller Host]]). Der Code des Moduls ist unverändert.
*The shop cart block displayed raw keys (<code>quantity</code>, <code>total</code>, <code>shipping</code>, <code>FreeShipping</code>): it now loads the module translations. Reset the website template to benefit from it.
*Added the missing labels of the shop pages (references, VAT, items, adding and removing addresses, registration form checks…) and of the administration messages, in the five languages.
*Translated into French, German, Spanish and Italian the labels that only existed in English.


===Documentation and distribution===
==Neuerungen in Version 24.0.0==
*User guide: requirements and compatibility section; the English guide becomes <code>GUIDE_UTILISATEUR-EN.md</code>.
*Wiki page rewritten from the current screens, with screenshots in the five languages.
*DoliStore package build script and continuous integration (dependency installation and syntax check under PHP 8.4 and 8.5).


==Previous versions==
===Kompatibilität===
*'''Mindestens Dolibarr 24 und PHP 8.2''': Das Modul erfordert jetzt Dolibarr 24.0.0 und PHP 8.2; es ist bis PHP 8.5 getestet. Die Update-Prüfung liest <code>versionmodules/ultimatemarketplace/v24/ultimatemarketplace.txt</code>.
*'''An Dolibarr angeglichene Nummerierung''': Nach 1.0.8 springt das Modul direkt auf 24.0.0, wie die anderen Atoo-Net-Module.


The details of versions 1.0.0 to 1.0.8 (coupon codes, category discounts, carousel, login protection, simplified URLs, <code>llms.txt</code>, user guide…) are in the <code>ChangeLog.md</code> file shipped with the module.
===Übersetzungen===
*Der Warenkorbblock des Shops zeigte rohe Schlüssel an (<code>quantity</code>, <code>total</code>, <code>shipping</code>, <code>FreeShipping</code>): Er lädt jetzt die Übersetzungen des Moduls. Setzen Sie das Website-Template zurück, um davon zu profitieren.
*Fehlende Bezeichnungen der Shop-Seiten (Referenzen, MwSt., Artikel, Hinzufügen und Löschen von Adressen, Prüfungen des Registrierungsformulars…) und der Verwaltungsmeldungen in den fünf Sprachen ergänzt.
*Übersetzung der bisher nur auf Englisch vorhandenen Bezeichnungen ins Französische, Deutsche, Spanische und Italienische.


==FAQ==
===Dokumentation und Verteilung===
*Benutzerhandbuch: Abschnitt zu Voraussetzungen und Kompatibilität; das englische Handbuch heißt jetzt <code>GUIDE_UTILISATEUR-EN.md</code>.
*Wiki-Seite anhand der aktuellen Bildschirme neu geschrieben, mit Bildschirmfotos in den fünf Sprachen.
*Skript zum Erstellen des DoliStore-Pakets und kontinuierliche Integration (Installation der Abhängigkeiten und Syntaxprüfung unter PHP 8.4 und 8.5).


===The marketplace website was not created or the shop is empty===
==Frühere Versionen==
Check that the line <code>$dolibarr_website_allow_custom_php</code> is present in <code>conf.php</code>, then disable and enable the module again. Without this line, Dolibarr refuses to import the template pages, which contain PHP code.


===The cart block displays "quantity" or "FreeShipping"===
Die Details der Versionen 1.0.0 bis 1.0.8 (Gutscheincodes, Kategorierabatte, Karussell, Anmeldeschutz, vereinfachte URLs, <code>llms.txt</code>, Benutzerhandbuch…) stehen in der mit dem Modul gelieferten Datei <code>ChangeLog.md</code>.
The website still uses the pages of an earlier version of the module. Switch to maintenance mode and click '''Reset website template''' in the Settings tab.


===How do I change the website used without losing the existing orders?===
==FAQ==
It is not recommended: changing <code>ULTIMATEMARKETPLACE_WEBSITE_ID</code> does not migrate the users, third parties and orders already created to the new website. They remain associated with the former website.
 
===What is the difference between a coupon code and a category discount?===
The coupon code is entered by the buyer and only applies to one given product. The category discount is automatic: it applies to all the products of a category for the customers of a given category, as soon as they are logged in.
 
===The customer cannot download the purchased product===
Check, in the '''Shop files''' tab of the product, that a file is ticked "Main file" or "Visible to customer". The home page of the '''Marketplace''' menu reports products already sold that no longer have a deliverable file.
 
===Is payment in a frame mandatory?===
No, it is an option for advanced users. By default, payment simply redirects to the public payment pages of your Dolibarr, with no particular server setup.
 
===Which languages are supported?===
The module and the website template are available in '''French''', '''English''', '''German''', '''Spanish''' and '''Italian'''.
 
==See also==
 
*[https://www.atoo-net.com Atoo-Net — Module publisher]
*[https://framagit.org/grandoc/ultimatemarketplace Module repository]
*[https://wiki.dolibarr.org/index.php/Module_Website Documentation of the Dolibarr Website module]
 
==Other languages==
 
* [[Module_UltimateMarketPlace_FR|Documentation en français du module UltimateMarketPlace]]
* [[Module_UltimateMarketPlace_DE|Deutsche Dokumentation für das Modul UltimateMarketPlace]]
* [[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]]
[[de:Module_UltimateMarketPlace_DE]]
[[es:Module_UltimateMarketPlace_ES]]
[[it:Module_UltimateMarketPlace_IT]]
Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/68010"

Navigation menu