Товары не добавляются в корзину OpenCart: что проверить

Краткое описание задачи

Из практики. Клиент жалуется: товары не добавляются в корзину, но только в Chrome на мобильных. В Safari всё работает. Стали разбираться — оказалось, модуль «Быстрый просмотр» (Quick View) конфликтовал с темой: он подгружал товар в модальное окно через AJAX, и в мобильной версии темы скрипт корзины не инициализировался после подгрузки контента. Стандартная кнопка «В корзину» на карточке товара — работает. Кнопка в модальном окне быстрого просмотра — нет, потому что JavaScript-обработчик не вешался на динамически добавленные элементы. Решение: отключили быстрый просмотр на мобильных, проблема ушла. Если без быстрого просмотра никак — нужно дорабатывать скрипт, чтобы он перевешивал обработчики после AJAX-загрузки.

Как не надо. Не думайте, что проблемы с корзиной — это всегда ошибка OpenCart. Сначала проверьте консоль браузера (F12 → Console): если там ошибка JavaScript — проблема в скриптах темы или модуля. Если ошибок JS нет — проверьте, передаётся ли CSRF-токен в POST-запросе добавления в корзину (в Firefox/Chrome вкладка Network). Если токен не передаётся — обновите страницу и попробуйте снова, возможно, сессия истекла. Частая причина на OpenCart 3 — несовместимость PHP 8.x с модулями, которые использовали устаревшие функции (eregi, mysql_* и т.п.). Проверьте логи PHP, если после обновления версии PHP корзина перестала работать.

Покупатель нажимает «В корзину», но товар не добавляется. Или добавляется, но корзина остаётся пустой. Критическая проблема, которая напрямую влияет на продажи. По практике, с такой проблемой сталкивается примерно каждый пятый проект, к которому обращаются после установки сторонних модулей.

Основные причины

• JavaScript-ошибка — скрипт добавления не выполняется из-за конфликта модулей
• Проблемы с сессиями — сессия не сохраняется, товар теряется при переходе между страницами
• Кэш страниц — закэшированная страница не отправляет AJAX-запрос на добавление
• Модуль корзины — кастомный модуль корзины конфликтует с дефолтным
• Товар недоступен — опция обязательна, но не выбрана, или товара нет в наличии

Рекомендации из практики

Как лучше: Проверьте консоль браузера (F12) на ошибки JavaScript. Чаще всего товар не добавляется из-за конфликта скриптов модуля корзины с другими модулями.

Как не делать: Не пишите кастомный обработчик корзины сразу. Сначала отключите все недавно установленные модули — возможно, один из них ломает стандартную корзину.

Кейс из практики: Товары перестали добавляться в корзину после установки модуля «Рекомендуемые товары». Отключили модуль — корзина заработала. Заменили на другой модуль, совместимый с версией OpenCart.

По практике, конфликты JavaScript — главная причина неработающей корзины в OpenCart. Нужна помощь — закажите техподдержку

Диагностика

Шаг 1. Проверьте консоль

F12 → Console. Ошибки JavaScript — главная причина.

Шаг 2. Проверьте AJAX-запросы

Вкладка Network → XHR. Нажмите «В корзину». Должен появиться POST-запрос к index.php?route=checkout/cart/add. Если нет — проблема в JS.

Шаг 3. Отключите кэш страниц

Если используется полный кэш страниц — убедитесь, что страницы товаров и корзины исключены из кэширования.

FAQ

Товар добавляется, но после перехода на другую страницу корзина пуста

Проблема с сессиями. Проверьте настройки сессий в PHP и конфигурации OpenCart. Попробуйте включить Redis для хранения сессий.

Кнопка «В корзину» не работает только на одной странице

Скорее всего, на этой странице есть конфликт JavaScript-скриптов. Откройте консоль браузера и посмотрите, какие ошибки выводятся при нажатии на кнопку. Чаще всего виноват модуль, который переопределяет стандартный обработчик добавления в корзину.

Товар добавляется, но количество всегда равно 1

Проверьте, передаётся ли параметр quantity в POST-запросе. Если вы используете кастомный модуль количества — убедитесь, что он корректно передаёт значение в поле quantity. Также проверьте, нет ли в теме JavaScript-кода, который принудительно устанавливает quantity=1.

После обновления PHP корзина перестала работать

Типичная ситуация при переходе с PHP 7.x на PHP 8.x. Многие старые модули используют функции, удалённые в PHP 8.0 (eregi, mysql_* и т.п.). Проверьте логи PHP — там будут точные указания на проблемные строки. Решение: обновить модули до совместимых версий или заменить устаревшие вызовы.

Итог

Проверьте консоль браузера и AJAX-запросы. Отключите кэш для страниц товаров и корзины. Проверьте модули, которые влияют на корзину. Если проблема повторяется и самостоятельно разобраться не удаётся — техническая поддержка OpenCart поможет найти и устранить причину. Подробнее — брошенная корзина в OpenCart.