Docs
Setting up WOC Messenger.
How to install the plugin, open chat from your own buttons and menus, and choose how the messenger loads.
1. Install the plugin
It installs like any other WordPress plugin and doesn’t add chat tables to your database.
- Download the plugin ZIP from your My Account page.
- In WordPress, go to Plugins, Add New Plugin, Upload Plugin.
- Choose the ZIP, click Install Now, then Activate.
- Go to Settings, Chat Messenger to check your licence and settings. The Chat bar now appears on your site.
2. Open chat from your own buttons and links
The Chat bar appears along the bottom of your site by default. You can also turn any button, menu item or link into a way to open chat. All of these work by adding the class open-chat.
In HTML
Add the class to any link or button:
<a href="#" class="open-chat">Chat with the community</a>Clicking it opens the messenger without reloading the page.
In the block editor
- Select your Button block.
- Set its link to #
- In the sidebar, open Advanced.
- In Additional CSS class(es), type open-chat
In your menu
- In Appearance, Menus, add a Custom Link with the URL # and the text Live Chat.
- Open Screen Options at the top and tick CSS Classes.
- In the menu item’s CSS Classes box, type open-chat
With JavaScript
For themes, pop-ups or your own code:
if (typeof window.maximizeChat === 'function') {
window.maximizeChat();
} else {
document.getElementById('chat-messenger-launcher')?.click();
}Example on this site
The orange Chat Now button at the top of this page is a normal button with the open-chat class.
3. Choose how the messenger loads
In Settings, Chat Messenger you can pick one of two load modes.
Recommended
Click to load
Only the Chat bar loads with your pages. The messenger connects when someone clicks the bar or one of your chat buttons. Best for blogs, publishers and anyone who cares about page speed.
For chat-first sites
Auto-connect
The messenger connects in the background once the page has finished loading, so the online count is live straight away. Best for community sites where chat is the main event.
Stuck on something?
Tell us what you’re trying to do and we’ll help you get it working.