Repository navigation
Guest comments
Guests enter a required name (up to 40 visible characters), email and plain-text comment. Email is private and shown only in the admin. Text defaults to 5000 visible characters, including spaces and line breaks; composed emoji count as one character. HTML and Markdown are not rendered.
Names may include a first and last name or a nickname. Surrounding whitespace is trimmed before counting Unicode graphemes. Longer new names are rejected without truncation; existing saved names and registered account names are unchanged.
An unremembered guest completes a local arithmetic CAPTCHA: five-minute expiry, five attempts, refresh available. Refresh invalidates the selected form’s old challenge; other tabs stay valid. This is one spam layer, not a guarantee against automated submissions. Optional Google/Yandex adapters require JavaScript. When an external challenge is required, enable JavaScript in the browser and complete the check before sending. No alternative submission path is offered without JavaScript; the existing remembered-email exemption is unchanged. Invisible form checks and attempt quotas complement CAPTCHA; fast submission alone never discards a comment. Recent repeated long text and bursts of links are also review signals, including guest revisions. Short common replies and one or two links do not trigger the default content thresholds. See guest content checks.
From 1.4.0, Apply rules mode refuses new guest text matching an enabled Reject rule before acceptance. The form shows the configured reason and preserves the draft; no comment or mail is created. CAPTCHA and attempt limits still apply, including for remembered guests. Review rules and soft signals continue through email proof. See rules and reason selection.
- Acceptance creates a private submission and queues verification mail.
- Opening the link displays a confirmation form; GET alone confirms nothing.
- Pressing Confirm verifies email, then applies moderation and filtering.
- Publication happens immediately or after a moderator's decision.
- Publication sends a separate guest editing-link email.
The confirmation deadline is 24 hours from acceptance, including delivery delays. Resends never extend it. The worker fully deletes unconfirmed submissions after expiry.
Proof is remembered in the browser separately for each Site/email for 30 days from confirmation. Matching ordinary submissions need neither new CAPTCHA nor new email proof while it is valid. Enabled suspicious-header checks can require CAPTCHA again; the optional strict mode checks every guest submission. Visits and submissions do not renew the deadline. A different browser/email, cleared storage or expired proof requires verification again. This proof is not a registered site account.
Unpublished content is author-only, through the submitting browser/account or a protected status link. The browser can inspect confirmation-mail status and resend eligible mail. An email address alone never proves ownership. Guest edits open inline from the protected publication email link and use the same rules as account edits: see Replies and editing.
Site email and configured email delivery must be enabled for guest submission. From 1.4.0, this can use Commentail's separate backend. See email setup. Also check author access, discussion mode, target permission and quotas.
← Rules and CSV · Documentation home · Replies and editing →
- Home
- Главная на русском
- Course in English
- Курс на русском
- Installation
- Configuration
- Moderation
- Rules and CSV
- Guest comments
- Replies and editing
- Email and worker
- Separate email configuration
- Отдельная настройка почты
- Styling
- Templates
- Recent comments
- Structured data
- Callbacks
- Object adapters
- Security and privacy
- Deployment
- Performance
- Troubleshooting
- Example and testing
- Release 0.1.0
- Release 0.1.1
- Release 0.2.0
- Stability
- Template contract
- Release 1.0.0
- Release 1.1.0
- Release 1.2.0
- Release 1.3.0
- Security update 1.3.1
- Translated Site roots 1.3.2
- Release 1.4.1
- Выпуск 1.4.1 на русском
- Release 1.4.0
- Выпуск 1.4.0 на русском
- Changelog
- Roadmap
- Support