Community Forum — Complete guide
Install, configure and run a complete community forum for PrestaShop 8 and 9: categories and sub-forums, topics and replies, moderation, pre-moderation, reports, search and friendly URLs.
Overview and requirements
Community Forum adds a real forum to your PrestaShop store, wired directly into the existing customer account. Your customers open topics, reply to each other, edit or delete their own posts and report abuse, while you stay in control from the back office: categories and sub-forums, moderation individually or in bulk, optional pre-moderation and a report queue. All without a third-party tool or external database.
- Compatible with PrestaShop 8.0 to 9.x, Classic theme and derived themes.
- PHP 8.1 to 8.3.
- Multistore and multilingual (FR/EN/ES/DE/IT).
- No CRON task required, no Composer dependency.
- PrestaShop-compliant architecture (ObjectModel, ModuleAdminController), compatible with PS 8 and PS 9 with no adaptation.
Members use their existing PrestaShop customer account. No second account is needed: a link to the forum is added to the customer area and to the footer.
Installation
Install the module like any other PrestaShop module:
- Download the
dfforum.ziparchive from your customer account. - In the back office, go to Modules > Module Manager.
- Click Upload a module and drop the archive.
- Once installed, click Configure.
On installation, the module creates its tables (categories, topics, posts, reports), registers its hooks, adds the parent DataFirefly Forum tab and seeds a first demo category named “General discussion” so you can test right away.
If friendly URLs don’t activate immediately, clear the cache (Advanced Parameters > Performance) and regenerate URLs from Traffic & SEO.
General module settings
The configuration page gathers all the forum settings:
- Pre-moderation: when enabled, every new topic or post goes into a queue before becoming public.
- Guest reading: allows or not browsing the forum without being logged in (writing remains reserved for logged-in customers).
- Topics per page: number of topics shown in a category (20 by default).
- Posts per page: number of posts shown in a topic (15 by default).
- Minimum length: minimum number of characters required for a post (10 by default).
- Anti-flood delay: minimum time, in seconds, between two posts from the same member (30 by default; 0 to disable).
- Reports: enables or not the ability for members to report a post.
- Edit window: time, in minutes, during which a member can still edit their post (30 by default; 0 to forbid editing).
- Notification e-mail: address that receives reports (the store e-mail by default).
Creating categories and sub-forums
From the DataFirefly Forum > Categories tab, structure your forum. A category can be a top-level topic area or a sub-forum attached to another category.
- Name and description: per-language translatable texts, shown on the forum home.
- Parent category: leave empty for a root category, or pick a category to create a sub-forum.
- Icon: optional pictogram shown next to the name.
- Position: display order, adjustable by drag-and-drop in the list.
- Active: hides or shows the category on the storefront.
Each sub-forum automatically shows its topic count, post count and last post.
Deleting a category also deletes the topics and posts it contains. Any sub-forums it had are detached (moved back to the root), not deleted.
On the visitor side: creating a topic and replying
A logged-in customer opens a topic from the New topic button: they choose the category, enter a title and a message. The module automatically generates a slug and a friendly URL for the topic. Inside a topic, the reply form appears at the bottom of the page for logged-in members.
Each post shows an author card: initial avatar, name, post count and member-since date. As long as the edit window has not passed, the author can edit or delete their own post directly, without reloading the page (AJAX).
If the author deletes the only post of a topic they created, the whole topic is deleted. This is the expected behaviour to avoid empty topics.
Moderating topics and posts
Two dedicated tabs let you moderate:
- DataFirefly Forum > Topics: enable or disable, pin, lock or delete topics, individually or in bulk. A locked topic stays readable but no longer accepts replies; a pinned topic rises to the top of its category.
- DataFirefly Forum > Posts: moderate each post individually or in bulk, approve pending posts, or filter the posts of a specific topic.
The dashboard (first tab) shows at a glance the number of categories, topics, posts, pending posts and reports, with direct links to moderation.
Pre-moderation
When pre-moderation is enabled in the settings, every new topic and every new reply is created with a “pending” status and does not appear until you approve it. The member is informed that their post will be published after approval.
To approve, go to Posts: pending content is flagged there and can be approved individually or in bulk. The “pending” counter on the dashboard always tells you what remains to be handled.
Pre-moderation applies to new content. Already published posts do not go back into the queue if you enable the option later.
Reports and notifications
If reports are enabled, each member can report a post they consider abusive (one report per member and per post). The report lands in the DataFirefly Forum > Reports tab, with direct access to the post concerned, and can be marked as handled.
On each report, an e-mail is sent to the configured notification address. Ready-to-use e-mail templates are provided in French and English.
So you never miss a report, set a notification address dedicated to moderation rather than the generic store e-mail.
Search and friendly URLs
The forum exposes a full-text search based on a FULLTEXT index on post titles and content: your visitors instantly find a discussion. On the address side, the module generates clean, readable URLs for the forum, categories and topics, as well as for creating a new topic.
This customer-generated content, accessible through clear URLs, naturally feeds your SEO on long-tail queries. Leave reading open to guests to maximise indexing.
Customer-account integration
The module integrates with the PrestaShop customer area via the displayCustomerAccount and displayMyAccountBlock hooks: a link to the forum appears in the customer account dashboard. A second link is added to the footer via the displayFooter hook, to make the forum visible from any page.
FAQ and troubleshooting
The forum link doesn’t appear in the customer area
Check that the displayCustomerAccount and displayMyAccountBlock hooks are properly attached (Modules > Positions tab). Some custom themes don’t call these hooks: you then need to add them to the customer-account template.
Forum URLs return a 404 error
Clear the cache and regenerate URLs from Traffic & SEO. Make sure URL rewriting (friendly URLs) is enabled in your store.
A member can no longer edit their post
Editing is only possible during the edit window defined in the settings. After that delay, the edit button disappears. Set the window to 0 to forbid any editing, or increase it to allow more time.
Posts don’t appear immediately
This is normal behaviour when pre-moderation is active: posts stay pending until approved from the Posts tab. Disable pre-moderation for immediate publication.
How do I fight spam?
The module combines several safeguards: invisible honeypot field, configurable anti-flood, minimum length and community reporting. For maximum control, enable pre-moderation.
What happens on uninstall?
Uninstalling removes the module’s tables and its back-office tabs. A confirmation is requested because this operation permanently erases categories, topics and posts.