Обновили WooCommerce, а вместо магазина пустая белая страница или фраза «На сайте возникла критическая ошибка». Заказы в этот момент не принимаются, поэтому первая мысль – откатить всё. Не торопитесь: сначала нужно понять, что именно упало. Обычно виноват не сам WooCommerce, а то, что с ним работает.
Что не делать в первые минуты
- не обновлять остальные плагины «заодно», чтобы стало лучше;
- не удалять WooCommerce через админку, если она открывается: удаление плагина может запустить очистку данных, если включена такая опция;
- не переустанавливать WordPress поверх. Сам сайт целый, ломается одно место.
Шаг 1: Включить журнал ошибок
В wp-config.php, выше строки «That’s all, stop editing», добавьте:
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );
Откройте магазин ещё раз и загляните в wp-content/debug.log. Последние строки с «Fatal error» покажут файл и строку. Если путь ведёт в wp-content/plugins/woocommerce, дело в самом плагине или окружении. Если в другую папку плагина или в themes, виноват он.
Шаг 2: Понять, какая из трёх причин
- Версия PHP. Новые версии WooCommerce поднимают минимальные требования к PHP и WordPress. На старом хостинге обновление может положить сайт сразу. В журнале это обычно ошибки про неизвестные функции или синтаксис.
- Расширение магазина. Платёжный модуль, доставка, купоны, фильтры. Они написаны под старую версию и вызывают то, чего больше нет. В журнале путь ведёт в папку расширения.
- Шаблоны темы. Если в теме есть папка woocommerce с копиями шаблонов, после обновления они устаревают и ломают страницу товара, корзину или оформление заказа. В журнале путь ведёт в themes/…/woocommerce.
Шаг 3: Вернуть сайт без доступа в админку
Если есть WP-CLI, достаточно одной команды:
wp plugin deactivate woocommerce
Без WP-CLI зайдите по SFTP и переименуйте папку wp-content/plugins/woocommerce, например в woocommerce-off. WordPress отключит плагин, а сайт заработает без магазина. Заказы и товары при этом остаются в базе данных, они не пропадают.
Шаг 4: Найти конфликтующее расширение
Верните папку WooCommerce на место, но сначала отключите расширения магазина. Получить список можно так:
wp plugin list --status=active
Отключайте по одному, начиная с платёжных и доставки, и после каждого проверяйте сайт. Как только магазин заработал, вы нашли виновника. Дальше либо обновить это расширение, либо заменить его.
Шаг 5: Откатить версию, если иначе никак
Если нужно вернуть магазин сразу, а разбираться потом:
wp plugin install woocommerce --version=ПРЕДЫДУЩАЯ_ВЕРСИЯ --force
Одна оговорка. Если после обновления WooCommerce уже запустил обновление базы данных, откат версии без отката базы может создать новые проблемы. Поэтому откат делают с копией базы, сделанной до обновления. Если копии нет, лучше искать причину, чем откатывать вслепую.
Как обновлять магазин, чтобы это не повторилось
- сначала копия сайта и базы, потом обновление;
- обновлять на тестовой копии, если магазин живой и заказов много;
- не обновлять в час пик и не в пятницу вечером;
- после обновления пройти путь покупателя: товар, корзина, оформление, оплата, письмо о заказе.
Если магазин стоит, а разбираться некогда, услуга «Правки и ремонт сайта на WordPress» решает такие случаи в день обращения. Общий порядок для любых белых экранов описан в статье «Белый экран WordPress», а чтобы обновления проходили спокойно, можно подключить присмотр за сайтом.
Частые вопросы
Пропадут ли заказы, если отключить WooCommerce?
Нет. Заказы, товары и клиенты лежат в базе данных и остаются на месте, пока вы сознательно не удалите данные плагина. Но пока магазин отключён, заказы он принимать не будет
Можно ли подождать, пока автор расширения выпустит обновление?
Если расширение отвечает за оплату или доставку, ждать с остановленным магазином дороже, чем вернуть прежнюю версию WooCommerce или заменить расширение
Где посмотреть требования к PHP и устаревшие шаблоны?
В WooCommerce на странице «Состояние системы»: там видна версия PHP и список шаблонов темы, которые отстали от текущей версии плагина
