WordPress

Эта инструкция для сайтов на WordPress и WooCommerce. EasyChat устанавливается как обычный плагин и открывается из админки WordPress.

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

• Скачайте WordPress-пакет EasyChat с лендинга easychat24.ru.
• Сделайте резервную копию сайта.
• Войдите в WordPress под администратором.
• Подготовьте страницу сайта, где после установки проверите кнопку чата.

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

Перед установкой можно открыть карточку EasyChat24 Live Chat в WordPress.org. Разработчик EasyChat — ООО «Альфа-ИТ». В карточке видны системные требования, история обновлений и форум поддержки. Размещение в каталоге помогает проверить пакет, но не является отдельной сертификацией или рекомендацией со стороны WordPress.org.

Установка

1. Откройте Плагины в админке WordPress.
2. Нажмите Добавить новый и загрузите архив EasyChat.
3. Активируйте плагин.
4. Откройте пункт EasyChat в меню WordPress.

При нормальной установке EasyChat не спрашивает параметры базы данных. Плагин использует настройки вашего WordPress и готовит все сам.

Первый Вход

EasyChat должен открыться прямо из wp-admin, без отдельного ручного ввода пароля. Кнопка проверяет право администратора и защитный код WordPress, после чего создает одноразовый вход; сгенерированный пароль не хранится в настройках WordPress и не попадает в адресную строку. Если EasyChat предложит задать свой постоянный пароль, сделайте это сразу.

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

Виджет На Сайте

Откройте публичную страницу сайта в новом окне и проверьте:

• кнопка чата видна посетителю;
• окно чата открывается без ошибок;
• тестовое сообщение появляется в EasyChat;
• ответ оператора возвращается в виджет.

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

Виджет не появляется: WP-Optimize и другие оптимизаторы

Если чат виден администратору, но отсутствует у гостей, откройте Плагины → Установленные плагины и проверьте, есть ли WP-Optimize или другой плагин оптимизации JavaScript. Минификация, объединение или отложенный запуск скриптов могут мешать загрузке виджета. Сначала убедитесь, что сам виджет включён в EasyChat.

Как добавить исключение в WP-Optimize

1. Откройте WP-Optimize → Minify → JavaScript (минификация JavaScript).

2. Найдите Exclude JavaScript from processing — исключения из обработки.

3. Добавьте следующие фрагменты адресов, каждый с новой строки, сохранив уже существующие исключения:

   easychat24-live-chat/v1/widget.js
   index.php?route=widget

   Первый фрагмент относится к плагину из WordPress.org, второй — к прямой сборке EasyChat. Можно добавить оба: они позволяют найти скрипт виджета без привязки к домену и номеру версии.

4. Нажмите Save settings — сохранить настройки.

5. Очистите кеш минификации WP-Optimize, затем кеш страниц сайта. Если хостинг или CDN также кеширует страницы, очистите этот кеш.

6. Откройте сайт в приватном окне без входа в WordPress. Проверьте, что кнопка чата появилась, окно открывается, а тестовое сообщение доходит до оператора.

Названия пунктов могут отличаться в переводе плагина. Инструкция WP-Optimize по исключению JavaScript.

Какой именно скрипт исключать

Для WordPress.org адрес обычно выглядит так:

https://example.com/index.php?rest_route=/easychat24-live-chat/v1/widget.js

Встречается и адрес с /wp-json/easychat24-live-chat/v1/widget.js. Для прямой сборки адрес скрипта заканчивается на index.php?route=widget. Домен и папка зависят от установки; параметры версии могут меняться.

В исключения добавляйте исходный скрипт EasyChat. Файл вида wpo-minify-footer-easychat-widget.min.js — уже обработанная копия в кеше: исключение этой копии не устраняет причину.

Если используется другой плагин оптимизации

Найдите его исключения для JavaScript: минификация, объединение и задержка выполнения (Delay JavaScript). Исключите исходный скрипт виджета из этих видов обработки. Если плагин принимает фрагменты URL, используйте строки выше. Если требуется полный адрес, скопируйте адрес скрипта своего сайта; пример с example.com замените своим адресом. Сохраните настройки и очистите кеш.

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

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

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

В EasyChat есть блок состояния фоновых задач. Он подскажет, если сайт давно не выполнял фоновые действия.

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

Обновляйте плагин поверх текущей версии. Перед обновлением сделайте резервную копию, затем установите новый архив или обновите плагин из каталога.

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

• EasyChat открывается из меню WordPress;
• старые диалоги на месте;
• виджет виден на публичной странице;
• тестовое сообщение приходит в админку.

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

• После клика снова видна форма логина EasyChat. Не подбирайте начальный пароль. Закройте вкладку, вернитесь в админку WordPress и снова нажмите Открыть EasyChat: WordPress создаст новый защищенный вход. Если ошибка повторяется, проверьте право manage_options, обновите весь плагин EasyChat и очистите серверный PHP OPcache через панель хостинга.
• Открывается экран установки вместо EasyChat. Проверьте, что загружен именно WordPress-пакет и плагин активировался без ошибок.
• WP Cerber запрещает REST API. Добавьте namespace easychat24-live-chat в WP Cerber → Hardening → REST API → Allow these namespaces. Пока он не разрешён, EasyChat не загружает виджет: это исключает поток отклонённых REST-запросов, из-за которого Cerber может заблокировать IP администратора.
• WordPress пишет «Вход запрещён» ещё до открытия EasyChat. Проверьте журнал блокировок защитного плагина и снимите блокировку своего IP. EasyChat не изменяет пользователей, роли и право manage_options в WordPress.
• Виджет не виден на сайте или виден только администратору. Проверьте исключения скрипта в WP-Optimize и других оптимизаторах.
• Сообщения или AI-ответы задерживаются. Проверьте фоновые задачи WordPress на хостинге.
• Нужна помощь поддержки. Отправьте скриншот ошибки, адрес сайта и версию WordPress. Не отправляйте пароли, платежные данные и личные сообщения.

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

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

Обновление

Прямая сборка EasyChat использует обычный экран обновлений WordPress и дополнительно проверяет подпись, размер и SHA-256 пакета до распаковки. WordPress.org-версия обновляется только через WordPress.org. Подробнее о проверках.