Documentation of Easy Articles Accordion Module

Easy Articles Accordion is a powerful Joomla 5 module that displays articles in an interactive accordion format. It combines the functionality of Joomla's core article display with modern accordion UI, offering extensive customization options for design, animations, and content filtering.

Key Features

  • 📱 Fully responsive Bootstrap-based accordion
  • 🎨 10+ beautiful presets
  • 🎯 Custom design builder
  • ✨ 4 animation effects
  • 🔍 Advanced article filtering
  • 📊 Multiple grouping options
  • ⚡ AJAX pagination support
  • 🌐 Multi-language ready

Installation & Basic Setup

Installation Steps

  1. Download the module package (mod_easyarticlesaccordion.zip)
  2. Navigate to Extensions → Manage → Install in Joomla administrator
  3. Upload & Install the package
  4. Enable the module in Extensions → Manage → Manage
  5. Configure the module in Content → Site Modules

Basic Configuration

Display Mode Selection

Normal Mode

Perfect for displaying a fixed set of articles from specific categories:

  • Homepage featured articles
  • Category-specific content blocks
  • Sidebar article lists
Dynamic Mode

Automatically adapts content based on the current page:

  • Shows related articles when viewing a category
  • Displays articles from the same category when viewing an article
  • Perfect for "Related Articles" sections

Quick Start

For a basic accordion:

  1. Set Mode to "Normal"
  2. Select your categories
  3. Choose "Bootstrap Default" for style
  4. Set article count (or 0 for all)
  5. Save and assign to a module position

Filtering Articles

The module provides comprehensive filtering options to display exactly the articles you need.

Article Count

  • 0: Display all articles (no limit)
  • 1-100: Limit the number of displayed articles

Featured Articles

Option Description Use Case
Show Include all articles General content display
Hide Exclude featured articles Regular articles only
Only Show only featured articles Highlight important content

Category Filtering

Category Options
  • Category Filtering Type
    • Inclusive: Show articles FROM selected categories
    • Exclusive: Show articles NOT IN selected categories
  • Categories: Select one or multiple categories
  • Include Subcategories: Include articles from child categories
  • Subcategory Levels: How deep to traverse subcategories

Tag Filtering

Select specific tags to filter articles. Only articles with these tags will be displayed. Great for creating topic-specific accordions.

Author Filtering

  • Author Filtering Type: Inclusive/Exclusive
  • Authors: Select specific authors
  • Author Alias Filtering: Filter by author aliases

Date Filtering

Off

No date filtering applied

Date Range

Specify exact start and end dates

Relative

Show articles from last X days

Excluded Articles

Enter article IDs (one per line) to exclude specific articles from display.

Ordering & Grouping

Article Ordering Options

Order Type Description Best For
Article Order Default Joomla ordering Manual control
Featured Order Featured articles first Highlighting important content
Most Popular By hit count Trending content
Title Alphabetical by title Reference lists, directories
Created Date Newest/oldest first News, blogs
Modified Date Recently updated first Dynamic content
Random Randomize order Discovery, variety

Article Grouping

Group articles to create organized sections within your accordion:

Grouping Options

  • None: No grouping (default)
  • Year: Group by year
  • Month & Year: Group by month and year
  • Author: Group by author name
  • Category: Group by category
  • Tags: Group by tags

Grouping Direction

  • Ascending: A to Z, oldest to newest
  • Descending: Z to A, newest to oldest

Design & Styling

Choose from three styling approaches to match your website's design perfectly.

1. Bootstrap Default

Uses your template's default Bootstrap styling. Best for consistency with your site design.

When to use: When you want the accordion to match your template's existing style.

2. Use Preset

Choose from 10 professionally designed presets:

🎨 Modern Flat

  • Clean, minimalist design
  • Subtle shadows and smooth corners
  • Perfect for: Corporate sites, portfolios

🌈 Gradient Purple

  • Eye-catching purple gradient
  • Bold and vibrant
  • Perfect for: Creative agencies, artistic sites

💙 Gradient Blue

  • Professional blue gradient
  • Cool and calming
  • Perfect for: Tech companies, business sites

➖ Minimal Clean

  • Ultra-minimalist design
  • No borders, clean lines
  • Perfect for: Blogs, news sites

🃏 Card Style

  • Each item as a separate card
  • Modern shadow effects
  • Perfect for: E-commerce, product showcases

🌙 Dark Theme

  • Dark background with light text
  • Easy on the eyes
  • Perfect for: Gaming sites, night mode

📱 Material Design

  • Google Material Design inspired
  • Clean with subtle shadows
  • Perfect for: Modern web apps

🔮 Glassmorphism

  • Trendy glass effect with blur
  • Semi-transparent backgrounds
  • Perfect for: Modern, stylish sites

💫 Neumorphism

  • Soft UI with inset shadows
  • Modern 3D effect
  • Perfect for: Design-focused sites

⭕ Outline Style

  • Clean borders, no fills
  • Minimalist approach
  • Perfect for: Documentation, tutorials

3. Custom Design

Full control over every design aspect:

Color Customization

Setting Controls
Header Background Background color for closed accordions
Header Text Text color for headers
Header Hover Background Color when hovering
Active Header Background Color for open accordion
Active Header Text Text color for active state
Body Background Content area background
Body Text Content text color
Icon Color Expand/collapse arrow color

Layout Customization

  • Border Color: Color of accordion borders
  • Border Width: Thickness in pixels
  • Border Radius: Rounded corners in pixels
  • Header Padding: Space inside headers
  • Body Padding: Space inside content area
  • Transition Duration: Animation speed (e.g., 0.3s)
  • Custom CSS Classes: Additional classes for styling

Animation Effects

Enhance user experience with smooth animations. You can enable multiple effects simultaneously.

✨ Smooth Transitions

What it does: Adds smooth, professional transitions when accordions expand/collapse

  • Headers smoothly change colors
  • Expand/collapse arrows rotate smoothly
  • Content fades in when opened
  • Height changes are animated instead of instant

Best for: Professional websites that want polished interactions

📏 Hover Scale Effect

What it does: Makes accordion items slightly grow and lift when you hover over them

  • Entire accordion item scales up by 2% on hover
  • Item lifts up 3px (appears to float)
  • Shadow increases to create depth
  • Smooth transition in and out

Best for: Modern, interactive designs

🌈 Hover Glow Effect

What it does: Creates an animated rainbow glow around accordion items on hover

  • Animated gradient border appears on hover
  • Soft glow shadow spreads around the item
  • Gradient colors shift continuously
  • Creates a premium, high-tech look

Best for: Tech websites, gaming sites, or modern portfolios

➡️ Slide In Animation

What it does: Accordion items slide in from the left when the page loads

  • Items start invisible and off-screen to the left
  • Each item slides in with a staggered delay
  • Creates a cascading entrance effect
  • First item appears first, then second, etc.

Best for: Landing pages or sections that need attention

💡 Pro Tips for Animations

  • Don't overdo it - usually 1-2 animation effects are enough
  • Consider mobile users - hover effects won't work on touch devices
  • Test performance - if you have many accordions, use fewer animations
  • Smooth Transitions + one other effect usually works best

Display Options

Accordion Behavior

  • Open First Item: Automatically expand the first accordion on page load
    • Yes: First item starts expanded
    • No: All items start collapsed

Content Elements

Date Display

  • Show Date: Enable/disable date display
  • Date Field: Created, Modified, or Publish date
  • Date Format: PHP date format (e.g., Y-m-d, F j, Y)

Metadata Display

  • Show Category: Display category name with link
  • Show Hits: Display article view count
  • Show Author: Display author name
  • Show Tags: Display article tags

Article Content Options

Option Description
Hide No article content shown
Auto Smart detection (intro or full)
Intro Text Show introduction only
Full Text Show complete article
Both Show intro + full text

Content Processing

  • Intro Text Limit: Character limit for intro
  • Fix Broken HTML: Auto-fix unclosed HTML tags
  • Clean Intro Text: Remove HTML from intro
  • Prepare Content: Process with Joomla plugins

Read More Options

  • Show Read More: Display read more link
  • Show Title in Read More: Include article title in link
  • Read More Limit: Character limit for title in read more

Advanced Settings

Layout Options

  • Alternative Layout: Choose custom template override
  • Module Class Suffix: Add custom CSS classes for additional styling

Custom CSS

Add your own CSS rules directly in the module. Example:

/* Custom title styling */
#mod-easy-articles-accordion-{id} .accordion-button {
    font-family: 'Georgia', serif;
    text-transform: uppercase;
    letter-spacing: 1px;
}

/* Custom content styling */
#mod-easy-articles-accordion-{id} .accordion-body {
    line-height: 1.8;
    font-size: 16px;
}

Caching Options

Setting Description When to Use
Use Global Use Joomla's global cache settings Default choice
No Caching Disable caching for this module Dynamic content
Cache Time Custom cache duration in seconds Specific requirements

Performance Optimization

Best Practices for Performance

  1. Limit article count - Display only necessary articles
  2. Enable caching - For static content
  3. Optimize images - Compress images in articles
  4. Minimize animations - Use fewer effects on pages with many accordions
  5. Test on mobile - Ensure smooth performance on all devices

Troubleshooting

Accordion not expanding/collapsing

Check: Bootstrap JavaScript is loaded

Solution: The module automatically loads Bootstrap, but check for conflicts with your template

Styles not applying

Check: No CSS conflicts with template

Solution: Use Custom Design mode or add !important to custom CSS

Articles not showing

Check: Article access levels and publishing status

Solution: Verify user permissions and article states

Animations not working

Check: Browser supports CSS3 animations

Solution: Update browser or disable animations for older browsers

Example Configurations

FAQ Section

Mode: Normal
Categories: FAQ Category
Grouping: None
Preset: Minimal Clean
Animation: Smooth Transitions
Open First: No
Show Date: No
Show Author: No
Show Category: No

Result: Clean FAQ accordion with smooth animations

Latest News Sidebar

Mode: Normal
Categories: News
Count: 5
Ordering: Created Date Descending
Preset: Card Style
Animation: Slide In
Show Date: Yes
Date Format: F j, Y
Show Category: Yes

Result: Eye-catching news accordion with dates

Related Articles

Mode: Dynamic
Show on Article Page: Yes
Count: 10
Preset: Modern Flat
Animation: Smooth Transitions
Show Intro: Yes
Intro Limit: 150

Result: Context-aware related articles

Product Categories

Mode: Normal
Categories: All Product Categories
Grouping: Category
Ordering: Title
Preset: Material Design
Animation: Hover Scale
Show Readmore: Yes

Result: Organized product listings by category

Team Member Bios

Mode: Normal
Categories: Team
Grouping: None
Ordering: Custom Order
Preset: Gradient Blue
Animation: Hover Scale + Smooth Transitions
Show Full Text: Yes
Show Author: No

Result: Professional team member showcase

Cron Job Starts