BetterCX Widget

The BetterCX Widget plugin provides a powerful, AI-driven customer support solution that integrates seamlessly into your WordPress website. This plugin offers a complete chat widget experience with advanced features, customizable appearance, and enterprise-grade security.

Key Features

• AI-Powered Support: Intelligent chatbot that understands context and provides helpful responses
• Real-time Chat: Instant messaging with your customers
• Customizable Appearance: Match your brand with themes, colors, titles, and positioning options
• Embedded Mode Options: Flexible sizing (full, medium, small) and placement (top, center, bottom) for embedded contexts
• Rich Media Support: Image upload and sharing capabilities for enhanced communication
• Branding Control: Customizable “Powered by BetterCX” attribution display
• Mobile Responsive: Optimized for all devices and screen sizes
• WordPress Integration: Native shortcode and widget support
• Event Tracking: Monitor user interactions and analytics
• Security First: GPLv2+ licensed, no tracking without consent
• Developer Friendly: Full API access and customization options

How It Works

1. Install & Activate: Install the plugin and activate it
2. Get Your Key: Obtain your public key from the BetterCX dashboard
3. Configure: Set your preferences in the admin settings
4. Deploy: Use shortcodes, widgets, or automatic placement
5. Monitor: Track interactions and improve customer support

Integration Options

• Shortcode: [bettercx_widget] – Use anywhere in posts, pages, or widgets
• Widget Areas: Drag and drop into any widget area
• Automatic Placement: Global widget placement on all pages
• Custom Positioning: Left or right side positioning
• Embedded Sizing: Full screen, medium (60%), or small (40%) width with 4:3 aspect ratio
• Embedded Placement: Top, center, or bottom positioning for embedded widgets
• Theme Integration: Seamless integration with any WordPress theme

Privacy & Security

This plugin is designed with privacy and security in mind:

• No Unauthorized Tracking: Only tracks with explicit user consent
• Local Asset Loading: All assets are bundled locally (no external CDN dependencies)
• No External Scripts: All JavaScript and CSS files are included in the plugin
• Secure Communication: All API calls use HTTPS encryption
• Data Minimization: Only collects necessary information for functionality
• GDPR Compliant: Follows European data protection regulations
• Opt-in Analytics: Analytics tracking requires explicit user consent
• No Third-party Dependencies: No external libraries loaded from CDNs

Service Integration

This plugin integrates with the BetterCX service to provide AI-powered customer support. The service:

• Processes chat messages to provide intelligent responses
• Stores conversation history for context
• Provides analytics and insights
• Offers enterprise-grade security and reliability

Service Terms and Privacy:
* Service Provider: BetterCX Inc.
* Service URL: https://bettercx.ai
* Terms of Service: https://bettercx.ai/terms
* Privacy Policy: https://bettercx.ai/privacy
* Data Processing: All data processing occurs on BetterCX servers
* Data Retention: As per BetterCX privacy policy
* User Rights: Users can request data deletion and opt-out of tracking

Important: This plugin requires a BetterCX account and API key to function. The plugin is free, but the BetterCX service may have usage limits or pricing tiers.

For more information about the BetterCX service, visit bettercx.ai.

External Services

This plugin uses the following external services:

BetterCX API Service

What it is: AI-powered customer support service that processes chat messages and provides intelligent responses.

What data is sent:
* Chat messages sent through the widget
* Session information for authentication
* Website origin for security validation

When data is sent:
* When a user sends a message through the chat widget
* When the widget initializes and creates a session
* When the widget needs to authenticate with the service

Service Provider: BetterCX Inc.
Terms of Service: https://bettercx.ai/terms
Privacy Policy: https://bettercx.ai/privacy

Google Translate API (Optional)

What it is: Language detection service used to automatically detect the website’s language for proper widget localization.

What data is sent:
* Sample text from the website (first 1000 characters)
* Only sent when automatic language detection is enabled

When data is sent:
* Only when the widget needs to detect the website’s language
* Only if the language cannot be determined from HTML meta tags or browser settings

Service Provider: Google LLC
Terms of Service: https://policies.google.com/terms
Privacy Policy: https://policies.google.com/privacy

Note: This service is optional and only used for language detection. The widget will fall back to English if the service is unavailable or if the user has disabled this feature.

Important: The Google Translate API usage is implemented in the compiled JavaScript files (/assets/p-*.js) and is only called when automatic language detection is enabled. The source code for this functionality is available in /src/services/theme.service.ts in the detectLanguageWithGoogleTranslate() method.

Privacy Policy

This plugin integrates with the BetterCX service to provide AI-powered customer support. Here’s what you need to know about privacy:

Data Collection

The plugin may collect the following information:
* Chat messages sent through the widget
* Session information for authentication
* Basic usage analytics (with user consent)

Data Usage

Collected data is used to:
* Provide AI-powered responses to customer inquiries
* Maintain conversation context
* Improve the service quality
* Generate analytics and insights

Data Storage

• Chat messages are stored securely on BetterCX servers
• Session data is stored temporarily for authentication
• No sensitive data is stored locally on your WordPress site

User Rights

Users have the right to:
* Access their data
* Request data deletion
* Opt out of analytics tracking
* Close the chat widget at any time

Contact Information

For privacy-related questions, contact:
* Email: privacy@bettercx.ai
* Website: bettercx.ai/privacy

Service Terms

This plugin integrates with the BetterCX service. By using this plugin, you agree to:

• BetterCX Terms of Service: bettercx.ai/terms
• BetterCX Privacy Policy: bettercx.ai/privacy
• WordPress.org Plugin Directory Guidelines

The BetterCX service is provided by BetterCX Inc. and is subject to their terms and conditions.

Support

Getting Help

• Plugin Documentation: Check the plugin settings page for usage instructions
• WordPress.org Forums: Post questions in the plugin support forum
• BetterCX Support: Visit bettercx.ai/support
• Email Support: Contact office@appwave.dev

Reporting Issues

If you encounter any issues:
1. Check the plugin settings and configuration
2. Test with a default WordPress theme
3. Disable other plugins temporarily
4. Check the browser console for errors
5. Report the issue with detailed information

Feature Requests

We welcome feature requests! Please:
* Check if the feature already exists
* Describe the use case clearly
* Explain how it would benefit users
* Submit through our support channels

Development

Source Code

This plugin includes human-readable source code in the /src/ directory:
* TypeScript/React source files for the widget component
* SCSS source files for styling
* Service layer source code
* Type definitions
* Build configuration files

The source code is licensed under the MIT License (GPLv2+ compatible) and is provided to meet WordPress.org requirements for human-readable code.

Source Code Location: The complete source code is available in the /src/ directory of this plugin, including:
– /src/components/ – React/TypeScript components
– /src/services/ – API and authentication services
– /src/types/ – TypeScript type definitions
– /src/utils/ – Utility functions
– /src/global/ – Global styles

Building

To build the widget from source:
1. Navigate to the /src/ directory
2. Run npm install to install dependencies
3. Run npm run build to build the widget
4. The built files will be output to the assets/ directory

Build Process: The plugin uses Stencil.js build system to compile TypeScript/React source code into web components. The build process:
1. Compiles TypeScript source files from /src/ directory
2. Bundles and minifies JavaScript/CSS assets
3. Outputs compiled files to /assets/ directory
4. Generates multiple output formats (ES modules, SystemJS, UMD)

Contributing

This plugin is open source and welcomes contributions:
* Fork the repository
* Create a feature branch
* Follow WordPress coding standards
* Submit a pull request

Code Standards

The plugin follows:
* WordPress PHP Coding Standards
* WordPress JavaScript Coding Standards
* WordPress CSS Coding Standards
* PSR-12 coding standards where applicable

Testing

Before submitting changes:
* Test with multiple WordPress versions
* Test with different themes
* Test with other plugins
* Run PHP linting tools
* Test JavaScript functionality

License

This plugin is licensed under the GPLv2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Credits

Development Team

• BetterCX Team – Plugin development and maintenance
• WordPress Community – Testing and feedback
• Open Source Contributors – Code improvements and bug fixes

Third-Party Libraries

This plugin uses the following open source libraries:
* BetterCX Widget (MIT License)
* WordPress Core APIs (GPLv2+)
* Modern JavaScript (ES6+)

Acknowledgments

Special thanks to:
* WordPress.org Plugin Directory team
* WordPress community contributors
* Beta testers and early adopters
* All users who provide feedback and suggestions

Technical Details

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Modern web browser (Chrome 60+, Firefox 55+, Safari 12+, Edge 79+)
• HTTPS recommended for production use

Performance

• Lightweight and fast loading
• Optimized asset delivery
• Minimal database queries
• Efficient caching mechanisms

Security

• Input sanitization and validation
• Output escaping
• Nonce verification
• Capability checks
• Secure API communication

Compatibility

• WordPress 5.0 – 6.8+
• PHP 7.4 – 8.3+
• All major browsers
• Mobile and tablet devices
• Popular WordPress themes
• Major page builders

Additional Information

Plugin URI

https://wordpress.org/plugins/bettercx-widget/

Author URI

https://bettercx.ai

Tags

chat, widget, customer support, ai, live chat, support, customer service, chatbot, bettercx, artificial intelligence, automation, help desk, customer experience

Requires Plugins

None

Network

No

Multisite

Yes, works with WordPress Multisite

Export

Yes, settings can be exported and imported

Import

Yes, settings can be imported from exported files

Last Updated

2025-12-18

Version

1.0.21

Minimum WordPress Version

5.0

Tested WordPress Version

6.8

Minimum PHP Version

7.4

Tested PHP Version

8.3

Stable Tag

1.0.21

Development Version

1.0.21

Requires at least

5.0

Tested up to

6.8

Requires PHP

7.4

License

GPLv2 or later

License URI

https://www.gnu.org/licenses/gpl-2.0.html

Text Domain

bettercx-widget

Domain Path

/languages

Network

false

Update URI

https://wordpress.org/plugins/bettercx-widget/