WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Image Widget

A simple image widget that uses the native WordPress media manager to add image widgets to your site.

Documentation

The built in template can be overridden by files within your template.

Default vs. Custom Templates

The Image Widget comes with a default template for the widget output. If you would like to alter the widget display code, create a new folder called "image-widget" in your template directory and copy over the "views/widget.php" file.

Edit the new file to your hearts content. Please do not edit the one in the plugin folder as that will cause conflicts when you update the plugin to the latest release.

New in 3.2: You may now also use the "sp_template_image-widget_widget.php" filter to override the default template behavior for .php template files. Eg: if you wanted widget.php to reside in a folder called my-custom-templates/ and wanted it to be called my-custom-name.php:

add_filter('sp_template_image-widget_widget.php', 'my_template_filter');
function my_template_filter($template) {
    return get_template_directory() . '/my-custom-templates/my-custom-name.php';
}

Filters

There are a number of filters in the code that will allow you to override data as you see fit. The best way to learn what filters are available is always by simply searching the code for 'apply_filters'. But all the same, here are a few of the more essential filters:

widget_title

This is actually a pretty typical filter in widgets and is applied to the widget title.

widget_text

Another very typical widget filter that is applied to the description body text. This filter also takes 2 additional arguments for $args and $instance so that you can learn more about the specific widget instance in the process of filtering the content.

image_widget_image_attachment_id

Filters the attachment id of the image. Accepts additional $args and $instance arguments.

image_widget_image_url

Filters the url of the image displayed in the widget. Accepts additional $args and $instance arguments. THIS IS DEPRECATED AND WILL EVENTUALLY BE DELETED

image_widget_image_width

Filters the display width of the image. Accepts additional $args and $instance arguments.

image_widget_image_height

Filters the display height of the image. Accepts additional $args and $instance arguments.

image_widget_image_maxwidth

Filters the inline max-width style of the image. Hint: override this to use this in responsive designs :) Accepts additional $args and $instance arguments. Return null to remove this css from the image output (defaults to '100%').

image_widget_image_maxheight

Filters the inline max-height style of the image. Accepts additional $args and $instance arguments. Return null to remove this css from the image output (defaults to null)

image_widget_image_size

Filters the selected image 'size' corresponding to WordPress registered sizes. If this is set to 'tribe_image_widget_custom' then the width and height are used instead. Accepts additional $args and $instance arguments.

image_widget_image_align

Filters the display alignment of the image. Accepts additional $args and $instance arguments.

image_widget_image_alt

Filters the alt text of the image. Accepts additional $args and $instance arguments.

image_widget_image_link

Filters the url that the image links to. Accepts additional $args and $instance arguments.

image_widget_image_link_target

Filters the link target of the image link. Accepts additional $args and $instance arguments.

image_widget_image_attributes

Filters a list of image attributes used in the image output. Similar to 'wp_get_attachment_image_attributes' Accepts $instance arguments

image_widget_link_attributes

Filters a list of attributes used in the image link. Similar to 'wp_get_attachment_image_attributes' Accepts $instance arguments

Have You Supported the Image Widget?

If so, then THANK YOU! Also, feel free to add this line to your wp-config.php file to prevent the image widget from displaying a message after upgrades.

define( 'I_HAVE_SUPPORTED_THE_IMAGE_WIDGET', true );

For more info on the philosophy here, check out our blog post: http://tri.be/define-i-have-donated-true/

Requires: 3.5 or higher
Compatible up to: 3.9.2
Last Updated: 2014-5-5
Downloads: 1,219,339

Ratings

4 stars
4.8 out of 5 stars

Support

0 of 9 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

1 person says it works.
0 people say it's broken.

0,1,0 100,1,1
0,1,0 100,2,2
80,5,4
100,1,1 33,3,1 100,3,3
100,5,5 100,2,2 56,9,5
33,3,1 73,11,8 100,1,1
17,6,1 63,8,5 100,2,2
80,5,4 86,7,6 71,7,5
100,1,1
100,1,1 100,4,4
100,1,1
100,2,2 100,1,1 67,3,2 100,1,1
67,3,2
100,2,2
0,1,0 100,1,1
33,3,1
0,2,0 0,1,0 78,23,18 100,1,1 100,1,1
50,4,2 75,4,3 67,3,2 100,1,1
83,6,5 100,4,4 100,6,6 78,9,7 67,6,4 75,4,3
100,2,2 75,12,9
86,7,6
86,14,12 100,3,3 100,2,2 100,5,5
86,14,12
100,5,5 100,2,2 100,4,4 100,2,2 100,2,2 100,2,2 100,1,1 100,1,1 100,1,1
67,3,2 80,5,4 100,4,4 100,6,6 100,6,6 100,10,10 94,18,17 100,1,1
50,2,1 100,3,3
80,5,4
100,4,4
100,1,1
100,2,2
100,4,4
93,14,13
100,2,2 67,3,2 100,9,9
86,7,6
100,1,1