A modern, accessible Joomla module that displays FAQ articles grouped as tabs and accordions based on article tags. Built with Bootstrap 5 and comprehensive accessibility features.
- Tag-based Organization: Automatically groups FAQ articles by their assigned tags
- Multiple Navigation Styles: Tabs, Pills, or List
- Flexible Layouts: Horizontal or vertical tab orientations
- Accordion Content: Each tab contains an accordion of FAQ questions and answers
- Untagged articles are not displayed; only tagged articles generate tabs
- Tab Styles: Choose between traditional Tabs, modern Pills, or List
- Color Customization: Configure colors for active/inactive tabs, borders, text, and the active tab underline
- Active Underline Control: Adjustable height and color (supports RGBA)
- Layout Options: Multiple tab alignment options (left, center, right, justified, equal width, etc.)
- Responsive Design: Works seamlessly across all device sizes
- Professional Appearance: Enhanced styling with shadows, borders, and smooth transitions
- User Group Permissions: Control module visibility based on Joomla user groups
- Restricted User Groups: Grant special access to privileged users who can see restricted content
- Allowed User Groups: Limit module visibility to specific user groups
- Restricted Tags: Hide specific FAQ tags from normal users
- Public Access by Default: Module is accessible to all users (including guests) unless explicitly restricted
- Flexible Access Levels: Create public FAQs with private sections for staff, members, or administrators
- WCAG 2.1 AA Compliant: Full accessibility support for screen readers
- Keyboard Navigation: Complete keyboard support with arrow keys, Home/End
- Screen Reader Optimized: Proper ARIA labels, live regions, and semantic HTML
- Focus Management: Clear focus indicators and logical tab order
- High Contrast Support: Enhanced visibility for users with visual impairments
- Reduced Motion Support: Respects user preferences for reduced animations
- Download the module package
- In Joomla Administrator, go to Extensions > Manage > Install
- Upload the module package file
- Go to Extensions > Modules to configure and assign the module
- Field: FAQ Category ID
- Description: Select the Joomla content category containing your FAQ articles
- Required: Yes
- Field: Max Articles
- Description: Maximum number of FAQ articles to display
- Default: 100
- Range: 1-500
- Options:
- Tabs: Traditional tab interface
- Pills: Modern pill-style navigation
- List: Simple list navigation optimized for vertical layouts
- Default: Tabs
Behavior details for List:
- Vertical orientation: Shows standard bullets for inactive items; active item gets Bootstrap text-primary coloring and a Unicode arrow (→) indicator after the item
- Horizontal orientation: Uses a simple Bootstrap navbar presentation without the arrow indicator or hover translate effect
- Options:
- Horizontal: Tabs displayed horizontally above content
- Vertical: Tabs displayed vertically beside content
- Default: Horizontal
- Active Tab Background: Background color for the currently selected tab
- Inactive Tab Background: Background color for non-selected tabs
- Tab Font Color: Text color for all tabs (only applied when explicitly set)
- Question Color: Color for question links in accordions
- Border Color: Color for tab borders
- Active Tab Underline Color: Color of the underline bar for active tabs (supports RGBA)
- Border Radius: Rounded corner radius for tabs (0-50px)
- Tab Gap: Space between tabs (0-20px)
- Tab Alignment: How tabs are positioned within their container
- Left, Right, Centered, Space Between, Space Around, Justified, Equal Width
- Active Underline Height: Height of the active underline bar (in px)
- Active Underline Color: RGBA or HEX; applied to the active tab underline bar
The module includes a powerful permission system that allows you to control who can see the module and specific FAQ content based on Joomla user groups.
- Purpose: Grant privileged access to specific user groups
- Behavior: Users in these groups can see:
- The entire FAQ module
- ALL tags including restricted tags
- All FAQ content regardless of restrictions
- Use Cases:
- Staff/Administrator FAQs
- Internal documentation
- Premium member content
- Department-specific information
- Purpose: Limit module visibility to specific user groups
- Behavior:
- If specified, only users in these groups (or restricted groups) can see the module
- These users see non-restricted tags only
- Leave empty for public access (default)
- Use Cases:
- Member-only FAQs
- Registered user content
- Subscriber-specific information
- Purpose: Hide specific FAQ tags from normal users
- Behavior:
- Tags marked as restricted are hidden from all users EXCEPT those in "Restricted User Groups"
- Articles with restricted tags won't appear in tabs for normal users
- Users in restricted groups see these tags and their content
- Use Cases:
- Confidential information
- Staff-only procedures
- Beta features documentation
- VIP customer support
The system works with the following access levels (from highest to lowest):
-
Restricted User Groups (Highest Access)
- See the module: ✅
- See all tags: ✅
- See restricted tags: ✅
-
Allowed User Groups (Standard Access)
- See the module: ✅
- See non-restricted tags: ✅
- See restricted tags: ❌
-
Public/Guest Users (Default Access)
- See the module: ✅ (if no allowed groups specified)
- See non-restricted tags: ✅
- See restricted tags: ❌
Example 1: Public FAQ with Staff Section
Restricted User Groups: Administrators, Staff
Allowed User Groups: (empty)
Restricted Tags: Internal, Staff-Only, HR
Result:
- All users see the module with public FAQ tags
- Administrators and Staff also see Internal, Staff-Only, and HR tags
Example 2: Members-Only FAQ
Restricted User Groups: (empty)
Allowed User Groups: Registered, Premium Members
Restricted Tags: (empty)
Result:
- Only registered users and premium members see the module
- Public/guest users don't see the module at all
Example 3: Premium Content
Restricted User Groups: Premium Members
Allowed User Groups: Registered
Restricted Tags: Premium, Advanced, Pro-Tips
Result:
- Registered users see the module with basic FAQ tags
- Premium Members see all tags including Premium, Advanced, and Pro-Tips
- Public/guest users don't see the module
Example 4: Public Access (Default)
Restricted User Groups: (empty)
Allowed User Groups: (empty)
Restricted Tags: (empty)
Result:
- Everyone (including guests) sees the module
- All tags are visible to everyone
- This is the default behavior
-
Create FAQ Category:
- Go to Content > Categories
- Create a new category (e.g., "FAQ")
- Note the category alias for reference
-
Create FAQ Articles:
- Go to Content > Articles
- Create articles in your FAQ category
- Add relevant tags to group related questions
- Use clear, descriptive titles for questions
-
Organize with Tags:
- Create tags for different FAQ topics (e.g., "General", "Technical", "Billing")
- Assign appropriate tags to each FAQ article
- Articles can have multiple tags and will appear in multiple groups
- Note: Untagged articles are not displayed in the module
-
Assign Module:
- Go to Extensions > Modules
- Find "Bears FAQ" module
- Configure position and menu assignment
-
Configure Settings:
- Select your FAQ category
- Choose navigation style (Tabs, Pills, or List) and orientation
- Customize colors (including RGBA underline color) and layout as needed
-
Test Accessibility:
- Test keyboard navigation (Tab, Arrow keys, Enter/Space)
- Verify screen reader compatibility
- Check focus indicators are visible
- Vertical orientation:
- Inactive items show standard bullets
- Active item is highlighted using Bootstrap's text-primary class
- An arrow indicator (Unicode →) appears after the active item
- A subtle translateX hover effect is applied to links
- Horizontal orientation:
- Renders as a simple Bootstrap navbar without the arrow indicator or hover translate effect
- Joomla: 5.0+ or 6.0+
- PHP: 8.1+ for Joomla 5; 8.3+ for Joomla 6
- Bootstrap: 5.x (automatically loaded)
mod_bearsfaq/
├── mod_bearsfaq.php # Main module file
├── mod_bearsfaq.xml # Module manifest
├── README.md # Documentation
├── LICENSE # GPL v3 license
├── language/ # Language files
│ └── en-GB/
│ ├── en-GB.mod_bearsfaq.ini
│ └── en-GB.mod_bearsfaq.sys.ini
└── media/ # Assets
├── css/
│ └── mod_bearsfaq.css # Module styles
└── js/
└── mod_bearsfaq.js # Accessibility enhancements
The module uses CSS custom properties for easy customization:
.bearsfaq-tabs {
--bfq-accent: var(--bs-primary);
--bfq-active-tab-color: inherit;
--bfq-inactive-tab-color: transparent;
--bfq-tab-font-color: inherit;
--bfq-question-color: inherit;
--bfq-border-color: rgba(0,0,0,0.275);
--bfq-active-underline-height: 2px;
--bfq-active-underline-color: rgba(13,110,253,1); /* example; configurable via params */
--bfq-border-radius: 8px;
--bfq-tab-gap: 2px;
--bfq-tab-alignment: flex-start;
}- Keyboard Navigation: Arrow keys, Home/End support
- Screen Reader Announcements: Live region updates
- Focus Management: Proper tabindex handling
- Bootstrap Integration: Event handling for tabs and accordions
- Active List Item Sync: When using List style, the active item's parent
- is toggled with text-primary on tab switches, ensuring the active state color updates dynamically
- Tab: Navigate between interactive elements
- Arrow Keys: Move between tabs
- Home/End: Jump to first/last tab
- Enter/Space: Activate tabs and expand accordions
- Semantic HTML: Proper heading hierarchy (H1 > H3)
- ARIA Labels: Descriptive labels for all interactive elements
- Live Regions: Announcements for state changes
- Skip Links: Quick navigation for keyboard users
- Focus Indicators: Clear outlines for keyboard focus
- High Contrast: Enhanced borders in high contrast mode
- Reduced Motion: Respects user motion preferences
- Color Independence: Information not conveyed by color alone
Add custom styles to your template's CSS:
/* Example: Custom tab styling */
.bearsfaq-tabs .nav-link {
border-radius: 15px !important;
margin-right: 10px !important;
}
/* Example: Custom accordion styling */
.bearsfaq-tabs .accordion-button {
font-size: 1.1rem !important;
padding: 1rem 1.5rem !important;
}The module inherits your template's styling by default. Colors and fonts will match your site's design unless explicitly overridden.
No FAQs Displayed
- Verify FAQ category exists and contains published articles
- Check that articles are assigned to the correct category
- Ensure module is published and assigned to correct menu items
Tags Not Grouping Correctly
- Verify articles have tags assigned
- Check tag names for typos or extra spaces
- Ensure tags are published
Styling Issues
- Clear Joomla cache after making changes
- Check for CSS conflicts with template
- Verify Bootstrap 5 is loaded
Accessibility Problems
- Test with keyboard navigation
- Use screen reader testing tools
- Check browser console for JavaScript errors
Enable Joomla debug mode to see detailed error messages if the module fails to load.
- Modern Browsers: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
- Mobile: iOS Safari 14+, Chrome Mobile 90+
- Accessibility Tools: NVDA, JAWS, VoiceOver, Dragon NaturallySpeaking
- Fork the repository
- Create a feature branch
- Make your changes
- Test accessibility compliance
- Submit a pull request
- Follow Joomla coding standards
- Maintain WCAG 2.1 AA compliance
- Test with keyboard navigation
- Verify screen reader compatibility
- Document any new features
This module is licensed under the GNU General Public License v3.0. See LICENSE for details.
- Documentation: This README file
- Issues: https://github.com/N6REJ/mod_bearsfaq/issues
- Community: Joomla community forums
- Author: N6REJ
- Email: troy@hallhome.us
- Website: https://hallhome.us
- Framework: Joomla 5.x/6.x
- UI Framework: Bootstrap 5
- Accessibility: WCAG 2.1 AA compliant
Bears FAQ Module - Making FAQ management accessible and beautiful for Joomla websites.