Description
Advanced Reading Progress & View Counter adds a customizable reading progress indicator and an intelligent post view counter to your WordPress website.
Improve reader engagement with visual reading progress tracking and monitor content popularity with built-in anti-refresh view counting.
Key Features
- Reading progress indicator with bar and radial display modes.
- Custom colors, thickness, and position controls.
- Select which post types display the indicator.
- Post view counter with anti-refresh protection.
- Configurable prefix, suffix, colors, and placement.
- Shortcode support for manual placement.
- Lightweight and performance-friendly.
- No external services required.
Shortcodes
[arpvc_view_counter][arpvc_read_count](alias)[arpvc_view_counter post_id="123"][arpvc_view_counter prefix="Views:" suffix="total"][arpvc_view_counter show_zero="0"]
Notes
- If badge position is set to
Shortcode only, the badge is rendered only where shortcode is used. - Anti-refresh lock logic still applies to counting unless lock window is set to
0.
Development & Source Code
This plugin uses a modern build process (npm + gulp) to generate optimized production assets.
The full human-readable, uncompiled development source code is publicly available at:
https://github.com/Teckut-Git/advanced-reading-progress-view-counter
The plugin distributed via WordPress.org contains compiled production assets located in:
- build/js/
- build/css/
Developers can review, study, modify, and rebuild the original source code using the instructions below.
Rebuild Instructions
To regenerate compiled assets from source:
-
Clone the repository:
git clone https://github.com/Teckut-Git/advanced-reading-progress-view-counter -
Navigate into the project directory:
cd advanced-reading-progress-view-counter -
Install dependencies:
npm install -
Build production files:
npx gulp build
This ensures transparency and compliance with WordPress.org plugin guidelines.
Screenshots
View counter displayed on a single post. 
Reading progress bar displayed at the top of a post. 
Radial reading progress indicator example. 
Reading Progress settings page in WordPress admin. 
View Counter settings page in WordPress admin.
Installation
- Upload the plugin folder to
/wp-content/plugins/advanced-reading-progress-view-counter/. - Activate the plugin from the Plugins screen in WordPress.
- Open Reading Progress & Views in wp-admin.
- Configure progress indicator settings in Progress Settings tab.
- Configure counter settings in View Counter tab.
FAQ
-
How does “Lock window (hours)” work?
-
It is a cooldown per visitor per post.
- Example: if set to
24, the same visitor adds at most one view to that post every 24 hours. - Repeated refreshes inside the window do not increase the count.
- Example: if set to
-
Can I disable the lock window?
-
Yes. Set
Lock window (hours)to0to disable lock-based deduplication. -
How do I place the view counter manually?
-
Set badge position to
Shortcode only, then place[arpvc_view_counter]where needed. -
Does this plugin count bot traffic?
-
The plugin includes basic request filtering to skip obvious bot-like user agents and non-standard request contexts.
-
Can I show the counter on a specific post from another page?
-
Yes, use:
[arpvc_view_counter post_id="123"]
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Advanced Reading Progress & View Counter” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Advanced Reading Progress & View Counter” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.
- Progress indicator settings panel.
- Post view counter with lock window and shortcode support.