# Sostituire il Pulsante Aggiungi al Carrello negli Elenchi PrestaShop: installazione e configurazione > Presentazione Il modulo sostituisce il pulsante Aggiungi al carrello delle miniature prodotto (pagine categoria, ricerca, home, caroselli, prodotti correlati) con un pulsante che porta alla scheda prodotto. Lì il cliente… - Pagina: - Lingua: it - Aggiornato il: 2026-10-18 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dflistingbutton/index.md), [en](https://www.datafirefly.com/en/documentation/dflistingbutton/index.md), [es](https://www.datafirefly.com/es/documentation/dflistingbutton/index.md), [de](https://www.datafirefly.com/de/documentation/dflistingbutton/index.md), [pl](https://www.datafirefly.com/pl/documentation/dflistingbutton/index.md), [nl](https://www.datafirefly.com/nl/documentation/dflistingbutton/index.md), [pt](https://www.datafirefly.com/pt/documentation/dflistingbutton/index.md) - Indice: ## Presentazione Il modulo sostituisce il pulsante **Aggiungi al carrello** delle miniature prodotto (pagine categoria, ricerca, home, caroselli, prodotti correlati) con un pulsante che porta alla scheda prodotto. Lì il cliente sceglie peso, taglia o formato prima di aggiungere al carrello. Definite delle regole: quali prodotti sono interessati, quale testo mostra il pulsante e se il prezzo più basso delle combinazioni viene mostrato con «Da». ## Installazione 1. In **Moduli > Gestione moduli**, cliccate su **Carica un modulo** e inviate il file `dflistingbutton-1.0.0.zip`. 2. Il modulo crea le tabelle `ps_dflb_rule`, `ps_dflb_rule_lang`, `ps_dflb_rule_shop`, `ps_dflb_rule_category` e `ps_dflb_rule_product`, e aggiunge il menu **Catalogo > Pulsanti elenchi prodotti**. 3. Viene creata una regola di esempio disattivata, «Esempio: tutti i prodotti con combinazioni». Potete attivarla così com'è o eliminarla. 4. Dopo aver creato o attivato una regola, aprite una pagina categoria del negozio. Se il pulsante non compare, svuotate la cache in **Parametri avanzati > Prestazioni**. ## Creare una regola In **Catalogo > Pulsanti elenchi prodotti**, cliccate su **Aggiungi una regola**. Il modulo ha tre blocchi. ### Regola e destinazione - **Nome della regola**: nome interno, non visibile ai clienti. - **Attiva**: una regola disattivata viene ignorata. - **Priorità**: quando più regole corrispondono a un prodotto, vince quella con il numero più basso. Valore predefinito: 10. - **Si applica a**: _Tutti i prodotti_, _Categorie_ o _Prodotti specifici_. - **Categorie**: albero di caselle con campo filtro. Per questo tipo di regola è obbligatoria almeno una categoria. - **Includi sottocategorie**: sono inclusi anche i prodotti di tutte le sottocategorie delle categorie selezionate. - **Corrispondenza di categoria**: _Il prodotto è in una delle categorie_ (contano tutte le categorie associate al prodotto) o _Solo la categoria predefinita del prodotto_. - **Prodotti**: per il tipo _Prodotti specifici_, ricerca per nome, riferimento o ID. - **Condizione**: _Nessuna condizione_, _Prodotti con combinazioni_ o _Prodotti che usano un gruppo di attributi_. Con _Prodotti con combinazioni_, i prodotti semplici della stessa categoria mantengono il pulsante Aggiungi al carrello. - **Gruppo di attributi**: per l'ultima condizione, ad esempio Peso o Taglia. Sono interessati solo i prodotti con una combinazione che usa questo gruppo. - **Prodotti esclusi**: questi prodotti non ricevono mai il pulsante di questa regola, qualunque sia la destinazione. - **Associazione negozio**: in multinegozio, scegliete i negozi in cui si applica la regola. ### Pulsante - **Testo del pulsante**: un testo per lingua, ad esempio «Vedi tutti i pesi disponibili». Una lingua lasciata vuota riprende il primo testo inserito. - **Stile**: _Pulsante principale del tema_ (classi `btn btn-primary`), _Pulsante con bordo del tema_ (`btn btn-outline-primary`) o _Colori personalizzati_, con colore di sfondo, colore del testo e anteprima. - **Icona**: freccia, opzioni, bilancia, occhio o nessuna. - **Larghezza piena**: il pulsante occupa tutta la larghezza della miniatura. - **Classi CSS aggiuntive**: aggiunte al pulsante, utili per riprendere una classe del tema. - **Nascondi il selettore di quantità**: nasconde il campo quantità che alcuni temi mostrano negli elenchi. ### Prezzo negli elenchi Questo blocco riguarda solo i prodotti con almeno due combinazioni. - **Mostra il prezzo più basso delle combinazioni**: PrestaShop calcola il prezzo di ogni combinazione (imposte, gruppo del cliente, prezzi specifici e sconti compresi). Se il più basso differisce dal prezzo mostrato dal tema, lo sostituisce, e il prezzo precedente barrato e l'etichetta di sconto della miniatura vengono nascosti. - **Aggiungi il prefisso «Da»**: aggiunto davanti al prezzo solo se i prezzi delle combinazioni sono diversi e il prezzo mostrato è il più basso. Se disattivate l'opzione precedente e la combinazione predefinita non è la meno cara, il prefisso non viene mostrato, per non annunciare un prezzo errato. - **Testo del prefisso**: un testo per lingua («Da», «From», «Desde» ecc.). ## Esempio: formaggi e salumi venduti a peso 1. Nome: _Formaggi a peso_. Si applica a: _Categorie_. Selezionate _Formaggi e salumi_ e mantenete _Includi sottocategorie_. 2. Condizione: _Prodotti che usano un gruppo di attributi_, gruppo _Peso_. 3. Testo del pulsante: «Vedi tutti i pesi disponibili» in italiano, «Ver todas las opciones de peso» in spagnolo. 4. Mantenete attivi _Mostra il prezzo più basso_ e _Da_, poi salvate. Nella categoria, ogni formaggio venduto da 250 g, 500 g e 1 kg mostra «Da» seguito dal prezzo del 250 g e il pulsante verso la sua scheda. Un prodotto venduto a pezzo, senza combinazione di peso, mantiene il pulsante Aggiungi al carrello. ## Impostazioni generali La pagina di configurazione del modulo (pulsante **Impostazioni** sopra l'elenco delle regole) contiene: - **Attiva il modulo**: disattiva tutte le regole senza eliminarle. - **Rilevamento del tema**: _Automatico_ (consigliato), _Usa sempre la ricerca AJAX_ o _Solo hook_. Vedi la sezione successiva. - **Disattiva anche il link nativo di aggiunta al carrello**: svuota lato server l'URL di aggiunta al carrello dei prodotti interessati, tramite l'hook `actionPresentProductListing`. Alcuni temi mostrano allora un proprio link «Vedi prodotto»: se ottenete due pulsanti, lasciate questa opzione disattivata. - **Nascondi il pulsante Anteprima rapida**: solo sui prodotti interessati. - **Ignora le combinazioni esaurite per il prezzo più basso**: si applica quando la gestione delle scorte è attiva e il prodotto non accetta ordini senza disponibilità. Se tutte le combinazioni sono esaurite, vengono considerate tutte. ## Compatibilità con il tema ### Come il modulo individua i prodotti Durante la visualizzazione di una miniatura, il modulo viene eseguito negli hook `displayProductPriceBlock` e `displayProductListReviews`, richiamati dal tema Classic, da Hummingbird e dalla maggior parte dei temi. Per ogni prodotto interessato stampa un segnaposto invisibile. Lo script del modulo trova la miniatura che contiene il segnaposto, nasconde il pulsante carrello, il modulo di aggiunta al carrello che lo contiene e il selettore di quantità, poi inserisce il nuovo pulsante al posto di quello nascosto. Se il tema non mostra alcun pulsante carrello negli elenchi (caso del tema Classic), il pulsante viene inserito subito dopo il blocco prezzo. In modalità _Automatico_, se nessuna miniatura della pagina ha attivato questi hook, lo script invia gli ID dei prodotti visibili al controller del modulo, che restituisce quelli interessati (al massimo 60 prodotti per richiesta, solo prodotti attivi e visibili). Le miniature aggiunte dopo un filtro a faccette, un ordinamento o uno scroll infinito vengono gestite automaticamente. ### Selettori CSS Il blocco **Compatibilità tema (selettori CSS)** della configurazione contiene i selettori usati dallo script: - **Contenitore della miniatura prodotto**: blocco che racchiude un prodotto (`.product-miniature`, `.ajax_block_product` ecc.). - **Pulsante Aggiungi al carrello**: elementi sostituiti (`.add-to-cart`, `[data-button-action="add-to-cart"]` ecc.). - **Selettore di quantità**, **Prezzo**, **Prezzo precedente e sconto**, **Punto di inserimento**, **Pulsante Anteprima rapida**. Aggiungete le classi del vostro tema all'elenco, separate da virgole. Il pulsante **Ripristina i selettori predefiniti** riporta i valori originali. ### Personalizzare lo stile Il pulsante ha la classe `.dflb-btn`, più `.dflb-full` a larghezza piena e `.dflb-style-custom` con colori personalizzati (variabili `--dflb-bg` e `--dflb-color`). Il prefisso del prezzo ha la classe `.dflb-from`, e la miniatura elaborata riceve `.dflb-has-btn`. Con un tema molto personalizzato, provate su una copia del negozio: pagina categoria, ricerca, home e filtri a faccette. ## Cosa non modifica il modulo - il prodotto principale della scheda prodotto e la sua anteprima rapida; - il carrello, il processo d'ordine e l'account cliente; - i file del core e del tema (nessun override, nessun template modificato). ## Limiti noti - Il modulo cambia la visualizzazione degli elenchi. Non blocca un'aggiunta al carrello fatta in altro modo (link diretto, modulo di terze parti). - Il prezzo più basso e il prefisso vengono applicati nel browser. L'HTML originale e i dati strutturati del tema mantengono il prezzo della combinazione predefinita. - Oltre 150 combinazioni su uno stesso prodotto, solo le prime 150 servono al calcolo del prezzo più basso.