This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP Smart Image


WP Smart Image is deprecated. Please change to WP Smart Image II

What is Wp Smart Image?

WP Smart Image is the tool that combines the best image managment functionalities in WordPress and handles them to facilitate it’s use.

If you are used to personalized fileds to assign images to posts, with WP Smart Image will forget all the extra work and will enjoy the real process automation that has been in WordPress all this time and probably you never knew existed.

But what’s the problem with WordPress native image engine?

No problem. The WordPress image engine is one of the most advanced and flexible ones at the moment. WordPress offers a wide range of functionalities and tags, which allows for and easy handling of images and files, associating them with posts, categories, pages and other elements with total freedom.

However, the problem with all these funcionalities is that finding the propper way to associate data and get a specific result can get really hard. In an attempt to do that, many people have tried to do it by setting through custom fields, ignoring that WordPress has a large platform with many resources at our disposal to do that.

What isn’t Wp Smart Image?

It is not a filter that works inside the content. WP Smart Image only works in the template areas and it’s use is focused to the template’s file system.

It is not a plugin that changes other functionalities behaviour. It’s a resource that lets you take advantage of the already existing functionalities provided by WordPress.

Enjoy designing!


  • French (fr_FR) – Valentin
  • Russian (ru_RU) – Fat Cow
  • Spanish (es_ES) – Dario Ferrer

If you have been translated this plugin into your language, please let me know.


  • WP Smart Image - Settings
  • WP Smart Image - New Parameters tab.
  • Where to place the tag
  • New editor widget. Here you can choose easily the image to show.


  1. Upload wp-smart-image folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Place <?php wp_smart_image(); ?> in your template
  4. You can add further customization throught Settings > WP Smart Image Menu


  1. If you wish to remove the plugin completely, press button called “Remove data” to clean the WordPress Smart Image DB table
  2. Deactivate the plugin through the ‘Plugins’ menu in WordPress.


WP Smart Image works with custom fields?

No. Using custom fields to show associated images is a wrong method. Yes, it is relatively famous, but is wrong. WordPress has a very advanced ways to control post’s images. However, saying is not the same than do it, because many times it is some difficult to achieve tha we want in this area. WP Smart Images simply makes this work a quite more easy to you.

WP Smart Image adds many data in my DB?

Noup. This plugins uses all existing post data you have been entered through WordPress Editor. Only creates a little field in options table to save your settings.

How can I settings my images to be shown?
  • Upload the images through your edition panel (required for database file association).
  • In the Gallery section drag the image you want to show to the first position, then it will be shown, even if you don’t use it in the content.
  • That’s it.
Hey, I can’t see the widget in my editor!

Just activate the checkbox for option “Activate editor box” through Settings page. Save your settings.

This new widget disables my previous settings?

Absolutely not. Your old settings remains intacts.

Can I customize the tag for better control of my layout?

Yes. Please read the first step guide of WP Smart Image

Where I must to place the tag?

You should place the tag into the loop (see screenshot #3 for a graphic example)

I can place the parameters in an unordered way?

Yes, you can combine parameters without an specific order. Logically some parameters may not appear depending of your settings. For example, a “rel” attribute will not shown in an unlinked image, because “rel” is a property of links. In cases like this, if you set wrong parameters the plugin simply ignore them and works anyway.

All parameters are right to all situations?

You must to read the parameter’s table to setting your combo correctly. If you have a Stric DTD site and if you activate a “target _blank”, of course you’ll ruin your standard. If you add a fixed ID’s to several images or links, you are proceeding in a wrong way.

Otherwise, if you are trying to implement some javascript/ajax toy defining “rel” or “id” parameters , you are in a good way to achieve what you want, depending of your intentions.

Can I find direct support about WP Smart Image?

Sure. You can find direct support at: English users | Spanish users

… and of course starting a new topic in forum.

“Dario, you forgot to add certain function…”

Please let me know you’re thinking through any of ways above. Thank you!.

“I’m a programming guru and I think you can modify this string in this way…”

All your suggestions are welcome. Thank you!.

Contributors & Developers

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

Translate “WP Smart Image” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Bugfix: Orphan images are shown in widget editor on new posts.


  • Added option to show random images instead of only one.
  • Image widget is now available on Page editor.


  • Fixed minor bug: widget appears even if option is unchecked.


  • Added graphic interface for control images directly from article editor.
  • Minor bugfixes.


  • Added option for integrate Max Image Size Control plugin.
  • Minor optimizations.


  • Added option to include thumbnails in RSS feeds.
  • Added new parameter mode to prepare function wp_smart_image($mode='args') to be passed by PHP parameters.
  • Bugfix: Custom parameter $target ='framename' was changed to new one $targetname = 'framename' because old setting caused bad html parsing.


  • Code optimization.
  • Added french translation fr_FR (thanks Valentin!)


  • General improvements.
  • Added “width / height” image parameter.
  • Added “rel” parameter to linked images.
  • Added “target” parameter to linked images.
  • Added “class / id” parameters to links (in addition to image class / id).
  • Code optimization.
  • Added reference table within the parameters tab (plugin Settings page).


  • Some code optimization.
  • Added russian translation ru_RU (thanks Fat Cow!).


  • First public release