OpenCart

Эта страница для магазинов на OpenCart. Установите модуль, откройте EasyChat из админки магазина и проверьте, что посетитель может написать с витрины.

EasyChat использует один общий пакет для OpenCart 2.3 и 3. OpenCart 4 остаётся отдельной линией из-за другого штатного установщика и namespace.

В общем архиве файлы OpenCart 2.3 и 3 хранятся один раз. На OpenCart 2.3 после штатной установки EasyChat проверяет их версию, размер и SHA-256. Если архив доставлен не полностью, модуль не включится и покажет администратору безопасный код проверки вместо безымянной ошибки.

Выберите архив для своей версии магазина:

• Скачать EasyChat для OpenCart 2.3 и 3.x
• Скачать EasyChat для OpenCart 4

Где Проверить Модуль

EasyChat также представлен на российской площадке LiveOpenCart. В карточке можно независимо посмотреть описание, заявленную совместимость и отзывы пользователей. Актуальные публичные дистрибутивы по-прежнему безопаснее скачивать по кнопкам выше: gateway EasyChat отдаёт полностью опубликованную stable-версию для выбранной ветки OpenCart.

На OpenCart-странице EasyChat эти сведения собраны в блоке «Открытая информация — спокойный выбор». В нём отдельно указаны разработчик, поддерживаемые ветки OpenCart и ссылка «Проверить источник». Переход на LiveOpenCart всегда остаётся отдельным действием и не мешает бесплатному скачиванию с сайта EasyChat.

Перед Установкой

• Скачайте пакет EasyChat для OpenCart с лендинга easychat24.ru.
• Сделайте резервную копию сайта.
• Убедитесь, что сайт использует PHP 7.4 или новее. Если версия старше, EasyChat остановит установку до изменения базы и покажет текущую и минимальную версии. Смените PHP в панели хостинга и вернитесь на страницу модуля; удалять файлы или таблицы не нужно.
• Убедитесь, что у вас есть доступ администратора OpenCart.
• Для группы администратора должны быть разрешены и просмотр, и изменение модуля EasyChat. Пользователь только с правом просмотра намеренно не получает полный административный доступ к EasyChat.
• Для OpenCart 2.3 и 3 выберите единый EasyChat-OpenCart-OC23-OC3-vX.Y.Z.ocmod.zip. Для OpenCart 4 используйте easychat.ocmod.zip. Не переименовывайте архив и не ставьте пакет другой линии.

Установка

1. Откройте раздел расширений OpenCart.
2. Загрузите архив EasyChat для OpenCart.
3. Включите модуль.
4. Откройте пункт EasyChat в левом меню админки.

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

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

Если OpenCart не смог подтвердить права группы, установка не покажет ложный успех, а сообщит об ошибке. Исправьте права записи/администратора и повторите включение. После успешной установки пункт меню появляется без ручного редактирования группы пользователей.

Первый Вход

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

Переход из левого меню сначала открывает защищённую страницу запуска. Обычная загрузка или предварительная загрузка этой страницы ничего не меняет и не создаёт одноразовый ключ. Подтверждённый переход из той же админки продолжится автоматически; если браузер открыл вкладку в фоне или не передал защитные признаки перехода, нажмите единственную кнопку Открыть EasyChat вручную. Кнопка в настройках сразу выполняет такое же защищённое действие в новой вкладке. Страница запуска запрещает встраивание во фрейм сразу двумя совместимыми механизмами: это сохраняет защиту от подмены клика, даже если хостинг меняет устаревший защитный заголовок своей общей настройкой.

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

Начиная с 1.4.0, EasyChat сам изолирует вход даже на хостингах, где общий путь PHP-сессий и более строгие параметры cookie закреплены администратором сервера. Просить хостинг отключать эту защиту или делать общую папку сессий доступнее не нужно. Для диагностики достаточно проверить, что папка easychat/log/sessions/ принадлежит сайту и доступна ему для записи.

При первом входе из OpenCart EasyChat покажет короткий экран с полезными возможностями: мобильное приложение, уведомления, AI-помощник и новости обновлений. Можно включить нужное сразу или вернуться к этому позже.

Если EasyChat предложит задать постоянный пароль, выберите свой надежный пароль. Знать сгенерированный при установке пароль для этого входа не нужно.

Этот защищённый переход предназначен для администратора магазина. Обычным операторам создайте отдельные учетные записи и передайте адрес EasyChat по инструкции «Доступ оператора».

Виджет На Витрине

После установки откройте публичную страницу магазина в новом окне.

Проверьте:

• кнопка чата видна на странице;
• окно чата открывается;
• тестовое сообщение попадает в админку EasyChat;
• ответ оператора появляется у посетителя.

Если сайт использует кеш, очистите кеш OpenCart, кеш темы и кеш браузера.

Фоновые Задачи

EasyChat использует планировщик для уведомлений, AI-ответов, интеграций и других действий, которые должны выполняться без открытой админки.

Откройте в EasyChat раздел с планировщиком и скопируйте команду или ссылку, которую показывает ваш сайт. Добавьте ее в панель хостинга примерно раз в минуту. Используйте именно команду из вашей установки: в ней уже учтены путь к сайту и версия PHP на хостинге.

После Обновления

В OpenCart 4 переход со старой сборки, которая хранила данные внутри каталога расширения, выполняется в безопасном порядке: сначала установите easychat-migration.ocmod.zip, затем в списке модулей нажмите установку Безопасное обновление EasyChat и дождитесь сообщения о завершённом переносе. Только после этого удалите старый пакет easychat и установите новый easychat.ocmod.zip. Помощник сверяет SHA-256 каждого config.php, upload, MAX-сеанса и аватара, не удаляет исходник и останавливается при конфликте. Для свежей установки OpenCart 4 помощник не нужен.

Обновление ставится поверх текущей версии. Перед обновлением сделайте резервную копию, затем загрузите новый архив и откройте EasyChat из админки OpenCart. Модуль проверит обновленные файлы и сохранит существующие настройки и данные. В OpenCart 2.3 можно загружать тот же архив поверх прежней версии: установщик сам безопасно заменит только подтвержденную запись EasyChat в OCMOD. Если подготовка файлов завершилась не полностью, OpenCart покажет ошибку и не отметит обновление как готовое. Два обновления не запускаются одновременно, а при ошибке записи модуль восстанавливает предыдущий целый набор файлов. Не удаляйте конфигурацию или таблицы EasyChat.

Если поддержка доставила исправление через FTP, завершение безопасного обновления также согласует список файлов модуля с OpenCart. Повторная проверка не требует переустановки и не удаляет переписку. После её завершения проверьте вход именно из левого меню магазина; для WhatsApp откройте интеграцию и нажмите Показать QR. Подтвердить привязку нужно на телефоне владельца.

Во время обновления EasyChat также убирает свои старые внутренние файлы, которые прежние версии OpenCart могли показывать как множество непонятных разрешений. Удаляются только файлы EasyChat с подтверждённым именем и SHA-256. Изменённый вручную, неизвестный или связанный ссылкой файл не удаляется и остаётся доступен для диагностики. После успешного обновления группе выдан только обычный маршрут EasyChat. В общем списке контроллеров может оставаться один стабильный аварийный маршрут восстановления; он не выдаётся группе и не создаёт отдельных записей для каждой версии. Если старая версия сохранила маршрут с ошибочным экранированием или продублировала его, установщик исправит только записи EasyChat в группе текущего администратора. Права других модулей и остальных групп не меняются.

Если вы переходите с версии ниже 1.4.0, сразу после загрузки архива откройте именно настройки расширения EasyChat. Нажмите Безопасно обновить EasyChat и дождитесь результата. На некоторых хостингах старый пункт в левом меню может показываться до минуты, пока PHP перепроверяет закешированный код; это не означает, что архив установлен неправильно.

Не нажимайте Обновить в общем разделе Модификаторы ради EasyChat. Модуль завершает переход через собственную защищенную страницу и не требует глобальной пересборки OCMOD. Такая пересборка затрагивает все расширения магазина и не исправляет кэш PHP-кода EasyChat.

При первом переходе со старой версии модуль может включить безопасный режим примерно на четыре минуты. В это время только EasyChat временно отвечает страницей обслуживания; витрина и админка OpenCart продолжают работать. Остановите старые фоновые задачи EasyChat, дождитесь указанного времени и снова нажмите Безопасно обновить EasyChat или Открыть EasyChat. Это нужно, чтобы старые PHP-процессы завершились до замены всего набора файлов. Если публикация не завершится, модуль вернет прежние точки входа и оставит старую версию целой.

Во время незавершённого обновления пункт EasyChat не исчезает из левого меню: рядом появляется предупреждение, а пункт ведёт на страницу безопасного восстановления. Сначала завершите обновление и только затем открывайте панель. При восстановлении модуль удаляет только однозначно распознанные старые файлы EasyChat. Файл, который не совпадает с известной старой сигнатурой, остаётся на месте, а обновление останавливается с предупреждением — EasyChat не пытается угадать и не отмечает такую установку как готовую. Проверка охватывает обе старые версии шаблона виджета и оставшиеся языковые файлы всех локалей, поэтому после успешного восстановления пункт меню больше не застревает в состоянии «нужно обновление».

Поврежденная или незавершенная база требует отдельной диагностики, а не новой пустой установки поверх нее.

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

Если после обновления исчезли и панель, и виджет, не создавайте новый пустой чат и не выставляйте права 777. Сначала проверьте вместе с поддержкой, сохранена ли конфигурация EasyChat и использует ли магазин прежнюю базу. При переносе OpenCart важно перенести также данные, настройки и вложения чата; одной повторной загрузки архива модуля для этого недостаточно.

После обновления проверьте:

• открывается админка EasyChat;
• старые диалоги на месте;
• виджет виден на витрине;
• новое тестовое сообщение приходит в список диалогов.

Частые Ситуации

• EasyChat не открывается из OpenCart. Не входите по прямому адресу и не угадывайте начальный пароль. Проверьте права администратора, очистите кеш, убедитесь, что установлена версия 1.4.0 или новее, откройте настройки расширения и нажмите Открыть EasyChat еще раз.
• Кнопки чата нет на сайте. Убедитесь, что виджет включен в EasyChat и страница не отдает старую кешированную версию.
• Сообщения приходят с задержкой. Проверьте, что планировщик включен на хостинге.
• После установки видна ошибка. Не удаляйте таблицы и файлы вручную. После резервной копии загрузите свежий пакет поверх текущих файлов. Если ошибка повторилась, передайте в поддержку скриншот без паролей и личных сообщений; частичная база требует отдельной диагностики.

На странице загрузки доступны два разных актуальных пакета: общий архив для OpenCart 2.3/3 и отдельный архив для OpenCart 4. Не переименовывайте и не смешивайте их: кнопка загрузки всегда выдает последнюю полностью опубликованную стабильную версию для выбранной ветки.

Мини-Чеклист

• Установлен архив EasyChat для OpenCart.
• Админка EasyChat открывается из меню OpenCart.
• Для первого входа не потребовался неизвестный начальный пароль.
• Собственный постоянный пароль задан, если EasyChat это предложил.
• Виджет виден на витрине.
• Тестовый диалог создан и оператор ответил.
• Планировщик добавлен в панель хостинга.

Обновление

Откройте Обновить в EasyChat. В OpenCart 2.3 и 3 нажмите Обновить через OpenCart и подтвердите действие: EasyChat сам проверит официальный пакет, передаст его штатному установщику и вернет вас в модуль после завершения. Ручное скачивание не требуется. OpenCart 4 получает точный архив и переход в нужный раздел CMS; старая схема OpenCart 4 сначала использует migration helper. Подробнее о проверках.

Изображения магазина после старой установки

Начиная с 1.4.0 EasyChat исправляет выбор папок при обычной установке; версия 1.15.7 дополнительно исключает общие настройки каталогов других модулей и проверяет конфликтующие правила доступа.

Если после установки 1.3.1 часть изображений магазина перестала открываться, обновите EasyChat и попросите администратора хостинга проверить .htaccess в общей папке image, а также права этой папки и общих журналов OpenCart. Само обновление не удаляет прежние правила магазина.

Не удаляйте .htaccess целиком и не меняйте права наугад. Сначала сохраните текущий файл и восстановите прежние настройки из резервной копии. Если копии нет, согласуйте правила с хостингом. Добавление WebP в список статики Nginx может скрыть симптом, но оставляет исходную причину.

После восстановления проверьте JPG, PNG, WebP и другие используемые форматы на страницах магазина, отправку вложений в EasyChat и их открытие оператором.