Visitors can comment on published posts without an account. Every comment starts as Pending and is only shown publicly once it is approved.
Enabling comments
Comments are on by default. Turn them off with Enable comments on Admin > Blog > Settings (see Configuration). When off, the post page shows no comment section and /api/blog/posts/{id}/comments returns 403.
How visitors comment
On a published post page the Comments section shows a form with Name, Email (will not be published) and Comment, and a Post comment button. All three fields are required; the name is limited to 100 characters and the comment to 5,000. On success the page reloads with the message "Your comment has been submitted and is awaiting moderation."
Comments can only be attached to published posts. The visitor's IP address is stored as a SHA-256 hash, never in clear text. The email address is stored and shown to moderators but is not printed on the public page.
Comments can also be submitted programmatically; see REST API.
Notifications
If Moderation notification recipients are selected in Configuration, each new comment from the post page sends them an email with the post title, the commenter's name and email, and the comment text.
Moderating comments
Go to Admin > Blog > Comments (/admin/blog/comment). The list opens on Pending; use the dropdown to switch to All, Approved or Spam. It shows the author, the post ID, the status and the date, 50 comments at a time.
| Action | Effect |
|---|---|
| View | Opens the comment (/admin/blog/comment/show/{id}) with the email address, the full text and a link to the post. |
| Approve | Sets the status to approved. Hidden for comments that are already approved. |
| Spam (or Mark Spam on the detail page) | Sets the status to spam. The comment is kept but never shown. |
| Delete | Removes the comment permanently after confirmation. |
A comment can move between approved and spam at any time. Deleting a post deletes all of its comments.
The admin detail page of a post (View from the edit page) lists that post's comments with their status and a View link.
Displaying approved comments
The public post page loads the approved comments for the post in date order and passes them to the omeka/site/blog/show template as $comments. See Displaying the Blog if you override that template in your theme. Also see Troubleshooting if comments submitted from the site do not show up in the Comments list.