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
Steps to install this plugin.
- In the downloaded zip file, there is a folder with name 'attach-post-images'
- Upload the 'attach-post-images' folder to the '/wp-content/plugins/' directory
- Activate the plugin through the 'Plugins' menu in WordPress
- Read the usage instructions in the description.