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.
Note: This plugin DOES NOT HANDLE THE FRONTEND HTML CREATION. That is left for themes to handle, to allow for maximum flexibility. Featured Galleries just handles the backend/admin interface for creating featured galleries and storing them as metadata. You will need to integrate this into your theme, or use a theme with prebuilt integration.
Quick Start Guide to Integrate Into Themes
For more information, see GitHub Wiki.
I’ve tried to make this as intuitive as possible. Themes can integrate Featured Galleries in the same way they integrate Featured Images. Inside any template file where the gallery should appear, the theme will call the get_post_gallery_ids() function. As long as it is used inside the loop, the function doesn’t need any parameters. By default, it will return an array of image IDs.
Example
Set inside the Loop. This returns all images in the Featured Gallery, as an array, then loops through to display each using an HTML <img> tag.
$galleryArray = get_post_gallery_ids();
foreach ( $galleryArray as $id ) {
echo '<img src="' . wp_get_attachment_url( $id ) .'">';
}
You can also customize the returned value from the function to suit your needs. See the full function documentation page for details.
Custom Post Types
The plugin comes with a filter to easily add Featured Galleries to custom post types. See the fg_post_types documentation page for details.
Customizing the Media Manager
The media manager can be customized in sevearl ways. See the fg_show_sidebar and fg_use_legacy_selection filter documentation pages for details.
Want to Help?
I’d love some help with internationalization. It was working at one point, but drivingralle did that code because I don’t really understand it, and I’m not sure it’s still working.
