=== Advanced Scrollbar – Custom Scrollbar Styling and Behavior ===
Contributors: bplugins, abuhayat, charlescormier, muradwahid, freemius
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: Color Scrollbar, custom scroll, nice scrollbar, scrollbar, cursor effect
Requires at least: 6.5
Tested up to: 6.9
Stable tag: 1.1.12
Requires PHP: 7.1
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Advanced Scrollbar lets you add a scrollbar with customizable color, width, background, and speed for a sleek, branded user experience.


== Description ==

**Intuitively design scrollbar color, width, and behavior with a lightweight - No Code Required**


[Advanced Scrollbar](https://bplugins.com/products/advanced-scrollbar/) | [Pricing](https://bplugins.com/products/advanced-scrollbar/#pricing) | [Support](https://bplugins.com/support/) | [Demo](https://scrollbar.bplugins.com/)

https://www.youtube.com/watch?v=xuAVOi80HE8

[Advanced Scrollbar](https://bplugins.com/products/advanced-scrollbar/) is a lightweight WordPress plugin that lets you easily add and customize scrollbars to fit your site’s style. Customize scrollbar color, width, background, speed, and alignment—no coding required. Fully compatible with all major browsers and WordPress themes, it’s the fast way to give your site a polished, user-friendly scrolling experience.

Whether you prefer subtle styling tweaks or vibrant animated effects, Advanced Scrollbar helps you enhance navigation and match your design—especially useful for content-heavy pages with long scroll areas.


=== Key Features – Free Version ===
- **Scrollbar Appearance**: Customize thumb color, rail background, width, border, and rounded corners.
- **Visibility Controls**: Show or hide the scrollbar when not in use.
- **Scroll Behavior**: Adjust scroll speed, smoothness, and mouse scroll step.
- **Alignment Options**: Place the scrollbar on the left or right.
- **Touch-Friendly**: Enable optimized scrolling for touch devices.
- **Lightweight & Universal**: Ad-free, powered by jQuery, works across browsers and themes.

=== Cursor & Click Effects: Free Styles ===
- **Cursor Shapes**: Follow, Dot, Blob, Elastic.
- **Click Effects**: Spark, Spark Simple, Starburst.


=== Advanced Scrollbar Pro – Unlock Premium Features ===
The [Pro version](https://bplugins.com/products/advanced-scrollbar/#pricing) adds advanced design options, premium effects, and enhanced controls to give your scrollbar a unique look and feel.

== What’s New in the Pro Version? ==
- **Dynamic Full-Height Scrollbars**: Ideal for long pages.
- **Gradient & Floating Designs**: Apply modern gradient colors or floating scrollbars.
- **Premium Cursor Shapes**: Glitch Matrix, Neon, Gradient, Magnetic, Ribbon, Spotlight, and more.
- **Premium Click Effects**: Ripples, Pulses, Waves, Explosions, and other animations.
- **Custom Floating Scrollbar Colors**: Set background and text colors for floating scrollbars.

[Upgrade to Pro](https://bplugins.com/products/advanced-scrollbar/#pricing) and unlock all premium features today!


=== Flexible Application Modes ===
- **Global Mode**: Apply chosen styles site-wide from the plugin dashboard.
- **Page/Post Specific Mode**: Apply unique effects directly in the WordPress editor—great for campaigns or featured content.


=== How to Use Advanced Scrollbar – Quick Start Guide ===
Getting started is easy!

1. Install and activate the plugin.
2. Go to **Settings → Advanced Scrollbar**.
3. Customize scrollbar and cursor styles in the settings panel.
4. Save changes and enjoy your new scrolling experience.


=== Use Cases ===
- Enhance user experience on content-heavy pages.
- Strengthen brand consistency with customizable UI.
- Optimize navigation flow on long-form content or sites with dynamic layout.

[Live Demo](https://scrollbar.bplugins.com/) |  [Try the Pro Version](https://bplugins.com/products/advanced-scrollbar/#pricing)


= Feedback = 
Like that plugin? Hate it? Want a new feature?  [Send your feedback](https://bPlugins.com/support "Send feedback")  


### Check out our other WordPress Plugins-

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**Html5 Audio Player**](https://bplugins.com/products/html5-audio-player/) – Listen audios with awesome visuals.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) – Embed 3D models and 3D products with interaction.

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) – Show posts and custom posts in different layouts.


== Installation ==

### Automatic installation
1. Go to the Plugin menu and click on the **Add New** Button
2. Search for **Advanced Scrollbar**
3. Install and activate the Advanced Scrollbar plugin from there

### Download & Upload:
1. Download the **Advanced Scrollbar** plugin (*.zip file*)
2. In your admin area, go to the Plugins menu and click on **Add New**
3. Click on **Upload Plugin** and choose the **`advanced-scrollbar.zip`** file and click on **Install Now**
4. Activate the plugin and Enjoy!

### Manually:
1. Download and upload the **Advanced Scrollbar** plugin to the **`/wp-content/plugins/`** directory
2. Activate the plugin through the Plugins menu in WordPress



== Frequently Asked Questions ==

= How do I install this plugin? =

You can install it as another regular wordpress plugin. No different way. Please see on installation tab.

= Does the plugin contain an ad? =

No, The plugin is adless and totally free of cost.

= Can I change the Scrollbar Rail Position from left to right? =

Yes, You can do that. 

== Screenshots ==

1. Scrollbar Settings
2. Cursor and Click Effects
3. Popular Plugins


== Changelog ==

= 1.1.12 - 11 May, 2026 =
* Fixed: Removed GSAP library and replaced with raw JavaScript for GPL compliance
* Fixed: Standardized all internal prefixes from csb/CSB to casb/CASB
* Fixed: Removed all premium/trialware feature gating 
* Fixed: Added Font Awesome Free 6.4.2 third-party library disclosure in readme
* Fixed: Updated jQuery nicescroll third-party library documentation in readme
* Fixed: Added source code repository link in readme

= 1.1.11 - 7 May, 2026 =
* Fixed: Removed premium feature gating to comply with WordPress.org Guideline 5 (Trialware)
* Fixed: Added public source repository link in readme for compiled/minified build files
* Fixed: Replaced GSAP library with a GPL-compatible alternative to comply with WordPress.org licensing requirements
* Fixed: Added Freemius external service disclosure in readme

= 1.1.9 - 9 Oct, 2025 =
* Fixed scroll behavior

= 1.1.8 - 23 Sep, 2025 =
* Fixed emulate touch issue

= 1.1.6 - 10 Sep, 2025 =
* Added Cursor shape and click effects
* Added Modern dashboard

= 1.1.4 - 28 Jan, 2025 =
* Update freemius sdk

= 1.2 =
* Update Settings
* Optimized

= 1.1 =
* Removed The admin menu from the dashboard.

= 1.0 =
* Initial Release


== Source Code ==

You can find the source code, report bugs, and contribute to the development of this plugin on our GitHub repository:
[**Advanced Scrollbar on GitHub**](https://github.com/bPlugins/advanced-scrollbar)

== This plugin bundles the following third-party JavaScript/PHP libraries. ==

= jQuery nicescroll v3.7.6 =
* **File:** `assets/js/jquery.nicescroll.min.js`
* **Source:** https://github.com/inuyaksa/jquery.nicescroll
* **GitHub:** https://github.com/inuyaksa/jquery.nicescroll
* **License:** MIT – [https://github.com/inuyaksa/jquery.nicescroll/blob/master/MIT.LICENSE](https://github.com/inuyaksa/jquery.nicescroll/blob/master/MIT.LICENSE)
* **Purpose:** Enhances scrollable areas with smooth scrolling, momentum effects, and customizable stylish scrollbars for a more modern and user-friendly interface experience.

= Font Awesome Free v6.4.2 =
* **File:** `src/settings/assets/css/font-awesome.min.css`
* **Source:** [https://fontawesome.com/](https://fontawesome.com/)
* **GitHub:** [https://github.com/FortAwesome/Font-Awesome](https://github.com/FortAwesome/Font-Awesome)
* **License:** Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT – [https://fontawesome.com/license/free](https://fontawesome.com/license/free)
* **Purpose:** Provides scalable vector icons used in the plugin's admin settings interface for improved UI clarity and visual consistency.

= Freemius SDK =

* **Source:** [https://freemius.com/](https://freemius.com/)
* **GitHub:** [https://github.com/Freemius/wordpress-sdk](https://github.com/Freemius/wordpress-sdk)
* **License:** GPLv3 – [https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt](https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt)
* **Purpose:** Provides opt-in usage tracking and analytics to help improve the plugin.


= This plugin connects to the following external services from the admin dashboard: =

= bPlugins API =

* **Service URL:** [https://api.bplugins.com](https://api.bplugins.com)
* **Purpose:** The plugin's admin dashboard fetches product comparison data and pricing information to display relevant upgrade options and feature details.
* **Data Sent:** Only the plugin slug is transmitted; no personal or site data is collected.
* **Terms of Service:** [https://bplugins.com/terms-of-service/](https://bplugins.com/terms-of-service/)
* **Privacy Policy:** [https://bplugins.com/privacy-policy/](https://bplugins.com/privacy-policy/)

= WordPress.org Plugins API =

* **Service URL:** [https://api.wordpress.org/plugins/info/1.2/](https://api.wordpress.org/plugins/info/1.2/)
* **Purpose:** The admin dashboard queries the official WordPress.org Plugins API to retrieve and display a curated list of other plugins by the same author ("Our Plugins" section).
* **Data Sent:** Plugin slugs and author name; no personal or site data is collected.
* **Terms of Service:** [https://wordpress.org/about/tos/](https://wordpress.org/about/tos/)
* **Privacy Policy:** [https://wordpress.org/about/privacy/](https://wordpress.org/about/privacy/)

= bpl-tools =
* Source / GitHub: https://github.com/bPlugins/bpl-tools
* License: GPL-2.0-or-later – https://www.gnu.org/licenses/gpl-2.0.html
* Purpose: Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* External Services: The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: https://github.com/bPlugins/bpl-tools#external-requests--why-they-are-made