Init Recent Comments – Templated, Modern, Minimal
Display recent comments using clean templates and minimal CSS, with Block Editor & Abilities API support. Developer-friendly, fast, and built for modern WordPress.
No widgets. No jQuery. No bloat — just clean, templated output.
Overview
Init Recent Comments is a lightweight, developer-oriented plugin that displays the latest comments (and reviews) anywhere on your site — through a simple shortcode, or natively as a Block Editor block.
Built with flexibility and simplicity in mind — clean markup, minimal CSS, and template overrides directly from your theme.
Ideal for blogs, news sites, or any project that values both performance and clean design.
What's New in v2.0.1
- Security: recent comments only include comments on published posts (same rule as core's Recent Comments widget), and recent reviews skip reviews on posts that aren't publicly viewable — no more leaking private/draft post titles or content
- Security (Abilities API): looking up guest comments by email requires the
moderate_comments capability; non-approved reviews require manage_options
- Fixes:
maxheight is now actually applied, "Disable built-in CSS" also covers blocks, review links are no longer double-escaped, "time ago" uses GMT, Shortcode Builder strings are translated
- Performance: batched loading of posts/users/parent comments (≈6 queries instead of ≈33 for 10 comments), and TTL caches now auto-invalidate when data changes
- Code quality: full WordPress Coding Standards (WPCS 3) compliance
What's New in v2.0.0
- Block Editor (Gutenberg) support: four dynamic blocks — Recent Comments, Recent Reviews, User Recent Comments, User Recent Reviews — grouped under their own Init Recent Comments category in the block inserter. Each block is registered via
block.json with a PHP render.php that calls the exact same shortcode function as its shortcode counterpart, so output never diverges. A single no-build-step vanilla JS file powers the editor integration, with wp.serverSideRender for live preview
- Abilities API support (WordPress 6.9+): registers four read-only abilities —
get-recent-comments, get-recent-reviews, get-user-recent-comments, get-user-recent-reviews — mapping 1:1 to all four shortcodes. This plugin has no write actions at all (it's a pure display plugin), so all of its functionality is safely exposed. Discoverable and executable via PHP, wp_get_abilities(), and the wp-abilities/v1 REST namespace when a site opts in. Review-related abilities gracefully return an empty list if Init Review System isn't active. Fully optional: on WordPress versions older than 6.9, this silently does nothing
- Requires at least raised from 5.5 to 6.9 to support the Abilities API.
Requires PHP stays at 7.4
Features
- Block Editor (Gutenberg) blocks: Recent Comments, Recent Reviews, User Recent Comments, User Recent Reviews — each with a live server-side preview in the editor
- Abilities API (WordPress 6.9+): all 4 shortcodes' data exposed as discoverable, executable abilities
- Shortcode:
[init_plugin_suite_recent_comments] (legacy alias: [init_recent_comments])
- Shortcode for recent reviews:
[init_plugin_suite_recent_reviews] (legacy alias: [init_recent_reviews])
- Shortcode for a specific user's recent comments:
[init_plugin_suite_user_recent_comments] (legacy alias: [init_user_recent_comments])
- Shortcode for a specific user's recent reviews:
[init_plugin_suite_user_recent_reviews] (legacy alias: [init_user_recent_reviews])
- Template-based rendering (
comment-item.php, wrapper.php, review-item.php, review-wrapper.php)
- Disable built-in CSS and use your own styling
- No widgets, no jQuery, no frontend dependencies
- Developer-ready — filters, REST endpoints, and lazy loading (planned)
- Translation-ready (
.pot file included)
Block Editor (Gutenberg)
Four dynamic blocks are available under their own Init Recent Comments category in the block inserter — no shortcodes needed if you prefer working entirely in the editor:
| Block | Equivalent shortcode |
|---|
| Recent Comments | [init_plugin_suite_recent_comments] |
| Recent Reviews | [init_plugin_suite_recent_reviews] |
| User Recent Comments | [init_plugin_suite_user_recent_comments] |
| User Recent Reviews | [init_plugin_suite_user_recent_reviews] |
Each block shares the exact same rendering code as its shortcode, so switching between the Block Editor and shortcodes never changes the output. Block settings map directly to shortcode attributes, and a live preview is shown right in the editor as you configure it.
Abilities API (WordPress 6.9+)
On WordPress 6.9 and above, Init Recent Comments registers four read-only abilities under the init-recent-comments category, mirroring the plugin's four shortcodes exactly:
init-recent-comments/get-recent-comments — most recent approved comments site-wideinit-recent-comments/get-recent-reviews — most recent approved reviews site-wide (requires Init Review System)init-recent-comments/get-user-recent-comments — most recent approved comments by a specific userinit-recent-comments/get-user-recent-reviews — most recent reviews submitted by a specific user (requires Init Review System)
This plugin has no write actions at all — it's a pure display plugin — so all of its functionality can be safely exposed without exclusions. These abilities are discoverable and executable via PHP (wp_get_abilities()), and — for sites that opt in — the wp-abilities/v1 REST namespace. This integration is fully optional: on WordPress versions older than 6.9, it silently does nothing.
Usage
Prefer working in the Block Editor? Each shortcode below has an equivalent block — see Block Editor (Gutenberg) above.
Use the shortcode anywhere:
[init_plugin_suite_recent_comments number="5" maxheight="400px"]
Recent reviews:
[init_plugin_suite_recent_reviews number="5"]
Recent comments of a specific user:
[init_plugin_suite_user_recent_comments user_id="123"]
Recent reviews of a specific user:
[init_plugin_suite_user_recent_reviews user_id="123"]
The legacy tags [init_recent_comments], [init_recent_reviews], [init_user_recent_comments], and [init_user_recent_reviews] still work exactly the same way, for backward compatibility with existing content.
Attributes:
number – Total items to display (default: 5)maxheight – Optional scrollable height (e.g. 300px)paged – Optional paginationtheme – Light or dark (e.g. theme="dark")- For user shortcodes:
user_id, user_login, or user_email can be used to target the user
Template overrides:
Place custom templates inside your theme:
your-theme/
└── init-recent-comments/
├── wrapper.php
├── review-wrapper.php
├── comment-item.php
└── review-item.php
Developer Filters
This plugin provides multiple filters for customizing cache duration and performance of comment/review queries.
By default, comment and review queries are not cached (TTL = 0) so newly posted comments always show up immediately. Total comment count queries default to a 5-minute TTL instead, since counts are less time-sensitive. You can enable caching for the other queries yourself via the filters below if your site has heavy traffic and can tolerate a short delay.
| Filter | Description | Applies To | Params |
|---|
init_plugin_suite_recent_comments_ttl | Control TTL (in seconds) for recent comments | Recent Comments Query | int $ttl |
init_plugin_suite_recent_comments_query_args | Allow developers to modify/extend the WP_Comment query args before execution | Recent Comments Query | array $args |
init_plugin_suite_recent_reviews_ttl | Control TTL (in seconds) for recent reviews | Recent Reviews Query | int $ttl |
init_plugin_suite_user_recent_comments_ttl | Control TTL (in seconds) for a specific user's recent comments | [init_user_recent_comments] | int $ttl, array $args |
init_plugin_suite_user_recent_reviews_ttl | Control TTL (in seconds) for a specific user's recent reviews | [init_user_recent_reviews] | int $ttl, array $args |
init_plugin_suite_total_comments_ttl | Control TTL (in seconds) for total approved comment counts by post type | Total Comments Query | int $ttl, array $post_types |
init_plugin_suite_total_by_posts_ttl | Control TTL (in seconds) for total comments across multiple post IDs | Total by Post IDs Query | int $ttl, array $post_ids |
Installation
- Upload the plugin folder to
/wp-content/plugins/
- Activate it under Plugins → Init Recent Comments
- Insert
[init_plugin_suite_recent_comments] in any page, post, or widget — or add the equivalent block in the Block Editor
- (Optional) Disable built-in CSS via Settings → Init Recent Comments
Requirements
- WordPress 6.9 or later (raised from 5.5 in v2.0.0, to support the Abilities API integration)
- PHP 7.4 or later
License
GPLv2 or later — open source, minimal, developer-first.
Part of Init Plugin Suite
Init Recent Comments is part of the Init Plugin Suite — a collection of blazing-fast, no-bloat plugins made for WordPress developers who care about quality and speed.
