Sideconvo Button Customizer

الوصف

The Sideconvo Button Customizer is the perfect tool to integrate and unlock the full potential of the Sideconvo AI agent on your WordPress site.

This plugin provides a user-friendly Gutenberg block that lets you add a customizable button anywhere on your site (pages or posts). This allows your visitors to instantly trigger your AI agent for interaction. Placing the button within specific content enables you to provide deep contextual help or additional information regarding the specific post or topic.

Key Features

Quick Integration: Seamlessly connects your site to your Sideconvo AI agent using your unique Site Key.

Customizable Gutenberg Block: Use the native block editor to easily place the Sideconvo AI button exactly where you need it.

Flexible Interaction Modes:

• Chat Mode: Opens a text-based chat interface.

• Speak Mode: Initiates a voice-based interaction (requires microphone access).

Design Controls: Customize colors, backgrounds, button labels, and icons to perfectly match your site’s branding.

Boost Engagement: Provide 24/7 instant support and answers to your site visitors, improving user experience.

Support

If you encounter any issues or have questions, please visit our Support Page or contact us directly.

External Services

Important: This plugin connects to external Sideconvo services to provide AI functionality.

This plugin integrates with Sideconvo (https://www.sideconvo.ai), a third-party AI agent platform that provides conversational AI capabilities for your website.

When does the connection occur?

When a visitor interacts with the Sideconvo button on your site, the plugin loads the Sideconvo JavaScript widget from Sideconvo’s servers. The widget script is dynamically loaded from:
https://[scbc-domain]/button/[your-site-key]/spotlight.js

The connection occurs only when:
* You have configured a valid Site Key in the plugin settings
* A visitor loads a page containing the Sideconvo button block

What data is transmitted?

When the Sideconvo widget is loaded and used, the following data is transmitted to Sideconvo’s servers:

• Your unique Site Key (configured in plugin settings)
• User interactions with the AI chat interface
• Browser information (user agent, language preferences)
• Page URL where the button is located
• Any messages or voice input the user provides to the AI agent
• Session information for maintaining conversation context

Data Processing

All AI processing and conversation data is handled by Sideconvo’s servers, not on your WordPress site. Sideconvo uses this data to:

• Provide AI-powered responses to user queries
• Maintain conversation history during a session
• Improve AI agent performance and accuracy
• Generate analytics about AI agent usage

Privacy & Terms

For more information about how Sideconvo handles your data, please review:

• Sideconvo Terms of Service: https://www.sideconvo.ai/terms-of-service/
• Sideconvo Privacy Policy: https://www.sideconvo.ai/privacy/

Your Responsibilities

As a site owner using this plugin, you are responsible for:

• Informing your visitors that your site uses Sideconvo’s AI service
• Including Sideconvo’s privacy policy information in your site’s privacy documentation
• Obtaining necessary user consent per applicable privacy regulations (GDPR, CCPA, etc.)
• Understanding Sideconvo’s data handling practices
• Ensuring compliance with your local data protection laws

Service Provider

This external service is provided by:

Sideconvo AI
* Website: https://www.sideconvo.ai
* Service: AI conversational agent platform

Source Code

This plugin’s JavaScript and CSS assets are compiled from source code using modern build tools. In compliance with WordPress.org guidelines, the complete human-readable source code is included with this plugin.

Source Code Location

All uncompiled source code is included in the src/ directory of this plugin:

• src/apps/settings/ – React-based admin settings interface
• src/blocks/scbc-button/ – Gutenberg block editor components
• src/components/ – Reusable React components
• src/models/ – TypeScript type definitions
• src/services/ – API utility functions

The compiled production files are located in assets/build/:

• settings.js / settings.css – Admin interface bundle
• blocks.js / blocks.css – Gutenberg block editor bundle

Build Tools & Configuration

The following configuration files are included:

• package.json – NPM dependencies and build scripts
• tsconfig.json – TypeScript compiler configuration
• webpack.config.js – Webpack bundler configuration

How to Build from Source

If you want to modify and rebuild the plugin from source code:

Prerequisites:
* Node.js 22.x or higher
* npm (comes with Node.js)

Build Steps:

1. Navigate to the plugin directory:
   cd wp-content/plugins/sideconvo-button-customizer

2. Install dependencies:
   npm install

3. For development (with watch mode):
   npm start

4. For production build (minified):
   npm run build

The compiled files will be generated in the assets/build/ directory.

Technologies Used

• React 18.2.0 – UI framework
• TypeScript 5.x – Type-safe JavaScript
• Webpack 5 – Module bundler
• @wordpress/scripts 30.19.0 – WordPress official build tools
• Babel – JavaScript transpiler

All dependencies are listed in package.json with specific versions for reproducible builds.