Side Cart — guida al laboratorio

Aggiornata a 0.1.0-alpha.57, 20 settembre2026. Versione di sviluppo; il collaudo beta resta aperto. Usare un sito WooCommerce di prova. Gli stack verificati comprendono WordPress6.8/WooCommerce10.6.0 e WordPress7.1.1/WooCommerce11.1.0, entrambi su PHP8.2.29. Sono documentati ordini browser classici e Blocks, ruoli nativi e ciclo di vita; non è una promessa per tutti gli hosting, temi o versioni PHP.

Prima configurazione

Apri HookSpark → Side Cart → Carrello e aspetto. Side Cart, pulsante flottante, apertura automatica, barra spedizione e suggerimenti sono disattivati per default. Scegli un modello e un punto di accesso, prova l’anteprima e pubblica una configurazione attiva quando sei pronto.

Salva bozza conserva il negozio invariato. Pubblica applica la configurazione validata. Ripristina precedente recupera quella pubblicata prima, senza cambiare prezzi, ordini o impostazioni fiscali WooCommerce. Se un campo non è valido, correggi l’errore indicato: i valori inseriti vengono conservati nella schermata.

Aspetto e anteprima

Essenziale usa righe classiche; Boutique dà più spazio a immagini e dettagli; Compatto concentra le informazioni per carrelli più lunghi. Pannello laterale e modale usano lo stesso carrello. La posizione laterale è configurabile. Il font deriva dal tema, senza un servizio font remoto aggiunto da Side Cart.

La preview usa dati simulati e lo stesso renderer del pannello. Controlla desktop, mobile, stato vuoto, errore e personalizzazioni lunghe. La preview non esegue acquisti né modifica il carrello reale; non sostituisce una prova sul sito.

In Testi, colori e dimensioni puoi modificare titolo, etichette checkout/continua acquisti, messaggio vuoto e informazioni su resi o assistenza. I campi vuoti mantengono i valori predefiniti. Testi semplici, senza HTML; massimo120caratteri per etichetta,240per informazione di servizio,500per relativo URL. Un link informativo richiede anche il testo e un indirizzo HTTP/HTTPS valido.

La larghezza desktop accetta320–960px, limitata allo spazio disponibile. La visibilità delle immagini mobile è configurabile, attiva per default. Imposta insieme sfondo/testo del pannello e sfondo/testo del pulsante checkout: le coppie esplicite devono raggiungere contrasto4,5:1. Il controllo non certifica l’accessibilità dell’intero tema.

Come aprire il carrello

Scegli un pulsante flottante, una posizione di menu classico, il blocco Link Side Cart o lo shortcode [hs_smart_cart]. Puoi mantenere un normale link alla pagina Carrello come alternativa. Side Cart non sostituisce automaticamente i pannelli del tema o del builder: scegli una superficie principale per evitare due aperture.

Per il pulsante flottante scegli destra o sinistra indipendentemente dal drawer. La distanza dal fondo accetta0–300px (default18), si aggiunge allo spazio della barra mobile Storefront e viene limitata nelle finestre basse. Usa questi controlli per evitare chat, banner o barre fisse; verifica il risultato nel negozio, perché l’anteprima mostra il pannello del carrello. Pubblica per applicare.

Apri dopo un’aggiunta riuscita è facoltativo. Funziona con le aggiunte native collaudate e con il modulo Woo che ricarica la pagina. Quest’ultimo usa un cookie funzionale hs_sc_added_ di massimo un minuto, senza contenuto del carrello o dati cliente. Se il browser lo blocca resta disponibile l’apertura manuale.

La visibilità può essere limitata alle superfici previste nell’editor. In Pagine escluse scegli fino a100pagine; può essere escluso anche Negozio. Pubblica per applicare la scelta. Carrello e checkout sono sempre esclusi dal pannello; i collegamenti manuali mantengono il percorso Woo nativo. Rimuovi una pagina dalle esclusioni e pubblica per riabilitarla.

Carrello vuoto

Quando non ci sono articoli, Scopri i prodotti porta al negozio WooCommerce. In Testi, colori e dimensioni puoi cambiare etichetta e URL, per esempio verso una collezione. Lascia i campi vuoti per i valori predefiniti; il link richiede un indirizzo HTTP/HTTPS completo. Anteprima vuota mostra il risultato senza navigare. Pubblica per applicarlo al negozio; il checkout resta disabilitato finché il carrello è vuoto.

Quantità, opzioni e recupero

Dopo una modifica di quantità usa Aggiorna quantità: finché la bozza differisce dal valore confermato non puoi proseguire dal pulsante checkout. Prezzi, sconti, tasse, disponibilità e limiti restano autorevoli sul server WooCommerce. Il carrello si riallinea dopo le risposte e gli aggiornamenti tra schede supportati.

Le personalizzazioni sono visibili nella riga. Con più dettagli puoi richiudere la sezione; la scelta viene conservata durante i ricalcoli della stessa riga. Prodotti con personalizzazioni diverse mantengono identità separate. La modifica di varianti o opzioni complesse direttamente nella riga non è inclusa: usa il configuratore prodotto per una nuova selezione.

Rimuovi cancella la sola riga selezionata. Annulla rivalida la possibilità di acquisto: può essere rifiutato se scorte, opzioni o sessione sono cambiate. Un prodotto esaurito viene indicato nel pannello e sulla riga; rimuovilo per continuare. Le scorte condivise vengono sommate per prodotto responsabile dell’inventario. Woo può correggere quantità e totali quando la disponibilità diminuisce. Provider inventario esterni richiedono prove dedicate.

Apri il campo coupon per inserire il codice. Un errore lascia il campo disponibile per la correzione. Puoi togliere singolarmente i coupon applicati. Il totale riflette la risposta Woo; prima di una destinazione sufficiente, una spedizione non determinabile non viene presentata come gratuita.

Se una richiesta non è confermata, i comandi di modifica vengono sospesi: usa Ricarica carrello per verificare lo stato prima di ripeterla. Se il problema persiste, Visualizza carrello completo offre il percorso Woo nativo. Non presumere che un’azione sia fallita soltanto perché il browser non ha ricevuto la conferma.

Spedizione gratuita e suggerimenti

La barra usa i metodi nativi WooCommerce: zona, destinazione, soglia e condizioni coupon. Può restare nascosta finché il premio non è determinabile; non è una promessa universale di spedizione gratuita. Per esempio, togliere un coupon o cambiare quantità può modificare la soglia o revocare il metodo gratuito. La barra rimane nascosta nei carrelli composti soltanto da prodotti digitali. I provider custom non sono automaticamente supportati.

Per i suggerimenti scegli fino a30candidati manualmente, nell’ordine di visualizzazione, oppure usa i cross-sell Woo. Sono mostrati al massimo3prodotti pertinenti; possono essere meno o nessuno. Quelli già presenti, non acquistabili o indisponibili vengono esclusi. Le relazioni non vengono presentate come statistiche di acquisto.

Per una variante scegli tutti gli attributi e attendi prezzo/disponibilità prima di aggiungere. Le combinazioni non disponibili non devono essere aggiunte. Se servono personalizzazioni obbligatorie, Scegli opzioni apre il prodotto. Il prezzo finale del carrello include le regole effettive; i consigli non aggiungono articoli automaticamente.

Plugin della gamma e lingua

Integrazioni mostra attivazione e collegamenti locali; la presenza di un plugin non certifica ogni combinazione. Product Options & Add-Ons gestisce configurazioni e supplementi, MinMax i vincoli, Pricing gli sconti, Messages i messaggi pertinenti. Evita due indicatori spedizione quando utilizzi anche Messages. Le prove economiche con versioni nominate sono nella scheda tecnica (FEATURE_SPEC.md).

La tab finale Plugin HookSpark presenta il catalogo condiviso; la visita non installa né attiva prodotti. Le azioni disponibili dipendono dai permessi e dallo stato del prodotto.

Le stringhe proprie sono disponibili in italiano e inglese. Il negozio segue la lingua del sito; l’admin quella del profilo. Contenuti merchant, nomi prodotti e stringhe Woo/tema/altri plugin usano i rispettivi contenuti e cataloghi. Le etichette personalizzate salvate non vengono tradotte automaticamente.

Diagnostica e disinstallazione

Inizia da qui mostra controlli su attivazione pubblicata, pagina checkout e carrelli nativi nei template dei temi a blocchi, pattern sincronizzati e widget attivi. L’analisi ha limiti di profondità e dimensione; non copre automaticamente builder o pattern dinamici. Una pagina pubblicata non prova che modulo e gateway funzionino; serve un ordine di prova. L’assenza di un blocco rilevato non esclude pannelli di builder, widget o altri plugin.

Rapporto tecnico è chiuso per default. Scarica diagnostica genera un file locale con versioni, stato plugin e controlli; non include dati cliente o token e non viene inviato automaticamente. Esaminalo prima di condividerlo con l’assistenza.

Disattivare Side Cart lascia prodotti, coupon e ordini a WooCommerce e conserva la configurazione. Riattivandolo torna quella pubblicata. Prima della rimozione definitiva sostituisci i suoi blocchi/shortcode nel tema con un link nativo. Per eliminare anche le impostazioni, apri Conservazione dei dati / Data retention, attiva la scelta e premi Pubblica / Publish. Salvare solo la bozza non cambia questa politica. Alla cancellazione del plugin vengono eliminate soltanto le impostazioni Side Cart (bozza, pubblicata e precedente); ordini, prodotti e dati WooCommerce restano. Conservazione predefinita e cancellazione opt-in sono state verificate nel laboratorio a sito singolo, senza certificare multisite.

Prova prima dell’uso

Su desktop e mobile prova aggiunta semplice e variante, opzioni richieste, quantità valida/non valida, coupon, rimozione/annullamento e checkout. Confronta importi e dettagli con l’ordine Woo usando un metodo di test senza pagamento reale. Verifica anche scorte esaurite e recupero dopo errore.

FEATURE_SPEC (FEATURE_SPEC.md) è la fonte degli stati; perimetro beta (BETA_SCOPE.md), prove ordini (BROWSER_ORDERS_ALPHA14.md), scorte (STOCK_LOSS_ACCEPTANCE.md), tasse/spedizione (TAXED_SHIPPING_ACCEPTANCE.md) e contratti sviluppatori (PUBLIC_EVENTS.md) descrivono evidenze e limiti. Non sono promessi compatibilità universale, checkout incorporato, editor campi o pagamento express: sono percorsi separati dal prodotto.

English guide.

Se una bozza salvata è malformata, l’editor recupera la configurazione pubblicata valida (o i valori iniziali disabilitati). La sola apertura non modifica i dati: pubblica una configurazione corretta per sostituirli. Un ripristino malformato viene rifiutato senza salvataggi parziali.

L’apertura automatica rispetta un altro dialog già visibile, per esempio il mini-carrello WooCommerce: i dati si aggiornano senza aprire un secondo pannello. Mantieni comunque una sola superficie principale del carrello.

Dati e privacy

Side Cart usa la sessione WooCommerce; non crea un archivio clienti o analytics proprio. Il segnale di autoapertura dopo aggiunta è un cookie funzionale di un minuto. La diagnostica è un download esplicito, senza invio automatico. Le immagini configurate nel negozio possono provenire da host esterni. Dati, durata e limiti verificati (PRIVACY_ALPHA46.md).

Modifiche da più schede

Side Cart coordina le schede partecipanti quando il browser dispone di Web Locks. Il plugin corrente coordina anche le sessioni native WooCommerce sul server, dalla lettura al salvataggio del carrello. Questa protezione richiede un singolo server database e una connessione conservata per tutta la richiesta; i gestori di sessione personalizzati restano esclusi. Dopo un timeout o un risultato incerto ricarica il carrello prima di una nuova modifica. Non equivale a certificare ogni provider cache, passaggio di autenticazione o integrazione esterna.

Aggiornamento incompleto

Se mancano file dopo un aggiornamento e WordPress non si avvia, ripristina l’intera cartella hs-smart-cart dal pacchetto verificato usando il gestore file del laboratorio o dell’hosting. Conserva una copia per diagnosi e il backup precedente di file e database. Non disinstallare per riparare: l’opzione pubblicata di cancellazione dati può eliminare le configurazioni. Dopo il ripristino verifica impostazioni, carrello e checkout. Il recupero dei soli file è stato provato su alpha52. In alpha57 è passato anche un ripristino isolato completo di file, database e media, con avvio WordPress, ordine conservato e media servito correttamente. Il plugin non fornisce un servizio automatico di backup.

Gli errori di servizio o di sessione richiedono Aggiorna carrello: quantità e coupon non sono automaticamente considerati non validi. La bozza della quantità può rimanere visibile, distinta dal valore confermato; applicala solo dopo aver riconciliato il carrello.

Saldo e coupon

Il prezzo unitario di catalogo distingue listino e saldo prima delle opzioni. È un riferimento separato dal totale della riga personalizzata. Quando applicato, il coupon mostra un importo riga prima dei coupon; il totale riga resta quello calcolato da WooCommerce. Le promozioni della suite compaiono nei dettagli forniti da Pricing. Nell’anteprima scegli «Saldo e coupon» per vedere un esempio simulato: non applica promozioni al negozio.

Se WordPress rifiuta il salvataggio della bozza o la pubblicazione, Side Cart mostra un errore e conserva i campi inseriti per riprovare. Un ripristino non riuscito mostra un messaggio distinto: il comando Ripristina precedente non salva le modifiche non salvate nel modulo.

Valori iniziali

Questi sono i default del plugin, non necessariamente i valori già salvati nel negozio.

Tre prove pratiche di configurazione

Boutique con suggerimenti selezionati

Nel negozio di prova conserva un link al carrello nativo. Scegli Boutique e pannello laterale, poi una posizione menu oppure inserisci il blocco link Side Cart. Per i suggerimenti scegli due prodotti semplici disponibili, non già nel carrello. Salva la bozza e controlla le anteprime desktop/mobile; i suggerimenti dell’anteprima sono esempi, quindi verifica quelli selezionati nel negozio dopo la pubblicazione. Aggiungi un prodotto diverso e apri Side Cart: devono comparire i candidati idonei, fino a tre. Aggiungine uno e controlla che diventi una riga e scompaia dai suggerimenti. Se non compare nulla, verifica acquistabilità, scorte, contenuto del carrello e opzioni obbligatorie prima di cambiare selezione.

Prodotto digitale personalizzato con coupon

Usa un prodotto virtuale di prova da30€, un’opzione obbligatoria da5€ per articolo e un coupon valido del10%. Per questo esempio numerico, tasse e spedizione devono essere disattivate soltanto nell’ambiente di prova dedicato. Aggiungi due unità con l’opzione compilata: subtotale70€, totale dopo coupon63€. Togliendo il coupon deve tornare70€. Due valori di personalizzazione diversi devono produrre righe distinguibili. Rimuovine una e usa Annulla: controlla anche la personalizzazione ripristinata, oltre all’importo. Se i totali differiscono, controlla regole Pricing, tasse e restrizioni del coupon; Side Cart non ha un prezzo da correggere manualmente. Verifica gli stessi dettagli in un ordine di prova prima di accettare l’integrazione nel tuo negozio.

Spedizione gratuita nativa con destinazione nota

Usa un prodotto fisico e un metodo gratuito nativo WooCommerce applicabile in una zona di prova. Attiva il progresso spedizione e pubblica. Prima controlla il carrello senza destinazione: un indicatore nascosto è corretto se Side Cart non può determinare un metodo applicabile. Inserisci la destinazione nel carrello o checkout nativo, torna a una pagina con Side Cart attivo e ricarica il carrello. Prova quantità sotto e sopra la soglia configurata. Se il metodo richiede un coupon, prova con e senza un codice idoneo. Accetta il risultato solo se il checkout nativo offre lo stesso beneficio: la barra da sola non dimostra che la spedizione sia gratuita.

Quando il risultato non è quello atteso

Cache delle pagine e recupero sessione

Memorizza soltanto pagine pubbliche anonime. Escludi carrello, checkout, account, percorsi Store API WooCommerce e richieste POST. Salta la cache per utenti autenticati e cookie carrello/sessione WooCommerce, inclusi wp_woocommerce_session_*, woocommerce_items_in_cart e woocommerce_cart_hash. Rispetta le intestazioni private/no-store e non inviare mai a un altro visitatore intestazioni Set-Cookie memorizzate. Applica le esclusioni sia agli URL REST leggibili sia a quelli con ?rest_route=.

Dopo la configurazione prova due sessioni browser indipendenti: aggiungi quantità diverse e controlla che ciascun carrello e checkout mantenga il proprio totale. Se l’autorizzazione della sessione è scaduta, premi Aggiorna carrello, controlla lo stato confermato e ripeti esplicitamente la modifica desiderata. Non ripetere automaticamente acquisti o modifiche al carrello.

Alpha57 ha superato una prova locale di cache condivisa con carrelli separati, nonce Woo realmente scaduto e recupero esplicito. La prova verifica questa configurazione, non ogni CDN o provider di cache.