=== Simple Image Widget ===
Contributors: blazersix, bradyvercher
Tags: image widget, widget, media, media manager, sidebar, image, photo, picture
Requires at least: 3.5
Tested up to: 4.0
Stable tag: trunk
License: GPL-2.0+
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A simple widget that makes it a breeze to add images to your sidebars.

== Description ==

Simple Image Widget is what the name implies -- the easiest way to add images to your sidebars. Display advertisements, calls-to-action, or even build a slider based on image widgets.

Despite its simplicity, Simple Image Widget is built with extensibility in mind, making it super easy to spin off new image-based widgets, or customize the widget ouput using the available template hierarchy.

Blazer Six took over development and maintenance of Simple Image Widget with version 3.0, rewriting it from the ground up to take advantage of the media improvements in WordPress 3.5. Read about the original thought behind creating the plugin and ways it can be extended in [Building a Better Image Widget with the New WordPress Media Manager](http://www.blazersix.com/blog/wordpress-image-widget/).

= Additional Resources =

* [Write a review](http://wordpress.org/support/view/plugin-reviews/simple-image-widget#postform)
* [Have a question?](http://wordpress.org/support/plugin/simple-image-widget)
* [Contribute on GitHub](https://github.com/blazersix/simple-image-widget)
* [Follow @bradyvercher](https://twitter.com/bradyvercher)
* [Hire Blazer Six](http://www.blazersix.com/)

= Translation Credits =

* Finnish (fi) - Tomi Mäenpää [v4.1.1]
* French (fr_FR) - Alexandre Sadowski [v4.0.1]

== Installation ==

Install just like most other plugins. [Check out the codex](http://codex.wordpress.org/Managing_Plugins#Installing_Plugins) if you have any questions.

== Frequently Asked Questions ==

= Is there a way to filter the widget output? =

Absolutely. Changing the output can be done a few different ways, but the most common alternatives involve using the "`simple_image_widget_output`" filter or overriding the template in your theme.

To use the template method, copy "`widget.php`" from the "`/templates`" directory in the plugin to a "`/simple-image-widget`" directory in your theme. Then update as you wish. It's also possible to create a custom template specific to each sidebar in your theme using the following default template hierarchy:

* `{theme}/simple-image-widget/{sidebar_id}_widget.php`
* `{theme}/simple-image-widget/widget.php`
* `{plugin}/templates/widget.php`

_Always use a [child theme](https://codex.wordpress.org/Child_Themes) to make changes if you acquired your theme from a third-party and you expect it to be updated. Otherwise, you run the risk of losing your customizations._

= How do I add alt text to images in the widget? =

When selecting an image in the media modal (the popup to select images), the right sidebar will be titled "Attachment Details" and contains a field for entering alt text. After entering your alt text, click the "Update Image" button to use the selected image in your widget. Most browsers don't show the alt text, so you'll need to view the HTML source to make sure it exists.

= How do I center the widget? =

The widget can be centered using CSS. Custom CSS should be added a child theme or using a plugin like [Simple Custom CSS](https://wordpress.org/plugins/simple-custom-css/) or [Jetpack](https://wordpress.org/plugins/jetpack/). The following snippet will center the contents of the widget:

`.widget_simpleimage {
     text-align: center;
}`

= Can I remove the width and height attributes? =

The widget uses the core function `wp_get_attachment_image()` to display the image and it would be more trouble than it's worth to remove those attributes. Some basic CSS will typically allow you to make the image responsive if necessary:

`.widget_simpleimage img {
	height: auto;
	max-width: 100%;
}`

== Screenshots ==

1. A new image widget.
2. The widget after selecting an image.

== Changelog ==

= 4.1.1 =
* Added Finnish translation.
* Prevent a notice about non-existent title when adding a widget in the Customizer in debug mode.

= 4.1.0 =
* Added the ability to hide widget fields.
* Added a field to insert HTML classes on the text link. Hidden by default.
* Removed "the_content" filter from widget text to prevent other plugins from appending content.
* Renamed /scripts to /js and /styles to /css.
* Improved handling of fields that have been removed in child widgets.

= 4.0.2 =
* Fixed the reference to the widget's parent class to prevent an error.

= 4.0.1 =
* Allow more HTML tags in the text field.
* Updated customizer support and prevent cache poisoning.
* Added French translation.

= 4.0.0 =
* New template system to make it easier to override the output.
* Restructured to make it more intuitive for developers to extend the widget.
* Moved legacy support into a separate class that hooks into the widget.
* Works with the Widget Customizer added in WordPress 3.9.
* Improved compatibility with plugins like Page Builder by SiteOrigin.

= 3.0.4 =
* Fixed a slash preventing custom translations from loading.
* Dropped the text domain from custom translation filenames.
* Loading the text domain earlier so the widget title and description can be filtered.
* Minor code formatting updates.

= 3.0.3 =
* Fixed PHP class name formatting.
* Added 'link_open' and 'link_close' args to the $instance when rendering the widget display.
* Added a 'simple-image' CSS class to the image wrapper.

= 3.0.2 =
* Implemented feature for opening links in a new tab/window.
* Fixed a bug preventing links in legacy widgets to not work.

= 3.0.1 =
* Removed the main plugin file for the previous version.

= 3.0 =
* Complete rewrite with new media manager support.
