Description
This plugin add a metabox which allox to upload and link multiple images to one post.
Pictures are linked by the way of meta_value (and attachments ID). They can be reordered using drag and drop.
Number of allowed pictures and concerned post types can be overited using hooks.
Plugin includes many functions to retrieve linked pictures.
For more information on using the plugin, refer to the section «Other Notes».
Set concerned post types
Paste this into your theme’s functions.php file :
Set allowed number of picts
Paste this into your theme’s functions.php file :
‹_image1›,
‹image2› => ‹_image2›,
);
return $picts;
}
?>
Set allowed number of picts, depending to the post_type
Paste this into your theme’s functions.php file :
add_filter(‹list_images›,’my_list_images›,10,2);
function my_list_images($list_images, $cpt){
global $typenow;
if($typenow == «my_custom_post_type» || $cpt == «my_custom_post_type»)
$picts = array(
‹image1› => ‹_image1›,
‹image2› => ‹_image2›,
‹image3› => ‹_image3›,
);
else
$picts = array(
‹image1› => ‹_image1›,
‹image2› => ‹_image2›,
‹image3› => ‹_image3›,
‹image4› => ‹_image4›,
‹image5› => ‹_image5›,
‹image6› => ‹_image6›,
‹image7› => ‹_image7›,
‹image8› => ‹_image8›,
);
return $picts;
}
get_images_ids()
This function have to be used into a template file, or any function.
It return an array of the linked attachments’s ID.
It take two arguments whose are :
- include the thumbnail ? (boolean) if true include the thumbnail in the returned datas
-
ID (integer) for targeting images linked to a specific post
45,
‹image1› => 5,
‹image2› => 6,
‹image3› => 12,
‹image6› => 20,
‹image7› => 15
);//Empty pictures ar not returned
?>
get_images_src()
This function have to be used into a template file, or any function.
It return an array of URIs and dimension for the linked attachments’s, by order.
It take three agruments whose are :
- size (string) the size to return
- include the thumbnail ? (boolean) if true include the thumbnail in the returned datas
-
ID (integer) for targeting images linked to a specific post
array(
[0] => ‹http://url_of_the_medium_pict.jpg›,
[1] => 340,
[2] => 200,
[3] => false //I’ve no idea what is it…
),
‹image2› => array(
[0] => ‹http://url_of_the_medium_second_pict.jpg›,
[1] => 340,
[2] => 200,
[3] => false //I’ve no idea what is it…
)
);?>
get_multi_images_src()
Same as get_image_src(), but return two sizes for all the pictures.
It take for agruments whose are :
- size (string) the size to return
- size2 (string) another size to return
- include the thumbnail ? (boolean) if true include the thumbnail in the returned datas
-
ID (integer) for targeting images linked to a specific post
array(
[0] => array(
[0] => ‹http://url_of_the_medium_pict.jpg›,
[1] => 340,
[2] => 200,
[3] => false //I’ve no idea what is it…
),
[1] => array(
[0] => ‹http://url_of_the_full_pict.jpg›,
[1] => 1020,
[2] => 600,
[3] => false //I’ve no idea what is it…
),
),
‹image2› => array(
[0] => array(
[0] => ‹http://url_of_the_medium_second_pict.jpg›,
[1] => 340,
[2] => 200,
[3] => false //I’ve no idea what is it…
),
[1] => array(
[0] => ‹http://url_of_the_second_full_pict.jpg›,
[1] => 1020,
[2] => 600,
[3] => false //I’ve no idea what is it…
)
)
);
//Empty pictures ar not returned?>
Screenshots
Installation
-
Upload the Multi Image Metabox plugin to your blog and Activate it.
-
Customize (into the functions.php file of your theme):
- If you want to target other post type than PAGE, use the filter hook «images_cpt»
- If you want to change the number of image, use the filter hook «list_images»
-
Retrieve the linked images in your theme using the functions :
- Use get_images_ids() into the loop to get an array of attachment’s ID
- Use get_images_src(’size›) into the loop to get an array of attachment’s URI & dimensions for the quiered size
- Use get_multi_images_src(’size1′,’size2′) into the loop to get an array of attachment’s URI & dimensions for 2 differents size
-
Enjoy ^^ (report to developper section to view the returned datas)
FAQ
- Installation Instructions
-
-
Upload the Multi Image Metabox plugin to your blog and Activate it.
-
Customize (into the functions.php file of your theme):
- If you want to target other post type than PAGE, use the filter hook «images_cpt»
- If you want to change the number of image, use the filter hook «list_images»
-
Retrieve the linked images in your theme using the functions :
- Use get_images_ids() into the loop to get an array of attachment’s ID
- Use get_images_src(’size›) into the loop to get an array of attachment’s URI & dimensions for the quiered size
- Use get_multi_images_src(’size1′,’size2′) into the loop to get an array of attachment’s URI & dimensions for 2 differents size
-
Enjoy ^^ (report to developper section to view the returned datas)
-
Reviews
Contributors & Developers
“Multi Image Metabox” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Multi Image Metabox” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.3.4
- Solve a major bug on front end, when you want to customize number of pictures depending to the post type.
- YOU NEED TO UPDATE YOUR FILTERS «list_images», if you’re using it…
1.3.1
- Solve a minor bug while saving menus
1.3
- Add an integer argument id for all procedurals functions to target a specific post
- Solve a bug into the get_multi_images_src() function
1.2
- Add an boolean argument thumbnail for all procedurals functions to join image post thumbnail (ID, images) at the front of the returned arrays
1.1
- Change the hook for initializing the plugin. By this way we can now assign different numbers of picts, depending to the post type.
- Debug the default sizes of get_multi_image_src()
1.0
- First version, with some hooks and functions