Init Recent Comments – Templated, Modern, Minimal

Init Recent Comments is a developer-friendly plugin that lets you display the latest comments anywhere via a simple shortcode. It uses clean HTML, minimal CSS, and fully customizable templates.

No widgets, no bloated options. Just lightweight, extendable code — made for real sites.

Key design goals:

• Templated rendering with override support from themes
• Clean CSS you can disable or replace
• REST-ready architecture (future-proof)
• No jQuery, no nonsense

Perfect for blogs, news sites, or anyone who wants a better way to show active discussions.

This plugin is part of the Init Plugin Suite — a collection of minimalist, fast, and developer-focused tools for WordPress.

GitHub repository: https://github.com/brokensmile2103/init-recent-comments

Features

• Simple shortcode: [init_recent_comments]
• Template-based rendering (comment-item.php, wrapper.php)
• CSS can be disabled to use your theme’s design
• No widgets, no jQuery, no frontend bloat
• Developer-ready: extend with filters, REST, and lazy loading (planned)
• Translation-ready (.pot included)

Usage

Use the shortcode anywhere:

[init_recent_comments number="5" maxheight="400px"]

Attributes:

• number – Total comments to show (default: 5)
• maxheight – Optional max height with scroll and hidden scrollbar (example: 300px)

To override templates, create the folder in your theme:

your-theme/
└── init-recent-comments/
    ├── wrapper.php
    └── comment-item.php
Filters for Developers

This plugin provides multiple filters to help developers customize caching behavior and performance for recent comments, reviews, and total comment count queries.

init_plugin_suite_recent_comments_ttl
Control the cache TTL (in seconds) for recent comments.
Applies to: Recent Comments Query
Params: int $ttl

init_plugin_suite_recent_comments_query_args
Allows developers to modify or extend the WP_Comment query arguments before the query runs.
Applies to: Recent Comments Query
Params: array $args

init_plugin_suite_recent_reviews_ttl
Control the cache TTL (in seconds) for recent reviews.
Applies to: Recent Reviews Query
Params: int $ttl

init_plugin_suite_total_comments_ttl
Control the cache TTL (in seconds) for total approved comment counts by post type.
Applies to: Total Comments Query
Params: int $ttl, array $post_types

init_plugin_suite_total_by_posts_ttl
Control the cache TTL (in seconds) for total approved comment counts across multiple post IDs.
Applies to: Total by Post IDs Query
Params: int $ttl, array $post_ids

License

This plugin is licensed under the GPLv2 or later.
You are free to use, modify, and distribute it under the same license.