feat: add beacon color customization settings and spam protection features

Author: ajaydsouza

docs/BEACON-WIDGET.md

@@ -1,6 +1,6 @@
 # Beacon Help Widget
 
-The Beacon is a floating help widget inspired by HelpScout's Beacon that provides self-service support with search, suggested articles, and a contact form.
+The Beacon is a floating help widget that provides self-service support with search, suggested articles, and a contact form.
 
 ## Features
 
@@ -10,6 +10,7 @@ The Beacon is a floating help widget inspired by HelpScout's Beacon that provide
 - **Self-Service Search** - Search knowledge base articles with debounced AJAX search (500ms)
 - **Smart Suggested Articles** - Context-aware articles using Related class for KB posts, recent articles elsewhere
 - **Contact Form** - HTML email contact with beautiful template when articles don't help
+- **Built-in Spam Protection** - Honeypot field plus anonymous rate limiting without storing IPs
 - **Stacked Navigation** - Mobile-app-style layered interface for smooth UX
 - **Responsive Design** - Works beautifully on desktop, tablet, and mobile devices
 - **Fixed Search Box** - Search box locked at bottom using CSS Grid for optimal UX
@@ -359,6 +360,7 @@ Add custom styles to override defaults:
 - Output escaping (esc_html, esc_attr, esc_url)
 - Email validation
 - XSS prevention in JavaScript
+- Honeypot field on the contact form and token-based rate limiting (no IP storage)
 
 ### Performance
 

includes/admin/class-settings.php

@@ -713,8 +713,8 @@ public static function settings_pro() {
 				'type'    => 'select',
 				'default' => 'kb_only',
 				'options' => array(
-					'kb_only'   => esc_html__( 'Knowledge Base Only', 'knowledgebase' ),
-					'sitewide'  => esc_html__( 'Entire Site', 'knowledgebase' ),
+					'kb_only'  => esc_html__( 'Knowledge Base Only', 'knowledgebase' ),
+					'sitewide' => esc_html__( 'Entire Site', 'knowledgebase' ),
 				),
 				'pro'     => true,
 			),
@@ -760,6 +760,60 @@ public static function settings_pro() {
 				'field_class' => 'color-field',
 				'pro'         => true,
 			),
+			'beacon_hover_color'        => array(
+				'id'          => 'beacon_hover_color',
+				'name'        => esc_html__( 'Beacon Hover Color', 'knowledgebase' ),
+				'desc'        => esc_html__( 'Hover color for buttons and interactive elements.', 'knowledgebase' ),
+				'type'        => 'color',
+				'default'     => '#4c63d2',
+				'field_class' => 'color-field',
+				'pro'         => true,
+			),
+			'beacon_text_color'         => array(
+				'id'          => 'beacon_text_color',
+				'name'        => esc_html__( 'Beacon Text Color', 'knowledgebase' ),
+				'desc'        => esc_html__( 'Text color for the beacon button and interface elements.', 'knowledgebase' ),
+				'type'        => 'color',
+				'default'     => '#ffffff',
+				'field_class' => 'color-field',
+				'pro'         => true,
+			),
+			'beacon_hover_text_color'   => array(
+				'id'          => 'beacon_hover_text_color',
+				'name'        => esc_html__( 'Beacon Hover Text Color', 'knowledgebase' ),
+				'desc'        => esc_html__( 'Text color for the beacon button on hover.', 'knowledgebase' ),
+				'type'        => 'color',
+				'default'     => '#ffffff',
+				'field_class' => 'color-field',
+				'pro'         => true,
+			),
+			'beacon_panel_bg_color'     => array(
+				'id'          => 'beacon_panel_bg_color',
+				'name'        => esc_html__( 'Panel Background Color', 'knowledgebase' ),
+				'desc'        => esc_html__( 'Background color for the beacon panel.', 'knowledgebase' ),
+				'type'        => 'color',
+				'default'     => '#ffffff',
+				'field_class' => 'color-field',
+				'pro'         => true,
+			),
+			'beacon_panel_text_color'   => array(
+				'id'          => 'beacon_panel_text_color',
+				'name'        => esc_html__( 'Panel Text Color', 'knowledgebase' ),
+				'desc'        => esc_html__( 'Default text color within the beacon panel.', 'knowledgebase' ),
+				'type'        => 'color',
+				'default'     => '#1a1a1a',
+				'field_class' => 'color-field',
+				'pro'         => true,
+			),
+			'beacon_link_hover_color'   => array(
+				'id'          => 'beacon_link_hover_color',
+				'name'        => esc_html__( 'Link Hover Background', 'knowledgebase' ),
+				'desc'        => esc_html__( 'Background color when hovering over beacon links and list items.', 'knowledgebase' ),
+				'type'        => 'color',
+				'default'     => '#f3f4f6',
+				'field_class' => 'color-field',
+				'pro'         => true,
+			),
 			'beacon_greeting'           => array(
 				'id'          => 'beacon_greeting',
 				'name'        => esc_html__( 'Greeting Message', 'knowledgebase' ),