Gli utenti che utilizzano PrestaShop 1.7.x potrebbero riscontrare, in fase di accesso al pannello amministrativo (Back Office), errori simili ai seguenti:

StartTag: invalid element name
Extra content at the end of the document

Questo problema può comparire improvvisamente, anche su installazioni funzionanti fino a poco prima.

Causa del problema

L’errore è generalmente causato dalla mancata raggiungibilità del servizio Addons di PrestaShop.

Durante il login al Back Office, PrestaShop tenta di recuperare alcune informazioni dai server Addons e salvarle in file XML locali, tra cui:

• default_country_modules_list.xml

• modules_native_addons.xml

• must_have_modules_list.xml

Se il servizio remoto:

• non è raggiungibile

• è lento

• restituisce una risposta non valida

i file XML possono risultare vuoti o corrotti, causando l’errore in fase di parsing XML.

Versioni interessate

Il problema riguarda principalmente versioni PrestaShop 1.7.x, ormai End Of Life (EOL) e quindi più soggette a questo tipo di malfunzionamenti legati a servizi esterni.

Soluzione temporanea (workaround)

Creare override della classe Tools

Creare il file: override/classes/Tools.php

Con questo contenuto:

<?php
class Tools extends ToolsCore
{
    public static function addonsRequest($type, $params = [])
    {
        // XML valido di fallback
        $fallbackXml = '<?xml version="1.0" encoding="UTF-8"?>' . "\n" . '<modules></modules>' . "\n";

        $allowedRequests = ['native', 'must-have'];

        if (in_array($type, $allowedRequests, true)) {
            return $fallbackXml;
        }

        return false;
    }
}

Pulizia della cache e file XML

Da FTP, FileManager o ssh, elimina la cache e i file interessati:

var/cache/prod/*
var/cache/dev/*

config/xml/default_country_modules_list.xml
config/xml/modules_native_addons.xml
config/xml/must_have_modules_list.xml

Accesso al Back office

Dopo la pulizia, effettuare nuovamente l’accesso al pannello amministrativo.

Ripristino situazione standard

Il workaround è temporaneo. Una volta che il servizio Addons torna disponibile:

• eliminare il file override/classes/Tools.php

• ripetere la pulizia della cache e dei file XML

Raccomandazioni

• Valutare l’aggiornamento a versioni più recenti di PrestaShop, per ridurre la dipendenza da servizi legacy

• Monitorare eventuali disservizi lato Addons quando si verificano errori simili

• Evitare di lasciare override permanenti che bypassano funzionalità core