Attach images to posts (independent of post content) and control post images display.
Author: | Cyril Tata (profile at wordpress.org) |
WordPress version required: | 3.5 |
WordPress version tested: | 3.8.1 |
Plugin version: | 1.0.1 |
Added to WordPress repository: | 09-03-2014 |
Last updated: | 09-03-2014
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 0 |
Rated by: | 0 |
Plugin URI: | http://cyriltata.blogspot.com/2014/03/wordpre... |
Total downloads: | 2 809 |
Active installs: | 100+ |
Click to start download |
Unlike the traditional way of attaching images (or attachments) to posts by inserting them in the post content, this plugin allows you to attach images to posts in a manner that lets you control the way the images are later displayed in your theme.
It adds a metabox to the edit screen that lets you select/upload images (similar to the "Featured Image" metabox).
The images attached to a post can then later be gotten by the following means:
- If you are in a WordPress loop then you can use the tag
twp_the_post_images($size)
. $size (string|array) is an optional parameter (defaults to 'thumbnail') and can take values similar to the wp_get_attachment_image_src function.
This will return an array of objects where each object contains information about an image.
- You can directly call the plugin function
twp_get_post_images($post_id, $size)
.
$post_id (int): required - the ID of the post.
$size (string|array): is an optional parameter (defaults to 'thumbnail') and can take values similar to the wp_get_attachment_image_src function.
This will return an array of objects where each object contains information about an image.
- If you want to display the images directly as an unordered list, then you can use the shortcode
[twp_post_images id=post_id size=some_size]
. The parameters of this shortcode are same as those of the above functions. You will need some CSS knowledge to style the returned unordered list properly.
The functions twp_the_post_images()
and twp_get_post_images()
return an empty array if no images were found or an array of objects where each object has the following attributes:
- id: the attachment id
- width: The width of the image
- height: The height of the image
- orientation: The orientation of the image (landscape|protrait)
- url: The url of the image
- is_original: (boolean) false if $url is a resized image, true if it is the original.
NOTE THAT YOU HAVE TO SAVE/UPDATE YOUR POST EACH TIME YOU MODIFY THE IMAGE SELECTION
Screenshots
FAQ
ChangeLog