# [Custom Scrollbar](http://wordpress.org/plugins/custom-scrollbar/) #

### Welcome to our GitHub Repository

Custom Scrollbar is an open source WordPress plugin that lets you add custom scrollbars to specified HTML elements.

<p align="center">
    <img src="https://lh3.googleusercontent.com/-ifoBNxO0fBQ/VY2ZiH-3mYI/AAAAAAAACBM/nh9CawjMYSo/s0/screenshot.png" alt="Custom Scrollbar" />
</p>

## Screenshots ##

<div style="margin:20px; float:left">
	<a href="https://lh3.googleusercontent.com/-LmnXX-qM8SQ/VY2ZiMIVAGI/AAAAAAAACBM/wqJx5Ce1qsw/s0/screenshot-2.png" title="Custom Scrollbar - Settings">
		<img src="https://lh3.googleusercontent.com/-LmnXX-qM8SQ/VY2ZiMIVAGI/AAAAAAAACBM/wqJx5Ce1qsw/s320/screenshot-2.png" alt="Custom Scrollbar - Settings" width="320" />
	</a>
	&nbsp;
</div>

## Installation ##

- The latest development version can be found [here](https://github.com/michaeluno/custom-scrollbar/branches). 
- The latest stable version can be downloaded [here](http://downloads.wordpress.org/plugin/custom-scrollbar.latest-stable.zip).

1. Upload **`custom-scrollbar.php`** and other files compressed in the zip folder to the **`/wp-content/plugins/`** directory.,
2. Activate the plugin through the `Plugins` menu in WordPress.

## How to Use ##

1. Upload **`custom-scrollbar.php`** and other files compressed in the zip folder to the **`/wp-content/plugins/`** directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Dashboard** -> **Appearance** -> **Scrollbars**.
4. Configure the options by setting a selector and height.

## Bugs ##
If you find an issue, let us know [here](https://github.com/michaeluno/custom-scrollbar/issues)!

## Support ##
This is a developer's portal for Custom Scrollbar and should _not_ be used for support. Please visit the [support forums](http://wordpress.org/support/plugin/custom-scrollbar).

## Contributions ##
Anyone is welcome to contribute to Custom Scrollbar.

There are various ways you can contribute:

1. Raise an [Issue](https://github.com/michaeluno/custom-scrollbar/issues) on GitHub.
2. Send us a Pull Request with your bug fixes and/or new features.
3. Provide feedback and suggestions on [enhancements](https://github.com/michaeluno/custom-scrollbar/issues?direction=desc&labels=Enhancement&page=1&sort=created&state=open).

## Supporting Future Development ##

If you like it, please rate and review it in the [WordPress Plugin Directory](http://wordpress.org/support/view/plugin-reviews/custom-scrollbar?filter=5). Also donation would be greatly appreciated. Thank you!

[![Donate with PayPal](https://www.paypal.com/en_US/i/btn/x-click-but04.gif)](http://en.michaeluno.jp/donate) 

## Copyright and License ##

### Custom Scrollbar ###
Released under the [GPL v2](./LICENSE.txt) or later.
Copyright © 2015-2016 Michael Uno

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.