Category Browser
Categories give your wiki structure - instead of scrolling through a flat list of pages, your visitors can drill into a topic area and see exactly what’s there. The Category Browser makes this navigation intuitive, starting from a high-level overview and letting users go as deep as they need.
Navigating Categories
Section titled “Navigating Categories”Root View
Section titled “Root View”When you open the category browser without specifying a category, you see all top-level categories as a grid of cards. Each card shows:
- Category name
- Number of pages in that category
For example, if your wiki has “Science & Technology”, “History & Society”, and “Arts & Culture” as top-level categories, your visitors immediately understand how the knowledge base is organized.
Category View
Section titled “Category View”Clicking a category card opens that category’s detail view, which shows:
- Category description - if you’ve added one for the term in the admin
- Subcategories - child categories listed as cards with page counts
- Pages in this category - all published wiki pages assigned to this category, sorted alphabetically by title
If a category has no subcategories and no pages, the view shows “This category is empty.”
Navigation Controls
Section titled “Navigation Controls”- A Parent Category button appears when you’re inside a subcategory, linking back up the hierarchy
- An All Categories button appears when viewing a top-level category, returning you to the root
- A Dashboard button is always present to return to the main wiki listing
Accessing the Category Browser
Section titled “Accessing the Category Browser”Add the wbmw_action=category parameter to your wiki dashboard URL:
# Root view (all categories)?wbmw_action=category
# Jump directly to a specific category (pass the term ID)?wbmw_action=category&wiki_cat=12Category Taxonomy
Section titled “Category Taxonomy”Wiki categories use the wiki_category taxonomy registered specifically for the wiki-page post type. Categories are hierarchical - they can have parent and child relationships.
| Taxonomy slug | wiki_category |
|---|---|
| Hierarchical | Yes |
| Archive URL | yourdomain.com/wiki-category/{slug}/ |
Managing Categories
Section titled “Managing Categories”You can create categories in two ways:
- From the editor - type a new category name in the category field while creating or editing a page
- From WordPress admin - go to Wiki Pages > Wiki Categories in the admin menu
Any description you add to a category in the admin will appear at the top of that category’s browser view - useful for explaining the scope of a category to your readers.
Developer Notes
Section titled “Developer Notes”The category view fetches subcategories using get_terms() with 'parent' => $category_id and pages using a tax_query against wiki_category. The page list fetches up to 100 pages per category, sorted alphabetically.
To customize the category layout, override wiki-category.php in your theme (see Template Overrides).