=== HelpFrame Knowledge Base ===
Contributors: tsplugins
Tags: help, faq, documentation, knowledge-base, navigation
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build a clear documentation hub from existing pages, posts, and categories with drag-and-drop navigation and a live preview.

== Description ==

HelpFrame Knowledge Base turns existing WordPress content into a structured documentation hub. Create the default Documentation page and separate documentation collections for different audiences, products, or support topics.

* Add published pages, posts, or post categories from the content library.
* Arrange items with drag and drop or accessible Move up, Move down, and Add buttons.
* Create custom section labels and build a hierarchy up to three levels deep.
* Preview navigation, article content, and the table of contents while editing.
* Choose Classic, Clean, Editorial, or Minimal styling for the documentation hub.
* Include Heading 2 and Heading 3 in the right-side table of contents by default.
* Optionally include Heading 4 and FAQ questions created with Details blocks.
* Use responsive navigation controls on tablets and phones.
* Create named documentation collections with independent content structure, style, and table-of-contents settings.
* Copy a collection-specific shortcode to display each collection on any page or post.
* Optionally add selected collections to a navigation bar at the top of the default Documentation page.

Adding a category creates a dynamic group. Published posts in that category are displayed automatically in alphabetical order, so the navigation stays current as content changes.
If a category post is also placed manually in the structure, the manual placement takes priority and the post is not repeated inside the category.

== Installation ==

1. Upload the plugin ZIP through Plugins > Add New > Upload Plugin.
2. Activate HelpFrame Knowledge Base.
3. Open HelpFrame Knowledge Base in the WordPress admin menu.
4. Add pages, posts, or categories to the Documentation structure.
5. Choose the visual style and table-of-contents options, then save.
6. Use Publish Documentation page when the default hub is ready.
7. Add a documentation collection above the builder to create an independent structure. Copy its shortcode into any page or post when ready.

The plugin creates a draft Documentation page during activation and uses it automatically. The default Documentation structure remains separate from named collections. Each collection has its own structure and display settings. Its shortcode is shown above the builder; add it to a Shortcode block or other shortcode-enabled area. Select collections in the default builder if you also want them listed in the Documentation page navigation bar.

== Frequently Asked Questions ==

= What is a documentation collection? =

A collection is a separately configured documentation structure. It has its own navigation, style, and table-of-contents options. Use its displayed shortcode to place it on any page or post.

= Can a collection also appear on the Documentation page? =

Yes. Select the collection in the Documentation page settings. It will appear in the top navigation on the default Documentation view. The bar is not shown while a named collection is open.

= What content can I add? =

Published pages, published posts, post categories, and custom section labels.

= What happens when I add a category? =

The category appears as a navigation group and its published posts are loaded dynamically in alphabetical order.

= Which elements appear under On this page? =

Heading 2 and Heading 3 are enabled by default. You can also enable Heading 4 and FAQ questions created with WordPress Details blocks.

= Do the four styles change the documentation content? =

No. All four styles use the same documentation content and hierarchy; they change visual presentation only.

= Does the plugin copy my content? =

No. It reads and displays the current content of the selected pages and posts. Your original content remains unchanged.

== Changelog ==

= 1.0.1 =
* Updated the admin menu icon to match the plugin branding.
* Improved the Delete collection button and grouped its visibility settings inside a single panel.
* Kept top-navigation and collection visibility controls on the Documentation page settings only.
* Preserved saved table-of-contents choices when settings fields are omitted.
* Restored Heading 2 and Heading 3 as defaults when no choice has been saved.
* Restored the selected-item highlight and added a vertical guide to the table of contents.
* Added compact top navigation to the Minimal style based on top-level structure items.

= 1.0.0 =
* Initial release with drag-and-drop documentation navigation, live preview, four visual styles, and configurable table-of-contents options.
* Prevent duplicate navigation links when a category post is also placed manually.
