Table of Contents

Step 1: Installation & Setup

Follow these steps to get the CHAT.devad.io plugin running on your WordPress site.

  1. Download: Get the latest version of the plugin from here
  2. Upload: Log in to your WordPress Admin. Go to Plugins > Add New > Upload Plugin. Choose the file named CHAT-devad-io.zip and click Install Now.
  3. Activate: Once the upload is finished, click the Activate button.
  4. Locate Settings: After activation, a new menu item named CHAT.devad.io will appear in your sidebar. You can also find the settings page directly at :yourwebsite.com/wp-admin/options-general.php?page=CHAT-devad-io
  5. Go Live: By default, the chat is automatically shown on all pages of your site once configured.

Step 2: Finding Your Chat ID & Configuring Settings

To connect your specific account to your WordPress site, you need to link it using your unique ID.

How to find your Chat ID

  1. Go to your CHAT.devad.io Account Installation tab.
  2. Look for the Embed Code section.
  3. In the script code provided, look for the numbers at the end of the URL.Example: In <script id="chat-init" src="...js?id=55747"></script>, your ID is 55747.
  4. Copy that ID and Paste it into the Chat ID field in your WordPress plugin settings, then click Save.

Understanding the Plugin Settings

Once you’ve entered your ID, you can fine-tune how the chat behaves:

SettingWhat it does
VisibilityChoose specific Page IDs or Post Type slugs (like “product” or “blog”) where the chat should (or shouldn’t) appear.
Multisite RoutingFor WordPress Networks. It automatically sends chats to specific departments that match your Site ID.
Sync WP UsersAutomatically identifies logged-in WordPress users so they don’t have to type their name/email into the chat.
Force LanguageManually sets the chat language (e.g., “en” or “fr”) to override automatic detection.
Feedback NoticesOptions like Rate it now or Dismiss allow you to manage the plugin’s feedback notifications in your dashboard.

Comprehensive Guide to CHAT.devad.io WordPress Integration

This guide provides a complete, step-by-step manual for configuring the WordPress version of CHAT.devad.io. It covers essential setups such as user synchronization, WooCommerce integration, multilingual support, and advanced developer features. Please note that the settings details provided below are strictly related to the WordPress version of the software installed on your server. If you are utilizing the cloud version of CHAT.devad.io alongside its WordPress plugin, the specific features outlined in this documentation are not available.

User Synchronization and Authentication

One of the core features of the integration is the ability to seamlessly synchronize your WordPress user base with the chat platform. WordPress users can be automatically synchronized with CHAT.devad.io by selecting “WordPress” under the Users system option located in the Settings > WordPress area.

Success! When active, the front-end chat automatically recognizes all logged-in WordPress users and creates a new CHAT.devad.io user account with the exact same details (name, surname, email, and password).

Furthermore, the log-in form is designed to recognize the email and password of each WordPress user. Upon logging into CHAT.devad.io, the user is automatically logged into WordPress as well, ensuring a unified experience.

Automatic Registration Setup

To facilitate the creation of a WordPress user whenever a visitor registers through CHAT.devad.io, you must enable the specific option found at Settings > WordPress > WordPress registration. It is mandatory to include both password and email fields in the registration form; they are required for this process to function correctly. Once registered, the WordPress user is logged in automatically.

Direct Access to Admin Area and Progressive Web App

Administrators and agents have the flexibility to access the admin area directly, bypassing the WordPress interface. This is done by navigating to /wp-content/plugins/script/script/admin.php and logging in with your default WordPress user credentials or agent email and password. Please keep in mind that your wp-content folder location might differ depending on your server configuration.

By accessing the admin interface directly, you also gain the ability to utilize the admin area as a Progressive Web App (PWA). You can find more details on setting this up by clicking the relevant documentation links within the platform.

Login and Logout Procedures

To securely logout from the admin area of CHAT.devad.io, you must logout from WordPress via the admin area of CHAT.devad.io. Once you have successfully logged out, you will be able to login with a different WordPress account. To access the admin area from within the WordPress dashboard, you must be logged in with one of the following permissible WordPress user roles: administrator, author, or editor.

Getting Page and Post Type IDs

For advanced configuration, you may need to retrieve specific IDs or slugs for pages and posts.

  • Get a page or Post Type ID: To get the ID of a specific page or Post Type, go to the admin area of WordPress and edit the page or post. The ID is displayed in the address bar.
    Example: http://your-site.com/wp-admin/post.php?post=11&action=edit&lang=en (In this URL, the page/post ID is equal to 11).
  • Get a Post Type slug: The Post Type slug for the blog archive and posts is post. The Post Type for pages is page. To obtain the slug of a custom Post Type, go to the admin area of WordPress and open the custom Post Type page from the left menu. The slug is displayed in the address bar.
    Example: http://your-site.com/wp-admin/edit.php?post_type=food (In this URL, the slug is food).

Preventing WordPress Emoji Replacement

To prevent WordPress from replacing the chat emojis with the default WordPress ones, you must enter the specific code below into the functions.php file of your active theme.

function disable_emojis() {
remove_action("wp_head", "print_emoji_detection_script", 7);
remove_action("admin_print_scripts", "print_emoji_detection_script");
remove_action("wp_print_styles", "print_emoji_styles");
remove_action("admin_print_styles", "print_emoji_styles");
}
add_action("init", "disable_emojis");

WordPress Multisite and Multilingual Configuration

WordPress Multisite: If you are running a multisite installation, you must install CHAT.devad.io on the main website.

WordPress Multilingual: If you want the chat interface to use the same language as the current page on your website, you must disable the Settings > Chat > Language option. The multilingual feature is fully compatible with the WPML and Polylang plugins. To activate the multilingual feature, navigate to Settings > WordPress > Multilingual plugin and choose either WPML or Polylang.

Note that the multilingual feature for WooCommerce product attributes requires the WooCommerce Multilingual Plugin if you are using WPML, or the Polylang for WooCommerce Plugin if you are using Polylang.

Categorized in:

CHAT App, Ecommerce Features, More Apps & Integrations, Features & Use Cases,

Tagged in:

, ,