JoomFAQs - Managing Categories

Categories are the backbone of your FAQ structure in JoomFAQs. They let you group related questions together so visitors can quickly find the answers they need. JoomFAQs uses Joomla's native category system, which means you manage FAQ categories the same way you manage categories for articles, contacts, or any other Joomla component -- with powerful JoomFAQs-specific options layered on top.

How JoomFAQs Uses Joomla's Category System

Rather than implementing its own category management, JoomFAQs integrates directly with the category manager built into Joomla 4. This means:

• FAQ categories appear alongside other component categories in the Joomla admin, filtered by extension.
• You get all of Joomla's standard category features for free: nested hierarchies, publishing controls, access levels, language assignment, and versioning.
• Each FAQ category carries its own set of JoomFAQs-specific parameters that control how questions are displayed, how the submission form behaves, and whether search is enabled.
• Access control at the category level determines who can view, submit, and edit/answer questions within that category.

Every FAQ question belongs to exactly one category. When a visitor views a category on the frontend, JoomFAQs loads the questions that belong to it, applies the category's display parameters, and renders them accordingly.

Creating a New FAQ Category

1. Log in to the Joomla administrator panel.
2. Navigate to Components > JoomFAQs > Categories (or go to Content > Categories and filter by the JoomFAQs extension).
3. Click the New button in the toolbar.
4. Fill in the required fields:
   • Title -- A short, descriptive name for the category (e.g., "Billing & Payments" or "Getting Started").
   • Alias -- Leave blank to auto-generate from the title, or enter a custom URL-safe alias.
5. Optionally fill in the Description field. This text can be shown above the questions on the frontend if you enable the "Description of category" display option (see below).
6. Set the Parent field if you want this to be a subcategory (see "Setting Up Subcategories and Hierarchy" below).
7. Set Status to Published when you are ready for the category to appear on the frontend.
8. Configure the JoomFAQs-specific tabs described in the next section.
9. Click Save or Save & Close in the toolbar.

Category Parameters Reference

When editing a JoomFAQs category, you will see several custom tabs in addition to Joomla's standard Category, Options, and Publishing tabs. These tabs contain settings that control the behavior and appearance of that specific category on the frontend.

Display Options (Basic Tab)

These settings control how the category page itself is presented to visitors, including page titles, descriptions, and subcategory visibility.

Question Options

These settings control how individual questions and their answers are rendered within the category view.

Sorting options explained:

Form Options

These settings control the frontend question submission form that allows visitors to ask new questions in this category.

Search Options

These settings control the instant search feature that can be enabled per category.

Setting Up Subcategories and Hierarchy

JoomFAQs supports nested categories to any depth, allowing you to create a structured FAQ hierarchy. For example:

General
Billing & Payments
  - Pricing Plans
  - Refunds & Cancellations
  - Invoices
Technical Support
  - Installation
  - Configuration
  - Troubleshooting

Creating a Subcategory

1. Navigate to Components > JoomFAQs > Categories.
2. Click New to create a new category.
3. Fill in the Title and other details as usual.
4. In the Parent dropdown, select the category that should serve as the parent.
5. Click Save & Close.

The subcategory will now appear indented beneath its parent in the category list.

Controlling Subcategory Depth

You can limit how many levels of subcategories are displayed on the frontend using the Maximum Category Levels option in the parent category's Display Options tab:

• None -- Hides all subcategories from the frontend view.
• 1 -- Shows only direct children.
• 2 through 5 -- Shows subcategories up to that many levels deep.
• All -- Shows the entire nested tree regardless of depth.

Displaying Subcategory Questions in the Parent

By default, each category only shows questions directly assigned to it. If you want a parent category to also display questions from its subcategories inline, set Show Subcategory Questions to Show in the Display Options tab. This is useful for creating an "all questions" view where visitors see everything without navigating into individual subcategories.

Category Ordering

You can control the order in which categories appear in the admin list and on the frontend.

Reordering Categories in the Admin

1. Navigate to Components > JoomFAQs > Categories.
2. Make sure the list is sorted by the Ordering column (click the up/down arrow icon in the column header).
3. Use one of these methods to reorder:
   • Drag and drop -- Click and hold the dotted handle icon to the left of a category, then drag it to the desired position.
   • Order numbers -- Enter numeric values in the ordering fields and click the save icon in the column header.
   • Arrow buttons -- Use the up/down arrows next to each category to move it one position at a time.

Question Ordering Within Categories

The order of questions within each category is controlled by the Sorting option in the category's Question Options tab. This is independent of the category ordering and can be set differently for each category. See the Question Options table above for all available sort orders.

Access Levels per Category

JoomFAQs uses Joomla's access control system to manage permissions at the category level. There are two layers to consider:

Viewing Access

Each category has a standard Joomla Access field (on the main Category tab) that determines which user groups can see the category and its questions on the frontend. Common access levels include:

• Public -- Everyone can see it, including guests.
• Registered -- Only logged-in users can see it.
• Special -- Only users in the "Author" group or above can see it.
• Custom access levels you have created in Joomla.

Individual questions also have their own access level, providing an additional layer of control. A question is only visible if both the category access level and the question access level permit the visitor to view it.

Category-Level Permissions

Under the Permissions tab of each category, you can configure two JoomFAQs-specific actions:

These permissions cascade from the component level. If you set a permission at the component level (under Components > JoomFAQs > Options > Permissions), it applies to all categories unless overridden at the individual category level.

Common permission configurations:

• Public FAQ (anyone can ask): Set "Add a Question" to Allowed for the Public or Guest group.
• Members-only FAQ: Set the category access to Registered and "Add a Question" to Allowed for the Registered group.
• Moderated FAQ: Set "Add a Question" to Allowed for Registered, and "Edit / Respond" to Allowed for a specific editor or moderator group. Only that group will be able to answer questions and receive notifications.

Best Practices for Organizing FAQs

Keep your category structure shallow. One or two levels of nesting is usually enough. Deep hierarchies force visitors to click through multiple pages before finding an answer. If you have many questions, consider more top-level categories rather than deeply nested subcategories.

Use clear, visitor-focused category names. Name categories based on what your visitors are looking for, not your internal department structure. "Billing & Payments" is better than "Finance Department FAQ." Keep names short so they display well in navigation.

Enable search on categories with many questions. If a category contains more than 15-20 questions, turn on the search feature in the Search Options tab. This lets visitors filter results instantly without scrolling through pages of questions.

Set appropriate pagination limits. The default of 10 questions per page works well for most categories. For categories where visitors are likely to browse (rather than search), a higher limit like 20 or 25 may reduce unnecessary pagination clicks. For very long lists, keep the limit lower and enable search instead.

Use descriptions to guide visitors. Enable category descriptions and write a brief sentence or two explaining what kind of questions belong in each category. This helps visitors confirm they are in the right place and reduces the chance of question submissions ending up in the wrong category.

Configure permissions early. Before publishing your FAQ to visitors, decide who should be able to submit questions and who should be able to answer them. Set these permissions at the component level first, then override at the category level only where needed.

Use manual ordering for important questions. Set the category sorting to "Manual ordering (ascending)" and then arrange your most frequently asked questions at the top. This ensures the most useful answers are seen first, before visitors resort to search or scrolling.

Hide empty subcategories during initial setup. While you are still building out your FAQ content, set Empty Subcategories to Hide in the Display Options. This prevents visitors from seeing placeholder categories that have no questions yet.