{"id":269882,"date":"2026-04-09T06:57:31","date_gmt":"2026-04-09T06:57:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/sideconvo-button-customizer\/"},"modified":"2026-04-09T06:58:38","modified_gmt":"2026-04-09T06:58:38","slug":"sideconvo-button-customizer","status":"publish","type":"plugin","link":"https:\/\/es-mx.wordpress.org\/plugins\/sideconvo-button-customizer\/","author":23430745,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.4","stable_tag":"1.0.4","tested":"6.9.4","requires":"5.9","requires_php":"7.4","requires_plugins":null,"header_name":"Sideconvo Button Customizer","header_author":"ITXI","header_description":"A WordPress plugin that provides a robust initial setup for an external widget with React admin interface.","assets_banners_color":"","last_updated":"2026-04-09 06:58:38","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.sideconvo.ai","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":37,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.4":{"tag":"1.0.4","author":"sideconvo","date":"2026-04-09 06:58:38"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3502297,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3502297,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":3502297,"resolution":false,"location":"assets","locale":false}},"assets_banners":[],"assets_blueprints":{},"all_blocks":{"scs\/cta-button":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"scs\/cta-button","version":"0.4.0","title":"Sideconvo Button","category":"widgets","icon":"admin-page","description":"Customizable button block with interactive rotating text, border customization, and stunning gradient animations","example":{},"attributes":{"title":{"type":"string","default":""},"customAttributes":{"type":"array","default":[{"key":"data-sideconvo-message","value":""},{"key":"data-sideconvo-mode","value":"CHAT"}]},"backgroundColor":{"type":"string","default":"#701471"},"textColor":{"type":"string","default":"#ffffff"},"borderRadius":{"type":"number","default":20},"buttonHeight":{"type":"number","default":32},"buttonHeightOption":{"type":"string","default":"regular","enum":["compact","regular","custom"]},"logoOption":{"type":"string","default":"genstars-white"},"customLogoUrl":{"type":"string","default":""},"customLogos":{"type":"array","default":[]},"buttonStyle":{"type":"string","default":"animated","enum":["solid","animated"]},"gradientColor1":{"type":"string","default":"#b3425a"},"gradientColor2":{"type":"string","default":"#7c3aed"},"borderColor":{"type":"string","default":"#b3425a"},"borderStyle":{"type":"string","default":"none"},"fontSize":{"type":"number","default":13},"resizeMode":{"type":"string","default":"static","enum":["dynamic","static"]},"borderType":{"type":"string","default":"none","enum":["none","solid","gradient"]},"borderGradientColor1":{"type":"string","default":"#b3425a"},"borderGradientColor2":{"type":"string","default":"#7c3aed"},"themeCustomizable":{"type":"boolean","default":false},"darkModeBackgroundColor":{"type":"string","default":"#181a20"},"darkModeTextColor":{"type":"string","default":"#ffffff"},"darkModeLogoOption":{"type":"string","default":"genstars-white"},"darkModeBackgroundType":{"type":"string","default":"solid","enum":["solid","gradient"]},"darkModeGradientColor1":{"type":"string","default":"#b3425a"},"darkModeGradientColor2":{"type":"string","default":"#7c3aed"},"interactiveButton":{"type":"boolean","default":false},"interactiveTexts":{"type":"array","default":[]},"collapseAtEnd":{"type":"boolean","default":true},"marginTop":{"type":"string","default":"0px"},"marginRight":{"type":"string","default":"0px"},"marginBottom":{"type":"string","default":"0px"},"marginLeft":{"type":"string","default":"0px"},"marginLinked":{"type":"boolean","default":true},"marginPreset":{"type":"string","default":"none"},"forceInit":{"type":"boolean","default":false}},"supports":{"html":false},"textdomain":"scs-cta-button","editorScript":"file:..\/..\/..\/assets\/build\/blocks.js","editorStyle":"file:..\/..\/..\/assets\/build\/blocks.css","render":"file:.\/render.php"}},"tagged_versions":["1.0.4"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"<p>The Sideconvo Button block settings panel.<\/p>","2":"<p>Example of the button on the frontend.<\/p>","3":"<p>The plugin settings page for the API key.<\/p>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2353,1320,5707,2768,259782],"plugin_category":[41,43],"plugin_contributors":[234130],"plugin_business_model":[],"class_list":["post-269882","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-assistant","plugin_tags-chat","plugin_tags-customizer","plugin_tags-sideconvo-button","plugin_category-communication","plugin_category-customization","plugin_contributors-itxiplugins","plugin_committers-sideconvo"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/sideconvo-button-customizer\/assets\/icon.svg?rev=3502297","icon":"https:\/\/ps.w.org\/sideconvo-button-customizer\/assets\/icon.svg?rev=3502297","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>The Sideconvo Button Customizer is the perfect tool to integrate and unlock the full potential of the Sideconvo AI agent on your WordPress site.<\/p>\n\n<p>This plugin provides a user-friendly <strong>Gutenberg block<\/strong> 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.<\/p>\n\n<p><strong>Key Features<\/strong><\/p>\n\n<p><strong>Quick Integration:<\/strong> Seamlessly connects your site to your Sideconvo AI agent using your unique Site Key.<\/p>\n\n<p><strong>Customizable Gutenberg Block:<\/strong> Use the native block editor to easily place the Sideconvo AI button exactly where you need it.<\/p>\n\n<p><strong>Flexible Interaction Modes:<\/strong><\/p>\n\n<ul>\n<li><p><strong>Chat Mode:<\/strong> Opens a text-based chat interface.<\/p><\/li>\n<li><p><strong>Speak Mode:<\/strong> Initiates a voice-based interaction (requires microphone access).<\/p><\/li>\n<\/ul>\n\n<p><strong>Design Controls:<\/strong> Customize colors, backgrounds, button labels, and icons to perfectly match your site's branding.<\/p>\n\n<p><strong>Boost Engagement:<\/strong> Provide 24\/7 instant support and answers to your site visitors, improving user experience.<\/p>\n\n<p><strong>Support<\/strong><\/p>\n\n<p>If you encounter any issues or have questions, please visit our <a href=\"https:\/\/www.sideconvo.ai\">Support Page<\/a> or contact us directly.<\/p>\n\n<h3>External Services<\/h3>\n\n<p><strong>Important: This plugin connects to external Sideconvo services to provide AI functionality.<\/strong><\/p>\n\n<p>This plugin integrates with Sideconvo (https:\/\/www.sideconvo.ai), a third-party AI agent platform that provides conversational AI capabilities for your website.<\/p>\n\n<h4>When does the connection occur?<\/h4>\n\n<p>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:\n    https:\/\/[scbc-domain]\/button\/[your-site-key]\/spotlight.js<\/p>\n\n<p>The connection occurs only when:\n* You have configured a valid Site Key in the plugin settings\n* A visitor loads a page containing the Sideconvo button block<\/p>\n\n<h4>What data is transmitted?<\/h4>\n\n<p>When the Sideconvo widget is loaded and used, the following data is transmitted to Sideconvo's servers:<\/p>\n\n<ul>\n<li>Your unique Site Key (configured in plugin settings)<\/li>\n<li>User interactions with the AI chat interface<\/li>\n<li>Browser information (user agent, language preferences)<\/li>\n<li>Page URL where the button is located<\/li>\n<li>Any messages or voice input the user provides to the AI agent<\/li>\n<li>Session information for maintaining conversation context<\/li>\n<\/ul>\n\n<h4>Data Processing<\/h4>\n\n<p>All AI processing and conversation data is handled by Sideconvo's servers, not on your WordPress site. Sideconvo uses this data to:<\/p>\n\n<ul>\n<li>Provide AI-powered responses to user queries<\/li>\n<li>Maintain conversation history during a session<\/li>\n<li>Improve AI agent performance and accuracy<\/li>\n<li>Generate analytics about AI agent usage<\/li>\n<\/ul>\n\n<h4>Privacy &amp; Terms<\/h4>\n\n<p>For more information about how Sideconvo handles your data, please review:<\/p>\n\n<ul>\n<li>Sideconvo Terms of Service: https:\/\/www.sideconvo.ai\/terms-of-service\/<\/li>\n<li>Sideconvo Privacy Policy: https:\/\/www.sideconvo.ai\/privacy\/<\/li>\n<\/ul>\n\n<h4>Your Responsibilities<\/h4>\n\n<p>As a site owner using this plugin, you are responsible for:<\/p>\n\n<ul>\n<li>Informing your visitors that your site uses Sideconvo's AI service<\/li>\n<li>Including Sideconvo's privacy policy information in your site's privacy documentation<\/li>\n<li>Obtaining necessary user consent per applicable privacy regulations (GDPR, CCPA, etc.)<\/li>\n<li>Understanding Sideconvo's data handling practices<\/li>\n<li>Ensuring compliance with your local data protection laws<\/li>\n<\/ul>\n\n<h4>Service Provider<\/h4>\n\n<p>This external service is provided by:<\/p>\n\n<p><strong>Sideconvo AI<\/strong>\n* Website: https:\/\/www.sideconvo.ai\n* Service: AI conversational agent platform<\/p>\n\n<h3>Source Code<\/h3>\n\n<p>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.<\/p>\n\n<h4>Source Code Location<\/h4>\n\n<p>All uncompiled source code is included in the <code>src\/<\/code> directory of this plugin:<\/p>\n\n<ul>\n<li><code>src\/apps\/settings\/<\/code> - React-based admin settings interface<\/li>\n<li><code>src\/blocks\/scbc-button\/<\/code> - Gutenberg block editor components<\/li>\n<li><code>src\/components\/<\/code> - Reusable React components<\/li>\n<li><code>src\/models\/<\/code> - TypeScript type definitions<\/li>\n<li><code>src\/services\/<\/code> - API utility functions<\/li>\n<\/ul>\n\n<p>The compiled production files are located in <code>assets\/build\/<\/code>:<\/p>\n\n<ul>\n<li><code>settings.js<\/code> \/ <code>settings.css<\/code> - Admin interface bundle<\/li>\n<li><code>blocks.js<\/code> \/ <code>blocks.css<\/code> - Gutenberg block editor bundle<\/li>\n<\/ul>\n\n<h4>Build Tools &amp; Configuration<\/h4>\n\n<p>The following configuration files are included:<\/p>\n\n<ul>\n<li><code>package.json<\/code> - NPM dependencies and build scripts<\/li>\n<li><code>tsconfig.json<\/code> - TypeScript compiler configuration<\/li>\n<li><code>webpack.config.js<\/code> - Webpack bundler configuration<\/li>\n<\/ul>\n\n<h4>How to Build from Source<\/h4>\n\n<p>If you want to modify and rebuild the plugin from source code:<\/p>\n\n<p><strong>Prerequisites:<\/strong>\n* Node.js 22.x or higher\n* npm (comes with Node.js)<\/p>\n\n<p><strong>Build Steps:<\/strong><\/p>\n\n<ol>\n<li><p>Navigate to the plugin directory:\n   cd wp-content\/plugins\/sideconvo-button-customizer<\/p><\/li>\n<li><p>Install dependencies:\n   npm install<\/p><\/li>\n<li><p>For development (with watch mode):\n   npm start<\/p><\/li>\n<li><p>For production build (minified):\n   npm run build<\/p><\/li>\n<\/ol>\n\n<p>The compiled files will be generated in the <code>assets\/build\/<\/code> directory.<\/p>\n\n<h4>Technologies Used<\/h4>\n\n<ul>\n<li><strong>React<\/strong> 18.2.0 - UI framework<\/li>\n<li><strong>TypeScript<\/strong> 5.x - Type-safe JavaScript<\/li>\n<li><strong>Webpack<\/strong> 5 - Module bundler<\/li>\n<li><strong>@wordpress\/scripts<\/strong> 30.19.0 - WordPress official build tools<\/li>\n<li><strong>Babel<\/strong> - JavaScript transpiler<\/li>\n<\/ul>\n\n<p>All dependencies are listed in <code>package.json<\/code> with specific versions for reproducible builds.<\/p>\n\n<!--section=installation-->\n<ol>\n<li><p><strong>Install:<\/strong> Upload the plugin files to the \/wp-content\/plugins\/sideconvo-button-customizer directory, or install the plugin through the WordPress plugins screen.<\/p><\/li>\n<li><p><strong>Activate:<\/strong> Activate the plugin through the 'Plugins' screen in WordPress.<\/p><\/li>\n<li><p><strong>Connect:<\/strong><\/p><\/li>\n<\/ol>\n\n<ul>\n<li><p>Obtain your unique <strong>Site Key<\/strong> from your <a href=\"https:\/\/www.sideconvo.ai\">Sideconvo Dashboard<\/a>.<\/p><\/li>\n<li><p>In WordPress, navigate to <strong>Settings &gt; Sideconvo Button<\/strong>.<\/p><\/li>\n<li><p>Enter your key and save the settings.<\/p><\/li>\n<\/ul>\n\n<ol>\n<li><strong>Use:<\/strong> Edit a page or post, search for the <strong>Sideconvo Button<\/strong> block, and add it to your content.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20get%20the%20site%20key%3F\"><h3>Where do I get the Site Key?<\/h3><\/dt>\n<dd><p>The Site Key is unique to your website and is provided by the Sideconvo platform when you set up your AI agent. You can find this key in your Sideconvo account dashboard.<\/p><\/dd>\n<dt id=\"what%20is%20the%20difference%20between%20%27speak%27%20and%20%27chat%27%20modes%3F\"><h3>What is the difference between 'Speak' and 'Chat' modes?<\/h3><\/dt>\n<dd><p>These modes determine how the AI agent interacts with the user when the button is clicked:<\/p>\n\n<p><strong>Chat:<\/strong> Opens a standard text-based chat interface.<\/p>\n\n<p><strong>Speak:<\/strong> Initiates a voice-based interaction (this requires the user to grant microphone access).<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20work%20with%20the%20classic%20editor%3F\"><h3>Does this plugin work with the Classic Editor?<\/h3><\/dt>\n<dd><p>No. This plugin is designed exclusively for the <strong>WordPress Block Editor (Gutenberg)<\/strong> to ensure modern customization capabilities and performance.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.3 - 2026-01-15<\/h4>\n\n<ul>\n<li>Added comprehensive External Services documentation as required by WordPress.org<\/li>\n<li>Added Source Code section with build instructions<\/li>\n<li>Added Site ID format validation for enhanced security<\/li>\n<li>Implemented rate limiting on API endpoints (10 requests per minute)<\/li>\n<li>Fixed generic variable naming (renamed sideconvoData to scbcData for consistency)<\/li>\n<li>Included complete source code in src\/ directory for transparency<\/li>\n<li>Improved compliance with WordPress.org plugin guidelines<\/li>\n<\/ul>\n\n<h4>1.0.2 - 2026-01-09<\/h4>\n\n<p>Initial release.<\/p>\n\n<p>Added Settings page for Sideconvo Site Key.<\/p>\n\n<p>Added Gutenberg block for AI trigger button.<\/p>\n\n<p>Added customization options for label, icon, colors, and background.<\/p>\n\n<p>Added interaction modes (Chat\/Speak).<\/p>","raw_excerpt":"Easily integrate the Sideconvo AI agent into WordPress. Add customizable chat or voice trigger buttons anywhere on your site via Gutenberg.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/269882","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=269882"}],"author":[{"embeddable":true,"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sideconvo"}],"wp:attachment":[{"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=269882"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=269882"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=269882"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=269882"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=269882"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/es-mx.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=269882"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}