README

A full-featured comment system for Blogr CMS — threaded comments, moderation, voting, anti-spam, email notifications, and a complete Filament admin interface.

Features

🔧 Core

Threaded comments — Nested replies with configurable depth (1–10 levels) and dedicated partials for each level
Markdown formatting — Bold, italic, code blocks (with syntax highlighting via scrivo/highlight.php), inline code, links, H2
Live preview — See formatted content before posting
Character counter — Configurable max length (default 5000) with real-time countdown
Toolbar — Bold, italic, H2, link, code block, preview buttons (safe Markdown subset)

🛡️ Moderation & Anti-spam

3 moderation modes — Pre-moderation (all pending), post-moderation (auto-publish), trust system (auto-trust after N approved comments)
Multi-layer anti-spam — Cloudflare Turnstile (free, invisible), StopForumSpam API (free), Akismet API (paid, optional), local keyword/link filters
Rate limiting — Per-IP throttling for comments (configurable per hour) and votes (per minute) via dedicated middleware
Admin moderation — Approve, reject, mark as spam, or delete individually or in bulk
Email-based quick moderation — Signed URL approve/reject links in notification emails

📬 Notifications

New comment alert — Notify site owner on every new comment (or daily digest or weekly digest)
Reply notification — Possibility to auto-notify parent commenter when someone replies, with opt-out link
Comment subscriptions — Auto-subscribe on comment for reply notifications
Daily digest — Configurable email digest of pending comments

🗳️ Voting

Up/down voting — IP + User-Agent based anti-doublon protection
Denormalized score — vote_score column on comments for fast sorting
Sort options — Newest, oldest, best (by score)

⚙️ Filament Admin

Comment Resource — Full list/view with status filters, visible/invisible toggle
Dashboard widget — Pending comments count with quick link to moderation list
Settings page — All configuration UI (moderation, notifications, anti-spam, rate limits, nesting depth, display options)

🌍 Frontend Display

Syntax highlighting — Server-side code highlighting with language badge, dark mode support
Per-comment permalink — 🔗 button copies sharable URL with #comment-{id} anchor
Smart anchor scrolling — Dynamic scroll offset accounts for fixed/sticky navigation and mobile viewport
Comment count on articles — Shows count in card date line and article metadata (configurable)
Gravatar support — Automatic avatars via email MD5 hash
Multilingual — Complete EN, FR, ES, DE translations for frontend, admin, and email templates

🔌 Extension Points

BlogrExtension interface — Registers as blogr-comments extension, respects enable/disable state
FilamentPlugin — Auto-registers resource, settings page, and widget in the panel

Requirements

PHP ^8.3
Blogr ^1.3
Laravel ^12.0
Filament ^4.0

Installation

composer require happytodev/blogr-comments

Run the migrations:

php artisan migrate

Configuration

Publish the config file:

php artisan vendor:publish --tag=blogr-comments-config

Anti-spam (Turnstile)

Get your free Turnstile keys from Cloudflare Turnstile and add to your .env:

TURNSTILE_SITE_KEY=your_site_key
TURNSTILE_SECRET_KEY=your_secret_key

Anti-spam (Akismet — optional)

AKISMET_API_KEY=your_akismet_key

Usage

Frontend

Comments automatically appear at the bottom of each blog post. No additional setup needed.

Admin — Moderation

Navigate to Comments in your Filament admin sidebar to:

View all comments sorted by status
Filter by status (pending, approved, rejected, spam)
Approve, reject, or mark as spam (individual or bulk)
View comment details with full metadata

Admin — Settings

Go to Comments → Settings to configure:

Moderation mode (pre/post/trust)
Email notifications (owner + replies + digest)
Anti-spam providers
Rate limits
Nesting depth
Display options (comment count on articles)

Testing

vendor/bin/pest

Changelog

Please see CHANGELOG for more information.

License

The MIT License (MIT). Please see LICENSE for more information.

happytodev / blogr-comments

Maintainers

Package info

Statistics

Security