config\/xml\/<\/code><\/pre><\/div>Najwa\u017cniejsze z nich to:
- must_have_modules_list.xml<\/span> – lista modu\u0142\u00f3w oznaczonych jako „must have” przez PrestaShop<\/li>
- modules_native_addons.xml<\/span> – lista modu\u0142\u00f3w natywnych dost\u0119pnych w Addons<\/li>
- default_country_modules_list.xml<\/span> – modu\u0142y sugerowane dla konkretnego kraju<\/li>
- trusted_modules_list.xml<\/span> – lista zaufanych modu\u0142\u00f3w weryfikowanych przez PrestaShop<\/li><\/ul>Pliki te nie maj\u0105 wp\u0142ywu na frontend sklepu ani na przetwarzanie zam\u00f3wie\u0144. S\u0142u\u017c\u0105 wy\u0142\u0105cznie do wy\u015bwietlania informacji w sekcji modu\u0142\u00f3w panelu admina.
Jak wygl\u0105da b\u0142\u0105d XML i gdzie si\u0119 pojawia?<\/h6>B\u0142\u0105d najcz\u0119\u015bciej pojawia si\u0119 bezpo\u015brednio w panelu administracyjnym – w zak\u0142adce Modu\u0142y<\/strong> lub po wej\u015bciu do Mened\u017cera modu\u0142\u00f3w<\/strong>. Komunikaty mog\u0105 wygl\u0105da\u0107 nast\u0119puj\u0105co:
Error found : Start tag expected, '<' not found in must_have_modules_list.xml file\r\nError found : Start tag expected, '<' not found in modules_native_addons.xml file\r\nError found : Start tag expected, '<' not found in default_country_modules_list.xml file<\/code><\/pre><\/div>Notatka<\/div>B\u0142\u0119dy te pojawiaj\u0105 si\u0119 w PrestaShop 1.7 oraz PrestaShop 8.x. W starszych wersjach 1.6 mechanizm dzia\u0142a podobnie, cho\u0107 lokalizacja niekt\u00f3rych plik\u00f3w mo\u017ce si\u0119 r\u00f3\u017cni\u0107.<\/div><\/div>
Sk\u0105d bierze si\u0119 ten b\u0142\u0105d?<\/h6>PrestaShop wysy\u0142a zapytania HTTP do API PrestaShop Addons, aby pobra\u0107 aktualne listy modu\u0142\u00f3w. Przyk\u0142adowy endpoint wygl\u0105da tak:
https:\/\/api.addons.prestashop.com\/?version=1.7.8.x&method=listing&action=must-have<\/code><\/pre><\/div>Sklep oczekuje odpowiedzi w formacie XML. Problem pojawia si\u0119, gdy:- API Addons zwraca odpowied\u017a w innym formacie (np. JSON lub stron\u0119 b\u0142\u0119du HTML)<\/li>
- po\u0142\u0105czenie z API jest zablokowane przez firewall lub konfiguracj\u0119 serwera<\/li>
- serwer sklepu nie ma dost\u0119pu do zewn\u0119trznych zasob\u00f3w (brak wychodz\u0105cego ruchu HTTP\/HTTPS)<\/li>
- API Addons jest chwilowo niedost\u0119pne lub zwraca timeout<\/li>
- wersja PrestaShop jest zbyt stara i nie jest ju\u017c obs\u0142ugiwana przez API<\/li><\/ul>Parser PHP simplexml_load_string()<\/span> przy pr\u00f3bie przetworzenia nieprawid\u0142owej odpowiedzi zg\u0142asza w\u0142a\u015bnie ten b\u0142\u0105d – Start tag expected<\/em>.
Czy b\u0142\u0105d wp\u0142ywa na dzia\u0142anie sklepu?<\/h6>Sukces<\/div>Frontend sklepu, koszyk, zam\u00f3wienia, p\u0142atno\u015bci i wszystkie procesy zakupowe dzia\u0142aj\u0105 normalnie. B\u0142\u0105d dotyczy wy\u0142\u0105cznie panelu administracyjnego – konkretnie sekcji zarz\u0105dzania modu\u0142ami.<\/div><\/div>Co mo\u017ce przesta\u0107 dzia\u0142a\u0107 w panelu:- lista rekomendowanych modu\u0142\u00f3w<\/li>
- sekcja „must have” w mened\u017cerze modu\u0142\u00f3w<\/li>
- marketplace Addons dost\u0119pny z poziomu admina<\/li>
- sugestie modu\u0142\u00f3w dla kraju<\/li>
- wolniejsze \u0142adowanie strony Modu\u0142y (timeout przy pr\u00f3bie po\u0142\u0105czenia z API)<\/li><\/ul>
Krok 1 – sprawdzenie zawarto\u015bci plik\u00f3w XML<\/h6>Przed wprowadzeniem jakichkolwiek zmian warto sprawdzi\u0107, co aktualnie znajduje si\u0119 w plikach. Przez SSH<\/a> wykonujemy:
cat config\/xml\/must_have_modules_list.xml<\/code><\/pre><\/div>Je\u015bli plik jest pusty, zawiera HTML (np. stron\u0119 b\u0142\u0119du 503) lub JSON zamiast XML – to w\u0142a\u015bnie jest \u017ar\u00f3d\u0142o problemu.
Wskaz\u00f3wka<\/div>Do sprawdzenia zawarto\u015bci pliku mo\u017cna te\u017c u\u017cy\u0107 mened\u017cera plik\u00f3w w panelu hostingowym (np. Hestia CP, cPanel) lub klienta FTP – nie jest wymagany dost\u0119p SSH.<\/div><\/div>
Krok 2 – podmiana plik\u00f3w na poprawny XML<\/h6>Najszybsze rozwi\u0105zanie to zast\u0105pienie zawarto\u015bci problematycznych plik\u00f3w minimalnym, poprawnym XML-em. Przez SSH wykonujemy:
echo '<?xml version=\"1.0\" encoding=\"UTF-8\"?><modules\/>' > config\/xml\/must_have_modules_list.xml\r\necho '<?xml version=\"1.0\" encoding=\"UTF-8\"?><modules\/>' > config\/xml\/modules_native_addons.xml\r\necho '<?xml version=\"1.0\" encoding=\"UTF-8\"?><modules\/>' > config\/xml\/default_country_modules_list.xml\r\necho '<?xml version=\"1.0\" encoding=\"UTF-8\"?><modules\/>' > config\/xml\/trusted_modules_list.xml<\/code><\/pre><\/div>Mo\u017cna te\u017c wgra\u0107 pliki r\u0119cznie przez FTP. Zawarto\u015b\u0107 ka\u017cdego z nich powinna wygl\u0105da\u0107 tak:
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<modules\/><\/code><\/pre><\/div>Ostrze\u017cenie<\/div>Samo zast\u0105pienie plik\u00f3w rozwi\u0105\u017ce problem tymczasowo. PrestaShop przy kolejnym od\u015bwie\u017ceniu strony modu\u0142\u00f3w spr\u00f3buje ponownie pobra\u0107 dane z API i mo\u017ce nadpisa\u0107 pliki b\u0142\u0119dn\u0105 odpowiedzi\u0105.<\/div><\/div>
Krok 3 – trwa\u0142e rozwi\u0105zanie przez override klasy<\/h6>Aby trwale zablokowa\u0107 pr\u00f3by pobierania XML z API Addons, tworzymy override klasy Tools<\/span>. Tworzymy plik:
override\/classes\/Tools.php<\/code><\/pre><\/div>O nast\u0119puj\u0105cej zawarto\u015bci:
<?php\r\nclass Tools extends ToolsCore\r\n{\r\n protected static $is_addons_up = false;\r\n}<\/code><\/pre><\/div>W\u0142a\u015bciwo\u015b\u0107 $is_addons_up = false<\/span> sprawia, \u017ce PrestaShop nie b\u0119dzie pr\u00f3bowa\u0142 \u0142\u0105czy\u0107 si\u0119 z API Addons – a co za tym idzie, nie b\u0119dzie pobiera\u0142 ani nadpisywa\u0142 plik\u00f3w XML.
Po utworzeniu pliku override czy\u015bcimy cache. Dla PrestaShop 1.7 \/ 8.x<\/strong>:
rm -rf var\/cache\/dev\/*\r\nrm -rf var\/cache\/prod\/*<\/code><\/pre><\/div>Mo\u017cna te\u017c wyczy\u015bci\u0107 cache z poziomu panelu administracyjnego: Zaawansowane > Wydajno\u015b\u0107 > Wyczy\u015b\u0107 cache<\/strong>.
Info<\/div>Po zastosowaniu override sekcja modu\u0142\u00f3w nadal dzia\u0142a w pe\u0142ni – mo\u017cna instalowa\u0107, odinstalowywa\u0107 i aktualizowa\u0107 modu\u0142y z pliku ZIP. Wy\u0142\u0105czona zostaje jedynie integracja z marketplace Addons w panelu admina.<\/div><\/div>
Alternatywa – blokada zapisu do plik\u00f3w<\/h6>Je\u015bli nie chcemy korzysta\u0107 z override, mo\u017cna ustawi\u0107 plikom XML prawa tylko do odczytu. PrestaShop nie b\u0119dzie m\u00f3g\u0142 ich nadpisa\u0107:
chmod 444 config\/xml\/must_have_modules_list.xml\r\nchmod 444 config\/xml\/modules_native_addons.xml\r\nchmod 444 config\/xml\/default_country_modules_list.xml\r\nchmod 444 config\/xml\/trusted_modules_list.xml<\/code><\/pre><\/div>Notatka<\/div>Metoda z chmod jest prostsza, ale nie eliminuje pr\u00f3b po\u0142\u0105czenia z API – PrestaShop nadal b\u0119dzie je wykonywa\u0142, co mo\u017ce spowalnia\u0107 \u0142adowanie strony modu\u0142\u00f3w. Override klasy Tools jest rozwi\u0105zaniem czystszym technicznie.<\/div><\/div>
Czego nie tracimy po wy\u0142\u0105czeniu Addons API?<\/h6>Warto wiedzie\u0107, \u017ce w \u015brodowisku produkcyjnym wi\u0119kszo\u015b\u0107 tych funkcji i tak nie jest u\u017cywana na co dzie\u0144: