Wonda Client Plugin

1. Introduction

The Wonda Client plugin is a lightweight connector that allows you to embed the Wonda AI chatbot on your WordPress website. It does not contain any dashboard, analytics, or chat logs – it simply stores your credentials and outputs the central embed script.

All chatbot management (settings, knowledge base, leads, logs, etc.) is handled through the Central Dashboard at https://wonda.co.zw/dashboard/. This separation ensures that your WordPress site stays clean and your chat widget always works, even across multiple tabs and cached pages.

Key Capabilities of the Client Plugin

• 🔐 Securely stores your Site ID and Site Secret.
• 📌 Optionally restricts the widget to specific pages/posts.
• ⚡ Lightweight – no AJAX, no nonces, no bloat.
• 🌍 Works with any WordPress theme.

2. Getting Started

2.1 Registration Process

To begin using Wonda AI, you need a central account:

1. Visit the Registration Page – https://wonda.co.zw/register/
2. Complete the Form – Provide:
   • Your name or company name
   • Email address
   • Website domain (e.g., yourcompany.com)
   • Full website URL (e.g., https://yourcompany.com)
   • Create a secure password
3. Submit Registration – Click "Create Account".
4. Check Your Email – You'll receive your unique credentials:
   • Site ID – Your unique identifier (format: site_a1b2c3...)
   • Site Secret – Your private key (format: sk_...)

2.2 First Login

After registration, log in to your central dashboard at https://wonda.co.zw/dashboard/ to configure your chatbot (greeting, colors, knowledge base, etc.).

3. Plugin Installation

3.1 Upload from WordPress Admin

1. Download the plugin ZIP file (wonda-client.zip) from your dashboard or from the email you received.
2. Go to your WordPress admin → Plugins → Add New → Upload Plugin.
3. Choose the ZIP file and click Install Now.
4. After installation, click Activate.

3.2 Manual via FTP

1. Unzip the plugin folder and upload it to /wp-content/plugins/wonda-client/.
2. Go to Plugins → Installed Plugins and activate Wonda Client.

4. Plugin Settings

After activation, go to Settings → Wonda Connector to enter your credentials and optionally restrict the widget to certain pages.

4.1 Entering Credentials

Click Save Settings after entering the credentials.

4.2 Test Connection

Click the Test Connection button to verify that your credentials are correct. A green success message means the central server accepted them.

4.3 Widget Placement (Optional)

By default the widget appears on all pages. You can restrict it to selected pages/posts:

1. Choose Only selected pages.
2. Hold Ctrl (Windows) or Cmd (Mac) and click the pages/posts where you want the widget.
3. Save settings.

5. Embedding on Any Website (Standalone)

The Wonda widget can be embedded on any HTML website – not just WordPress. You can get the embed code from your central dashboard under Embed Code.

1. Log in to your central dashboard: https://wonda.co.zw/dashboard/
2. Go to Embed Code in the sidebar.
3. Choose where it appears:
   • Global – The widget appears on every page of your site.
   • Custom pages – Specify URL paths (e.g., /contact, /products/*).
4. Copy the script tag – It looks like:
   <script src="https://wonda.co.zw/wp-content/plugins/wonda-central/widget/embed.js" data-site-id="site_abc123" data-site-secret="sk_xyz789" async defer></script>
5. Paste it just before the closing </body> tag of your website.

If you are using the WordPress plugin, you do not need to manually add this script – the plugin does it automatically based on your settings.

6. Central Dashboard Overview

All chatbot configuration, analytics, and management happen at https://wonda.co.zw/dashboard/. Key sections include:

• Dashboard – Stats, token usage, charts.
• Settings – Bot name, greeting, colour, lead capture, knowledge base, etc.
• Knowledge Base – Train your bot with information about your business.
• Leads – View captured visitor contact info.
• Chat Logs – See all conversations.
• Unanswered – Questions your bot couldn't answer.
• Export Data – Download your data.
• Scheduled Reports – Set up automated email reports.
• Embed Code – Generate the embed script for non‑WordPress sites.
• Profile & Notifications – Manage your account.

For detailed information about each feature, please refer to the Central Dashboard Documentation (separate document).

7. Troubleshooting

8. Glossary