Release Date - 05 September 2026

• Enhancements:

  • [Pro] Added the %product_id% placeholder for product, section, and article permalink structures. Product and section IDs resolve to their corresponding taxonomy terms, including hierarchical sections.

• Bug fixes:

  • Fixed plugin data being deleted when uninstalling one version while its paired free or Pro counterpart was active.
  • [Pro] Fixed the %section_id% placeholder generating the wrong query variable, which caused section URLs to load the wrong archive or return a 404.
  • [Pro] Fixed custom permalink settings using stale rewrite rules immediately after they were saved. Rewrite rules now flush after the new settings have been registered.

• Other:

  • [Pro] Invalid product and section IDs now return a 404 response instead of falling back to another Knowledge Base archive.

Full Changelog: v3.1.3...v3.1.4

Changelog

Release Date - 26 August 2026

• Enhancements:

  • [Pro] GitHub commit messages generated when pushing articles are now prefixed with docs: so they follow conventional commit style in the target repository.
  • [Pro] The GitHub importer now skips Markdown files that have no frontmatter, and files whose frontmatter sets kb_exclude: true. An article that was imported earlier and is later marked kb_exclude is drafted or deleted according to the mapping's "When a File is Deleted" setting. Excluded files are reported in the import wizard results and counted separately.
  • [Pro] GitHub bulk exports now use Git Trees content uploads, prepare bounded chunks with progressive table updates, create one commit per repository and branch, and resume safely after an interruption.
  • [Pro] A GitHub export now resumes automatically when the wizard page is reloaded while an export is still running.
  • [Pro] The GitHub import and export results tables now show a Product column, so you can see which product each article belongs to.

• Bug fixes:

  • Fixed checkbox settings resolving to true/false instead of 1/0 when read before their saved value existed, which could break blocks and REST responses that expect a numeric value.
  • Fixed Custom CSS returning false instead of an empty string when no value had been saved.
  • Fixed the wzkb_settings_defaults filter being ignored when a default was read outside the admin area.
  • Fixed settings on a multisite network reading another site's values in the same request after a switch_to_blog() call, such as during network activation.
  • Fixed the settings wizard silently dropping repeater field rows on save.
  • [Pro] Fixed the GitHub export wizard preview using post timestamps instead of generated Markdown, which could omit articles that were later pushed.
  • [Pro] Fixed empty article exports from being hashed or sent to GitHub.
  • [Pro] Fixed the GitHub exporter attempting to push articles whose post no longer exists; such articles are now reported in the results table and the rest of the export continues.
  • [Pro] Fixed the GitHub exporter writing documented shortcodes as literal text, so re-importing an article executed them — a heading reading [bsearch_form] came back as a working search form. Literal shortcodes are now written in the [[shortcode]] form, which WordPress renders as text and which survives the round trip. Only registered shortcode tags are escaped, so WP-CLI notation such as [--force] and placeholders such as wzkb_rated_[article_id] are left untouched.
  • [Pro] Fixed the GitHub exporter dropping order: 0 from the frontmatter, which made push-back non-idempotent and produced a diff against the repository even when nothing about the article had changed.

• Other:

  • Updated the Settings API framework, Options API and admin notices API to their latest versions.
  • PHP compatibility checks now cover PHP 7.4 to 8.6.
  • Updated npm dependencies.

Full Changelog: v3.1.2...v3.1.3

Changelog

• Bug fixes:

  • Fixed a fatal error ("There has been a critical error on this website") that could occur when Pro features were activated — e.g. on starting a free trial or activating a licence — on sites whose saved settings predate the floating table of contents option.
  • Fixed a fatal error when Knowledge Base and Knowledge Base Pro were activated together by namespacing the function-existence guard for the main instance and guarding the autoloader and settings includes.
  • Fixed the Settings page sidebar overlapping the tab content by switching the post body layout to flexbox.
  • Fixed disabled and Pro-gated settings losing their stored values on save when their field was not submitted.

• Other:

  • Updated the Settings API framework.

Full Changelog: v3.1.1...v3.1.2

Changelog

• Enhancements:

  • Added search to the Settings page to quickly find options across tabs.
  • Smooth scroll-to-top when switching Settings tabs.

• Bug fixes:

  • Fixed default-value label lookup for select/radio fields that use an empty string as a real option key (e.g. "Do not display").
  • GitHub/Markdown exporter: unknown block types without inner blocks now export raw innerHTML instead of a block comment, so they round-trip correctly on re-import.
  • GitHub/Markdown exporter: pass <mark>, <u>, <sub>, <sup> through as raw HTML during inline conversion, and allow future as a valid frontmatter/mapping post status.
  • GitHub/Markdown exporter: emit the toc: true frontmatter flag when an article contains a TOC block, for full importer/exporter parity.

• Other:

  • Updated Settings API to 2.10.1 and refreshed the admin banner.
  • Updated Freemius SDK to 2.13.4.
  • Updated WordPress.org banner images.

Full Changelog: v3.1.0...v3.1.1

Changelog

Release post: https://webberzone.com/announcements/knowledge-base-v3-1-0/

• Features:

  • [Pro] Documentation Layout Mode: three-column docs site layout with a sticky, collapsible section-tree sidebar, article content area, and on-this-page TOC rail. Enable via Settings → Pro. Works on all KB page types (home, product, section, single article, search).
  • [Pro] Section Tree block (knowledgebase/section-tree) and sidebar widget: context-aware hierarchical navigation tree displaying products, sections, and articles with collapsible accordion and active-item highlighting. Adapts automatically to the current product, section, or article page.
  • [Pro] GitHub Integration: sync markdown documentation between GitHub repositories and the Knowledge Base via webhooks, with YAML frontmatter, markdown-to-Gutenberg conversion, and HMAC signature verification. Import and export are combined into a single Importer/Exporter page, with featured image support and a post-import next-actions panel.
  • [Pro] Article Export & Import: export articles as a Markdown ZIP, SQL dump, or XLSX spreadsheet, and re-import Markdown ZIPs (matched by slug) to restore or migrate.
  • [Pro] Term featured image support for product and section archives.
  • Plugin Importer: migrate articles, sections, products, and tags from BasePress, BetterDocs, and Echo KB.
  • Settings Export & Import: back up and restore plugin settings as JSON, with sensitive keys preserved on the existing site.
  • Sample content: import demo articles, sections, and products from the Setup Wizard or Tools page, removable in one click.
  • Added wzkb_tag taxonomy templates, displaying tag terms on single articles and tag archives.

• Modifications:

  • [Pro] Floating TOC now slides in horizontally from the viewport edge instead of collapsing vertically.
  • Reorganized admin navigation and added a Settings button to the admin banner.
  • Upgraded Tom Select to v2.6.1.

Full Changelog: v3.0.1...v3.1.0

Knowledge Base v3.1.0-beta3

• Modifications:
  • Fixed indentation in plugin importer wizard.

Full Changelog: v3.1.0-beta2...v3.1.0-beta3

Knowledge Base v3.1.0-beta2

• Features:

  • [Pro] GitHub Integration: Automatically sync markdown documentation from GitHub repositories. Configure webhooks in Settings → GitHub or set repository mappings directly on product terms. Features include YAML frontmatter support for metadata control, markdown-to-Gutenberg conversion, classic editor fallback, and HMAC-SHA256 signature verification. Test connections via wzkb/v1/github/validate.
  • [Pro] Merged GitHub Import and Export into a single "GitHub Importer/Exporter" admin page with link-based tab navigation (Import tab loads by default).
  • Settings Export & Import: export all plugin settings as a stripped JSON file and re-import from a backup. Sensitive keys (API tokens, webhook secrets) are preserved on the existing site and never overwritten by an import.
  • [Pro] Article Export & Import: export all Knowledge Base articles as a Markdown ZIP with YAML frontmatter, a SQL INSERT dump ZIP, or an XLSX metadata spreadsheet. Re-import Markdown ZIPs to restore or migrate articles — articles are matched by slug with overwrite/skip control.

• Bug fixes:

  • [Pro] Fixed product and section taxonomy archive pages redirecting to the homepage when a custom article permalink structure (e.g. %section_name%/%postname%) was active. The term link filter was incorrectly prepending the KB slug to taxonomy URLs that already contained their full path.
  • [Pro] Fixed article single pages not resolving when a custom article permalink structure was active. The rewrite rule was generated without the KB slug prefix, but the generated article URLs included it, causing a mismatch.

• Modifications:

  • Added a Settings button to the admin banner for quick access from any KB admin page.
  • Reorganised the Tools page and sub-menu items to group related features together and improve navigation.
  • Added wzkb_tag taxonomy template support across frontend handlers: block template, classic PHP template, and style enqueueing. Tag archives now render with the same layout consistency as product and section archives.
  • Single article templates now display linked wzkb_tag terms as styled pill badges after the article content and before related articles. Both classic and block-based patterns were updated.
  • Tag archive and search result cards now use a CSS Grid layout: thumbnail and title sit side-by-side on the top row, with the excerpt spanning the full width below. This matches the block template layout and improves visual consistency across classic and block themes.
  • [Pro] Floating TOC now slides in and out horizontally from the viewport edge instead of collapsing vertically. A narrow tab peeks from the edge when minimised; clicking it slides the full panel into view. Mobile bottom-bar behaviour is unchanged.
  • [Pro] TOC block now defaults the title field to "Table of Contents" instead of blank, so newly inserted blocks display a heading out of the box.

Changelog

• Modifications:

  • [Pro] Floating TOC now slides in and out horizontally from the viewport edge instead of collapsing vertically. A narrow tab peeks from the edge when minimised; clicking it slides the full panel into view. Mobile bottom-bar behaviour is unchanged.
  • [Pro] TOC block now defaults the title field to "Table of Contents" instead of blank, so newly inserted blocks display a heading out of the box.

• Features:

  • [Pro] GitHub Integration: Automatically sync markdown documentation from GitHub repositories. Configure webhooks in Settings → GitHub or set repository mappings directly on product terms. Features include YAML frontmatter support for metadata control, markdown-to-Gutenberg conversion, classic editor fallback, and HMAC-SHA256 signature verification. Test connections via wzkb/v1/github/validate.
  • [Pro] Merged GitHub Import and Export into a single "GitHub Importer/Exporter" admin page with link-based tab navigation (Import tab loads by default).
  • Admin banner now appears on all Knowledge Base admin pages, including GitHub, Ratings, Product Migration, and Setup Wizard screens.
  • Added a Settings button to the admin banner for quick access from any KB admin page.
  • Ratings Feedback and Product Migration are now surfaced as cards on the Tools page instead of standalone nav items; nav entries are hidden but pages remain directly accessible.
  • Setup Wizard is hidden from the admin nav menu once dismissed.

Full Changelog: v3.0.2...v3.1.0-beta1

Changelog

• Bug fixes:
  • Fixed build zip to include compiled block assets (includes/blocks/build/) missing in 3.0.1.

Full Changelog: v3.0.1...v3.0.2

Changelog

• Bug fixes:
  • Fixed TOC links not scrolling to headings when the inline TOC is disabled — heading anchor IDs are now injected for the floating TOC, sidebar widget, and TOC block. Existing IDs set by third-party TOC blocks (e.g. Kadence, Stackable) are preserved.
  • Fixed the TOC block rendering without container styling in all themes.

Full Changelog: v3.0.0...v3.0.1