Как исправить устаревший шаблон WooCommerce?

Плагин WooCommerce является очень популярным среди владельцев интернет-магазинов, ведь как нельзя лучше подходит для создания ecommerce-проектов на базе CMS WordPress. Для WooCommerce разработано множество готовых тем под различные товарные направления, однако большое количество пользователей предпочитает именно собственные шаблоны, которые потенциально лучше учитывают те или иные бизнес-потребности. Но со временем из-за этого может возникнуть конфликт совместимости: авторы WooCommerce выпускают новую версию плагина, его файлы обновляются, однако шаблоны, помещенные в директорию с вашей собственной темой, не заменяются в автоматическом режиме и остаются без изменений.

Именно поэтому после очередного обновления WooCommerce в административной панели сайта вы видите предупреждение: "Ваша тема ( ) содержит устаревшие копии некоторых файлов шаблона WooCommerce. Эти файлы, возможно, понадобится обновить, чтобы убедиться, что они совместимы с текущей версией WooCommerce" (см. скриншот ниже). Если интерфейс панели на английском языке, то сообщение будет выглядеть так: «Your theme () contains outdated copies of some WooCommerce template files. These files may need updating to ensure they are compatible with the current version of WooCommerce».

Не будем терять время, давайте сразу рассмотрим возможные пути исправления этой ошибки.

Исправление файлов устаревших шаблонов WooCommerce: пошаговая инструкция

В первую очередь стоит воспользоваться рекомендациями, приведенными в самом сообщении об ошибке. Проверьте, доступно ли обновление для вашей активной темы. Если оно есть, то примените его. Этого часто достаточно, чтобы заменить шаблоны WooCommerce новыми копиями файлов. Если же обновления нет, попробуйте поинтересоваться у разработчиков темы о том, когда оно будет выпущено.

Но бывают и немного худшие ситуации. Например, разработчики уже прекратили поддержку темы. Можно ли исправить файлы шаблонов WooCommerce в таком случае? Да! Для этого нужно выполнить следующие действия:

1. Откройте WooCommerce >Статус >Состояние Системы.
2. Перейдите в раздел Переопределения. В нем вы найдете список файлов, которые имеют устаревшие версии.

Пример сообщения об устаревшей версии файла cart-shipping.php

3. Сравните файлы темы с соответствующими файлами плагина, используя редакторы кода (например, PhpStorm). В частности, в PhpStorm есть встроенная опция для сравнения содержимого. Для ее вызова выберите два файла, которые вы хотите сравнить (кликните по ним, нажав Ctrl), затем перейдите к View > Compare With или нажмите Ctrl+D.
4. Если вы заметили отличия или дополнения в файлах плагина WooCommerce, то проанализируйте их и, при необходимости, внесите соответствующие исправления в файлы темы. Обычно разработчики Woocommerce предоставляют перечень внедренных изменений. Ознакомиться с ним можно по ссылке https://developer.woocommerce.com/releases/.

Как обновить файлы шаблонов WooCommerce: примеры

Пример 1

Давайте сравним версии файлов proceed-to-checkout-button.php с помощью PhpStorm (здесь и далее файлы шаблонов темы будут размещаться слева, а файлы шаблонов плагина - справа):

Анализ показывает следующие отличия:

• шаблон темы имеет версию 3.4.0, а актуальна 7.0.1;
• html-разметка шаблона темы отличается от имеющейся в плагине (мы видим, что в теме кода больше).

Для устранения проблемы необходимо:

• синхронизировать версию (прописать в файле темы тот номер версии, который указан в файле плагина WooCommerce;
• html-разметку можно оставить как есть, ведь это пользовательская адаптация автора темы.

Пример 2

Сравним файлы cart-empty.php:

Различия:

• шаблон темы использует версию 3.5.0, а плагин имеет 7.0.1;
• видим комментарий, что из версии 4.6.8 введен фильтр «woocommerce_return_to_shop_text», обрабатывающий вывод фразы «Return To Shop». Этот файл отсутствует в файле темы.

Что делать:

• синхронизировать версию;
• перенести в тему фильтр «woocommerce_return_to_shop_text».

Пример 3

Сравним файлы payment.php:

Различия:

• опять же, видим разные номера версий;
• вместо устаревшей функции is_ajax() внедрена актуальная wp_doing_ajax().

Как исправить:

• синхронизировать версию;
• заменить функцию is_ajax() в теме wp_doing_ajax().

Советы для самостоятельного устранения проблемы

Анализируя файлы, сфокусируйтесь на нескольких моментах:

• разногласия html-разметки не всегда являются проблемой, ведь они чаще всего и являются первопричиной кастомизации шаблонов WooCommerce. В большинстве случаев их можно игнорировать;
• обратите внимание на новые фильтры и хуки (функции apply_filters(), do_action()), а также комментарии, предложенные разработчиками плагина. Анализируйте каждый из них и решайте, нужны ли они для вашей темы;
• обязательно замените устаревшие функции актуальными;
• пропишите актуальную версию файла шаблона в своей теме;
• после внесения изменений вернитесь в раздел «Переопределение», чтобы убедиться, что сообщение о конфликте версий больше не отображается.

После удачной работы с файлом cart-shipping.php мы видим, что сообщение об устаревшей версии исчезло