← Tutti gli articoli

Modernizzazione di WordPress testata su un negozio WooCommerce datato

Modernizzazione di WordPress testata su un negozio WooCommerce datato

La modernizzazione di WordPress può essere incrementale, secondo un esperimento di Kinsta condotto su un negozio WooCommerce di tre anni. Il negozio online appariva normale ai visitatori, con prodotti funzionanti, navigazione del catalogo e un theme già configurato, ma un audit più approfondito ha rilevato dipendenze obsolete, messaggi ripetuti nei log degli errori, un aggiornamento del database di WooCommerce in sospeso e un PHP fatal error nell’integrazione del theme con Elementor. Kinsta ha analizzato il sito con Claude Code, Visual Studio Code tramite SSH e uno staging environment, senza ricostruire il negozio né sostituire le sue funzioni di commercio elettronico.

L’installazione di test vendeva prodotti di bellezza e per capelli e utilizzava WooCommerce con Astra, Elementor, CartFlows e altri plugin per la presentazione dei prodotti, i moduli e il checkout. La configurazione registrata indicava WordPress 7.1.4, PHP 8.2.35, Astra 4.1.5, Elementor 3.18.3, WooCommerce 8.5.5 e CartFlows 2.1.5. Quindici plugin erano attivi e per 14 erano disponibili aggiornamenti. Non erano presenti child theme o plugin personalizzati, quindi la maggior parte del comportamento del sito dipendeva da componenti di terze parti e dalle relative impostazioni.

Kinsta si è collegata inizialmente allo staging tramite SSH, un metodo per accedere da remoto ai file e ai comandi di un sito, usando Visual Studio Code. Claude Code è stato installato nell’editor e autorizzato a esaminare i file di WordPress, eseguire comandi WP-CLI, cioè strumenti a riga di comando per gestire WordPress, e analizzare l’installazione. Prima di apportare modifiche, il team ha eseguito il backup dello staging e registrato impostazioni, risposte delle pagine e log degli errori come baseline. L’istruzione iniziale era di sola lettura: individuare dipendenze obsolete, problemi di compatibilità, errori ricorrenti e miglioramenti incrementali, senza modificare file, aggiornare plugin o cambiare il database.

L’audit ha scoperto diversi problemi che non erano visibili durante la normale navigazione. Starter Templates scriveva ripetutamente messaggi nel log degli errori PHP e caricava un file JavaScript di anteprima del template da 6,5 KB sulle pagine pubbliche. Dal database venivano caricate automaticamente circa 2,9 MB di opzioni, con due opzioni contenenti dati della documentazione che costituivano la maggior parte del totale. La versione del database WooCommerce memorizzata era la 7.7.0, precedente alla versione 8.5.5 del plugin installato. CartFlows aveva registrato 122 errori per un’azione di aggiornamento della knowledge base e diversi plugin, insieme al theme Astra, erano indietro di più release rispetto agli aggiornamenti disponibili.

Invece di aggiornare tutto in una volta, Kinsta ha selezionato una modifica che poteva essere isolata e misurata. Starter Templates aveva già svolto il suo scopo originale, cioè importare design predefiniti, e il negozio esistente non aveva bisogno di usarlo per visualizzare le proprie pagine. L’analisi ha ricondotto tutte le 281 righe presenti in cinque log degli errori campionati alla stessa istruzione di logging nel plugin. Una release più recente aveva rimosso quell’istruzione, ma continuava a caricare lo script di anteprima, quindi la disattivazione offriva un test più pulito. Claude non ha trovato alcuna dipendenza runtime dal theme attivo o da altri plugin necessaria per visualizzare il negozio esistente.

Starter Templates è stato disattivato sullo staging tramite MyKinsta. Il compromesso era che gli editor avrebbero perso la libreria Starter Templates in Elementor e nell’editor a blocchi, cosa che avrebbe potuto essere rilevante se l’avessero ancora utilizzata per creare nuove sezioni. In 10 richieste senza cache, le nuove voci nel log degli errori sono scese da 10 a zero. Lo script di anteprima, precedentemente caricato in 10 delle 11 pagine testate, non veniva più caricato e l’output estraneo di WP-CLI era scomparso. I codici di stato delle risposte del negozio e l’output dei contenuti di Elementor sono rimasti invariati. Anche i controlli dell’editor specifici del plugin, come previsto, sono scomparsi, ma i dati dei prodotti, la configurazione del checkout e i contenuti delle pagine esistenti non sono stati modificati.

L’audit ha inoltre rilevato un problema di compatibilità più serio. Una richiesta anonima all’endpoint delle impostazioni globali di Elementor, un indirizzo web usato per richiedere dati specifici, restituiva HTTP 500. Il log PHP indicava il file di compatibilità di Astra con Elementor, dove Astra 4.1.5 chiamava get_data() su un oggetto WP_Error. WP_Error è il modo in cui WordPress rappresenta un’operazione non riuscita. L’endpoint di Elementor verifica i permessi e, quando una richiesta non autorizzata produceva WP_Error, il vecchio codice di Astra presumeva di aver ricevuto una REST response riuscita, cioè una risposta web strutturata utilizzata dalle funzionalità di WordPress. Poiché WP_Error non fornisce quel metodo, la richiesta terminava con un PHP fatal error.

Kinsta ha confrontato il theme installato con Astra 4.14.1 e ha trovato una protezione che verifica innanzitutto se la risposta è un errore o non è una WP_REST_Response. Il team ha utilizzato l’aggiornamento ufficiale di Astra invece di modificare manualmente il codice del theme di terze parti, evitando una patch locale che un aggiornamento successivo avrebbe potuto sovrascrivere. I test hanno mostrato che la richiesta anonima passava da HTTP 500 con un PHP fatal error a HTTP 401 con rest_forbidden. Per un utente autenticato senza la capability necessaria, il risultato passava da un fatal error a HTTP 403. Un amministratore autorizzato continuava a ricevere HTTP 200 e durante i controlli REST non sono stati registrati nuovi errori PHP.

La fase finale ha rinnovato l’aspetto del negozio senza modificare il catalogo o le funzionalità di commercio elettronico. Il design originale utilizzava accenti blu, il carattere Lato, pulsanti quadrati, una griglia di prodotti WooCommerce di base e grandi badge WhatsApp per gli ordini. Claude ha esaminato le impostazioni di Astra ed Elementor, poi ha introdotto bordeaux (#7B2342), espresso (#211A16) e avorio (#F7F2EC), con Cormorant Garamond per i titoli e Jost per il testo del corpo. I pulsanti arrotondati e il contrasto più marcato hanno portato il testo bianco sull’accento principale da 3.98:1 a 9.72:1, superando i requisiti WCAG AAA per il testo normale. WCAG è un insieme di linee guida sull’accessibilità per rendere più facili da usare i contenuti digitali.

Un piccolo must-use plugin, che WordPress carica automaticamente, forniva CSS personalizzato senza modificare i file di Astra o WooCommerce. Lo stile aggiungeva schede prodotto arrotondate, proporzioni coerenti per le immagini, effetti hover discreti, etichette di categoria più chiare, titoli dei prodotti con grazie e prezzi bordeaux. Utilizzava il markup esistente della product grid di WooCommerce, quindi il trattamento si applicava all’intero negozio e agli altri elenchi di prodotti. Il primo tentativo lasciava i badge WhatsApp originali, neri e verdi, accanto ai controlli ridisegnati perché il CSS esistente di WooCommerce sovrascriveva la regola di occultamento. Dopo aver esaminato uno screenshot, Claude ha modificato i selettori e il layout delle schede, spostando il link sotto i dettagli del prodotto e sostituendo il badge grande con un controllo più piccolo a forma di pillola.

La lezione pratica dell’esperimento non è dare a un agente AI il permesso di modernizzare un intero sito live in un unico passaggio. Il processo di Kinsta consisteva prima nell’eseguire l’audit, separare i guasti confermati dai possibili rischi, creare il backup dell’ambiente, apportare una modifica sullo staging e testare le funzioni interessate prima di valutare ulteriori aggiornamenti. Per i proprietari di siti e le agenzie, una copia staging offre un luogo più sicuro per verificare la disattivazione dei plugin, gli aggiornamenti del theme, il comportamento del checkout e l’aspetto delle pagine. Il managed WordPress hosting, come AEU Hosting, è rilevante per i lettori che desiderano un servizio di hosting WordPress protetto end-to-end mentre svolgono questo tipo di flusso di manutenzione.

Disponibile anche in: EnglishDeutschShqip