Step by step ImbaChat setup for WordPress

In this article, we will take a step-by-step look at all the setting up a chat depending on your CMS.

At the time of this writing, the plugin only supports active integrations with WordPress and Oсtober CMS. Let's consider the installation of a chat for WordPress platform.


First of all, you need to install the plugin. Follow these steps:

  1. Go to the admin panel of your site. Open the menu item Plugins → Download plugin. In the search line, enter the name of the plugin - ImbaChat. Install the plugin.


  1. Login on the ImbaChat and go to the Dashboard.
  2. Fill in the fields. Write the widget name. In the "Host" write your site URL without http:// (for example: your-site-domain-url.com). And then choose the "WordPress" CMS integration. Create the Widget.


  1. Write the widget id into “Widget id” field in the ImbaChat settings in the admin panel of your website. After that click “Connect to the widget”


  1. If you don't have a widget yet, click "Create a widget" at the same page. Connection between your website and ImbaChat server will be automatically configured.


To adjust widget style and customize the widget language, go to the «Style settings» in the Dashboard on the imbachat.com. Learn more about widget customization here.

To enable the online support feature, go to the Chat settings --> Online Support. Here you can enable the feature and create a new support manager account.


What's the next?

After installing you need to configure private and group chat for your users. For some WordPress theme it will configure automatically:

  • BuddyPress
  • Woocommerce
  • wpForo

When you install a chat on these themes, the buttons Send a message appear automatically in the necessary places. In particular, the BuddyPress integration has additional features. You can read more about them in this post.

If the above-mentioned themes are not installed on your WP website, then you need to use special shortcodes to configure the chat. A shortcode is a short command for displaying a function. ImbaChat for WordPress has its shortcodes.

With the ImbaChat shortcodes you can create:

  1. Send a message buttons
  2. Buttons and fields for creating group chats
  3. Join group chat button
  4. Buttons to close and open chat

How to insert shortcodes:


1. Send a message button

This shortcode adds a button to the page, by clicking which, a dialog with the user opens


  • id - user identification number on your site,
  • class - the name of the class for the button (if there is a need to use your own styles and classes),
  • name - button text,


[ic_open_dialog id=13 name="Write to admin" class="class_btn_msg"]

If the user id is not passed or id = 0, then the dialog opens with the current post author.

2. Create a group chat button

The second shortcode adds a button that adds the user who clicked the button. The pipe parameter defines the group.

This shortcode generate on page two input field and a button. The first field Group name - This field corresponds to the name of the group that is being created. The second field Pipe - is responsible for the Unique identifier of the group (this parameter is used in the ic_join_group shortcode). By clicking the button, a group chat is created, which site users can join.


  • classi - Class name for the input field
  • classb - Class name for the button
  • buttonname - button name

An application: Create a page for administrators, put a shortcode there and create the necessary groups through the ic_join_group shortcode.


[ic_create_group users="1,2,3" buttonname="Name of button" classi="class_of_input" classb="class_of_btn"]

3. Join group chat button


  • classb - Class name for the button
  • buttonname - button name
  • pipe - Parameter from Create a group chat button Shortcode, needed to understand which group to connect the user to. Example:
[ic_join_group classb="class_btn" buttonname="join group" pipe="group_example_1" title="The title of group"]

4. Open and close chat button

There are no parameters. Creates a button that opens a chat and a button that closes the chat.



After that your ImbaChat widget is ready.

If you need to display a shortcode somewhere in an arbitrary place in the template.


<?php $id = get_the_author_meta("ID"); echo do_shortcode( "[ic_open_dialog id = {$id} name = \"Write to administrator\" class = \"class_btn_msg\"]" ); ?>

where $id = get_the_author_meta("ID"); //passing the id of the current post author.

Thus, before adding a shortcode or php code to the template, you must get it through the function or explicitly set the id number.

If you do not pass the user id, then the id of the author of the current article will be selected. Then the code will be like this:

<?php echo do_shortcode( "[ic_open_dialog name = \"Write to administrator\" class = \"class_btn_msg\"]" ); ?>

We hope this article was helpful for you. You can get free installation service and technical support. Contact us by E-mail or Telegram.

More useful articles:

ImbaChat Troubleshooting

How to set up role-based access control for monetization

How to set up and use the group chat feature

  • Thank you for the clear explanation of wordpress shortcode with parameters.