| @@ -1,16 +1,16 @@ | ||
| 1 | -=== BetterDocs – AI Documentation, Knowledge Base, Docs, Wikis, FAQ with Chatbot === | |
| 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 | 5 | Requires at least: 6.4 |
| 6 | -Tested up to: 7.0 | |
| 6 | +Tested up to: 7.1 | |
| 7 | 7 | Requires PHP: 7.4 |
| 8 | -Stable tag: 4.6.2 | |
| 8 | +Stable tag: 4.9.4 | |
| 9 | 9 | License: GPLv3 or later |
| 10 | 10 | License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 11 | 11 | |
| 12 | -Documentation, FAQ & Knowledge Base plugin to create docs, FAQs, product FAQ, wikis & help center with AI writing, instant answers & AI Chatbot. | |
| 12 | +Documentation, FAQ & Knowledge Base plugin to create docs, FAQs, product FAQ, wikis & help center with MCP, AI writing, instant answers & AI Chatbot. | |
| 13 | 13 | == Description == |
| 14 | 14 | |
| 15 | 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? 🤔 |
| 16 | 16 | |
| @@ -35,8 +35,9 @@ | ||
| 35 | 35 | - In-built theme customization option, or use Shortcodes & Elementor widgets, or Gutenberg Blocks to design & customize the entire documentation page |
| 36 | 36 | - Table of Contents or Sticky TOC to provide an absolute user experience |
| 37 | 37 | - An in-built advanced live search bar to help visitors get the exact docs solution |
| 38 | 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 | |
| 39 | 40 | - Create & manage multiple knowledge bases for all products separately (PRO) |
| 40 | 41 | - Manage roles for your knowledgebase users & give access accordingly |
| 41 | 42 | - Integrated with Analytics to track and evaluate the performance |
| 42 | 43 | - 100% Compatibility with Elementor Page Builder |
| @@ -75,8 +76,12 @@ | ||
| 75 | 76 | ## ✅ FULL SITE EDITOR (FSE) COMPATIBILITY ## |
| 76 | 77 | |
| 77 | 78 | Design your documentation, single docs, and archive pages effortlessly in the Block Editor using BetterDocs. |
| 78 | 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 | + | |
| 79 | 84 | ## 📋 INTERACTIVE TABLE OF CONTENTS (TOC) ## |
| 80 | 85 | |
| 81 | 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. |
| 82 | 87 | |
| @@ -239,8 +244,11 @@ | ||
| 239 | 244 | |
| 240 | 245 | = Is BetterDocs useful for multilingual documentation? = |
| 241 | 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. |
| 242 | 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 | + | |
| 243 | 251 | == Screenshots == |
| 244 | 252 | |
| 245 | 253 | |
| 246 | 254 | |
| @@ -245,8 +253,99 @@ | ||
| 245 | 253 | |
| 246 | 254 | |
| 247 | 255 | == Changelog == |
| 248 | 256 | |
| 257 | += 4.9.4 - 08/10/2026 = | |
| 258 | + | |
| 259 | +- New: Write with AI now accepts audio and video attachments — drop in a Loom, a Zoom recording or a voice note and BetterDocs transcribes it, lets you correct the transcript, then writes the doc from it. Up to 25 MB, using your own OpenAI or Gemini key | |
| 260 | +- New: Listen — a pill beside reading time that reads the article aloud in the reader's browser, with play, pause, seek and speed controls. Enable it under Settings → Layout → Single Doc → Listen; it also ships in the Reading Time block and Elementor widget, and as the [betterdocs_listen] shortcode | |
| 261 | +- New: Animated GIFs in docs are served as a looping, muted video instead of a GIF, cutting page weight substantially, with an editor UI to link an MP4 and a poster image to an existing GIF | |
| 262 | +- New: AI Actions — a "Copy page" button in the single doc meta row that copies the article as clean Markdown, or opens it in ChatGPT, Claude, Google AI Studio, Perplexity or Grok with the page as context. Every doc is also published as Markdown at <doc-url>.md so AI assistants can read it. Enabled by default; configure under Settings → Layout → Single Doc → AI Actions, with full Customizer styling including Icon Color. On block themes and with Elementor Theme Builder it ships inside the "Reading Time, Listen and AI Action" block and widget, and the [betterdocs_ai_actions] shortcode places it anywhere | |
| 263 | +- Improvement: Search now ranks exact title matches above older partial matches, instead of sorting ties oldest-first | |
| 264 | +- Improvement: The Category Grid block script now loads only on pages where the block actually renders | |
| 265 | +- Fixed: AI features ignored the AI platform you selected and required an OpenAI key regardless | |
| 266 | +- Fixed: A site could crash when the AI Chatbot loaded before BetterDocs and Pro loaded after it | |
| 267 | +- Fixed: Single doc URLs returned 200 instead of a proper 404 on WPML sites | |
| 268 | +- Fixed: Table of contents, search box and search form could overflow the page on phones, scrolling the page sideways | |
| 269 | +- Fixed: Single Doc Layout 7 scrolled sideways at 360px, and the reactions box overflowed on phones | |
| 270 | +- Fixed: A collapsible table of contents placed on a regular page could not be expanded on phones | |
| 271 | +- Fixed: The doc sidebar shifted after page load, and sidebar items could stack incorrectly | |
| 272 | +- Fixed: Synced patterns containing BetterDocs blocks lost their styling on most pages, and stale Essential Blocks CSS kept loading in the widget stylesheet on every page | |
| 273 | +- Fixed: GIFs served as video ignored the Image block's size and styles, lost "Expand on click", stayed frozen with no controls when the browser blocked autoplay, and rendered as an empty box when linked to a non-video attachment | |
| 274 | +- Fixed: The REST API and RSS feed returned video markup for converted GIFs | |
| 275 | +- Few minor bug fixes and improvements | |
| 276 | + | |
| 277 | += 4.9.3 - 27/09/2026 = | |
| 278 | + | |
| 279 | +- New: AI Actions — a "Copy page" button in the single doc meta row that copies the article as clean Markdown, or opens it in ChatGPT, Claude, Google AI Studio, Perplexity or Grok with the page as context. Every doc is also published as Markdown at <doc-url>.md so AI assistants can read it. Enabled by default; configure under Settings → Layout → Single Doc → AI Actions. On block themes and with Elementor Theme Builder it ships inside the "Reading Time and AI Action" block and widget, and the [betterdocs_ai_actions] shortcode places it anywhere | |
| 280 | +- Fixed: Doc URLs that do not exist now return a proper 404 instead of an empty page, on sites using category-in-path permalinks | |
| 281 | +- Fixed: Live search returned no results when the knowledge base is served from a subdomain or a domain alias | |
| 282 | +- Fixed: Single Doc Layout 5 no longer shows Table of Contents Background, Hover and Padding controls that had no effect on the page | |
| 283 | +- Fixed: Encyclopedia entries are now listed alphabetically within each letter, instead of newest first | |
| 284 | +- 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 | |
| 285 | +- Few minor bug fixes and improvements | |
| 286 | + | |
| 287 | += 4.9.2 - 16/09/2026 = | |
| 288 | + | |
| 289 | +- Fixed: Customizer layout migration seeded the wrong defaults, so saved layouts reverted to Layout 1 | |
| 290 | +- Fixed: Nested subcategories could be cached while empty and stay empty until the cache expired | |
| 291 | +- Fixed: Term counts were not refreshed after a recount, and an aborted import left counts stale | |
| 292 | +- Fixed: Category grids now collapse to a single column below 500px | |
| 293 | +- Fixed: FAQ group titles can now have their own background color | |
| 294 | +- Few minor bug fixes and improvements | |
| 295 | + | |
| 296 | += 4.9.1 - 03/09/2026 = | |
| 297 | + | |
| 298 | +- New: Print template — add your logo and a custom footer to printed / PDF pages, from Settings → Layout → Single Doc | |
| 299 | +- Improvement: Glossaries now show a preview in Free, so you can see what the Pro feature does before upgrading | |
| 300 | +- 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 | |
| 301 | +- Fixed: The Documentation grid hid knowledge bases containing only private docs from admins and editors | |
| 302 | +- Fixed: Doc Category Archive layouts 2 and 3 never rendered nested subcategories | |
| 303 | +- Fixed: "Lazy Load Sidebar Docs & Subcategories" now works for nested categories across both Elementor and block layouts | |
| 304 | +- Fixed: Single doc URLs with arbitrary category segments returned 200 instead of redirecting to the real permalink | |
| 305 | +- Fixed: Importing docs failed with a critical error on exported XML files and on docs with existing slugs | |
| 306 | +- Fixed: The AI Content Suite showed "undefined" / "[object Object]" instead of a readable message when the API key is invalid | |
| 307 | +- Improved: Security Enhancement | |
| 308 | +- Few minor bug fixes and improvements | |
| 309 | + | |
| 310 | += 4.9.0 - 27/08/2026 = | |
| 311 | + | |
| 312 | +- 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 | |
| 313 | +- 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 | |
| 314 | +- New: MCP admin page with a connection health report, self-test, per-tool picker and ready-made setup snippets for each supported editor | |
| 315 | +- Improvement: Knowledge base meta is now visible over REST, and the FAQ Builder capability check repairs itself when roles drift | |
| 316 | +- Fix: Document import no longer fails on PHP 8 — WP_Importer has no constructor, and calling it aborted every import | |
| 317 | +- Fix: The FAQ block now accepts bare term IDs in its group filters | |
| 318 | +- Few minor bug fixes and improvements | |
| 319 | + | |
| 320 | += 4.8.2 - 20/08/2026 = | |
| 321 | + | |
| 322 | +- New: Code Snippet Tab — a tabbed, multi-language code block available as both a Gutenberg block and an Elementor widget | |
| 323 | +- 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 | |
| 324 | +- 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) | |
| 325 | +- Improvement: Content Area Width & Max Width controls for the single doc layout in the Customizer | |
| 326 | +- Improved: Security Enhancement | |
| 327 | +- Few minor bug fixes and improvements | |
| 328 | + | |
| 329 | += 4.8.1 - 04/08/2026 = | |
| 330 | + | |
| 331 | +- Few minor bug fixes and improvements | |
| 332 | + | |
| 333 | += 4.8.0 - 04/08/2026 = | |
| 334 | + | |
| 335 | +- New: Multiple AI platform support — choose OpenAI, Google Gemini, Anthropic Claude for Write with AI and the Docs AI Suite | |
| 336 | +- Improvement: Documentation archive & sidebar performance — term-count caching plus an optional "Lazy Load Sidebar Docs & Subcategories" mode for large knowledge bases | |
| 337 | +- Fixed: WPML-translated doc tag & category base slugs now resolve correctly in routing and term links | |
| 338 | +- Improved: Security Enhancement | |
| 339 | +- Few minor bug fixes and improvements | |
| 340 | + | |
| 341 | += 4.7.0 - 22/07/2026 = | |
| 342 | + | |
| 343 | +- New: AI category, tag & glossary suggestions in the editor and in the Write with AI flow | |
| 344 | +- Improvement: Redesigned "Write with AI" and "Edit with BetterDocs AI" modals — cleaner AI Studio surfaces aligned to the design system, with reusable instruction Guides | |
| 345 | +- Improved: Security Enhancement | |
| 346 | +- Few minor bug fixes and improvements | |
| 347 | + | |
| 249 | 348 | = 4.6.2 - 16/07/2026 = |
| 250 | 349 | |
| 251 | 350 | - 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) |
| 252 | 351 | - 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 |
| @@ -265,9 +364,9 @@ | ||
| 265 | 364 | - New: AI-powered "Generate Sample Docs & FAQs" — auto-detects your site and instantly creates a starter knowledge base or FAQ set |
| 266 | 365 | - New: Product FAQ for WooCommerce — dedicated FAQ groups that display on single product pages |
| 267 | 366 | - New: Rich text (HTML) editor support in the FAQ Builder |
| 268 | 367 | - Improvement: Revamped admin with new React-based Knowledge Base, Doc Categories, Doc Tags, FAQ Builder and Glossaries screens |
| 269 | -- Fixed: Code Snippet block now correctly removes cleared code on the frontend | |
| 368 | +- Fixed: Code Snippet block now correctly removes cleared code on the frontend | |
| 270 | 369 | - Few minor bug fixes and improvements |
| 271 | 370 | |
| 272 | 371 | = 4.5.6 - 30/06/2026 = |
| 273 | 372 | |
