=== BetterCX Widget === Contributors: appwavedev Tags: chat, widget, customer support, ai, live chat Requires at least: 5.0 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.0.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Professional AI-powered chat widget for BetterCX platform. Seamlessly integrate intelligent customer support into any WordPress website. == Description == 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 * **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 * **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](https://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. == Installation == = Automatic Installation = 1. Log in to your WordPress admin dashboard 2. Navigate to Plugins > Add New 3. Search for "BetterCX Widget" 4. Click "Install Now" and then "Activate" 5. Go to Settings > BetterCX Widget to configure = Manual Installation = 1. Download the plugin files 2. Upload the `bettercx-widget` folder to `/wp-content/plugins/` 3. Activate the plugin through the 'Plugins' menu in WordPress 4. Go to Settings > BetterCX Widget to configure = Configuration = 1. **Get Your Public Key**: Sign up at [bettercx.ai](https://bettercx.ai) and get your widget public key 2. **Enter Your Key**: Go to Settings > BetterCX Widget and enter your public key 3. **Customize Appearance**: Choose theme, position, and other visual options 4. **Test Connection**: Use the "Test Connection" button to verify your setup 5. **Deploy**: The widget will automatically appear on your site == Frequently Asked Questions == = How do I get started? = 1. Install and activate the plugin 2. Get your public key from the BetterCX dashboard 3. Enter the key in the plugin settings 4. Customize the appearance to match your brand 5. The widget will automatically appear on your site = Is this plugin free? = Yes, the plugin is completely free to use. BetterCX offers various pricing plans for the AI-powered backend services, but the WordPress plugin itself is free and open source. = What data does the plugin collect? = The plugin only collects: * Messages sent through the chat widget (for AI responses) * Session information (for authentication) * Basic usage analytics (with user consent) No personal information is collected without explicit consent. = Can I customize the appearance? = Yes! The plugin offers extensive customization options: * Light, dark, or automatic theme detection * Left or right positioning * Custom CSS support * Brand color customization * Custom widget titles * Image upload and sharing capabilities * Optional "Powered by BetterCX" attribution display = Does it work on mobile devices? = Absolutely! The widget is fully responsive and optimized for: * Desktop computers * Tablets * Mobile phones * All screen sizes and orientations = Can I use it with any WordPress theme? = Yes, the plugin is designed to work with any WordPress theme. It uses modern web standards and doesn't interfere with your theme's styling. = Is it compatible with page builders? = Yes, the plugin works with all major page builders including: * Elementor * Gutenberg * Beaver Builder * Divi * Visual Composer * And many more = How do I track widget interactions? = The plugin provides several ways to track interactions: * WordPress action hooks * JavaScript event listeners * Google Analytics integration (optional) * Custom event handlers = Can I disable the widget on certain pages? = Yes, you can: * Disable globally in settings * Use shortcode attributes to control individual instances * Use WordPress conditional tags in your theme * Exclude specific pages or post types = Is the plugin secure? = Yes, the plugin follows WordPress security best practices: * Input sanitization and validation * Output escaping * Nonce verification for forms * Capability checks for admin functions * No external script loading without consent = What if I need help? = We provide comprehensive support: * Plugin documentation * WordPress.org support forums * BetterCX support center * Email support for premium users == Screenshots == 1. **Admin Settings Page** - Clean, intuitive settings interface 2. **Widget on Website** - Professional chat widget in action 3. **Mobile View** - Responsive design on mobile devices 4. **Customization Options** - Theme and appearance settings 5. **Event Tracking** - Analytics and monitoring features == Changelog == = 1.0.1 = * Added customizable widget title support * Added "Powered by BetterCX" attribution toggle * Added image upload and sharing capabilities * Enhanced customization options * Updated documentation and examples = 1.0.0 = * Initial release * Full WordPress integration * Shortcode and widget support * Admin settings interface * Mobile responsive design * Event tracking and analytics * Custom CSS support * Privacy policy integration * GPLv2+ licensing * WordPress coding standards compliance == Upgrade Notice == = 1.0.1 = New features: customizable titles, image upload support, and attribution controls. Enhanced customization options for better brand integration. = 1.0.0 = Initial release of the BetterCX Widget plugin. Install to add AI-powered customer support to your WordPress site. == 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](https://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](https://bettercx.ai/terms) * BetterCX Privacy Policy: [bettercx.ai/privacy](https://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](https://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 = 2024-01-15 = Version = 1.0.0 = Minimum WordPress Version = 5.0 = Tested WordPress Version = 6.8 = Minimum PHP Version = 7.4 = Tested PHP Version = 8.3 = Stable Tag = 1.0.0 = Development Version = 1.0.0 = 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/