Lusi Permute

Lusi Permute è un plugin WordPress mobile-first per raccogliere e gestire richieste di valutazione, vendita e permuta di veicoli. Il cliente compila un wizard pubblico, allega fotografie e documenti e riceve una conferma; il concessionario conserva sempre la pratica nel database WordPress e la gestisce da un back-office dedicato.

Requisiti

• WordPress 6.4 o successivo
• PHP 7.4 o successivo
• HTTPS consigliato, necessario per la migliore esperienza fotocamera su mobile
• Estensione PHP GD o Imagick consigliata per il ridimensionamento immagini
• Permessi di scrittura su wp-content/uploads

Il plugin non richiede Composer, Node.js o una compilazione dopo l'installazione.

Installazione

1. Scaricare lusi-permute.zip dalla release GitHub più recente.
2. Aprire WordPress → Plugin → Aggiungi plugin → Carica plugin.
3. Selezionare lo ZIP, installare e attivare.
4. Aprire Lusi Permute → Impostazioni e configurare concessionario, email, WhatsApp, privacy e campi.
5. Inserire [lusi_permuta] nella pagina pubblica.

All'attivazione vengono create sei tabelle con dbDelta, incluse le notifiche, oltre alle capability e ai ruoli del plugin. I dati non vengono rimossi alla disinstallazione salvo scelta esplicita.

Shortcode

Modulo completo

[lusi_permuta]

Attributi supportati:

[lusi_permuta sede="roma" veicolo_id="123" layout="wizard" titolo="Valuta la tua auto" categoria="usato" destinatario="roma@example.com"]

• sede: provenienza o sede della richiesta.
• veicolo_id: collega automaticamente un veicolo del concessionario.
• layout: wizard oppure compact.
• titolo: sostituisce il titolo introduttivo.
• categoria: riservato alle integrazioni inventario.
• destinatario: aggiunge un destinatario valido al routing email della richiesta.

Modalità compatta

[lusi_permuta_compatta]

Usa lo stesso flusso affidabile con una presentazione più contenuta. Gli shortcode funzionano con editor classico, Gutenberg, Elementor e altri builder che eseguono gli shortcode WordPress.

Funzioni principali

• Wizard pubblico in 6 step con validazione immediata e riepilogo modificabile.
• Bozza locale per sette giorni; i file restano soltanto in memoria e non sono salvati in localStorage.
• Upload JPEG, PNG, WebP, HEIC/HEIF e PDF con controllo MIME, limite configurabile, nomi casuali, anteprima e ridimensionamento.
• Schermata successo animata, ricevuta PDF firmata e pulsante WhatsApp.
• Tabelle dedicate per richieste, metadati, allegati, note, attività e notifiche.
• Dashboard con metriche, grafico, ricerca, filtri, paginazione, CSV e azioni massive.
• Scheda pratica con cliente, veicolo, condizioni, allegati, valutazione, comunicazioni, note e cronologia.
• Email HTML tramite wp_mail() con destinatari validati, mittente sicuro, esiti persistenti e compatibilità con i comuni plugin SMTP.
• WhatsApp tramite link wa.me chiaramente manuale oppure Business API configurabile per notifiche automatiche.
• Retry progressivi, prevenzione duplicati, reinvio manuale e centro diagnostico delle notifiche.
• Esportatore e cancellatore per gli strumenti privacy di WordPress.
• Retention opzionale, IP memorizzato solo come hash HMAC, honeypot, nonce e rate limiting.
• Import/export impostazioni JSON senza token.
• Updater basato esclusivamente su GitHub Releases pubbliche.

Struttura

lusi-permute/
├── lusi-permute.php
├── uninstall.php
├── includes/        # dominio, servizi, sicurezza e integrazioni
├── public/          # wizard, CSS e JavaScript pubblici
├── admin/           # dashboard, CSS e JavaScript amministrativi
├── docs/            # guide operative
├── languages/       # file di traduzione
└── .github/         # workflow di release

Gli asset pubblici vengono accodati soltanto quando WordPress esegue uno shortcode. Gli asset amministrativi sono caricati soltanto nelle pagine Lusi Permute.

Email

Lusi Permute usa wp_mail() e non conserva password SMTP. Configurare il trasporto con il provider o un plugin come WP Mail SMTP, Post SMTP o FluentSMTP, quindi usare Lusi Permute → Email → Invia email di test. Lo stato “Inviata a WordPress” non equivale a consegna finale. Vedere docs/email.md.

WhatsApp

Inserire il numero completo di prefisso internazionale, ad esempio +39 333 123 4567; il plugin lo normalizza in 393331234567. La modalità link richiede un clic, mentre la modalità Business API effettua una chiamata server reale. I placeholder disponibili sono documentati in docs/whatsapp.md.

Privacy e sicurezza

Il titolare del sito deve adattare l'informativa e i tempi di conservazione alla propria base giuridica. Il plugin si integra con Strumenti → Esporta dati personali e Strumenti → Cancella dati personali. Gli allegati usano nomi casuali e directory non indicizzabili; per documenti ad alta riservatezza è consigliata una protezione server o object storage privato. Vedere docs/privacy.md.

Aggiornamenti GitHub

L'updater interroga le release di frattomella/lusi-permute, ignora draft e prerelease per impostazione predefinita e cerca prima l'asset lusi-permute.zip. Solo in assenza dell'asset usa lo ZIP del tag. La risposta è memorizzata in cache per sei ore ed è controllabile da Lusi Permute → Stato sistema.

Il token GitHub è facoltativo per repository pubblici. Se configurato, non viene mostrato, esportato o registrato nei log.

Procedura di release

1. Aggiornare la versione nell'header plugin, nella costante LUSI_PERMUTE_VERSION, in readme.txt e in CHANGELOG.md.
2. Eseguire lint PHP e JavaScript e i test WordPress.
3. Creare commit e tag annotato, ad esempio v1.0.1.
4. Pubblicare branch e tag.
5. Il workflow .github/workflows/release.yml verifica che tag e versione coincidano, crea lo ZIP con cartella radice lusi-permute/, crea una release pubblica e carica lusi-permute.zip.
6. Verificare release, asset e rilevamento dalla pagina aggiornamenti WordPress.

Dettagli in docs/updates.md.

Sviluppo e controlli

find . -name '*.php' -not -path './vendor/*' -exec php -l {} \;
node --check public/js/lusi-permute.js
node --check admin/js/lusi-permute-admin.js

I test funzionali completi richiedono un'installazione WordPress con database e server email disponibili. La checklist è in docs/troubleshooting.md.

Licenza

GPL-2.0-or-later. Vedere LICENSE.