| @@ -1,17 +1,16 @@ | ||
| 1 | -=== BetterDocs – Knowledge Base Docs & FAQ Solution for Elementor & Block Editor === | |
| 2 | -Contributors: wpdevteam, re_enter_rupok, asif2bd, emsohel, priyomukul, seakashdiu, bashar94, jamilbd07 | |
| 1 | +=== BetterDocs – AI Documentation, Knowledge Base, MCP Server, Docs, Wikis, FAQ & Chatbot === | |
| 2 | +Contributors: wpdevteam, re_enter_rupok, asif2bd, emsohel, priyomukul, seakashdiu, jamilbd07 | |
| 3 | 3 | Donate link: https://wpdeveloper.com |
| 4 | 4 | Tags: docs, documentation, knowledge base, faq, chatgpt ai writer |
| 5 | -Requires at least: 5.0 | |
| 6 | -Tested up to: 7.0 | |
| 5 | +Requires at least: 6.4 | |
| 6 | +Tested up to: 7.1 | |
| 7 | 7 | Requires PHP: 7.4 |
| 8 | -Stable tag: 4.5.1 | |
| 8 | +Stable tag: 4.9.3 | |
| 9 | 9 | License: GPLv3 or later |
| 10 | 10 | License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 11 | 11 | |
| 12 | -A full-featured documentation plugin including AI writing assistance to create knowledge bases, docs, FAQs, wikis, and more with easy drag & drop UI. | |
| 13 | - | |
| 12 | +Documentation, FAQ & Knowledge Base plugin to create docs, FAQs, product FAQ, wikis & help center with MCP, AI writing, instant answers & AI Chatbot. | |
| 14 | 13 | == Description == |
| 15 | 14 | |
| 16 | 15 | Do you want to reduce support tickets immediately? How about you creating a resourceful knowledge base for your customers with AI-powered documentation and FAQs? 🤔 |
| 17 | 16 | |
| @@ -36,8 +35,9 @@ | ||
| 36 | 35 | - In-built theme customization option, or use Shortcodes & Elementor widgets, or Gutenberg Blocks to design & customize the entire documentation page |
| 37 | 36 | - Table of Contents or Sticky TOC to provide an absolute user experience |
| 38 | 37 | - An in-built advanced live search bar to help visitors get the exact docs solution |
| 39 | 38 | - Advanced List View & Drag & Drop Grid View feature |
| 39 | +- Connect AI assistants like Claude, ChatGPT, and Cursor to your documentation via MCP with a simple OAuth-based setup — no coding or manual API configuration required | |
| 40 | 40 | - Create & manage multiple knowledge bases for all products separately (PRO) |
| 41 | 41 | - Manage roles for your knowledgebase users & give access accordingly |
| 42 | 42 | - Integrated with Analytics to track and evaluate the performance |
| 43 | 43 | - 100% Compatibility with Elementor Page Builder |
| @@ -76,8 +76,12 @@ | ||
| 76 | 76 | ## ✅ FULL SITE EDITOR (FSE) COMPATIBILITY ## |
| 77 | 77 | |
| 78 | 78 | Design your documentation, single docs, and archive pages effortlessly in the Block Editor using BetterDocs. |
| 79 | 79 | |
| 80 | +## 🛠️ AI-NATIVE DOCUMENTATION ACCESS WITH MCP ## | |
| 81 | + | |
| 82 | +Let AI assistants like Claude, ChatGPT, and Cursor read and write your documentation directly through the Model Context Protocol, so your team can create, update, and manage docs from chat instead of switching between tools. | |
| 83 | + | |
| 80 | 84 | ## 📋 INTERACTIVE TABLE OF CONTENTS (TOC) ## |
| 81 | 85 | |
| 82 | 86 | Create a reader-friendly [Table Of Contents(TOC)](https://wpdeveloper.com/display-toc-wordpress/) while you are writing your documentation. This TOC moves with your scroll, so your visitors can always go to other pages easily. |
| 83 | 87 | |
| @@ -131,8 +135,11 @@ | ||
| 131 | 135 | |
| 132 | 136 | ## 📚 EMBED RELATED DOCS IN SINGLE DOCUMENTATION ## |
| 133 | 137 | Incorporate relevant documentation into each document to promote supporting content and additional information. |
| 134 | 138 | |
| 139 | +## ⚡ AI-POWERED REAL-TIME RELATED DOCS (PRO) ## | |
| 140 | +Automatically suggest the most relevant documentation to your readers using AI-powered, real-time related docs, helping users discover answers faster and stay engaged. | |
| 141 | + | |
| 135 | 142 | ## 📙 GLOSSARY (PRO) ## |
| 136 | 143 | Create glossaries for frequently used terms or technical jargon and showcase them as tooltips so readers can easily understand them. |
| 137 | 144 | |
| 138 | 145 | ## 📖 ENCYCLOPEDIA (PRO) ## |
| @@ -207,13 +214,41 @@ | ||
| 207 | 214 | |
| 208 | 215 | |
| 209 | 216 | == Frequently Asked Questions == |
| 210 | 217 | |
| 211 | -= Does it work with any WordPress theme? = | |
| 218 | += What is BetterDocs used for? = | |
| 219 | +BetterDocs helps you create and manage a WordPress knowledge base, documentation site, FAQ section, wiki, or help center so visitors can find answers faster and your team can reduce repetitive support tickets. | |
| 212 | 220 | |
| 213 | -Yes, it will work with any standard WordPress theme. | |
| 221 | += Does BetterDocs work with any WordPress theme? = | |
| 222 | +Yes. BetterDocs works with standard WordPress themes. You can use it to create documentation pages and knowledge base layouts while keeping your existing site design. | |
| 214 | 223 | |
| 224 | += Can BetterDocs help reduce support tickets? = | |
| 225 | +Yes. By organizing documentation, FAQs, and help articles in a searchable knowledge base, BetterDocs helps customers find answers on their own before contacting support. | |
| 215 | 226 | |
| 227 | += Does BetterDocs include live search for documentation? = | |
| 228 | +Yes. BetterDocs includes an advanced search experience so visitors can quickly find relevant documentation articles, FAQs, and knowledge base content. | |
| 229 | + | |
| 230 | += Can I create documentation with Elementor or Gutenberg? = | |
| 231 | +Yes. BetterDocs supports designing documentation with ready templates and works with popular WordPress editing workflows, including Elementor and the Gutenberg block editor. | |
| 232 | + | |
| 233 | += Does BetterDocs support AI features? = | |
| 234 | +BetterDocs includes AI-focused documentation features such as writing assistance, document summarization, quality analysis, and an AI chatbot experience depending on the feature setup and plan you use. | |
| 235 | + | |
| 236 | += Can I create an internal knowledge base with BetterDocs? = | |
| 237 | +Yes. BetterDocs can be used for internal documentation and private knowledge bases, including role-based access control for teams that need internal docs, SOPs, or company resources. | |
| 238 | + | |
| 239 | += Does BetterDocs support multiple knowledge bases? = | |
| 240 | +BetterDocs is designed to help organize documentation into categories and knowledge bases. Multiple knowledge base workflows are useful when you need separate docs for different products, teams, or audiences. | |
| 241 | + | |
| 242 | += Can I track how my documentation performs? = | |
| 243 | +Yes. BetterDocs provides analytics-focused features to help you understand documentation performance, visitor behavior, popular docs, and opportunities to improve your help center content. | |
| 244 | + | |
| 245 | += Is BetterDocs useful for multilingual documentation? = | |
| 246 | +Yes. BetterDocs supports multilingual documentation workflows and integrates with multilingual tools such as WPML, helping you create knowledge base content for users in different languages. | |
| 247 | + | |
| 248 | += Can I connect ChatGPT or Claude to my documentation? = | |
| 249 | +Yes. BetterDocs includes an MCP server, which lets AI assistants such as Claude, ChatGPT, Cursor and VS Code work with your documentation directly. Turn it on under BetterDocs → MCP, copy the connection URL, and add it to your assistant — it will ask you to approve the connection on your own site. | |
| 250 | + | |
| 216 | 251 | == Screenshots == |
| 217 | 252 | |
| 218 | 253 | |
| 219 | 254 | |
| @@ -218,8 +253,134 @@ | ||
| 218 | 253 | |
| 219 | 254 | |
| 220 | 255 | == Changelog == |
| 221 | 256 | |
| 257 | += 4.9.3 - 27/09/2026 = | |
| 258 | + | |
| 259 | +- Fixed: Doc URLs that do not exist now return a proper 404 instead of an empty page, on sites using category-in-path permalinks | |
| 260 | +- Fixed: Live search returned no results when the knowledge base is served from a subdomain or a domain alias | |
| 261 | +- Fixed: Single Doc Layout 5 no longer shows Table of Contents Background, Hover and Padding controls that had no effect on the page | |
| 262 | +- Fixed: Encyclopedia entries are now listed alphabetically within each letter, instead of newest first | |
| 263 | +- Fixed: MCP OAuth discovery could answer for — or be answered by — another MCP-enabled plugin on the same site, so connecting clients were handed metadata for the wrong plugin | |
| 264 | +- Few minor bug fixes and improvements | |
| 265 | + | |
| 266 | += 4.9.2 - 16/09/2026 = | |
| 267 | + | |
| 268 | +- Fixed: Customizer layout migration seeded the wrong defaults, so saved layouts reverted to Layout 1 | |
| 269 | +- Fixed: Nested subcategories could be cached while empty and stay empty until the cache expired | |
| 270 | +- Fixed: Term counts were not refreshed after a recount, and an aborted import left counts stale | |
| 271 | +- Fixed: Category grids now collapse to a single column below 500px | |
| 272 | +- Fixed: FAQ group titles can now have their own background color | |
| 273 | +- Few minor bug fixes and improvements | |
| 274 | + | |
| 275 | += 4.9.1 - 03/09/2026 = | |
| 276 | + | |
| 277 | +- New: Print template — add your logo and a custom footer to printed / PDF pages, from Settings → Layout → Single Doc | |
| 278 | +- Improvement: Glossaries now show a preview in Free, so you can see what the Pro feature does before upgrading | |
| 279 | +- Improvement: MCP catalogue now surfaces Pro's API Docs, insights, Git Sync and related-docs abilities; connection self-test no longer flags healthy endpoints as broken | |
| 280 | +- Fixed: The Documentation grid hid knowledge bases containing only private docs from admins and editors | |
| 281 | +- Fixed: Doc Category Archive layouts 2 and 3 never rendered nested subcategories | |
| 282 | +- Fixed: "Lazy Load Sidebar Docs & Subcategories" now works for nested categories across both Elementor and block layouts | |
| 283 | +- Fixed: Single doc URLs with arbitrary category segments returned 200 instead of redirecting to the real permalink | |
| 284 | +- Fixed: Importing docs failed with a critical error on exported XML files and on docs with existing slugs | |
| 285 | +- Fixed: The AI Content Suite showed "undefined" / "[object Object]" instead of a readable message when the API key is invalid | |
| 286 | +- Improved: Security Enhancement | |
| 287 | +- Few minor bug fixes and improvements | |
| 288 | + | |
| 289 | += 4.9.0 - 27/08/2026 = | |
| 290 | + | |
| 291 | +- New: MCP Server — connect Claude, Cursor, VS Code and other MCP-capable editors directly to your knowledge base over a per-site endpoint, with OAuth 2.1 consent, pairing tokens and rate limiting | |
| 292 | +- New: BetterDocs registers its docs, categories, tags, glossary, FAQ, settings and analytics with the WordPress Abilities API, so any Abilities-aware tool can read and write your knowledge base | |
| 293 | +- New: MCP admin page with a connection health report, self-test, per-tool picker and ready-made setup snippets for each supported editor | |
| 294 | +- Improvement: Knowledge base meta is now visible over REST, and the FAQ Builder capability check repairs itself when roles drift | |
| 295 | +- Fix: Document import no longer fails on PHP 8 — WP_Importer has no constructor, and calling it aborted every import | |
| 296 | +- Fix: The FAQ block now accepts bare term IDs in its group filters | |
| 297 | +- Few minor bug fixes and improvements | |
| 298 | + | |
| 299 | += 4.8.2 - 20/08/2026 = | |
| 300 | + | |
| 301 | +- New: Code Snippet Tab — a tabbed, multi-language code block available as both a Gutenberg block and an Elementor widget | |
| 302 | +- New: Write with AI can now draft from an uploaded file (TXT, MD, DOCX, PDF) or read image attachments (PNG, JPG, WEBP) using a vision model | |
| 303 | +- Improvement: Code Snippet block, Elementor widget & shortcode now support multiple languages with a built-in language switcher and self-hosted syntax highlighting (no external requests) | |
| 304 | +- Improvement: Content Area Width & Max Width controls for the single doc layout in the Customizer | |
| 305 | +- Improved: Security Enhancement | |
| 306 | +- Few minor bug fixes and improvements | |
| 307 | + | |
| 308 | += 4.8.1 - 04/08/2026 = | |
| 309 | + | |
| 310 | +- Few minor bug fixes and improvements | |
| 311 | + | |
| 312 | += 4.8.0 - 04/08/2026 = | |
| 313 | + | |
| 314 | +- New: Multiple AI platform support — choose OpenAI, Google Gemini, Anthropic Claude for Write with AI and the Docs AI Suite | |
| 315 | +- Improvement: Documentation archive & sidebar performance — term-count caching plus an optional "Lazy Load Sidebar Docs & Subcategories" mode for large knowledge bases | |
| 316 | +- Fixed: WPML-translated doc tag & category base slugs now resolve correctly in routing and term links | |
| 317 | +- Improved: Security Enhancement | |
| 318 | +- Few minor bug fixes and improvements | |
| 319 | + | |
| 320 | += 4.7.0 - 22/07/2026 = | |
| 321 | + | |
| 322 | +- New: AI category, tag & glossary suggestions in the editor and in the Write with AI flow | |
| 323 | +- Improvement: Redesigned "Write with AI" and "Edit with BetterDocs AI" modals — cleaner AI Studio surfaces aligned to the design system, with reusable instruction Guides | |
| 324 | +- Improved: Security Enhancement | |
| 325 | +- Few minor bug fixes and improvements | |
| 326 | + | |
| 327 | += 4.6.2 - 16/07/2026 = | |
| 328 | + | |
| 329 | +- Improvement: AI Sample Docs — deeper knowledge base generation grounded in your real site content, with AI-designed outlines expanded into full articles (inserted as drafts for review) | |
| 330 | +- Improvement: AI Sample FAQs — AI now designs the FAQ groups, questions & answers from your site content, including store-wide and per-category Product FAQs for WooCommerce | |
| 331 | +- Improvement: Product FAQ groups can now target all products or specific products | |
| 332 | +- Improvement: Quick Setup wizard now hands off to the Site Editor on block (FSE) themes | |
| 333 | +- Improvement: FAQ Builder — clearer published/draft group counts and a dedicated Uncategorized bucket for Product FAQs | |
| 334 | +- Few minor bug fixes and improvements | |
| 335 | + | |
| 336 | += 4.6.1 - 09/07/2026 = | |
| 337 | + | |
| 338 | +- Improved: Security Enhancement | |
| 339 | +- Few minor bug fixes and improvements | |
| 340 | + | |
| 341 | += 4.6.0 - 07/07/2026 = | |
| 342 | + | |
| 343 | +- New: AI-powered "Generate Sample Docs & FAQs" — auto-detects your site and instantly creates a starter knowledge base or FAQ set | |
| 344 | +- New: Product FAQ for WooCommerce — dedicated FAQ groups that display on single product pages | |
| 345 | +- New: Rich text (HTML) editor support in the FAQ Builder | |
| 346 | +- Improvement: Revamped admin with new React-based Knowledge Base, Doc Categories, Doc Tags, FAQ Builder and Glossaries screens | |
| 347 | +- Fixed: Code Snippet block now correctly removes cleared code on the frontend | |
| 348 | +- Few minor bug fixes and improvements | |
| 349 | + | |
| 350 | += 4.5.6 - 30/06/2026 = | |
| 351 | + | |
| 352 | +- Fixed: Redirect issue with Glossary & Learn More buttons in the Gutenberg/FSE environment | |
| 353 | +- Few minor bug fixes and improvements | |
| 354 | + | |
| 355 | += 4.5.5 - 23/06/2026 = | |
| 356 | + | |
| 357 | +- Improved: Security Enhancement | |
| 358 | +- Few minor bug fixes and improvements | |
| 359 | + | |
| 360 | += 4.5.4 - 18/06/2026 = | |
| 361 | + | |
| 362 | +- Added: Translated documents support in BetterDocs Export | |
| 363 | +- Fixed: Scheduled doc showing wrong "Updated on" date after publish | |
| 364 | +- Improved: Plugin integration list completeness during initial setup | |
| 365 | +- Improved: Compatibility with PHP 8.4 and PHP 8.5 | |
| 366 | +- Improved: Security Enhancement | |
| 367 | +- Few minor bug fixes and improvements | |
| 368 | + | |
| 369 | += 4.5.3 - 10/06/2026 = | |
| 370 | + | |
| 371 | +- Fixed: AI Chatbot tab — Save failing with 'Could not get a valid response from the server' error | |
| 372 | + | |
| 373 | += 4.5.2 - 08/06/2026 = | |
| 374 | + | |
| 375 | +- Added: Tag archive template for the Elementor theme builder | |
| 376 | +- Added: GPT-5 and GPT-5.5 support for the BetterDocs AI Content Suite | |
| 377 | +- Improved: Tag and category based search support across Customizer, blocks, widgets, and WordPress search | |
| 378 | +- Fixed: Search modal results jumping while typing and returning no results for known keywords | |
| 379 | +- Fixed: Non-heading options (H6, Div, Nav, P) for the sidebar block Category Title Tag | |
| 380 | +- Few minor bug fixes and improvements | |
| 381 | + | |
| 382 | + | |
| 222 | 383 | = 4.5.1 - 25/05/2026 = |
| 223 | 384 | |
| 224 | 385 | - Fixed: Fatal error in category counter templates on PHP 8.x triggered by a translation issue in some locales |
| 225 | 386 | |
| @@ -686,7 +847,5 @@ | ||
| 686 | 847 | |
| 687 | 848 | == Upgrade Notice == |
| 688 | 849 | |
| 689 | 850 | = 2.5.6 = |
| 690 | -Attention! Please Backup your site before updating. | |
| 691 | - | |
| 692 | -The latest version of **BetterDocs v2.5** includes massive changes across different areas of the plugin with revamped code structure for optimized performance. We would highly recommend you to [backup your entire site](https://wpdeveloper.com/backup-wordpress-site/) before updating the plugin & test it on your staging website. [Contact our Support](https://wpdeveloper.com/support/) if you encounter any kind of errors or if you need any kind of assistance. | |
| 851 | +Attention! Please backup your site before updating. v2.5 includes massive changes with revamped code for optimized performance. Test on staging first; [contact support](https://wpdeveloper.com/support/) if needed. | |
