Comments

Features

• Attaches to entries of news, pages, downloads, products and custom sections. Those modules know nothing about comments: turn comments off and the site carries on as before.
• Threaded replies up to five levels deep. A reply deeper than allowed is placed next to the last permitted level, so nothing written is lost.
• Guests post with a name and, optionally, an email; the email is never shown on the site.
• Pre-moderation: a new comment stays hidden until it is approved.
• Signed-in users can edit or delete their own comment within a set time.
• Reviews rated from 1 to 5 wherever the owning module allows it (currently the shop): an average score above the reviews and a «Verified purchase» badge when the shop confirms the purchase.
• Bot protection without a CAPTCHA: a hidden honeypot field, a minimum fill time, a link limit, a per-address submission limit and duplicate filtering.
• In the admin panel: «Pending», «Published» and «Spam» queues, bulk actions and a counter of waiting comments in the menu. The «Missing source» tab lists comments whose entry has been deleted.

Settings

In the admin panel: Comments → Settings, in four groups.

• Publishing and permissions: guest comments, moderation before publishing, editing own comments and the edit window (30 minutes by default).
• Reviews and ratings: ratings, the average score and the «Verified purchase» badge.
• Discussion and display: order, closing the discussion after N days, reply depth (0–5), minimum and maximum length, conversations per page.
• Anti-spam: minimum fill time, allowed number of links, posts per IP per 10 minutes, duplicate window.

Permissions

• Moderate comments — see the section in the admin panel, approve comments, and send them to spam or the bin. Comments from users with this permission are published without pre-moderation.

On installation, administrators and editors get this permission.

On the site

The module has no pages of its own. The «Discussion» block sits below the content of an entry page. The form is signed with the module's key, so a comment cannot be slipped under someone else's entry.

Installation and removal

Installation creates the comments table and the module's own form-signing key. Removing the module with its data drops the table with all comments and ratings, along with the module's permission and settings.