Init View Count – Minimal, Accurate, Extensible
| 开发者 | brokensmile.2103 |
|---|---|
| 更新时间 | 2025年6月26日 18:28 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.8 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Init View Count is a fast, clean plugin to track post views without clutter. It:
- Uses REST API and JS to count real views
- Prevents duplicate counts with session/local storage
- Stores counts in meta keys like
_init_view_count,_init_view_day_count, etc. - Provides
[init_view_count]and[init_view_list]shortcodes - Includes
[init_view_ranking]shortcode with tabbed ranking by time range - Supports template overrides (like WooCommerce)
- Lightweight. No tracking, no admin bloat.
- Includes REST API to query most viewed posts
- Supports pagination in
[init_view_list]via thepageattribute - Batch view tracking support to reduce REST requests on busy sites
- Optional strict IP-based filtering to block fake view requests posted directly to the REST endpoint
- Now includes a Dashboard widget to monitor top viewed posts directly in wp-admin.
安装:
- Upload plugin to
/wp-content/plugins/init-view-count/ - Activate via Plugins menu
- Use
[init_view_count]or[init_view_list]in your content - Customize settings in Settings → Init View Count
屏幕截图:
![Shortcode builder for [init_view_list] – generate view-based post lists with custom templates.](https://cdn.jsdelivr.net/wp/init-view-count/assets/screenshot-2.png)
![Shortcode builder for [init_view_ranking] – generate tabbed rankings for different view ranges.](https://cdn.jsdelivr.net/wp/init-view-count/assets/screenshot-3.png)
![Shortcode builder for [init_view_count] – display view count for current post with format options.](https://cdn.jsdelivr.net/wp/init-view-count/assets/screenshot-4.png)
常见问题:
Can I reduce the number of view requests sent to the server?
= Can I customize the layout of the list? =\
Yes. Use the template attribute in [init_view_list] (e.g. template="grid"), and override the corresponding file in your theme like WooCommerce templates.
= Does it work with custom post types? =\
Yes. Just set post_type="your_custom_type" in the shortcode or REST query.
= How does it avoid duplicate views? =\
Init View Count uses both time delay and scroll detection via JavaScript, and stores viewed post IDs in either sessionStorage or localStorage (your choice).
= Is the view count updated immediately? =\
Yes. When the scroll+delay conditions are met, the count is updated via REST API and saved using update_post_meta().
= What meta key is used to store views? =\
By default:
_init_view_count(total)_init_view_day_count_init_view_week_count_init_view_month_count\ These keys can be changed via theinit_plugin_suite_view_count_meta_keyfilter. Trending scores are calculated separately and stored in a transient. = Can I display view counts in my template manually? =\ Yes. Useget_post_meta($post_id, '_init_view_count', true)or similar keys. Or use[init_view_count]shortcode in post content.
/top) are cached using transients.
= Can I use it in block editor / Gutenberg? =\
Yes. Just insert a Shortcode block and paste [init_view_count] or [init_view_list] as needed.
= Does it track bots? =\
No. Since counting only happens after scroll and delay via JavaScript, bots like Googlebot are naturally excluded.
= Can I sort posts by views in WP_Query? =\
Yes. Use 'meta_key' => '_init_view_count' and 'orderby' => 'meta_value_num' in your WP_Query args.
Yes. You can enable batch view tracking in the plugin settings. Instead of sending one request per view, views will be stored in the browser and sent in a group once the threshold is reached.
更新日志:
1.10 – June 26, 2025
- Added new
icon="true"attribute to[init_view_count]shortcode to display inline SVG before the view count - New setting: "Auto-insert shortcode into post content?" with options to insert before or after post content
- Auto-insert only applies to post types where view tracking is enabled (manual shortcode use still supported)
- Added
schema="true"attribute to[init_view_count]to output Schema.org microdata (InteractionCounter) - Added
class="custom-class"attribute to allow injecting custom CSS classes into the shortcode wrapper - New filter
init_plugin_suite_view_count_default_shortcodeallows developers to override default auto-insert output - New filter
init_plugin_suite_view_count_auto_insert_enabledgives control over whether auto-insert is active per context - Fully backward-compatible: all new features are optional and disabled by default
- Replaced all PHP 8+
matchexpressions with backwards-compatible logic using array maps and switches - Now fully compatible with PHP 7.4 and above – no syntax errors on legacy environments
- All changes preserve existing filters like
init_plugin_suite_view_count_meta_keyand template behavior - Maintained consistent behavior across REST API endpoints,
[init_view_list], and[init_view_count]shortcodes - Improved code clarity and maintainability without altering plugin output or logic
- Added new "Strict IP check" option to block repeated views from the same IP in a short timeframe
- Uses hashed IPs and transient-based FIFO cache (default: 75 recent IPs per post)
- Designed to prevent fake views posted directly to the REST endpoint (e.g., bots, cURL scripts)
- Fully privacy-safe: does not store raw IPs and automatically expires over time
- New setting: "Enable strict IP check?" (disabled by default)
- Added Dashboard widget with [init_view_ranking] display
- Introduced admin-style.css optimized for clean, one-line layout
- REST API /count now respects the batch limit setting to avoid overload
- Added batch view tracking option to reduce server requests on high-traffic sites
- Views can be temporarily stored in localStorage and sent in groups
- New setting: "Batch view tracking" (default = 1 for real-time)
- Updated JS to support batch logic with scroll + delay detection
- REST API now accepts multiple post IDs and returns array responses
- View count updates instantly after tracking, no reload needed
- Added shortcode builder panel to settings screen for easier shortcode generation
- Introduced new
init-shortcode-builder.jswith full shortcode configuration UI - Supports
[init_view_list],[init_view_ranking], and[init_view_count]shortcodes - i18n-ready: all UI strings are fully translatable via
InitViewCountShortcodeBuilder.i18n - Improved JS architecture to separate builder panel from core builder logic
- Introduced "Trending" scoring system based on daily views and post age (views per hour)
- Trending posts are calculated hourly via cron, optimized for high-traffic and large sites
- New
range=trendingsupport added to/topREST endpoint with built-in sorting and pagination - Shortcode
[init_view_list range="trending"]now fetches trending posts - Internal meta key filtering is fully respected in all ranking and trending logic
- Improved post meta cleanup for day/week/month reset with filterable keys
- Prepared shortcode UI and REST responses for enhanced performance and data accuracy
- Added new
[init_view_ranking]shortcode to display tabbed ranking UI by day/week/month/all-time - Shortcode uses lazy-loading via REST API and includes built-in skeleton loaders for smoother UX
- Fully compatible with headless or SPA environments – optimized to load only when visible
- All assets are conditionally enqueued: JS loads only when shortcode is used, styles are shared via
style.css
- Enqueued
style.cssearlier to avoid being printed in the footer - Added toggle option to disable plugin’s default CSS in the settings page
- Applied
init_plugin_suite_view_count_meta_keyconsistently across REST API, shortcodes, and background tasks - Fixed issue where custom meta key override was ignored in some cases
- Added
pageparameter to/topREST endpoint for pagination - Added
pageattribute to[init_view_list]shortcode for paginated lists - Removed infinite scroll trigger for simplicity and better template control
- Fully compatible with existing templates and theme overrides
- Initial release
- REST-based view counter
- 4 templates included
- Fully extensible with filters/hooks
- Shortcodes with layout switching