Overview

The Cognitium AI Chat Pro WordPress Plugin adds a floating chat bubble and full chat interface to your WordPress site. It connects to the Cognitium Fast API (default URL: https://fastapi.cognitium.co.uk/api) to deliver AI-powered responses, rich link previews, and support for voting.

Upon activation, the plugin creates a custom logging table and automatically displays the chat bubble on your site. All configuration settings are available under the "Cognitium" menu in your WordPress dashboard.

Installation & Activation

To install the plugin:

Upload the plugin file (e.g. wordpress+plugin.php) to your wp-content/plugins/ directory or install it via the WordPress admin.
Activate the plugin from the WordPress Plugins menu.
On activation, the plugin automatically creates a logging table (wp_ai_chat_pro_logs) for tracking events.

Plugin Configuration

In your WordPress dashboard, navigate to the "Cognitium" menu to configure the plugin. The settings page is divided into the following sections:

API Credentials: Enter your user_id, api_key, and the API URL. It is recommended that you set the API URL to the default: https://fastapi.cognitium.co.uk/api.
Chat Appearance: Customize the chat header text, background colors, font size, and more.
Chat Bubble Settings: Configure the colors for the floating chat bubble (and its hover state) as well as the icon used.
Send Button Options: Set the send button’s background color, label, and text color.
Message Bubble Colors: Define separate colors for user and bot messages.
Chat Background & Footer: Choose the background color for the chat container and the footer’s appearance.
Logging: Enable logging to capture detailed event data. Use the “Clear Logs” button to remove old log entries when needed.

After saving your settings, click the "Reload Plugin" button on the settings page to apply any changes.

Frontend Behavior

The plugin automatically adds a floating chat bubble to the bottom-right corner of your website. When a visitor clicks the bubble:

The chat interface slides into view, allowing visitors to type messages.
Messages are sent via AJAX to the Cognitium Fast API for processing.
The AI-generated responses, including rich link previews, are displayed in the chat window.
Users can upvote or downvote responses. Vote data is forwarded to the API and processed accordingly.

How It Works

Under the hood, the plugin:

Creates a custom database table to log all requests, responses, and errors for troubleshooting.
Enqueues custom CSS and JavaScript to style the chat bubble, interface, and link preview cards based on your settings.
Uses AJAX handlers to send chat messages and vote data to the Cognitium Fast API (https://fastapi.cognitium.co.uk/api) and then displays the responses.
Fetches link metadata using the URLPreviewGenerator class to provide rich previews in chat messages.

Sample Integration

Once the plugin is activated, the chat bubble is automatically added to your site’s footer. For example, your theme’s footer output might look like this (handled automatically via the wp_footer hook):

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Chat Test</title>
    <!-- Optional: Include Tailwind CSS -->
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/tailwind.min.css" rel="stylesheet">
    <!-- Optional: Include jQuery if not already included -->
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/jquery.min.js"></script>
</head>
<body>
    <!-- The Cognitium AI Chat Pro plugin automatically adds the chat bubble via wp_footer -->
</body>
</html>

Troubleshooting & Support

If you encounter issues:

Ensure your API credentials and API URL (default: https://fastapi.cognitium.co.uk/api) are entered correctly in the settings.
Check the “Event Log” on the settings page for detailed error and debug information.
Confirm that your theme or other plugins do not conflict with the plugin’s CSS or JavaScript.
Verify that AJAX requests are not blocked by security plugins or server configurations.

Conclusion

The Cognitium AI Chat Pro WordPress Plugin offers a simple and powerful way to integrate AI-powered chat support into your WordPress site. By following the instructions above, you can easily configure API credentials, customize the chat appearance, and enable detailed logging for troubleshooting. If you need further assistance or advanced customization options, please refer to the inline comments in the plugin code or contact support.

Cognitium Official WordPress Plugin