Module UltimateMarketPlace IT
Modulo UltimateMarketPlace
Presentazione
Il modulo UltimateMarketPlace è un'estensione per Dolibarr ERP/CRM pubblicata da 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.
| 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 DoliStore oppure clonare il repository Git in
htdocs/custom/ultimatemarketplace - Andare su Home → Configurazione → Moduli/Applicazioni
- Individuare UltimateMarketPlace nella sezione AtooNet
- Attivare il modulo cliccando sul pulsante nella colonna Attivato
All'attivazione, il modulo esegue automaticamente diverse azioni:
- Creazione di un sito web dedicato (riferimento
ultimatemarketplace) 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 (
PriceComment) e messaggio di avviso pubblico (DisclaimerMessage)
Configurazione
La configurazione del modulo si effettua in Home → Configurazione → Moduli/Applicazioni → UltimateMarketPlace, suddivisa in diverse schede.
Generale: prodotti e terzi
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_NAME |
Nome del marketplace |
ULTIMATEMARKETPLACE_EMAIL |
Email di contatto del marketplace |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID |
Categoria radice dei prodotti venduti nel marketplace |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS |
Categoria in evidenza nel blocco centrale della homepage |
ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID |
Categoria utilizzata dal widget "Versione" della homepage |
ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID |
Categoria utilizzata dal widget "Promozioni" della homepage |
ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE |
Prezzo minimo di un prodotto (se non è gratuito) |
ULTIMATEMARKETPLACE_DELAY_FOR_NEW |
Anzianità massima (in giorni) affinché un prodotto appaia nella sezione "Novità" |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID |
Categoria assegnata a tutti i prospect/clienti creati dal sito di vendita |
Sconti per clienti preferenziali
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID |
Categoria di terzi etichettati come "Preferenziale", idonei allo sconto |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT |
Percentuale di sconto applicata a questi terzi |
ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID |
Categoria di prodotti esclusi da questo sconto |
Sito Web
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_URL_FOR_LOGO |
URL del logo del marketplace |
ULTIMATEMARKETPLACE_THEME_COLOR |
Colore principale del tema (pulsanti, banner, elementi in evidenza) |
ULTIMATEMARKETPLACE_WEBSITE_ID |
Sito Web di Dolibarr utilizzato dal marketplace |
ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE |
Utente tecnico autorizzato a eseguire le azioni del sito (aggiungere prodotti, gestire terzi, creare ordini) |
Importante: se cambiate il sito web associato (ULTIMATEMARKETPLACE_WEBSITE_ID), 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:
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID |
Prodotto aggiuntivo da aggiungere |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT |
Prezzo del prodotto aggiuntivo, espresso in % del totale del carrello |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES |
Codici paese in cui si applica questo prodotto aggiuntivo |
Spese di spedizione
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT / ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID |
Prodotto Dolibarr utilizzato per fatturare le spese di spedizione |
Registrazione: Google reCAPTCHA
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM |
Attiva il Captcha di Google nel modulo di registrazione |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY |
Chiave pubblica reCAPTCHA fornita da Google |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY |
Chiave privata reCAPTCHA (da mantenere riservata) |
Pagamento
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_BLOCK_SALES |
Blocca temporaneamente le vendite nel marketplace |
ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT |
Chiude automaticamente l'ordine dopo un pagamento riuscito |
ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD |
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
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_PUBLIC_API_KEY |
Chiave pubblica utilizzata per accedere all'API di prodotti/categorie |
L'API espone un flusso XML dei prodotti e delle categorie, con i parametri categorieid, limit, page, search e lang. È possibile configurare un instradamento proxy per nascondere l'URL reale dell'API dietro al dominio del negozio.
Matomo
| Costante | Descrizione |
|---|---|
ULTIMATEMARKETPLACE_ENABLE_MATOMO |
Attiva Matomo Analytics sul sito del marketplace |
ULTIMATEMARKETPLACE_MATOMO_SITE_KEY |
Identificativo di sito (Site ID) di Matomo |
ULTIMATEMARKETPLACE_MATOMO_SERVER_URL |
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
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
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 module_source = ultimatemarketplace).
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 ULTIMATEMARKETPLACE_WEBSITE_ID 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 ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID 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 ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD.