About this plugin
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