WooCommerce в Lana Digital Platform: системные страницы

Системные страницы WooCommerce выглядят как обычные страницы WordPress, но работают иначе. Каталог, корзина, оформление заказа и личный кабинет формируются плагином, шаблонами темы и хуками. Поэтому большой HTML-блок в post_content часто приводит к двойной разметке, сырому коду и конфликтам после обновления.

Какие страницы считаются системными

Магазин и архив товаров.
Корзина.
Оформление заказа.
Личный кабинет.
Служебные endpoint-разделы аккаунта и заказа.

У этих страниц есть ID, но основной интерфейс выводится WooCommerce. Содержимое страницы не должно становиться вторым источником системной разметки.

Главное правило платформы

Post_content страниц shop, cart, checkout и my-account должен оставаться пустым. Оболочки и оформление задаются через вкладку «Магазин», шаблоны темы и штатные механизмы WooCommerce.

Такой подход исключает ситуацию, когда сначала выводится пользовательский HTML, а затем тот же функциональный блок создаёт WooCommerce.

Почему HTML внутри страницы опасен

Может появиться двойной каталог или двойная корзина.
Глобальный CSS затронет карточки и формы.
Шорткод продублирует системный вывод.
После обновления структура WooCommerce изменится, а старый CSS останется.
Кэш сохранит смешанную версию страницы.

Каталог и карточки товаров

Проверять нужно не только первый экран. Ошибки проявляются в пагинации, пустой категории, активных фильтрах и вариативных товарах.

Ширина контейнера.
Количество колонок.
Высота карточек.
Диапазоны цен вариаций.
Изображения и заглушки.
Сортировка и пагинация.

Корзина и оформление заказа

Корзина должна работать с простыми и вариативными товарами, пересчитывать количество и корректно удалять позиции. На мобильном экране таблица должна превращаться в читаемую структуру.

Checkout необходимо тестировать с реальным набором полей, способом доставки, оплатой, купоном и тестовым заказом. Нельзя скрывать функциональные поля только ради внешнего вида.

Личный кабинет

Общая оболочка должна сохраняться при переходах между заказами, адресами и данными аккаунта. Активный пункт меню должен выделяться, а endpoint-страницы — открываться без 404.

Совместимость пользовательских шаблонов

Если пользовательская WooCommerce-разметка содержит классы или ID с префиксом kps-, корневому элементу нужен официальный атрибут data-lana-woo-template.

<section class="kps-product-layout"
  data-lana-woo-template="single-product">
  ...
</section>

Типичные ошибки

На странице магазина выводится сырой код

Разметка записана в post_content вместо поля оболочки магазина.

Галерея товара не меняет главное изображение

Нужно проверить JavaScript-события, качество главного изображения и конфликт пользовательской разметки.

Частые вопросы

Можно ли оставить шорткод корзины в содержимом?

В старых конфигурациях это встречается, но в управляемой схеме платформы системный вывод лучше не смешивать с пользовательской разметкой.

Можно ли обновлять системные страницы обычным импортом?

Можно обновлять служебные данные, но нельзя массово записывать в post_content оболочки, предназначенные для вкладки «Магазин».

Что проверять после правок?

Полный путь: каталог → товар → корзина → оформление → кабинет, отдельно на мобильном устройстве.

Практический случай: сырой код на странице магазина

Во время доработки одного из сайтов оформление магазина было записано в содержимое системной страницы. В результате WooCommerce одновременно выводил собственный каталог и пользовательскую оболочку, а часть кода отображалась как текст. Исправление состояло не в добавлении ещё одного CSS-патча, а в переносе разметки в поля вкладки «Магазин» и очистке post_content.

Отдельная проверка вариативных товаров

После исправления оболочки необходимо проверять не только простые товары. У вариативных товаров важны переключение вариаций, изменение цены, доступность, галерея и качество главного изображения. Ошибка может не проявляться в каталоге и становиться заметной только на странице товара после выбора варианта.

Связанные материалы

Надёжная интеграция WooCommerce начинается с разделения ответственности: функциональный вывод остаётся у WooCommerce, оформление — у темы, а системные страницы не хранят дублирующую разметку.