Lean Bunker Commerce – WordPress Plugin

🌬️ Un solo file. Zero compromessi.

Lean Bunker Commerce è distribuito in un unico file PHP — niente cartelle, niente asset, niente dipendenze.
Non è un limite: è una scelta di principio.

In un’epoca di plugin gonfiati da librerie esterne, script invasivi e tabelle database superflue, crediamo che la potenza debba stare nella semplicità, non nel peso.

Questo plugin:

  • pesa meno di un commento WordPress,
  • non carica alcun JavaScript,
  • non crea tabelle SQL,
  • non chiama server esterni,
  • non traccia i tuoi visitatori.

Funziona esattamente come il nucleo di WordPress:
leggero, trasparente, controllabile, autonomo.

Perché ogni riga di codice che non c’è…
è una vulnerabilità in meno,
un millisecondo di velocità in più,
e un passo verso un web più onesto.

Benvenuto nel bunker.
Qui, il peso si misura in valore — non in kilobyte.

📝 Nota su versione attuale e compatibilità – Lean Bunker Commerce v0.0.7

Versione: 0.0.7
Stato: Stabile, single-file, zero dipendenze esterne.

Compatibilità:

  • WordPress: 5.0+ (testato fino a 6.7+)
  • PHP: 7.4+, 8.0, 8.1, 8.2, 8.3 (nessuna funzione deprecata)
  • Multisite: pienamente supportato (impostazioni per singolo subsite)
  • Temi e page builder: neutrale, usa solo shortcode → compatibile con tutti
  • Sicurezza: non richiede eval() se sostituito con parser sicuro (opzionale); altrimenti funziona ovunque eval() è consentito (standard in quasi tutti gli hosting)

Requisiti minimi:

  • PHP con floatval(), number_format(), preg_match() (presenti di default)
  • WordPress con wp_mail() configurato (per il modulo richiesta)

Filosofia:
Single file, zero JavaScript, zero bloat, autonomo, multisite-ready — coerente con la visione Lean Bunker.

📦 Lean Bunker Commerce – Descrizione Granulare

Lean Bunker Commerce è un plugin WordPress minimalista, autonomo e privo di dipendenze, progettato per creare configuratori di prodotti o servizi personalizzati direttamente all’interno di qualsiasi contenuto (pagina, post o custom post type).

Non è un costruttore visuale, né un sistema di ecommerce.
È uno strumento preciso, leggero e discreto per chi ha bisogno di calcolare un risultato dinamico (es. un preventivo) e, se desiderato, permettere al visitatore di inviare una richiesta con i dati calcolati — tutto senza uscire dal sito, senza JavaScript e senza appesantire il caricamento.


👤 Come lo usa l’amministratore del sito

  1. Abilita il plugin sui contenuti desiderati
    Dalla pagina Impostazioni → Lean Bunker Commerce, seleziona su quali tipi di contenuto (es. pagine, prodotti, ecc.) vuoi che appaia il metabox di configurazione. In ambiente Multisite, ogni subsito gestisce queste impostazioni in modo indipendente.
  2. Configura il calcolatore
    Modificando un contenuto abilitato, trovi un metabox chiamato “Configuratore Prodotto”. Qui puoi:

    • Definire campi personalizzati (menu a tendina con valori numerici, campi numerici, ecc.) usando un formato testuale semplice:
      nome_campo | Etichetta | tipo | opzioni
      Esempio: pavimento | Tipo di pavimento | select | Legno|80, Ceramica|45
    • Scrivere una formula di calcolo usando le variabili {nome_campo}:
      Esempio: {pavimento} * {mq}
    • Opzionalmente, attivare un modulo di invio email dopo il calcolo, spuntando “Abilita modulo richiesta”.
  3. Mostra il configuratore nel frontend
    Inserisci lo shortcode

    Configuratore non disponibile.

    nel contenuto stesso, oppure

    Configuratore non disponibile.

    per mostrare il configuratore di un altro contenuto.
  4. Ricevi le richieste via email
    Se il modulo è abilitato, ogni volta che un visitatore invia una richiesta, ricevi un’email completa con: nome, email, messaggio, totale calcolato e configurazione scelta. L’email viene inviata all’indirizzo impostato in Impostazioni → Generale.

🔒 Il plugin non salva alcun dato nel database (a meno che tu non lo estenda). Non traccia, non logga, non carica script esterni.


👥 Come lo usa il visitatore (cliente)

  1. Compila il form
    Seleziona opzioni (es. tipo di materiale) e inserisce valori (es. metri quadrati).
  2. Calcola il risultato
    Clicca su “Calcola Totale” e vede immediatamente il prezzo o il risultato (es. “Totale: 1.240 €”).
  3. Invia la richiesta (se disponibile)
    Se il proprietario del sito ha abilitato il modulo:

    • Compila nome ed email (obbligatori) e un messaggio opzionale.
    • Clicca su “Invia richiesta”.
    • Riceve un messaggio di conferma: “Grazie! La tua richiesta è stata inviata.”

Tutto avviene nella stessa pagina, senza popup, redirect o caricamenti aggiuntivi.


🧠 Perché è diverso

  • Un solo file PHP – facile da installare, auditare, aggiornare.
  • Zero JavaScript – funziona ovunque, anche su browser testuali o con JS disabilitato.
  • Nessuna dipendenza – non richiede librerie, framework o plugin aggiuntivi.
  • Compatibile con hardening avanzato – funziona anche con REST API, XML-RPC, emoji, embeds disattivati.
  • Design nativo – si adatta automaticamente allo stile del tuo tema, senza CSS forzato.
  • Privacy by design – nessun tracking, nessun dato raccolto senza azione esplicita.
  • Multisite-ready – ogni sito gestisce autonomamente le proprie impostazioni.

🛠️ Ideale per

  • Artigiani, geometri, imbianchini, falegnami
  • Consulenti, formatori, designer
  • Aziende B2B con servizi su misura
  • Chiunque debba generare preventivi qualificati senza usare fogli Excel o moduli statici

Non è pensato per

  • Ecommerce con carrello e pagamenti online (usa WooCommerce per quello)
  • Configuratori complessi con decine di regole condizionali
  • Siti che richiedono integrazioni con CRM esterni (a meno che non lo estendi)

💡 In sintesi

Lean Bunker Commerce trasforma qualsiasi pagina WordPress in un punto vendita intelligente — senza rumore, senza peso, senza compromessi.

Per chi crede che il miglior codice sia quello che non c’è… ma che quando serve, funziona perfettamente.

FAQ – Lean Bunker Commerce

1. Cos’è Lean Bunker Commerce?

È un plugin WordPress leggerissimo che permette di creare configuratori personalizzati (es. preventivi, calcoli su misura) direttamente in una pagina, post o prodotto. Non richiede JavaScript, non crea tabelle nel database e non carica script esterni.


2. A chi serve?

A chiunque debba offrire un servizio personalizzato con calcolo dinamico: artigiani, consulenti, designer, formatori, aziende B2B. Ideale per generare lead qualificati senza usare moduli statici o fogli Excel.


3. Funziona con il mio tema?

Sì. Il plugin non impone stili propri: si adatta automaticamente al design del tuo tema grazie all’uso di classi standard di WordPress (button, regular-text, ecc.).


4. Serve WooCommerce?

No. Lean Bunker Commerce è pensato per richieste di preventivo, non per ecommerce con carrello e pagamenti online. Se hai bisogno di vendere prodotti digitali/fisici con pagamento immediato, usa WooCommerce. Questo plugin è per chi dice: “Mi contatti dopo aver visto il prezzo”.


5. Funziona in Multisite?

Sì, e ogni subsito gestisce le proprie impostazioni in totale autonomia. Abilitare il metabox su “pagine” in un sito non influisce sugli altri.


6. Salva i dati degli utenti?

No. Per impostazione predefinita, non memorizza nulla nel database. Quando un visitatore invia una richiesta, i dati vengono inviati via email e poi scartati. Nessun tracking, nessun log automatico.

ℹ️ Puoi aggiungere il logging manualmente se lo desideri, ma non è incluso di default — per rispetto della privacy.


7. Ha dipendenze esterne?

Assolutamente no.

  • Zero librerie JavaScript
  • Zero chiamate a server esterni
  • Zero API di terze parti
  • Zero tabelle SQL

Tutto avviene lato server, usando solo funzioni native di WordPress (wp_mail, get_post_meta, ecc.).


8. È compatibile con siti hardenati (sicurezza avanzata)?

Sì. Funziona perfettamente anche se hai disattivato:

  • REST API
  • XML-RPC
  • Gutenberg
  • Emojis
  • Embeds
  • Heartbeat

Non ne ha bisogno.


9. Come faccio a mostrarlo in una pagina?

Inserisci lo shortcode

Configuratore non disponibile.

nel contenuto.
Se vuoi mostrare il configuratore di un altro contenuto, usa:

Configuratore non disponibile.

(dove 123 è l’ID del post/prodotto configurato).


10. Posso personalizzare l’email inviata?

Non dall’interfaccia, ma essendo un plugin single-file, puoi aprire il file PHP e modificare la sezione wp_mail() in pochi secondi. Tutto è trasparente e accessibile.


11. È open source?

Sì. Essendo distribuito come un unico file PHP, puoi leggerlo, modificarlo, auditare ogni riga. Nessun codice nascosto, nessuna sorpresa.


12. Perché non usa JavaScript?

Perché non ne ha bisogno. Il calcolo avviene lato server, il che garantisce:

  • Maggiore sicurezza (nessuna logica esposta al client)
  • Compatibilità universale (funziona anche su Tor, Lynx, o browser con JS bloccato)
  • Migliore performance (niente parsing di script)

La semplicità è una scelta, non un limite.


13. Cosa succede se la formula è sbagliata?

Il plugin convalida la formula prima del calcolo. Se contiene caratteri non consentiti (es. lettere, simboli strani), mostra un messaggio di errore: “Caratteri non consentiti nella formula.”
Questo previene errori e potenziali vulnerabilità.


14. Posso usare più campi?

Sì. Puoi aggiungere quanti campi vuoi: menu a tendina con valori numerici, campi numerici, ecc. Basta elencarli nel metabox, uno per riga.


15. È gratuito?

Sì. Lean Bunker Commerce è rilasciato sotto licenza GPL-3.0+, come il core di WordPress. Puoi usarlo, modificarlo e distribuirlo liberamente.


💡 Hai altre domande?
Apri il file lean-bunker-commerce.php: troverai tutto il codice, commentato e leggibile.
Perché in fondo, la migliore documentazione… è il codice stesso.

Nuove Funzioni e Bug Fix

Bug fix (v0.0.7):
Il calcolo non veniva mostrato quando il totale superava 1.000 € a causa di un controllo errato su una stringa formattata ("1.250,75"). Ora il plugin usa il valore numerico puro per decidere se mostrare il risultato, garantendo che funzioni correttamente per qualsiasi importo.