=== Animated Scroll to Top Button, Progress Bar & Read Time - Uply ===
Contributors: shoiswp, freemius
Tags: scroll to top, progress bar, read time, reading time, scroll button
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds Animated Scroll to Top button, dynamic Reading Progress Bar, & estimated Read Time. SEO-optimized, lightweight, and fully customizable.

== Description ==

**Ultimate UX Toolkit: Advanced Scroll to Top, Progress Bar, and Smart Reading Time.**

Uply is designed to solve one major problem: Reader Fatigue. Long articles can be overwhelming, but with the right visual cues, you can keep users engaged and navigating effortlessly. This plugin brings together three essential tools - Scroll to Top, Progress Bar, and Reading Time — all optimized for speed and SEO.

### 1. Advanced Scroll to Top Button
Make site navigation effortless. Say goodbye to boring navigation and give your users a stylish way to return to the top.

*   **Standard Icon Library**: Access a clean collection of Arrows, Chevrons, and Circles that fits any theme.
*   **Flexible Positioning**: Toggle between Left or Right alignment with adjustable bottom margins.
*   **Custom SVG Icon Builder**: Upload your own branding icons and fully customize background colors, borders, and hover effects.
*   **Mobile Visibility Control**: Keep your mobile interface clean by specifically enabling or disabling the button on mobile devices.
*   **58+ Premium Button Designs [PRO]**: Upgrade to a massive library featuring Rocket icons, Paper planes, 3D animated buttons, and unique modern shapes.
*   **10+ Special Progress Buttons [PRO]**: A high-end feature where a circular or square progress indicator is built directly around the button, filling up as the user scrolls.
*   **Unique Styles & Fluid Animations [PRO]**: Every Pro button comes with "Joss" (stunning) animations and designer-grade transitions that make your site stand out.

### 2. Dynamic Reading Progress Bar
A visual roadmap that encourages users to finish your articles. Give your readers a sense of accomplishment as they scroll.

*   **Sleek Minimalist Styles**: Solid, Segmented, or Rainbow bars that track progress in real-time.
*   **Top Positioning**: A standard, non-intrusive bar fixed to the top of the viewport.
*   **Bottom Viewport Toggle**: Choose to fix the progress bar to either the top or the bottom of the screen.
*   **Precision Height & Thickness**: Use a range slider to adjust the thickness of the bar to match your brand's style perfectly.
*   **Intelligent Sticky Offset**: Smart "Space Above/Below" settings to prevent the bar from overlapping with your sticky headers or menus.
*   **30+ Premium Animation Styles [PRO]**: Access 30+ stunning animations, including Neon Glow, Liquid Metal, Gradient Waves, and Glitch effects.
*   **Advanced Unique Designs [PRO]**: High-end, eye-catching designs that elevate your website’s aesthetic instantly.

### 3. Smart Reading Time Indicator
Transparency builds trust. Letting readers know the time commitment upfront significantly reduces bounce rates.

*   **Precision WPM Algorithm**: Automatically calculates reading time based on a customizable "Words Per Minute" logic.
*   **Clean Text Layout**: Displays a simple, automated "X min read" label before your content.
*   **Dual-Positioning Display**: Display the reading time Before Content, After Content, or in Both locations simultaneously.
*   **Full Typography & Styling Suite**: Total control over font size, colors, background padding, and margins—no coding required.
*   **Custom Labels**: Fully customize your Prefix (e.g., "Ready in:") and Postfix (e.g., "minutes") text.
*   **25+ Designer Layouts [PRO]**: Access 25+ unique and advanced layouts featuring professional icons like Clocks, Books, Hourglasses, and Sand-timers.
*   **Stunning Layout Animations [PRO]**: Beautifully animated entry and hover effects for the reading time badge.

### 4. Intelligent Targeting & Performance
Uply is built for speed and control. It gives power users the tools they need without sacrificing performance.

*   **Vanilla CSS Power**: No heavy libraries (No jQuery UI or GSAP). All animations are built with optimized CSS for zero impact on Core Web Vitals.
*   **Conditional Display Logic**: Enable or disable features globally or for specific Post Types (e.g., show on Posts but hide on Pages).
*   **Precise Page Exclusion**: Use a built-in search interface to exclude specific Page IDs or posts where you don't want the tools to appear.

### Why Choose Uply?
Whether you use the feature-packed Free version or the designer-grade PRO version, Uply is engineered to improve your "Time on Site" and "Bounce Rate" — two of the most important metrics for SEO and user satisfaction.

== Installation ==

1.  Upload the plugin files to the `/wp-content/plugins/uply-scroll-to-top` directory, or install the plugin through the WordPress plugins screen directly.
2.  Activate the plugin through the 'Plugins' screen in WordPress.
3.  Use the **Uply** menu in the dashboard to configure settings.

== Frequently Asked Questions ==

= Can I hide the Scroll to Top button on mobile? =
Yes, there is a setting to toggle visibility on mobile devices.

= How is the read time calculated? =
It is based on the word count of the post content divided by the reading speed (default 200 words per minute), which you can customize.

== Screenshots ==

1.  **Dashboard**: The main welcome screen with feature cards.
2.  **Scroll to Top Settings**: Configure position and visibility.
3.  **Progress Bar Settings**: Customize color and height.
4.  **Read Time Settings**: Set WPM and labels.

== Changelog ==

= 1.0.2 =
*   Moved Enable toggle and Save Changes button into each tab's settings panel for a cleaner, more organized layout.
*   Enable/Save section is now sticky — stays visible while scrolling through settings.
*   Synced WordPress sidebar sub-menu active state with dashboard tab navigation.
*   Fixed Read Time template icon visibility in admin dashboard preview.
*   Updated Upgrade to Pro button and lock overlay styling to use consistent blue color scheme.
*   Improved top navigation tab styling — removed focus outlines for a cleaner look.
*   Minor alignment fixes for the settings panel width consistency.

= 1.0.1 =
*   Added advanced premium templates for Scroll to Top, Progress Bar, and Reading Time.
*   Introduced New Branded Custom SVG logos for better visual identity.
*   Enhanced UI/UX with modern Toast notifications replacing browser popups.
*   Improved sidebar visibility and active state icons for better navigation.
*   Optimized CSS performance and fixed minor layout bugs in the admin dashboard.

= 1.0.0 =
*   Initial release with premium dashboard UI.
*   Refactored codebase for strict WordPress compliance.
*   Enhanced security with robust nonce and permission checks.
