# Easy Banners Widget

Easily build call-to-action banners for your sidebars.

The Easy Banners Widget is an easy-to-use widget that allows you to configure and display call-to-action bannerss in your site's sidebars.

_Preview your color selections before saving._

## Features

* Configurable widget title.
* Easily select banner color using built-in color picker.
* Include `html` in your banners message.
* Easily select text color using built-in color picker.
* Preview your color selections before saving!
* Easily link banners to any url.
* Choose the default (basic) CSS styling or roll your own.

## Developer Features

This widget was built not only with end-users in mind, but also plugin developers.  Almost every aspect of this widget is extensible through filters and action hooks.  You can even add your own form fields to the widget form!

* Need to remove a field from the widget form?  Not a problem!  Every field is passed through its own filter for easy customization.
* Need to modify the output of the widget?  Easy!  The output is passed through numerous filters, allowing you to customize the post list to meet your project's requirements.
* For a full list of action hooks and filters, please see the plugin documentation: http://darrinb.com/plugins/easy-banners-widget


## Installation

### From the WordPress.org plugin repository:

* Download and install using the built in WordPress plugin installer.
* Activate in the "Plugins" area of your admin by clicking the "Activate" link.
* No further setup or configuration is necessary.
* Head on over to the Widgets screen or the Customizer to start building your lists!

### From GitHub:

* Download the [latest stable version](https://github.com/dboutote/Easy-Banners-Widget/archive/master.zip).
* Extract the zip folder to your plugins directory.
* Activate in the "Plugins" area of your admin by clicking the "Activate" link.
* No further setup or configuration is necessary.

## FAQ

#### Where can I find additional additional documentation?

The plugin's official page: http://darrinb.com/plugins/easy-banners-widget

#### Can I contribute?

Of course! Have an idea for a feature?  Reach out on the plugin's official page.  Want to dive into  the code?  Jump right in!  Feel free to submit pull requests for new ideas & enhancements!