Title: Image Shortcake Author: Daniel Bachhuber Published: May 20, 2015 Last modified: August 27, 2015 --- Search plugins 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. ![](https://s.w.org/plugins/geopattern-icon/image-shortcake.svg) # Image Shortcake By [Daniel Bachhuber](https://profiles.wordpress.org/danielbachhuber/) [Download](https://downloads.wordpress.org/plugin/image-shortcake.0.1.0.zip) * [Details](https://test.wordpress.org/plugins/image-shortcake/#description) * [Reviews](https://test.wordpress.org/plugins/image-shortcake/#reviews) * [Installation](https://test.wordpress.org/plugins/image-shortcake/#installation) * [Development](https://test.wordpress.org/plugins/image-shortcake/#developers) [Support](https://wordpress.org/support/plugin/image-shortcake/) ## Description When images are inserted into posts from the media library or media uploader, only the html of the `` tag and the link around it (if any) are preserved. This means that themes which want to change the way images are marked up in content don’t have an easy way of doing this. Image Shortcake is an attempt to solve this problem, by saving images in post content as _shortcodes_ rather than HTML. The output of shortcodes can be easily filtered in themes, plugins and templates, and since the original attachment data is preseved as attributes on the shortcode, it becomes much easier for modify the way images are marked up in themes. For best results, use this with the [Shortcake (Shortcode UI)](https://github.com/fusioneng/Shortcake) plugin. Shortcake offers an easy to use interface to manage shortcodes in post content. What could you use this for? Well, at [Fusion](http://fusion.net) we use this shortcode for: * **Responsive Images**. By filtering the output of the `[img]` shortcode image tag, we’re able to insert the `srcset` attribute, so that all of the images on our site are served responsively to browsers that support that. * **Inline sharing buttons**. We’ve added share links to each of the images on our site. Because these are inserted through a filter on a shortcode and not in the post content, it’s easy to modify them on the fly. And having this logic in template files rather in on-page javascript that runs after page load makes it quicker for users. * **Photo credits**. We’ve added “credit” as an image meta field, and we use a filter on ‘img_shortcode_output_after_linkify’ to display it on all images. See the [Installation](https://test.wordpress.org/plugins/image-shortcake/?output_format=md#Installation) section for more ideas and tips for custom image templates. [Get involved with the project](https://github.com/fusioneng/image-shortcake) on Github. ## Screenshots * [[ * This is the shortcode UI form as accessed from **Insert Media > Insert Post Element**.( Note that you can also insert images as usual, by inserting them in the Media Library – they will be transparently converted into shortcodes behind the scenes for you.) * [[ * Once inserted into a post, the image preview renders in the editor just as it normally would. The Shortcake plugin’s edit/delete buttons are available to modify the shortcode through the provided UI. ## Installation #### Customizing Output The whole point of using shortcodes rather than HTML tags for images is that you can customize the markup of images in your theme. This plugin offers three primary hooks to modify the output: * `img_shortcode_output_img_tag`: Filters the output of the tag before wrapping it in link or caption * `img_shortcode_output_after_linkify`: Filters the output of the tag after wrapping in link * `img_shortcode_output_after_captionify`: Filters the output of the tag after wrapping in link and attaching caption You can, of course, disregard the markup generated by this plugin altogether and use a template part for images if you want. This example adds EXIF data below all images containing those fields, in all post content: in the theme’s `functions.php`: ``` ` add_filter( 'img_shortcode_output_img_tag', 'load_image_template', 10, 2 ); function load_image_template( $_, $attributes ) { ob_start(); get_template_part( 'inline-image' ); return ob_get_clean(); } ` ``` in a template file called `inline-image.php`: ``` ` "$class $align attachment-$size", 'alt' => $alt, ) ); if ( is_array( $exif_data ) ) { echo ''; } ` ``` #### Data Migration The plugin comes with two [WP-CLI](http://wp-cli.org) commands to migrate images in your existing content into the `[img]` shortcode format used by this plugin. _Note: if it isn’t clear, this is an early release — use at your own risk, and make sure you’ve backed up your posts before migrating!_ ``` wp image-shortcake migrate [--dry-run] ``` This command searches the post content of the posts specified in ``, and replaces any `` tags or `[caption]` shortcodes with `[img]` shortcodes. Currently it only catches images added through the media library; custom img tags will not be converted. If you add the `--dry-run` flag, no replacements will actually be performed, just a summary report of the changes which would have been made. ``` wp image-shortcake revert [--dry-run] ``` This command finds all `[img]` shortcodes in the content of any of the posts specified in ``, and replaces them with the markup that would be generated by those shortcodes. Note that this runs any filters in your theme, so that if you have filtered the output of the shortcodes at any output, those filters will be reflected in the coverted post content. ## Reviews ![](https://secure.gravatar.com/avatar/76608d69915353f11913a82565deb771520c7857362c91ca3a399f9b4e4c76e4? s=60&d=retro&r=g) ### 󠀁[Works terrifically!](https://wordpress.org/support/topic/works-terrifically/)󠁿 [Christina](https://profiles.wordpress.org/carasmo/) November 18, 2017 Works great with ShortCake. Love the filters! Please update this code so it doesn’t scare people away. Thanks! [ Read all 1 review ](https://wordpress.org/support/plugin/image-shortcake/reviews/) ## Contributors & Developers “Image Shortcake” is open source software. The following people have contributed to this plugin. Contributors * [ Daniel Bachhuber ](https://profiles.wordpress.org/danielbachhuber/) * [ fusionengineering ](https://profiles.wordpress.org/fusionengineering/) * [ goldenapples ](https://profiles.wordpress.org/goldenapples/) [Translate “Image Shortcake” into your language.](https://translate.wordpress.org/projects/wp-plugins/image-shortcake) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/image-shortcake/), check out the [SVN repository](https://plugins.svn.wordpress.org/image-shortcake/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/image-shortcake/) by [RSS](https://plugins.trac.wordpress.org/log/image-shortcake/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.1.0 (May 1, 2015) * Initial release ## Meta * Version **0.1.0** * Last updated **11 years ago** * Active installations **10+** * WordPress version ** 3.0.1 or higher ** * Tested up to **4.3.34** * Language * [English (US)](https://wordpress.org/plugins/image-shortcake/) * Tags * [images](https://test.wordpress.org/plugins/tags/images/)[shortcodes](https://test.wordpress.org/plugins/tags/shortcodes/) * [Advanced View](https://test.wordpress.org/plugins/image-shortcake/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/image-shortcake/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/image-shortcake/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/image-shortcake/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/image-shortcake/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/image-shortcake/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/image-shortcake/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/image-shortcake/reviews/) ## Contributors * [ Daniel Bachhuber ](https://profiles.wordpress.org/danielbachhuber/) * [ fusionengineering ](https://profiles.wordpress.org/fusionengineering/) * [ goldenapples ](https://profiles.wordpress.org/goldenapples/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/image-shortcake/)