Title: Simple Image Widget
Author: Cedaro
Published: <strong>ستمبر 9, 2008</strong>
Last modified: جُلائی 20, 2025

---

Search plugins

![](https://ps.w.org/simple-image-widget/assets/banner-772x250.png?rev=3330956)

![](https://ps.w.org/simple-image-widget/assets/icon.svg?rev=3330956)

# Simple Image Widget

 By [Cedaro](https://profiles.wordpress.org/cedaro/)

[Download](https://downloads.wordpress.org/plugin/simple-image-widget.4.4.2.zip)

 * [Details](https://bcc.wordpress.org/plugins/simple-image-widget/#description)
 * [Reviews](https://bcc.wordpress.org/plugins/simple-image-widget/#reviews)
 *  [Installation](https://bcc.wordpress.org/plugins/simple-image-widget/#installation)
 * [Development](https://bcc.wordpress.org/plugins/simple-image-widget/#developers)

 [Support](https://wordpress.org/support/plugin/simple-image-widget/)

## 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.

### Additional Resources

 * [Write a review](https://wordpress.org/support/view/plugin-reviews/simple-image-widget#postform)
 * [Contribute on GitHub](https://github.com/cedaro/simple-image-widget)
 * [Follow @cedaroco](https://twitter.com/cedaroco)
 * [Visit Cedaro](https://www.cedaro.com/?utm_source=wordpress.org&utm_medium=link&utm_content=simple-image-widget-readme&utm_campaign=plugins)

## Screenshots

 * [[
 * A new image widget.
 * [[
 * The widget after selecting an image.

## Installation

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

## FAQ

### 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%;
    }
    ```

## Reviews

![](https://secure.gravatar.com/avatar/109851919a171ac5df460c01952fd3782b23125be70f12d8494c06192bae28b6?
s=60&d=retro&r=g)

### 󠀁[Better than WP native image](https://wordpress.org/support/topic/better-than-wp-native-image/)󠁿

 [Cyndi](https://profiles.wordpress.org/cynderella/) جُون 24, 2020

Nice to be able to choose an appropriate grid size.

![](https://secure.gravatar.com/avatar/dcded9809b7d316c7621baf81897501f785ea6469609be53fb26a4f05374f9f2?
s=60&d=retro&r=g)

### 󠀁[Customizable and simply great](https://wordpress.org/support/topic/customizable-and-simply-great/)󠁿

 [ryver](https://profiles.wordpress.org/ryver/) ستمبر 21, 2018

Thanks for creating the simple image widget, it’s great! I was able to easily customize
the template to finally display widgetized bootstrap cards the way I want.

![](https://secure.gravatar.com/avatar/5b68023318947f7d846033c0b8179f9f82b02d6d6d61ce5608d59bd016ab1541?
s=60&d=retro&r=g)

### 󠀁[Perfect image widget plugin](https://wordpress.org/support/topic/perfect-widget-plugin/)󠁿

 [John-Pierre Cornelissen](https://profiles.wordpress.org/jpnl/) جُون 9, 2017

With the native image widget that has been introduced with WP 4.8 this plugin has
become obsolete. Still, this plugin has served me very well, so 5 stars and thank
you for that!

![](https://secure.gravatar.com/avatar/b3cc07fdd6f325ffb582bc20204ab993730a35037e5907bddc55d84454b18d03?
s=60&d=retro&r=g)

### 󠀁[cool stuff – best choice for developers!](https://wordpress.org/support/topic/cool-stuff-best-choice-for-developers/)󠁿

 [usability.idealist](https://profiles.wordpress.org/usabilityidealist/) ستمبر 3,
2016 1 reply

Excellent choice for developers. Uses the native WP functions, and thus automatically
supports the new responsive image attributes (srcset / sizes) 🙂 The widget template
is awesome fun; make it work with Bootstrap 3? No problemo, boss – just add the 
template to your theme directory, adjust the wp_get_attachment_image() call, and
off you go 🙂 Similar to this: echo wp_get_attachment_image( $image_id, $image_size,
false, array( 'class' => 'img-responsive attachment-' . $image_size . ' size-' .
$image_size ) ); So, if you need flexibility and KNOW what you’re doing – go for
it! cu, w0lf.

![](https://secure.gravatar.com/avatar/c8f95766754d580eb5c9817dcc1d7c9ca5b962d3c9ca102046ae93c2ae8870b0?
s=60&d=retro&r=g)

### 󠀁[Easy to use](https://wordpress.org/support/topic/easy-to-use-959/)󠁿

 [Trek Themes](https://profiles.wordpress.org/trek-themes/) ستمبر 3, 2016

Fantastic plugin that I use on many sites

![](https://secure.gravatar.com/avatar/698131a069b7c4b8a1a7bc4de00442ad20438cdd07d7770e8461cf29550d5fe2?
s=60&d=retro&r=g)

### 󠀁[Awesome Plugin](https://wordpress.org/support/topic/awesome-plugin-1908/)󠁿

 [arnold](https://profiles.wordpress.org/liido/) ستمبر 3, 2016

Great Plugin. Very Easy to customize fantastic

 [ Read all 39 reviews ](https://wordpress.org/support/plugin/simple-image-widget/reviews/)

## Contributors & Developers

“Simple Image Widget” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Cedaro ](https://profiles.wordpress.org/cedaro/)
 *   [ Brady Vercher ](https://profiles.wordpress.org/bradyvercher/)

“Simple Image Widget” has been translated into 6 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/simple-image-widget/contributors)
for their contributions.

[Translate “Simple Image Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/simple-image-widget)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/simple-image-widget/),
check out the [SVN repository](https://plugins.svn.wordpress.org/simple-image-widget/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/simple-image-widget/)
by [RSS](https://plugins.trac.wordpress.org/log/simple-image-widget/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

### 4.4.2 – October 12, 2017

 * Changed the widget name to “Image (Simple)” to differentiate it from the core
   image widget introduced in WordPress 4.8.

### 4.4.1 – September 6, 2016

 * Added missing text domains.

### 4.4.0 – April 22, 2016

 * Enabled selective refresh in the Customizer.
 * Removed PO and MO files in favor of WordPress.org Language Packs.
 * Prevented errors if the main plugin file is accessed directly.

### 4.3.0

 * Transferred to [Cedaro](http://www.cedaro.com/).

### 4.2.2

 * Show media extensions in the post finder modal.
 * Added Dutch translation.

### 4.2.1

 * Fixed a PHP 5.2 incompatibility that prevented the correct image from showing
   on the front-end.
 * Fixed a debug notice when searching for attachments in the new find posts modal.

### 4.2.0

 * Added functionality to search for posts to link images to.
 * Added Japanese translation.
 * Changed the method for generating cache keys. Should provide better support for
   the_widget() and similar methods.
 * Deprecated the method for flushing a single widget instance from the cache.

### 4.1.2

 * Added Serbo-Croation translation.

### 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.

## Meta

 *  Version **4.4.2**
 *  Last updated **9 months ago**
 *  Active installations **10,000+**
 *  WordPress version ** 4.9 or higher **
 *  Tested up to **6.8.5**
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/simple-image-widget/), [English (US)](https://wordpress.org/plugins/simple-image-widget/),
   [Greek](https://el.wordpress.org/plugins/simple-image-widget/), [Hebrew](https://he.wordpress.org/plugins/simple-image-widget/),
   [Italian](https://it.wordpress.org/plugins/simple-image-widget/), [Japanese](https://ja.wordpress.org/plugins/simple-image-widget/),
   and [Swedish](https://sv.wordpress.org/plugins/simple-image-widget/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/simple-image-widget)
 * Tags
 * [image widget](https://bcc.wordpress.org/plugins/tags/image-widget/)[media](https://bcc.wordpress.org/plugins/tags/media/)
   [media manager](https://bcc.wordpress.org/plugins/tags/media-manager/)[sidebar](https://bcc.wordpress.org/plugins/tags/sidebar/)
   [widget](https://bcc.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://bcc.wordpress.org/plugins/simple-image-widget/advanced/)

## Ratings

 4.5 out of 5 stars.

 *  [  32 5-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=4)
 *  [  2 3-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=3)
 *  [  2 2-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/simple-image-widget/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/simple-image-widget/reviews/)

## Contributors

 *   [ Cedaro ](https://profiles.wordpress.org/cedaro/)
 *   [ Brady Vercher ](https://profiles.wordpress.org/bradyvercher/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/simple-image-widget/)