Hai aggiornato il tema Shopify, o qualcuno l’ha fatto per te, e ora qualcosa ha un aspetto o un funzionamento diverso. Forse è sparita una sezione, il layout non è più a posto, manca una funzionalità personalizzata o il carrello non si comporta più come prima.
I sintomi tipici sono:
- sezioni o blocchi personalizzati mancanti
- colori, font o spaziature cambiati
- una funzionalità aggiunta da uno sviluppatore non funziona più
- un widget di un’app, come le recensioni o la guida alle taglie, è sparito
- il carrello o il pulsante "aggiungi al carrello" si comporta in modo diverso
- le pagine si vedono bene da desktop ma non da mobile
La buona notizia è che in Shopify l’aggiornamento di un tema di norma non distrugge il tema precedente. Nella maggior parte dei casi la versione precedente è ancora nella tua libreria temi, e puoi tornare a usarla mentre capisci cosa è cambiato.
Questa guida spiega come funzionano in generale gli aggiornamenti dei temi, perché le personalizzazioni potrebbero non essere riportate, come ripristinare la versione precedente in sicurezza e come evitare lo stesso problema la prossima volta.
Come funzionano gli aggiornamenti dei temi Shopify?
Un tema Shopify è un insieme di template, sezioni, impostazioni e codice che controlla l’aspetto e il comportamento del tuo negozio.
Quando un tema dello Shopify Theme Store ha una nuova versione, di solito Shopify ti permette di aggiungere la versione aggiornata alla libreria temi invece di sovrascrivere il tema che stai usando. I passaggi esatti possono variare a seconda del tema e di come Shopify presenta gli aggiornamenti in quel momento, ma l’idea generale è questa:
- l’aggiornamento arriva come una nuova copia del tema
- le impostazioni fatte nell’editor del tema in genere vengono riportate dove possibile
- le modifiche fatte direttamente al codice del tema in genere non vengono riportate
- il tema attuale resta nella libreria finché non lo rimuovi
Ecco perché un aggiornamento può sembrare rotto anche se non è andato "perso" niente: la nuova versione semplicemente non include il codice personalizzato aggiunto a quella vecchia.
I temi acquistati da altre fonti, o i temi personalizzati realizzati da uno sviluppatore, potrebbero non aggiornarsi affatto in questo modo. Potrebbero dover essere aggiornati a mano, file per file.
Perché il tema si è rotto dopo l’aggiornamento?
Il codice personalizzato non è stato riportato
Se uno sviluppatore, un’agenzia o un’app ha modificato i file del tema, quelle modifiche esistono solo nella vecchia versione. Esempi comuni:
- sezioni o snippet personalizzati
- modifiche alla pagina prodotto o al carrello
- codice di tracciamento o di analytics
- piccole correzioni di stile
- codice aggiunto da un’app durante l’installazione
La nuova versione parte dal codice originale dello sviluppatore del tema, quindi queste modifiche mancano.
Sezioni e impostazioni sono cambiate nella nuova versione
Gli sviluppatori dei temi a volte rinominano, uniscono o rimuovono sezioni e impostazioni da una versione all’altra. Un’impostazione su cui facevi affidamento potrebbe ora funzionare in modo diverso o non esistere più. I contenuti legati a una sezione rimossa potrebbero non comparire.
App embed e app block vanno riattivati
Molte app aggiungono funzionalità tramite app embed o app block nell’editor del tema. Su una nuova versione del tema, alcuni potrebbero dover essere riattivati o inseriti di nuovo nella sezione giusta.
Le app più vecchie che inserivano codice direttamente nei file del tema potrebbero non comparire affatto nella nuova versione, perché quel codice faceva parte del vecchio tema.
L’aggiornamento è stato pubblicato subito
Se il tema aggiornato è stato pubblicato prima che qualcuno lo controllasse, i clienti vedono subito i problemi. È il motivo più comune per cui un aggiornamento di routine diventa urgente.
Prima di tutto, scopri cosa è cambiato
Prima di modificare qualsiasi altra cosa, rispondi a queste domande:
- Quando è stato aggiornato il tema, e da chi?
- La nuova versione è stata pubblicata o è ancora non pubblicata?
- La versione precedente è ancora nella libreria temi?
- Cosa è rotto esattamente: una pagina, una sezione, una funzionalità, il carrello?
- Il problema si verifica da desktop, da mobile o su entrambi?
- Il vecchio tema era stato personalizzato con codice, da uno sviluppatore o da app?
Se l’aggiornamento l’ha fatto qualcun altro, chiedigli quale versione ha installato e se sapeva del codice personalizzato nel vecchio tema.
Cosa puoi provare in sicurezza?
Vai alla libreria temi
Vai su Online Store → Themes (Negozio online → Temi). Vedrai il tema attuale (pubblicato) e una libreria di altri temi. Cerca la versione precedente: spesso ha lo stesso nome con un numero di versione o una data diversa.
Visualizza l’anteprima della versione precedente
Visualizza l’anteprima della vecchia versione prima di fare qualsiasi cosa. L’anteprima non cambia ciò che vedono i clienti. Verifica che abbia ancora l’aspetto e il funzionamento che ti aspetti, carrello compreso.
Pubblica la versione precedente se serve
Se il negozio è chiaramente rotto e la vecchia versione funziona, pubblicarla è di solito il modo più rapido per ripristinare il negozio per i clienti. Poi puoi lavorare con calma sulla nuova versione, non pubblicata.
Prima di pubblicare, pensa a eventuali modifiche fatte nella nuova versione dopo l’aggiornamento, come nuovi contenuti nelle sezioni o nuove impostazioni. Quelle modifiche potrebbero non esistere nella vecchia versione. Annotale per poterle riapplicare in seguito.
Controlla app embed e app block
Apri l’editor del tema a cui manca una funzionalità di un’app e controlla la sezione degli app embed. Se l’embed di un’app è disattivato, attivarlo potrebbe far tornare la funzionalità. Alcune app richiedono anche di reinserire il loro blocco in una sezione specifica.
Tieni entrambe le versioni
Non cancellare la vecchia versione. Contiene il codice personalizzato da riportare nella nuova. Tienila nella libreria finché la nuova versione non è completa e testata.
Cosa dovresti evitare di fare?
Evita di:
- cancellare il vecchio tema dalla libreria
- modificare il codice del tema pubblicato senza un duplicato
- installare un altro aggiornamento sopra uno che non funziona
- disinstallare app per "fare pulizia" prima di sapere cosa fanno
- copiare file dal vecchio tema al nuovo senza capirli
- dare per scontato che la vecchia versione si aggiorni di nuovo da sola più avanti
Cambia una cosa alla volta e visualizza l’anteprima di ogni modifica prima di pubblicare.
Come evitarlo la prossima volta?
Un aggiornamento del tema va trattato come qualsiasi altra modifica a un negozio online:
- Prima duplica. Prima di modificare il codice o applicare un aggiornamento, crea un duplicato del tema pubblicato. Non costa nulla e ti dà una soluzione di riserva pulita.
- Tieni traccia del codice personalizzato. Un breve elenco di cosa è stato modificato, dove e perché rende gli aggiornamenti molto più semplici.
- Aggiorna nella libreria, non sul tema pubblicato. Aggiungi la nuova versione, lasciala non pubblicata e controllala con attenzione.
- Riapplica le personalizzazioni alla nuova versione prima di pubblicarla.
- Testa i percorsi importanti: homepage, collezione, pagina prodotto, carrello, avvio del checkout, visualizzazione da mobile.
- Pubblica in un momento tranquillo e tieni la vecchia versione per un po’, nel caso ti serva.
Quando conviene chiedere supporto tecnico?
È una buona idea farsi aiutare quando:
- il vecchio tema contiene codice personalizzato e non sai cosa fa
- sono coinvolti il carrello, l’avvio del checkout o le opzioni dei prodotti
- app che prima funzionavano non compaiono più
- la versione precedente non è nella libreria
- ti servono le funzionalità della nuova versione ma anche le vecchie personalizzazioni
- il tema è realizzato su misura o non proviene dal Theme Store
- hai già provato qualche modifica e non sai in che stato si trova il tema
Non serve sapere esattamente cosa si è rotto prima di chiedere aiuto.
Quali informazioni conviene raccogliere?
Tra i dettagli utili:
- l’URL del tuo negozio
- il nome del tema e i numeri della vecchia e della nuova versione
- quando è stato fatto l’aggiornamento e da chi
- se la nuova versione è pubblicata
- cosa non funziona, con screenshot
- un elenco delle personalizzazioni note e delle app che interagiscono con il tema
Se qualcuno deve lavorare sul tuo tema, aggiungilo come membro dello staff o collaboratore dall’admin di Shopify. Non inviare la password dell’admin via email.
Come può aiutarti D4Hub
D4Hub può aiutarti a:
- individuare l’ultima versione funzionante e ripristinarla in sicurezza
- confrontare la vecchia e la nuova versione del tema per trovare il codice personalizzato
- riportare le personalizzazioni nella nuova versione
- riattivare e posizionare app embed e app block
- testare pagina prodotto, carrello e avvio del checkout sulla nuova versione
- documentare le personalizzazioni per rendere più semplici gli aggiornamenti futuri
- impostare un processo più sicuro per gli aggiornamenti del tema
Puoi chiedere supporto in qualsiasi momento, sia che ti serva solo aiuto per trovare la versione giusta sia che tu voglia far gestire tutto l’aggiornamento.
Apri un ticket di supportoPer chi vuole fare da sé: confrontare e ripristinare le versioni del tema
Questi passaggi sono pensati per chi ha dimestichezza con l’editor del tema e l’editor di codice di Shopify. Lavora sempre su un duplicato, mai sul tema pubblicato, e tieni la vecchia versione finché la nuova non è stata testata del tutto.
Duplica prima di ogni altra cosa
In Online Store → Themes (Negozio online → Temi), usa il menu delle azioni del tema pubblicato per duplicarlo. Fai lo stesso con ogni versione che stai per modificare. Un duplicato è la tua rete di sicurezza.
Puoi anche scaricare una copia dei file del tema dal menu delle azioni del tema. Shopify invia il file via email all’account, così hai una copia offline.
Trova il codice personalizzato nella vecchia versione
Apri l’editor di codice della vecchia versione (dal menu delle azioni del tema, scegli di modificare il codice). Cerca:
- file che non esistono nella nuova versione, spesso nelle cartelle sections e snippets
- file con nomi che richiamano un’app o una funzionalità personalizzata
- modifiche recenti: l’editor di codice ti permette di vedere le versioni precedenti di un file, il che aiuta a individuare cosa è stato modificato
Fai un elenco dei file e delle modifiche che trovi prima di spostare qualsiasi cosa.
Confronta i file tra le versioni
Per un confronto più affidabile, scarica entrambe le versioni e confronta i file sul tuo computer con uno strumento di confronto file. Gli sviluppatori che usano Shopify CLI possono scaricare ogni tema in locale per confrontarli. Le differenze nei file che sai essere stati personalizzati sono quelle da riportare.
Non copiare file interi dalla vecchia versione nella nuova. Un file può contenere anche modifiche dello sviluppatore del tema da cui la nuova versione dipende. Copia solo le parti personalizzate e visualizza l’anteprima dopo ogni modifica.
Controlla app embed e app block
Sulla nuova versione, apri l’editor del tema e:
- Controlla la sezione degli app embed e attiva quelli che servono alle tue app.
- Controlla le sezioni in cui comparivano gli app block e aggiungili di nuovo dove serve.
- Visualizza l’anteprima della pagina prodotto, del carrello e di ogni pagina in cui le app mostrano contenuti.
Testa prima di pubblicare
Visualizza l’anteprima della nuova versione e testa:
- homepage, una pagina collezione e una pagina prodotto
- opzioni e varianti dei prodotti
- aggiunta al carrello, pagina o pannello del carrello e avvio del checkout
- mobile e desktop
- ogni funzionalità che si basava su codice personalizzato o su app
Pubblica solo quando tutto questo funziona. Tieni la vecchia versione nella libreria per un po’ di tempo anche dopo.
Domande frequenti
L’aggiornamento ha cancellato il mio vecchio tema?
Di solito no. Per i temi dello Shopify Theme Store, l’aggiornamento viene normalmente aggiunto come versione separata nella libreria temi, e la vecchia versione resta lì a meno che qualcuno non la rimuova.
Perché mancano le mie personalizzazioni?
Le modifiche fatte direttamente nel codice del tema in genere non vengono riportate in una nuova versione del tema. Le impostazioni fatte nell’editor del tema di solito sì, se la nuova versione le supporta.
Posso semplicemente tornare alla vecchia versione?
Nella maggior parte dei casi sì. Visualizza l’anteprima della versione precedente, verifica che funzioni e pubblicala. Prima annota le modifiche fatte nella nuova versione, perché potrebbero non esistere in quella vecchia.
Devo per forza aggiornare il tema?
Gli aggiornamenti possono portare correzioni, nuove funzionalità e compatibilità con le novità di Shopify, quindi conviene tenere i temi ragionevolmente aggiornati. L’approccio più sicuro è aggiornare nella libreria, riapplicare le personalizzazioni e testare prima di pubblicare.
Il widget di un’app è sparito dopo l’aggiornamento. L’app è rotta?
Probabilmente no. Controlla app embed e app block nell’editor del tema della nuova versione. Alcune app vanno riattivate o reinserite dopo un cambio di tema.
D4Hub può aggiornare il mio tema senza perdere le personalizzazioni?
D4Hub può confrontare le versioni, riportare il tuo codice personalizzato e testare la nuova versione prima che vada online. L’obiettivo è che i clienti vedano il tema aggiornato solo quando funziona come previsto.