How to Install and Style Akeeba Engage on Joomla 5 and 6 — Dark Theme Comments That Actually Look Good

Akeeba Engage is a lightweight, privacy-respecting comment system for Joomla articles. It was maintained by Nicholas K. Dionysopoulos until August 2025, when the repository was archived. The final release — version 3.4.3 — works on both Joomla 5 and Joomla 6 with a small namespace fix. Here’s exactly what we did to get it running, styled for a dark template, and looking like it belongs.

No third-party comment services. No JavaScript embeds. No tracking. Just native Joomla comments stored in your own database, managed through your own admin panel.

What Is Akeeba Engage?

Akeeba Engage adds a comment section below your Joomla articles. It supports threaded replies, Gravatar avatars, spam filtering via Akismet, email notifications, and full admin moderation. It installs as a component with a content plugin that automatically renders comments on article pages.

The extension was part of the Akeeba ecosystem alongside Akeeba Backup and Admin Tools. When Akeeba Ltd wound down active development in 2025, Engage was the first to be archived. The good news: it still works perfectly.

Installation

Download the final release (3.4.3) from the Akeeba Engage GitHub releases page. Install it through the Joomla admin panel the normal way: System → Install → Extensions, upload the zip.

After installation, you need to enable the content plugin manually:

1. Go to System → Manage → Plugins
2. Search for “Content - Akeeba Engage”
3. Open it and set Status to Enabled

The browser installer sometimes leaves the plugin disabled. Without it, comments simply won’t appear on your articles.

The Joomla 6 Namespace Fix

If you’re running Joomla 6 (or a future version where the old namespace wrappers have been removed), you’ll see an error like:

Class "Joomla\CMS\Filesystem\Path" not found

This happens because Joomla 6 moved the filesystem classes from Joomla\CMS\Filesystem to Joomla\Filesystem. The fix is four lines across three files:

File 1: ViewLoadAnyTemplateTrait.php

administrator/components/com_engage/src/Mixin/ViewLoadAnyTemplateTrait.php

// Change:
use Joomla\CMS\Filesystem\Path;
// To:
use Joomla\Filesystem\Path;

File 2: UpdatesModel.php

administrator/components/com_engage/src/Model/UpdatesModel.php

// Change:
use Joomla\CMS\Filesystem\File;
// To:
use Joomla\Filesystem\File;

File 3: UpgradeModel.php

administrator/components/com_engage/src/Model/UpgradeModel.php

// Change:
use Joomla\CMS\Filesystem\File;
use Joomla\CMS\Filesystem\Folder;
// To:
use Joomla\Filesystem\File;
use Joomla\Filesystem\Folder;

That’s it. Four use statements. The extension works perfectly after this change on both Joomla 5 and 6 — the Joomla\Filesystem namespace exists in both versions.

Dark Theme Styling

Akeeba Engage ships with Bootstrap-based styling that assumes a light background. If you’re running a dark template, the comments section will look like a flashbang went off on your page. Here’s the approach we used for the Signal Dark template.

The key CSS targets:

• .akengage-outer-container — the main wrapper
• .akengage-comment-card — individual comment cards
• .akengage-comment-hdr-title — commenter name
• .akengage-comment-hdr-meta — date and permalink
• .akengage-comment-body — comment text
• .akengage-comment-form — the comment submission form

We styled comments with a subtle left border (violet accent), dark card backgrounds using CSS custom properties, and ensured nested replies indent properly at each depth level. The comment form gets dark inputs with visible focus states. Bootstrap utility classes like .bg-light, .text-body, and .border-secondary need explicit overrides since they assume light mode.

The result: comments that look native to the dark template, not like a foreign widget bolted on.

How Comments Are Stored

Engage creates its own database tables, primarily #__engage_comments. Comments are linked to articles through Joomla’s asset system — each comment references the article’s asset_id from the #__assets table. This means comments survive article ID changes as long as the asset relationship is maintained.

The component also stores its own configuration and handles email notifications, spam checks, and user permissions through standard Joomla ACL.

Should You Use It?

If you want article comments without depending on Disqus, Facebook Comments, or any external service — yes. Akeeba Engage is self-hosted, respects privacy, and the code is solid. The fact that it’s no longer actively maintained is a consideration, but the codebase is clean and well-documented.

For Joomla 5 it works out of the box. For Joomla 6, apply the four-line namespace fix above. That’s the entire maintenance burden so far.

The extension is released under the GNU GPL v3, so forking and maintaining it is perfectly legitimate if the community decides it’s worth continuing.