RPS Image Gallery takes over where the WordPress gallery leaves off by adding responsive galleries, slideshow and advanced linking capabilities.
RPS Image Gallery enhances the core WordPress gallery function by dynamically adjusting the column count based on viewport width and enabling an image in the gallery to either invoke a slideshow or link to another page, post or any URL. The link and link target are specified in the image’s Edit Media screen using the Gallery Link URL and Gallery Link Target fields. When an image having a Gallery Link URL is clicked, the user will be directed to that location. Images linking elsewhere are automatically excluded from the slideshow – clicking the image will not invoke the slideshow but will call the specified Gallery Link URL.
In addition, RPS Image Gallery combines attachments from multiple posts or pages into a single gallery, enables the use of paging – useful for galleries with a large number of images, and provides the ability to link a gallery image to the post to which it is attached.
The post IDs containing a gallery to include.
The image IDs to display in the gallery.
The container for the gallery.
How many columns to use for the gallery view.
Determines whether the number of columns should respond to the viewport width.
Determines how many images show at a time. Includes paging navigation. Not compatible with Masonry.
Affects the heading(title), caption and the last row of images when there are fewer images in the row than number of columns.
The size of the image that should be displayed in the gallery view. It can be any of the standard image sizes including any registered by the theme.
Specify if the image dimensions should be constrained by width only or both width and height. Only available with specific themes or when the theme is set to “none”.
Only available if the constrain value is set to ‘media’. Allows the use of the Thumbnail, Medium or Large image dimensions as specified in Media Settings.
Only available if the constrain value is set to ‘plugin’. Allows the constrain width to be specified by the plugin.
Only available if the constrain value is set to ‘plugin’. Allows the constrain height to be specified by the plugin.
The size of the image that should be displayed in the slideshow view. It can be any of the standard image sizes including any registered by the theme.
How to sort the images. It is ignored if a list of image IDs is included in the shortcode.
How to order the images. It is ignored if a list of image IDs is included in the shortcode.
Display the image title in the gallery and slideshow views.
The tag that should be used to wrap the image heading (title).
Specify alignment of the heading text presented in the gallery grid.
Display the image caption or description under the images in the gallery grid view.
Automatically insert break and paragraph tags into caption.
Define where the text presented as the caption should be sourced.
Specify alignment of the caption text presented in the gallery grid.
Where to get the URL to direct a user when clicking/tapping an image. Only has an effect if Slideshow is set to false and the Gallery Link URL is empty.
Which HTML structure to use to output the gallery.
Which theme to use to style the HTML output.
Whether to use the Masonry script cascading grid layout library for the gallery.
Invoke the slideshow (fancyBox) viewer when an image without a Gallery Link URL value is clicked.
Which version of fancyBox to use.
Specify whether the slideshow should automatically cycle through the images or not.
Display the gallery thumbnail images as backgrounds or standard images.
(since 1.2.24)
Show the EXIF image data.
Where to show the EXIF data associated with the image.
What EXIF fields to display and in what order.
Comma separated attachment IDs to display. Cannot be used with exclude.
Comma separated attachment IDs to display. Cannot be used with include.
The class of the gallery group which determines what images belong to the gallery slideshow.
Use the ALT value as a fallback in case the Caption field is empty.
Show the title area in the slideshow view including the image heading, caption or description, and EXIF data.
Show the image heading within the title area of the slideshow.
Show the image caption within the title area of the slideshow.
The position of the title area in relation to the image in the slideshow.
The alignment of the text in the slideshow title.
Show the close button in the upper-right corner of the slideshow (clicking outside the slideshow always closes it).
The effect that should be used when the slideshow is opened.
The effect that should be used when the slideshow is closed.
Time in milliseconds of the fade and transition when the slideshow is opened.
Time in milliseconds of the fade and transition when the slideshow is closed.
Display the image counter in the slideshow (i.e. “Image 1/10).
Make the slideshow start from the beginning once the end is reached.
Center the image on the screen while scrolling the page.
Space between FancyBox wrapper and content.
Space between viewport and FancyBox wrapper.
Opacity of the overlay appearing behind the slideshow and on top of the page.
Color of the overlay appearing behind the slideshow and on top of the page.
Display helper thumbnails appearing below the slideshow in fancyBox2.
The width of the helper thumbnails appearing below the slideshow in fancyBox2.
The height of the helper thumbnails appearing below the slideshow in fancyBox2.
Set to true if it is preferred the native WordPress gallery output is used.
rps-image-gallery
directory and its containing files to the /wp-content/plugins/
directory.The gallery output features an option to include Facebook and Pinterest buttons along with gallery paging navigation.
Clicking a gallery image opens the slideshow(fancyBox) viewer or directs the site visitor to a page specified in the Gallery Link field.
Defaults can be set for image galleries sitewide from one convenient interface.
"Gallery Link URL" and "Gallery Link Target" appear on the Edit Media screen for images so that an admin can force the image to link to a post on their site or another site.
You must have the Redux Framework plugin installed in order to edit the default options. Once activated you will see an Image Gallery link show under the WordPress admin Settings tab.
Yes. Any shortcode attribute will override the gallery default settings.
Have a look at the “Other Notes” tab.
You can refer to the gallery instructions posted at WordPress.com support.
Nothing bad. The default WordPress Gallery behavior will take over and any shortcode attributes that are specific to RPS Image Gallery are ignored. However, if you have chosen to use the alternate shortcode [[rps-gallery]] instead, those instances of the shortcode will not process and will simply be displayed within the body of the post.
You will need to make sure the Redux Framework is installed and active. Then go to the RPS Image Gallery settings page located in the WordPress admin under Settings > RPS Image Gallery and select the Gallery tab. Locate the switch labeled “Responsive Columns” and set it to “On”. You will notice additional settings appear below the Columns slider, one for each column count. Adjust the sliders for each to specify the minimum viewport width in pixels at which that number of gallery columns is supported. The viewport widths do not need to be in ascending order so feel free to assign any combination that works bet with your theme.
Please note: Any shortcode featuring the “columns” attribute will not be affected by the responsive gallery columns settings.
Yes. As of version 2.1.1, unique stylesheets are generated for each site using RPS Image Gallery responsive gallery columns in the multisite network.
You may use any of the standard image sizes including “thumbnail”, “medium”, “large”, “full” and any other additional image size registered by the active theme.
[gallery size="thumbnail" size_large="large"]
The fields “Gallery Link URL” and “Gallery Link Target” on the Edit Media screen allow you to specify the settings for each image (see screenshots).
link – By default the only two options are “file” and “permalink”. We have added an option of “none” in order to prevent gallery thumbnail images from linking anywhere if slideshow is also set to “false” (since version 1.2.2). An example of this approach is:
[gallery link=”none” slideshow=”false”]
id – By default you can use the id to display a gallery that exists on another post/page. We have added the option to pass along a comma delimited list of ids so that a single gallery can be created from multiple galleries. The ‘orderby’ and ‘order’ arguments are applied after the attachments are combined. The following example will combine the image attachments from post 321 and 455 into a single gallery sorted alphabetically by title:
[gallery id=”321,455″ orderby=”title” order=”asc”]
Notice for WordPress 3.5+ Users: When the “ids” attribute and “id” attribute are present in the same shortcode, the “ids” attribute will be used to determine which images should be included and what order they will be in.
The plugin will fall back to the image title if a caption or description is not defined for the image.
Yes. You will need to select which one you want to use, but the approach is simple:
[gallery caption="true" caption_source="caption"] [gallery caption="true" caption_source="description"]
The ‘caption_auto_format’ attribute will automatically add paragraph tags where double line breaks are found and break tags for every single line break.
[gallery caption_auto_format="true"]
Though the WordPress Gallery editor only allows you to manage a single gallery, you can combine galleries from multiple post/pages onto a single page. To do this, create a post/page for each gallery that you want to include. Record the post IDs for the gallery pages, then add a gallery shortcode for each of them on the post/page that will contain them. For example:
[gallery id="134" group_name="group1"] [gallery id="159" group_name="group2"]
This code will pull the gallery from post 134 and 159 and display them one after the other. The group name attribute allows for each gallery to display in a separate slideshow. Excluding the group name or making it the same will cause the slideshow to be contiguous between the galleries.
Alternatively, you can create multiple galleries from the attached images on a post/page. To do so, get a list of the image (attachment) IDs that you want for each gallery, then pass them to the gallery shortcode in the “include” attribute like so:
[gallery include="10,11,24,87"] [gallery include="7,16,23,45"]
Keep in mind that all of the included images must be attached to the post/page to be successfully added to the gallery.
Since version 2.0.9, all you need to do to combine multiple galleries is pass along a comma delimited list of ids like so:
[gallery id="134,159" orderby="title"]
This code will take all of the images from the two galleries, merge and order them by the image title.
fancyBox version 1.3.4 and 2.1.5 are included with this plugin. However, the use of fancyBox2 is contingent upon your site meeting license requirements.
You can make the EXIF data show by adding the exif_locations argument to the shortcode like so.
[gallery exif="true" exif_locations="slideshow"]
The EXIF fields that can be displayed are “camera”, “aperture”, “focal_length”, “iso”, “shutter_speed”, “title”, “caption”, “credit”, “copyright” and “created_timestamp”. The order you enter the fields is reflected in the output.
[gallery exif="true" exif_locations="slideshow" exif_fields="aperture,focal_length,iso,shutter_speed"]