Gest Web Rent

Gest Web Rent e un plugin WordPress per noleggio veicoli configurabile come vetrina, sistema di richieste manuali o piattaforma di prenotazione online. Gestisce veicoli, foto, indisponibilita, contatti e un catalogo responsive con dettagli in overlay.

Il plugin non usa l'editor WordPress come esperienza principale per creare veicoli: la gestione e interna, con form custom e tabelle dedicate.

Requisiti

• WordPress 6.0 o superiore.
• PHP 7.4 o superiore.
• Nessuna dipendenza obbligatoria da WooCommerce, Elementor o plugin esterni.

Installazione da ZIP

Non scaricare lo ZIP automatico del branch GitHub, perche GitHub crea cartelle tipo gest-web-rent-main.

Usa invece:

bash scripts/build-zip.sh

Poi carica in WordPress:

build/gest-web-rent.zip

Lo ZIP corretto contiene:

gest-web-rent/
gest-web-rent/gest-web-rent.php

Admin

Menu principale:

Gest Web Rent

Sottomenu:

• Dashboard
• Veicoli
• Aggiungi veicolo
• Disponibilita
• Richieste informazioni oppure Prenotazioni, secondo la modalita attiva
• Documenti, Tariffe, Pagamenti e Comunicazioni in modalita Prenotazione online
• Condizioni di noleggio
• Impostazioni

La dashboard mostra riepilogo veicoli, veicoli attivi, veicoli in evidenza, blocchi futuri, stato WhatsApp/email e shortcode catalogo.

Modalita Operative

Dalla dashboard o da Gest Web Rent > Impostazioni puoi scegliere una sola modalita:

• Vetrina e richieste di informazioni: catalogo, disponibilita, dettaglio e contatti; nessuna prenotazione o pagamento viene creato.
• Richiesta di prenotazione: salva una richiesta Da valutare, invia le notifiche e non avvia pagamenti. Il blocco temporaneo del veicolo e opzionale e disattivato per impostazione predefinita.
• Prenotazione online: mantiene configuratore, prenotazioni, documenti e metodi di pagamento. Stripe resta opzionale e viene mostrato solo con configurazione valida.

Il cambio modalita non elimina prenotazioni, pagamenti, documenti o richieste gia presenti. Le funzioni non pertinenti non vengono registrate nel menu e gli URL amministrativi diretti mostrano un avviso sicuro.

Creare Un Veicolo

Vai in Gest Web Rent > Aggiungi veicolo.

Il form custom include:

• dati principali;
• prezzi;
• regole noleggio;
• servizi inclusi;
• dotazioni;
• descrizione e note;
• foto veicolo tramite Media Library;
• stato;
• evidenza;
• indisponibilita.

I veicoli sono salvati nella tabella custom wp_gwr_vehicles, non come post WordPress.

Condizioni Di Noleggio

Vai in Gest Web Rent > Condizioni di noleggio per configurare i valori globali di servizi inclusi ed esclusi, coperture, franchigie, deposito, conducente, documenti, carburante, chilometraggio, pagamento, cancellazione, ritiro, territorio, extra e FAQ.

Nel form di modifica del veicolo la sezione Condizioni di noleggio permette di ereditare ogni gruppo globale oppure conservarne una versione personalizzata. Gli extra possono essere associati a tutti i veicoli, a specifici ID o a categorie veicolo.

Le selezioni di extra e coperture entrano nel calcolo server-side e nello snapshot della prenotazione.

Prenotazioni

Dal configuratore frontend il cliente puo completare quattro step: veicolo ed extra, dati cliente/conducente, riepilogo e consensi, conferma. Il server ricalcola tariffa giornaliera, coperture, extra, supplementi e tasse senza fidarsi del totale JavaScript.

Le richieste vengono salvate in wp_gwr_bookings, con righe economiche in wp_gwr_booking_items e cronologia in wp_gwr_booking_logs. La creazione usa un lock MySQL per veicolo e una transazione che ricontrolla disponibilita, salva snapshot e righe e crea il blocco in wp_gwr_availability.

L area Gest Web Rent > Prenotazioni permette ricerca, filtri, paginazione, modifica controllata, transizioni di stato, consegna, riconsegna e stampa. Le richieste in attesa scadono secondo il valore configurato in Impostazioni e liberano il veicolo tramite WP-Cron.

La pagina con shortcode [gwr_booking_portal] offre un'area cliente protetta per stato, timeline, pagamenti, documenti, upload e richieste di modifica o annullamento. Le richieste non cambiano direttamente una prenotazione confermata e richiedono approvazione amministrativa.

Area Cliente E Comunicazioni

Il link cliente usa codice prenotazione e token casuale; nel database viene salvato soltanto l'hash. Il modulo di recupero invia un nuovo link con risposta pubblica neutra, rate limiting e rotazione del token.

La pagina Gest Web Rent > Comunicazioni gestisce mittente, template email, promemoria e coda. Un singolo evento WP-Cron processa batch limitati, retry e attività periodiche. WhatsApp usa esclusivamente link wa.me quando il numero è configurato.

Foto Veicolo

Nel form veicolo puoi selezionare piu immagini dalla Media Library, impostare la copertina, riordinare le immagini e rimuoverle. Le foto sono salvate in wp_gwr_vehicle_images.

Disponibilita

Le indisponibilita si gestiscono:

• dentro la scheda custom del veicolo;
• oppure dalla pagina Gest Web Rent > Disponibilita.

La tabella wp_gwr_availability salva periodi con:

• busy;
• maintenance;
• reserved;
• unavailable.

Tutti questi stati rendono il veicolo non disponibile nel catalogo quando le date richieste si sovrappongono.

Catalogo Frontend

Inserisci in una pagina:

[gwr_catalog]

Alias compatibile:

[gest_web_rent_catalog]

Il catalogo include:

• filtro date integrato;
• aggiornamento AJAX automatico al cambio date;
• filtri veicolo;
• card responsive a 2 colonne desktop e 1 colonna mobile;
• dettaglio veicolo in overlay/modal con blur;
• gallery foto;
• info noleggio complete;
• pulsanti WhatsApp/email con date selezionate.
• modulo informazioni o richiesta coerente con la modalita scelta.

Non esistono piu come esperienza pubblica centrale:

• calendario separato;
• scheda veicolo separata;
• pagina single veicolo;
• blocchi Gutenberg rigidi.

WhatsApp Ed Email

Configura in Gest Web Rent > Impostazioni:

• numero WhatsApp Business;
• email concessionario;
• nome concessionario;
• messaggio WhatsApp predefinito;
• oggetto email predefinito;
• corpo email predefinito;
• testo privacy/nota contatto;
• colore primario.

Il modal usa automaticamente le date selezionate nel catalogo.

Google Calendar

Google Calendar non e usato come sistema principale. Una integrazione stabile richiederebbe OAuth/API/service account e una configurazione Google Cloud non adatta a un plugin installabile con facilita.

La gestione principale resta interna e stabile. Una futura sincronizzazione Google Calendar potra essere aggiunta come modulo opzionale.

Aggiornamenti Da GitHub

Il plugin usa GitHub Releases della repository:

https://github.com/frattomella/gest-web-rent

L'updater cerca prima l'asset release gest-web-rent.zip; solo come fallback usa lo zipball GitHub e rinomina la cartella estratta in gest-web-rent.

Dalla dashboard Gest Web Rent e disponibile il box Aggiornamenti GitHub con il pulsante Controlla aggiornamenti GitHub: svuota le cache gwr_github_release_payload, gwr_github_release e update_plugins, forza wp_update_plugins() e rimanda alla dashboard con conferma. L'installazione dell'aggiornamento resta manuale dalla pagina Plugin di WordPress.

Versionamento

Ogni release deve aggiornare:

• header Version in gest-web-rent.php;
• costante GWR_VERSION;
• Stable tag in readme.txt;
• CHANGELOG.md.

Release corrente:

2.0.2