Advanced Reading Progress & View Counter

تفصیل

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:

1. Clone the repository:
   git clone https://github.com/Teckut-Git/advanced-reading-progress-view-counter

2. Navigate into the project directory:
   cd advanced-reading-progress-view-counter

3. Install dependencies:
   npm install

4. Build production files:
   npx gulp build

This ensures transparency and compliance with WordPress.org plugin guidelines.