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
