Module UltimateMarketPlace IT - Revision history

Grandoc at 08:51, 12 October 2026

2026-10-12T08:51:58Z

@@ Line 20: / Line 20: @@
 |Autore||Philippe Grand — Atoo-Net
 |-
-|Versione||24.0.0
+|Versione||24.0.1
 |-
 |Licenza||GNU GPL v3+
@@ Line 77: / Line 77: @@
 Il modulo non dichiara alcun permesso proprio: le pagine di amministrazione sono riservate agli amministratori di Dolibarr, e le pagine del negozio usano una propria sessione cliente.
 ==Configurazione==
@@ Line 308: / Line 343: @@
 <code>robots.txt</code>, <code>sitemap.xml</code> e <code>llms.txt</code> vengono rigenerati automaticamente all'attivazione, all'apertura della scheda Impostazioni e dopo una reimpostazione del modello. Una volta attivati gli URL semplificati, i vecchi URL restano validi durante la transizione.
 ==Novità della versione 24.0.0==
@@ Line 330: / Line 369: @@
 ==FAQ==

Grandoc at 20:37, 6 October 2026

2026-10-06T20:37:26Z

Show changes

Grandoc: /* Altre lingue */

2026-07-10T10:08:34Z

Altre lingue

← Older revision		Revision as of 10:08, 10 July 2026
Line 283:		Line 283:
	==Altre lingue==		==Altre lingue==

			* [[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_DE\|Deutsche Dokumentation für das Modul 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_ES\|Documentación en español del módulo UltimateMarketPlace]]

			[[fr:Module_UltimateMarketPlace_FR]]
	[[en:Module_UltimateMarketPlace_EN]]		[[en:Module_UltimateMarketPlace_EN]]
	[[de:Module_UltimateMarketPlace_DE]]		[[de:Module_UltimateMarketPlace_DE]]
	[[es:Module_UltimateMarketPlace_ES]]		[[es:Module_UltimateMarketPlace_ES]]

Grandoc: Created page with "Category:Modules Category:AtooNet =Modulo UltimateMarketPlace= ==Presentazione== Il modulo '''UltimateMarketPlace''' è un'estensione per Dolibarr ERP/CRM pubblicat..."

2026-07-10T10:06:58Z

Created page with "Category:Modules Category:AtooNet =Modulo UltimateMarketPlace= ==Presentazione== Il modulo '''UltimateMarketPlace''' è un'estensione per Dolibarr ERP/CRM pubblicat..."

New page

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

=Modulo UltimateMarketPlace=

==Presentazione==

Il modulo '''UltimateMarketPlace''' è un'estensione per Dolibarr ERP/CRM pubblicata da [https://www.atoo-net.com Atoo-Net].

Fornisce tutte le funzionalità necessarie per pubblicare un '''marketplace online monofornitore''': un modello di sito web pronto all'uso (catalogo prodotti, carrello, processo d'ordine, account cliente), utilizzabile con il modulo Sito Web di Dolibarr, per vendere direttamente online i propri prodotti e servizi.

Si tratta di un fork semplificato del modulo Dolibarr «Marketplace» (utilizzato per dolistore.com), da cui è stato rimosso tutto ciò che è specifico dell'associazione Dolibarr, così come il circuito multifornitore di invio e revisione dei moduli da parte di sviluppatori esterni.

{| class="wikitable"
|-
!Proprietà!!Valore
|-
|Autore||Philippe Grand — Atoo-Net
|-
|Versione||1.0
|-
|Licenza||GNU GPL v3+
|-
|Dolibarr minimo||v24.0
|-
|PHP minimo||v8.0
|}

==Perché usare UltimateMarketPlace?==

UltimateMarketPlace trasforma la vostra installazione Dolibarr in un negozio online autonomo, senza dipendere da un CMS né da una piattaforma di e-commerce di terze parti (come PrestaShop, WooCommerce…). Il catalogo, gli ordini, le fatture e i clienti restano nativamente in Dolibarr.

===Casi d'uso===

====Vendita di prodotti fisici o dematerializzati====
Pubblicate il vostro catalogo di prodotti o servizi direttamente dalle schede prodotto di Dolibarr. Il modulo gestisce sia i beni fisici (con spese di spedizione) sia gli articoli dematerializzati (download, licenze, servizi).

====Fidelizzazione dei clienti professionali====
Grazie agli sconti automatici per i «clienti preferenziali» (categoria di terzi dedicata), offrite una tariffa preferenziale negoziata ai vostri migliori clienti, con la possibilità di escludere determinati prodotti dallo sconto.

====Promozioni commerciali e codici sconto====
Create codici sconto (percentuale o importo fisso), limitati nel tempo o nel numero di utilizzi, eventualmente riservati a un prodotto specifico, per dinamizzare le vostre vendite online.

====Vendita aggiuntiva (upsell) nel carrello====
Proponete automaticamente un prodotto complementare nel carrello (es. assicurazione, garanzia, ecotassa), calcolato come percentuale del totale e limitato ai paesi che scegliete.

====Pagamento online====
Collegate il processo d'acquisto ai metodi di pagamento già configurati in Dolibarr (Stripe, PayPal, bonifico…), tramite reindirizzamento classico al vostro back-office oppure integrato in un frame all'interno del negozio.

====Monitoraggio del traffico====
Integrate Matomo Analytics per monitorare l'affluenza e il comportamento d'acquisto nel vostro negozio, senza dipendere da Google Analytics.

==Installazione==

'''Prerequisiti''': il modulo richiede che i seguenti moduli Dolibarr siano attivati (si attivano automaticamente se necessario): Terzi, Prodotti, Servizi, Categorie, Ordini, Fatture, Banca, Mailing e Sito Web.

#Scaricare il modulo da [https://www.dolistore.com DoliStore] oppure clonare il repository Git in <code>htdocs/custom/ultimatemarketplace</code>
#Andare su '''Home → Configurazione → Moduli/Applicazioni'''
#Individuare '''UltimateMarketPlace''' nella sezione '''AtooNet'''
#Attivare il modulo cliccando sul pulsante nella colonna ''Attivato''

[[File:ultimatemarketplace_activation.png|center|thumb|800px|Attivazione del modulo UltimateMarketPlace nella sezione AtooNet]]

All'attivazione, il modulo esegue automaticamente diverse azioni:

*Creazione di un '''sito web dedicato''' (riferimento <code>ultimatemarketplace</code>) con il modello "website_template-ultimatemarketplace" importato
*Creazione di una '''categoria radice di prodotti''' per gli articoli visibili nel marketplace
*Creazione di una '''categoria di terzi''' per i clienti/prospect creati dal sito di vendita
*Aggiunta di 3 '''campi aggiuntivi prodotto''': separatore "Marketplace", commento dopo il prezzo (<code>PriceComment</code>) e messaggio di avviso pubblico (<code>DisclaimerMessage</code>)

==Configurazione==

La configurazione del modulo si effettua in '''Home → Configurazione → Moduli/Applicazioni → UltimateMarketPlace''', suddivisa in diverse schede.

===Generale: prodotti e terzi===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_NAME</code>||Nome del marketplace
|-
|<code>ULTIMATEMARKETPLACE_EMAIL</code>||Email di contatto del marketplace
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID</code>||Categoria radice dei prodotti venduti nel marketplace
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS</code>||Categoria in evidenza nel blocco centrale della homepage
|-
|<code>ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID</code>||Categoria utilizzata dal widget "Versione" della homepage
|-
|<code>ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID</code>||Categoria utilizzata dal widget "Promozioni" della homepage
|-
|<code>ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE</code>||Prezzo minimo di un prodotto (se non è gratuito)
|-
|<code>ULTIMATEMARKETPLACE_DELAY_FOR_NEW</code>||Anzianità massima (in giorni) affinché un prodotto appaia nella sezione "Novità"
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID</code>||Categoria assegnata a tutti i prospect/clienti creati dal sito di vendita
|}

===Sconti per clienti preferenziali===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID</code>||Categoria di terzi etichettati come "Preferenziale", idonei allo sconto
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT</code>||Percentuale di sconto applicata a questi terzi
|-
|<code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code>||Categoria di prodotti esclusi da questo sconto
|}

===Sito Web===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_URL_FOR_LOGO</code>||URL del logo del marketplace
|-
|<code>ULTIMATEMARKETPLACE_THEME_COLOR</code>||Colore principale del tema (pulsanti, banner, elementi in evidenza)
|-
|<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>||Sito Web di Dolibarr utilizzato dal marketplace
|-
|<code>ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE</code>||Utente tecnico autorizzato a eseguire le azioni del sito (aggiungere prodotti, gestire terzi, creare ordini)
|}

'''Importante''': se cambiate il sito web associato (<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>), gli utenti, i terzi e gli ordini già creati restano collegati al vecchio sito e non vengono migrati automaticamente.

===Modelli email===

Si possono personalizzare tre modelli email di Dolibarr:

*'''Email di benvenuto''' inviata alla creazione dell'account cliente
*'''Email "password dimenticata"'''
*'''Email di conferma ordine''' inviata all'acquirente

===Prodotto aggiuntivo nel carrello===

Permette di aggiungere automaticamente un prodotto complementare (assicurazione, garanzia, ecotassa…) al carrello:

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID</code>||Prodotto aggiuntivo da aggiungere
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT</code>||Prezzo del prodotto aggiuntivo, espresso in % del totale del carrello
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES</code>||Codici paese in cui si applica questo prodotto aggiuntivo
|}

===Spese di spedizione===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT</code> / <code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID</code>||Prodotto Dolibarr utilizzato per fatturare le spese di spedizione
|}

===Registrazione: Google reCAPTCHA===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM</code>||Attiva il Captcha di Google nel modulo di registrazione
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY</code>||Chiave pubblica reCAPTCHA fornita da Google
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY</code>||Chiave privata reCAPTCHA (da mantenere riservata)
|}

===Pagamento===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_BLOCK_SALES</code>||Blocca temporaneamente le vendite nel marketplace
|-
|<code>ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT</code>||Chiude automaticamente l'ordine dopo un pagamento riuscito
|-
|<code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>||Metodo di pagamento da utilizzare
|}

Esistono due modalità possibili di integrazione del pagamento:

*'''Pagina separata''' (predefinita): senza configurazione particolare, il cliente viene reindirizzato alle pagine di pagamento pubbliche del vostro back-office Dolibarr. Svantaggio: il dominio del back-office è visibile al cliente.
*'''Frame''' (utenti avanzati): la pagina di pagamento del back-office viene richiamata tramite un URL del negozio del marketplace stesso. Richiede una configurazione proxy sul server web del marketplace per reindirizzare le richieste verso il back-office Dolibarr. Vantaggio: il dominio del back-office resta nascosto.

===API===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_PUBLIC_API_KEY</code>||Chiave pubblica utilizzata per accedere all'API di prodotti/categorie
|}

L'API espone un flusso XML dei prodotti e delle categorie, con i parametri <code>categorieid</code>, <code>limit</code>, <code>page</code>, <code>search</code> e <code>lang</code>. È possibile configurare un instradamento proxy per nascondere l'URL reale dell'API dietro al dominio del negozio.

===Matomo===

{| class="wikitable"
|-
!Costante!!Descrizione
|-
|<code>ULTIMATEMARKETPLACE_ENABLE_MATOMO</code>||Attiva Matomo Analytics sul sito del marketplace
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SITE_KEY</code>||Identificativo di sito (Site ID) di Matomo
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SERVER_URL</code>||URL completo del server Matomo
|}

===Codici sconto (coupon)===

Una scheda dedicata '''Codici sconto''' consente di creare codici sconto:

*'''Tipo di sconto''': percentuale o importo fisso al netto delle imposte
*'''Numero massimo di utilizzi''' (lasciare vuoto per utilizzo illimitato)
*Possibile restrizione a un '''prodotto specifico'''
*Monitoraggio del numero di utilizzi già effettuati

[[File:ultimatemarketplace_coupons.png|center|thumb|800px|Scheda di amministrazione dei codici sconto]]

Il codice viene verificato al momento dell'applicazione nel carrello: un codice inesistente, scaduto o già completamente utilizzato viene rifiutato (messaggio "Questo codice sconto non è valido, è scaduto o è già stato utilizzato").

==Utilizzo==

===Negozio online (front office)===

Il sito generato dal modulo riprende l'identità visiva definita nella configurazione (logo, colore principale) e offre:

#Un catalogo prodotti organizzato per categorie, con evidenziazione di '''novità''' e '''promozioni'''
#Una scheda prodotto con prezzo, commento libero dopo il prezzo e messaggio di avviso pubblico se configurati
#Un carrello con applicazione del codice sconto, calcolo automatico degli sconti "cliente preferenziale" e aggiunta dell'eventuale prodotto aggiuntivo
#Un processo d'ordine collegato ai metodi di pagamento configurati in Dolibarr
#Un'area cliente (registrazione, accesso, storico ordini) protetta da Google reCAPTCHA se attivato

[[File:ultimatemarketplace_home.png|center|thumb|800px|Homepage del negozio generata da UltimateMarketPlace]]

===Gestione delle etichette prodotto===

Il menu '''UltimateMarketPlace → Prodotti senza etichette''' elenca i prodotti/servizi del marketplace non ancora associati a una categoria/etichetta, per applicare in massa una o più etichette (categorie).

===Statistiche===

Il modulo aggiunge pagine di statistiche dedicate al marketplace:

*Statistiche di '''fatture''' e '''vendite''' (raggruppamento per paese/aliquota IVA o per zona/aliquota IVA)
*Statistiche '''clienti''' (ultimi terzi creati, ultimi terzi "preferenziali")
*Statistiche '''prodotti/servizi''' (classifica per popolarità)

===Monitoraggio ordini e fatture===

Due voci di menu permettono di individuare rapidamente gli ordini e le fatture provenienti dal marketplace (filtrati per <code>module_source = ultimatemarketplace</code>).

==FAQ==

===Il sito del marketplace non è stato creato automaticamente===
Verificate che il modulo '''Sito Web''' di Dolibarr sia attivato. Se il sito continua a non esistere dopo l'attivazione del modulo, disattivate e riattivate UltimateMarketPlace.

===Come cambio il sito web utilizzato senza perdere gli ordini esistenti?===
Non è consigliato: modificare <code>ULTIMATEMARKETPLACE_WEBSITE_ID</code> non migra gli utenti, i terzi e gli ordini già creati verso il nuovo sito. Restano associati al sito precedente.

===Posso limitare lo sconto "cliente preferenziale" solo ad alcuni prodotti?===
Sì, configurando <code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code> con una categoria che raggruppa i prodotti da escludere dallo sconto.

===Il pagamento in frame è obbligatorio?===
No, è un'opzione per utenti avanzati. Per impostazione predefinita, il pagamento reindirizza semplicemente alle pagine di pagamento pubbliche del vostro back-office Dolibarr, senza alcuna configurazione server particolare.

===Quali metodi di pagamento sono compatibili?===
Tutti i metodi di pagamento già supportati nativamente da Dolibarr (Stripe, PayPal, bonifico, ecc.), selezionati tramite <code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>.

==Vedi anche==

*[https://www.atoo-net.com Atoo-Net — Editore del modulo]
*[https://framagit.org/grandoc/ultimatemarketplace Repository del modulo]
*[https://wiki.dolibarr.org/index.php/Module_Website Documentazione del modulo Sito Web di Dolibarr]

==Altre lingue==

* [[Module_UltimateMarketPlace_EN|English documentation for the UltimateMarketPlace module]]
* [[Module_UltimateMarketPlace_DE|Deutsche Dokumentation für das Modul UltimateMarketPlace]]
* [[Module_UltimateMarketPlace_ES|Documentación en español del módulo UltimateMarketPlace]]

[[en:Module_UltimateMarketPlace_EN]]
[[de:Module_UltimateMarketPlace_DE]]
[[es:Module_UltimateMarketPlace_ES]]