Improve RTL styles, update settings and functions, update readme

- RTL CSS: add missing RTL rules for classic and vibrant themes
- class-settings.php: additional settings fields
- class-main.php: register new hooks
- functions.php: additional helper functions
- tom-select: update bundled JS to latest
- readme.txt / README.md: content updates

Fixes #75

Author: ajaydsouza

README.md

@@ -39,6 +39,7 @@ Effortlessly create a powerful, multi-product knowledge base. Boost your support
 - 🧭 __Built-in Breadcrumbs__ — Improve UX and SEO with breadcrumb navigation.
 - 🧩 __Widgets Included__ — WZKB Articles, WZKB Sections, and WZKB Breadcrumbs widgets.
 - ⚡ __Built-in Caching__ — Speed up your Knowledge Base without extra plugins.
+- 📋 __Auto Table of Contents__ — Automatically generate a linked Table of Contents from article headings, with configurable depth and minimum heading threshold.
 
 ### Pro features
 

includes/admin/class-settings.php

@@ -690,6 +690,46 @@ public static function settings_output() {
 				'type'    => 'checkbox',
 				'default' => true,
 			),
+			'toc_header'            => array(
+				'id'   => 'toc_header',
+				'name' => '<h3>' . esc_html__( 'Table of Contents', 'knowledgebase' ) . '</h3>',
+				'desc' => '',
+				'type' => 'header',
+			),
+			'show_toc'              => array(
+				'id'      => 'show_toc',
+				'name'    => esc_html__( 'Show table of contents', 'knowledgebase' ),
+				'desc'    => esc_html__( 'Auto-generate a table of contents from headings in article content. Only displays when there are sufficient headings.', 'knowledgebase' ),
+				'type'    => 'checkbox',
+				'default' => false,
+			),
+			'toc_heading_depth'     => array(
+				'id'      => 'toc_heading_depth',
+				'name'    => esc_html__( 'TOC heading depth', 'knowledgebase' ),
+				'desc'    => esc_html__( 'Maximum heading level to include in the table of contents. 2 includes only H2; 3 includes H2 and H3, and so on.', 'knowledgebase' ),
+				'type'    => 'number',
+				'default' => 4,
+				'size'    => 'small',
+				'min'     => 2,
+				'max'     => 6,
+			),
+			'toc_min_headings'      => array(
+				'id'      => 'toc_min_headings',
+				'name'    => esc_html__( 'Minimum headings for TOC', 'knowledgebase' ),
+				'desc'    => esc_html__( 'Minimum number of headings required before the table of contents is displayed.', 'knowledgebase' ),
+				'type'    => 'number',
+				'default' => 3,
+				'size'    => 'small',
+				'min'     => 1,
+				'max'     => 20,
+			),
+			'toc_title'             => array(
+				'id'      => 'toc_title',
+				'name'    => esc_html__( 'TOC title', 'knowledgebase' ),
+				'desc'    => esc_html__( 'Title displayed above the table of contents. Leave empty to hide the title.', 'knowledgebase' ),
+				'type'    => 'text',
+				'default' => __( 'Table of Contents', 'knowledgebase' ),
+			),
 		);
 
 		/**

includes/admin/settings/js/tom-select.complete.min.js

@@ -155,6 +155,15 @@ final class Main {
 	 */
 	public Frontend\Related $related_articles;
 
+	/**
+	 * Table of contents.
+	 *
+	 * @since 3.0.0
+	 *
+	 * @var Frontend\TOC TOC handler.
+	 */
+	public Frontend\TOC $toc;
+
 	/**
 	 * Block patterns.
 	 *
@@ -201,6 +210,7 @@ private function init() {
 		$this->styles           = new Frontend\Styles_Handler();
 		$this->display          = new Frontend\Display();
 		$this->related_articles = new Frontend\Related();
+		$this->toc              = new Frontend\TOC();
 		$this->search           = new Frontend\Search();
 		$this->shortcodes       = new Frontend\Shortcodes();
 		$this->feed             = new Frontend\Feed();

includes/class-main.php

@@ -14,12 +14,12 @@
 	--wzkb-color-text: #333;
 	--wzkb-color-text-medium: #666;
 	--wzkb-color-white: #fff;
-	--wzkb-color-orange: orange;
+	--wzkb-color-orange: #f97316;
 
 	/* Background colors */
 	--wzkb-bg-white: #fff;
 	--wzkb-bg-light: #f8f9fa;
-	--wzkb-bg-ghostwhite: ghostwhite;
+	--wzkb-bg-ghostwhite: #f8f8ff;
 
 	/* Border colors */
 	--wzkb-border-light: #e0e0e0;
@@ -189,11 +189,11 @@
 }
 
 .wzkb-section-name-level-1 {
-	border-bottom: 1px black dotted;
-	border-top: 1px black dotted;
-	padding: 5px 1px;
-	background-color: var(--wzkb-bg-ghostwhite);
-	margin-top: 30px;
+	border-bottom: 2px solid var(--wzkb-border-light);
+	border-top: none;
+	padding: 8px 0 10px;
+	background-color: transparent;
+	margin-top: 24px;
 	margin-bottom: 0;
 	grid-column: 1 / -1;
 }
@@ -242,25 +242,17 @@
 }
 
 .wzkb-articles-list li:before {
-	content: "\f123";
+	content: "›";
 	display: inline-block;
-	width: 20px;
-	height: 20px;
-	font-size: 20px;
-	line-height: 1;
-	font-family: dashicons;
-	text-decoration: inherit;
+	width: 16px;
+	font-size: 18px;
+	line-height: 1.4;
 	font-weight: 400;
-	font-style: normal;
-	vertical-align: top;
-	text-align: center;
-	-webkit-transition: color 0.1s ease-in 0;
-	transition: color 0.1s ease-in 0;
+	font-family: inherit;
 	-webkit-font-smoothing: antialiased;
 	-moz-osx-font-smoothing: grayscale;
-	margin-left: 10px;
-	word-wrap: break-word;
-	color: var(--wzkb-color-text-medium);
+	margin-left: 8px;
+	color: var(--wzkb-color-primary);
 }
 
 .wzkb-articles-list li a {
@@ -927,3 +919,51 @@ nav.pagination {
 	margin: 0;
 	line-height: 1.55;
 }
+
+/* Table of Contents */
+.wzkb-toc {
+	background: var(--wzkb-bg-light);
+	border: 1px solid var(--wzkb-border-light);
+	border-radius: 6px;
+	padding: 1rem 1.5rem;
+	margin-bottom: 2rem;
+	display: inline-block;
+	min-width: 200px;
+	max-width: 100%;
+	box-sizing: border-box;
+	box-shadow: 0 1px 4px var(--wzkb-shadow-color);
+}
+
+.wzkb-toc-title {
+	font-weight: 700;
+	margin: 0 0 0.5rem;
+	color: var(--wzkb-color-text-dark);
+	font-size: 15px;
+}
+
+.wzkb-toc-list,
+.wzkb-toc-list ul {
+	margin: 0;
+	padding-right: 1.25rem;
+	list-style: disc;
+}
+
+.wzkb-toc-list ul {
+	padding-right: 1.5rem;
+}
+
+.wzkb-toc-list li {
+	margin: 0.2rem 0;
+	line-height: 1.5;
+}
+
+.wzkb-toc-list a {
+	color: var(--wzkb-color-primary);
+	text-decoration: none;
+	transition: color 0.2s ease;
+}
+
+.wzkb-toc-list a:hover {
+	color: var(--wzkb-color-dark);
+	text-decoration: underline;
+}