Checklist di compatibilità dei temi per app B2B di Shopify: come testare prima di installare

Provi un'app B2B di Shopify su un duplicato del tema prima che tocchi quello live. Verifichi che il tema usi template JSON, attivi l'app embed, aggiunga gli eventuali blocchi dell'app, poi faccia passare un ospite, un cliente con tag e un cliente senza tag su ogni pagina che l'app modifica.

Ultimo aggiornamento: 4 ottobre 2026. I dati su Shopify provengono dalle pagine linkate nel testo, lette in quella data. I dati su BSS provengono dalle guide utente su docs.bss-b2b.solutions e dalla nostra revisione delle app di ottobre 2026. BSS B2B Solutions sviluppa BSS B2B Solution, Lock e Quote. Questa checklist vale per qualsiasi app B2B. Fa parte della nostra guida completa a Shopify B2B; per scegliere un tema anziché testarne uno, consulti la guida ai temi B2B di Shopify.

Che cosa significa compatibilità con il tema per un'app B2B?

Un'app B2B modifica prezzi, pulsanti, moduli e pagine in tre modi. Un app embed carica uno script per tutto il tema. Un app block è un blocco che si aggiunge a un template nell'editor del tema. Alcune app scrivono codice nei file del tema. Ognuno fallisce in modo diverso: un embed disattivato non mostra nulla, un blocco non si può aggiungere a un template legacy, e il codice scritto può essere sovrascritto da un aggiornamento del tema.

Shopify indica che i blocchi dell'app richiedono template JSON (shopify.dev). Per verificare il suo, apra Negozio online, Temi, Modifica codice e guardi nella cartella templates. I file che terminano con .json sono template JSON. Un tema in cui i template di prodotto e collezione sono file .liquid è un tema legacy, e lì i blocchi dell'app non funzionano.

Come ogni app BSS interviene sul tema

App	Come raggiunge il tema	Requisiti e note per il tema
BSS B2B Solution	Un app embed chiamato B2B Solution carica gli script della vetrina. Alcuni moduli richiedono anche snippet di prezzo da aggiungere ai template di prodotto, collezione e carrello	L'embed è per tema. I temi Online Store 2.0 funzionano con blocchi ed embed. I temi legacy possono richiedere uno snippet manuale. La documentazione elenca 13 temi Online Store 2.0 e 28 temi a pagamento come supportati
BSS B2B Lock	Scrive snippet Liquid nel suo tema e modifica layout/theme.liquid e i file di prodotto, prezzo e modulo, così le regole si applicano quando Shopify genera la pagina. Un secondo app embed gestisce i pop-up con codice di accesso, la richiesta di accesso e il nascondere i pulsanti di pagamento accelerato	L'installazione automatica funziona sui temi gratuiti. I temi a pagamento possono richiedere l'installazione manuale. Le vetrine headless non sono supportate
BSS B2B Quote	Le pagine di Quick Order scrivono una sezione e un template di pagina nel tema live. La tabella varianti è un blocco dell'app nel template di prodotto. I pulsanti di preventivo arrivano dall'app embed	Quick Order e la tabella varianti richiedono un template di prodotto o di pagina Online Store 2.0. Quote ha 63 preset di tema e, per i temi che non riconosce, usa il preset Dawn o Horizon

BSS B2B Solution

Tutto si carica da un unico embed nel target head. Se è disattivato, non compare «nessuno» dei prezzi, delle tabelle, dei moduli o dei messaggi, anche con le regole salvate. Pubblicare un tema nuovo o un duplicato non trasferisce l'impostazione (guida). L'app verifica anche Online Store 2.0 cercando i template JSON di prodotto, collezione, carrello e home. L'elenco dei temi supportati indica i temi in cui l'installazione è automatica e precisa che il team può personalizzare l'integrazione per un tema non elencato. Verifichi questi punti: con le regole attive l'app nasconde Buy it now, e i carrelli a scomparsa e le anteprime rapide possono richiedere selettori CSS manuali.

BSS B2B Lock

Lock non funziona solo tramite l'app embed. Per applicare le regole in modo corretto installa codice nel tema, e la guida consiglia di installare prima su un tema di prova. Nella scheda Installation scelga Install to TEST (Draft) oppure Install to LIVE. Se i blocchi funzionano già, non ripeta l'installazione automatica, perché può causare incompatibilità. Lock è testato su temi gratuiti come Dawn, Ride, Horizon e Spotlight, e può funzionare solo in parte sui temi a pagamento (guida all'installazione).

Il codice resta nel tema, quindi pianifichi anche l'uscita. Prima di disinstallare o cambiare tema, apra Theme Cleanup e clicchi su Disable all rules. Può rimanere uno snippet inattivo, e il supporto può rimuovere tutti i file su richiesta (guida a Theme Cleanup). La nostra guida alla disinstallazione di un'app B2B o Lock elenca ogni passo per rimuovere il codice del tema rimasto.

BSS B2B Quote

Pubblicare una pagina Quick Order aggiunge i suoi file al tema che è live in quel momento. Un tema nuovo non li riceve automaticamente. In Advanced Settings, Theme installation seleziona un tema qualsiasi, vede il suo stato (Installed, Needs update o Not installed) e clicca Install, così può preparare un duplicato prima che vada live (guida). La pagina richiede un tema Online Store 2.0. La tabella varianti è un blocco dell'app, «BSS Product Page Variant Table», che si aggiunge al template di prodotto, e la vetrina live la mostra dal piano Business in su. Per i pulsanti di preventivo su un tema molto personalizzato o a pagamento possono servire l'installazione manuale o l'aiuto del supporto (FAQ di Quote).

La checklist di compatibilità del tema

Prima di installare

• ☐ Annoti nome e versione del tema, e se è gratuito, a pagamento o personalizzato.
• ☐ Apra Modifica codice e verifichi che i template di prodotto, collezione, carrello e index siano .json.
• ☐ Verifichi se il tema è nell'elenco supportato dall'app e annoti ogni personalizzazione: carrello a scomparsa, anteprima rapida, snippet di prezzo personalizzati.
• ☐ Duplichi il tema, gli dia un nome chiaro e lasci l'originale intatto.
• ☐ Crei clienti di prova: uno con il tag per i clienti all'ingrosso e uno senza. Usi una finestra privata per simulare un ospite.

Installazione sul duplicato

• ☐ Installi l'app, poi apra l'editor del tema per il duplicato e attivi l'app embed.
• ☐ Aggiunga i blocchi dell'app dove servono: tabella varianti nel template di prodotto.
• ☐ Per Lock, scelga Install to TEST (Draft) e selezioni il duplicato. Per Quote, usi Theme installation e installi sul duplicato.
• ☐ Visualizzi l'anteprima del duplicato e verifichi che l'editor si carichi ancora senza errori.

Verifichi ogni superficie

Superficie	Verifica	Perché fallisce su alcuni temi
Pagina prodotto	Prezzo, Add to cart, Buy it now, campo quantità, tabella dei volumi	Markup di prezzo personalizzato o sezioni che l'app non trova
Griglia collezione e ricerca	Prezzi e badge su ogni scheda	Temi con snippet di scheda propri
Anteprima rapida e carrello a scomparsa	Prezzi e regole dentro il pop-up	Possono richiedere selettori CSS manuali
Pagina carrello	Messaggio di limite d'ordine	Blocco dell'app mancante nel template del carrello
Accesso e registrazione	Il modulo si visualizza, il messaggio di accesso rimanda alla pagina giusta	Template dell'account modificati dal tema
Pagine e prezzi bloccati	L'ospite vede il messaggio di blocco, il cliente con tag vede i contenuti	File del tema non aggiornati dall'installazione
Quick Order e pulsante preventivo	La pagina si carica, la ricerca funziona, il caricamento CSV e il modulo di preventivo si aprono	Template legacy o file mancanti in questo tema
Mobile	Tutto quanto sopra a larghezza smartphone	Layout ed elementi fissi si sovrappongono
Editor del tema	L'editor si carica e si possono modificare le sezioni	Lock può essere disattivato nell'editor dalle sue impostazioni

Prima di andare live

• ☐ Confronti il duplicato con l'originale sullo stesso prodotto, la stessa collezione e lo stesso carrello.
• ☐ Verifichi che il checkout funzioni con un ordine di prova. Shopify suggerisce di testare come cliente di prova con il suo gateway di pagamento di test (Shopify Help Center).
• ☐ Pubblichi il duplicato, poi attivi l'app embed nel tema live e ripeta lì i passi di installazione per Lock e Quote.
• ☐ Conservi il vecchio tema per un periodo di ripristino. Sappia dove si trova Theme Cleanup.
• ☐ Dopo ogni aggiornamento del tema, ripeta la matrice di test.

Se il suo tema non è nell'elenco

Un tema fuori dall'elenco testato è un caso da verificare, non un rifiuto. Esegua la checklist, annoti quali superfici non funzionano e mandi al supporto il nome del tema, un URL di prodotto e uno screenshot. La documentazione BSS indica che il team può personalizzare l'integrazione per un tema non completamente supportato. Se sta ancora scegliendo un tema, legga la guida ai temi B2B di Shopify e, per le opzioni specifiche per il B2B, veda i temi B2B di Shopify.

Cosa non dichiariamo

• Non dichiariamo che una qualsiasi app BSS funzioni con tutti i temi.
• Non abbiamo verificato le vetrine headless o Hydrogen. Le app dipendono dal tema, dal suo embed e da Liquid, quindi consideri l'headless non supportato, salvo diversa indicazione del supporto.
• Un esito positivo oggi non copre un futuro aggiornamento del tema.

Compatibilità dei temi per le app B2B di Shopify: domande frequenti

Prossimi passi

Scelga l'app che vuole provare, duplichi il tema ed esegua la checklist qui sopra. La checklist di configurazione inserisce questa verifica nella configurazione completa in dieci passi. Casi d'uso correlati: nascondere i prezzi all'ingrosso ai visitatori ospiti e tabella varianti nella pagina prodotto. L'hub sul controllo degli accessi e l'hub su quick order e RFQ trattano Lock e Quote.

Fonti

Pagine Shopify lette il 4 ottobre 2026. Dati BSS: guide utente BSS su docs.bss-b2b.solutions e nostra revisione di ottobre 2026 del comportamento delle app.

• Shopify Help Center: Duplicare i temi
• shopify.dev: App blocks
• Shopify Help Center: Testare l'esperienza del cliente B2B
• Guida utente BSS B2B Solution: elenco dei temi supportati
• Guida utente BSS B2B Solution: Attivare o disattivare l'app nel tema
• Guida utente BSS B2B Lock: Installare e aprire BSS B2B Lock
• Guida utente BSS B2B Lock: Theme Cleanup
• Guida utente BSS B2B Quote: Installare Quick Order su un tema

• Facebook
• Twitter
• LinkedIn
• Pinterest