WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Featured Galleries

Do you like giving posts a Featured Image? Try out a Featured Gallery. It's like a Featured Images ... except as many images as you want.

Hello Theme Developers!

Have you ever added a Featured Image to a post and thought to yourself, 'I wish I could add more than one image this way'? Well, now you can. "Featured Galleries" mirrors the Featured Images functionality of WordPress. The only difference is that posts get an entire gallery rather than just a single image. These galleries behave almost exactly like Featured Images, and make use of WordPress's built in Media Manager. Users can select images, define the order, and save the gallery, all through a simple drag-n-drop interface.

--Instructions--

Just like with Featured Images themes will need to call a Featured Gallery in any template file where the Featured Gallery should appear. I've tried to make this as intuitive as possible.

Just like WordPress comes with get_post_thumbnail_id() built-in, you can use get_post_gallery_ids() to call the Featured Gallery. It needs the post's ID, and will return a PHP array with the ID's of all images in the post's Featured Gallery. Additionally you can send a second argument, "string", which will cause the function to return a comma-delimited string instead of an array.

--Examples--

This example pulls the entire Featured Gallery, as an array, then loops through to display each as an img.

$galleryArray = get_post_gallery_ids($post->ID); 

<?php foreach ($galleryArray as $id) { 

    <img src="<?php echo wp_get_attachment_url( $id ); ?>">

<?php } ?>

You can additionally request a comma-delimited string, instead of an array.

$galleryString = get_post_gallery_ids($post->ID,"string"); 

echo $galleryString;

Finally, you may want to just grab the first image of the gallery. You can do this by specifying the number of images to return. The default is -1, which returns all. Setting this to 1 instead, as shown below, will get you only one image.

$galleryArray = get_post_gallery_ids($post->ID,1); 

<?php foreach ($galleryArray as $id) { 

    <img src="<?php echo wp_get_attachment_url( $id ); ?>">

<?php } ?>

Want to Help?

I'd love some help with internationalization. I'm not sure how to do that. Also, if anyone wants to take a look at admin.js, which calls up the media manager, I feel like the way that I open it to the gallery-edit state could be improved. (Opens tofeatured-gallery state, plugs in pre-selected images, then changes state to gallery-edit, and plugs in pre-selected images. Couldn't get selection to transfer, so there's a weird flash as it propagates.)

Requires: 3.5.0 or higher
Compatible up to: 4.0
Last Updated: 2014-8-28
Downloads: 694

Ratings

4 stars
4 out of 5 stars

Support

4 of 4 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1