Feature: Comments #

Comment system tied to a page or piece of content. Logged-in users can post short messages linked to an object identified by a hash.

---

Installation and Configuration #

Via FTP: Upload the `comments/` directory into `/plugins/`.

Via package manager: Select `comments` from the available plugins list.

Paths:

• Main plugin: `/plugins/comments/comments.php`
• Configuration: `/plugins/comments/conf/comments.conf.inc.php`
• Locales: `/plugins/comments/locale/`

Configuration parameters:

| Variable | Default | Description |

|---|---|---|

| `$basedatadisplay` | `'no'` | Hidden from management interface |

| `$basedisplevel` | `BASE_LEVEL_USER` | Level required to comment |

Required SQL table: `comments`

Default pagination: 25 comments per page.

---

Usage #

The plugin is embedded in other pages via direct inclusion. The input form is shown to users with `COMMENTS_LEVEL_USER` level.

Anti-spam: each comment is identified by an MD5 hash composed of the commented object and a configuration key. Per-user duplicates are detected and rejected.

Moderation: JSON configuration files in `conf/` define filtered word lists.

---

Hooks and Entry Points #

Form submission via POST:

| Parameter | Description |

|---|---|

| `cmtmessage` | Comment text |

| `cmtobj` | Identifier of the commented object |

?obj=comments.php          — Comment list
?obj=comments.php&page=N   — Page N

---

Dependencies #

• `Beamreactor\Database\SQL` — `comments` table
• `Beamreactor\Sanitizer\Parser`