WordPress

Use this guide for WordPress and WooCommerce websites. EasyChat is installed as a regular plugin and opens from the WordPress admin area.

Before Installation

• Download the EasyChat WordPress package from the easychat24.ru landing page.
• Create a website backup.
• Log in to WordPress as an administrator.
• Prepare a public page where you will check the chat button after installation.

If you install EasyChat from WordPress.org, the basic chat works locally and for free. Paid services, notifications and external integrations are enabled only after your action.

Before installation, you can open the EasyChat24 Live Chat listing on WordPress.org. EasyChat is developed by Alfa-IT LLC. The listing shows the system requirements, update history and support forum. Directory availability helps you verify the package, but it is not a separate WordPress.org certification or endorsement.

Installation

1. Open Plugins in the WordPress admin area.
2. Click Add New and upload the EasyChat package.
3. Activate the plugin.
4. Open EasyChat from the WordPress menu.

During a normal installation, EasyChat does not ask for database settings. The plugin uses your WordPress settings and prepares everything automatically.

First Login

EasyChat should open directly from wp-admin, without asking you to type a separate password manually. The button verifies the WordPress administrator capability and security nonce, then creates a one-time sign-in. The generated password is not stored in WordPress settings or placed in the address bar. If EasyChat asks you to set your own permanent password, do it right away.

On the first entry from WordPress, EasyChat shows a short optional-services screen for the mobile app, notifications, AI assistant and update news. Skip it if you do not need these options now; you can return to them later.

Website Widget

Open a public website page in a new window and check that:

• the chat button is visible to the visitor;
• the chat window opens without errors;
• a test message appears in EasyChat;
• the operator reply returns to the widget.

If the button is missing, clear the WordPress cache, optimization plugin cache and browser cache. Also check that the widget is enabled in EasyChat settings.

Widget missing: WP-Optimize and other optimizers

If the chat appears for administrators but not for visitors, open Plugins → Installed Plugins and check for WP-Optimize or another JavaScript optimization plugin. Minifying, combining or delaying scripts can prevent the widget from loading. First, make sure the widget itself is enabled in EasyChat.

Add an exclusion in WP-Optimize

1. Open WP-Optimize → Minify → JavaScript.

2. Find Exclude JavaScript from processing.

3. Add these URL fragments, one per line, keeping any existing exclusions:

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

   The first fragment matches the WordPress.org plugin; the second matches the direct EasyChat build. You can add both. They identify the widget script regardless of your domain or version number.

4. Select Save settings.

5. Clear the WP-Optimize minification cache, then the website page cache. If your hosting provider or CDN also caches pages, clear that cache too.

6. Open the site in a private window without signing in to WordPress. Check that the chat button appears, the chat opens and a test message reaches the operator.

Menu labels may vary with the plugin’s language. WP-Optimize’s JavaScript exclusion guide.

Which script to exclude

For the WordPress.org plugin, the address usually looks like this:

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

You may also see /wp-json/easychat24-live-chat/v1/widget.js. For the direct build, the script address ends in index.php?route=widget. The domain and folder depend on your installation; version parameters may change.

Exclude the original EasyChat script. A file such as wpo-minify-footer-easychat-widget.min.js is an already processed cached copy. Excluding that copy does not fix the cause.

Using another optimization plugin

Find its JavaScript exclusions for minification, combining and delayed execution (Delay JavaScript). Exclude the original widget script from these types of processing. If the plugin accepts URL fragments, use the lines above. If it requires a full URL, copy the script address from your own site; replace the example.com example with your actual address. Save settings and clear caches.

You do not need to remove the optimizer or disable optimization for the entire site. If the widget is still missing, send support the page address, the name of the optimization plugin and the exclusions you added.

Background Tasks

WordPress usually runs background tasks automatically when visitors open the site. If your website has many messages or low traffic, ask the hosting provider to run standard WordPress background tasks about once a minute.

EasyChat includes a background-task status block. It will show a warning if the website has not run background actions for a long time.

After Updating

Update the plugin over the current version. Create a backup first, then install the new package or update from the directory.

After the update, check that:

• EasyChat opens from the WordPress menu;
• previous conversations are still there;
• the widget is visible on a public page;
• a test message appears in the admin panel.

Common Situations

• The EasyChat login form reappears after clicking the admin button. Do not guess the initial password. Close that tab, return to WordPress, and click Open EasyChat again; WordPress creates a new protected sign-in. If it keeps failing, verify the manage_options capability, update the complete EasyChat plugin, and clear PHP OPcache in the hosting panel.
• The installation screen opens instead of EasyChat. Check that you uploaded the WordPress package and that plugin activation finished without errors.
• WP Cerber blocks the REST API. Add the easychat24-live-chat namespace under WP Cerber → Hardening → REST API → Allow these namespaces. Until it is allowed, EasyChat keeps the widget paused. This prevents repeated denied REST requests from causing an administrator IP lockout.
• WordPress denies sign-in before EasyChat opens. Check the security plugin’s lockout log and unblock your IP. EasyChat does not change WordPress users, roles or the manage_options capability.
• The widget is missing or only visible to administrators. Check script exclusions in WP-Optimize and other optimizers.
• Messages or AI replies are delayed. Check WordPress background tasks on the hosting panel.
• Support needs details. Send an error screenshot, website address and WordPress version. Do not send passwords, payment data or private messages.

Quick Checklist

• The EasyChat plugin is installed and activated.
• The EasyChat admin panel opens from WordPress.
• Sign-in did not require an unknown generated password.
• A personal permanent password is set if EasyChat offered that option.
• The widget is visible on the website.
• A test conversation was created and answered.
• Background tasks run regularly.

Updates

The direct EasyChat build uses the regular WordPress updates screen and also checks the package signature, size and SHA-256 before extraction. The WordPress.org edition updates only through WordPress.org. Read about update checks.