We have support forum that you can check answers for issues or add your issue and get answered by other customers and experts.
Getting Started
An overview of WordPress Gallery Extra, how to download and use.
The most intuitive and extensible gallery management tool ever created for native WordPress Gallery.
A brand new algorithm
There are dozens of WordPress photo galleries out there, but the problem is that they always look the same! WordPress Gallery Extra uses a brand new algorithm to make much more interesting image grids.
The WordPress Gallery Extra is fully responsive and it adapts to the browser using a nice and smooth animation, even on mobile devices because it can use the hardware acceleration taking advantage of CSS3 properties.
Installation
There are two ways to install WordPress Gallery Extra:
WordPress Plugin Uploader
You can install WordPress Gallery Extra via the WordPress plugin uploader without unzipping the file:
Log into your WordPress admin panel
Navigate to Plugins > Add New
Click Upload
Click Choose File and select the wordpress-gallery-extra-upload.zip file.
Click Install Now.
Navigate to your Control Panel: Plugins
Under WordPress Gallery Extra, click Activate
FTP
You can also install WordPress Gallery Extra via FTP:
Extract the .zip file you downloaded from CodeCanyon.
Find the wordpress-plugin-extra folder (this directory is created when you unzip the file).
Upload the wordpress-plugin-extra folder to your wp-content/plugins directory.
Navigate to your Control Panel: Plugins
Under WordPress Gallery Extra, click Activate
Once you install the plugin, you’ll get new Menu Item in the Admin Panel
That’s it! WordPress Gallery Extra should now be ready for use.
Gallery
How to create galleries and manage galleries options and images.
Image galleries are a great way to share groups of pictures on your WordPress site. The Create Gallery feature of the WordPress media uploader allows you to add a simple image gallery to pages or posts on your site.
Here’s how to add an image gallery step-by-step, using the media uploader:
Step 1 – Place your cursor
A gallery can go anywhere on a page or post – by itself on a blank page, or above, below, or in the midst of text. Start by placing your cursor where you want the gallery to appear – if it’s in between blocks of text, like in the photo example below, consider adding a return and placing your cursor on a new line so there’s space above and below.
Step 2 – Click the Add Media button
Once you’ve placed your cursor where you want your image gallery to appear, click on the Add Media button (located left above the editing window) to launch the media uploader interface. In the resulting popup window, select the ‘Create a Gallery’ option from the list of actions on the left.
Step 3 – Add and/or Select the Images You Want to Include
You can add or select the images you want to include in your image gallery by choosing from either of the following options in the center of the media uploader window:
Upload Files: Upload the images you want to use from your computer by dragging them into the upload area. You can add more than one image, and they will be automatically grouped together as an image gallery.
Media Library: Select from previously uploaded images in the media library by clicking on the ones you wish to add to the gallery. You will see a checkbox next to your selections.
Note: You can create an image gallery using any combination of new images and previously uploaded images simply by switching back and forth between the Upload Files and Media Library tabs.
As you upload and/or select images, you will see your selection confirmed on the Insert Media screen by check boxes at the top corner of each thumbnail. Also, a row of thumbnails appears at the bottom of the window to help you keep track of all the images you’ve selected. When you are happy with your selection, click the Create a new gallery button.
Step 4 – Edit Your Gallery
On the Edit Gallery page, you can do the following things before inserting the gallery you have created into your page or post:
Rearrange your images: Drag and Drop image thumbnails to rearrange the order of images in your gallery.
Reverse Order: Reverses the order of the images in your gallery.
Add image descriptions: Add descriptions to your images (optional) which appear as image captions below each thumbnail in the gallery.
Remove images: Hover over a thumbnail and click on the “X” to remove any of the images you previously selected.
Add more images: Click on the “Add to Gallery” link in the left hand sidebar and add or select the images you want to include in your image gallery by choosing from either “Upload Files” or “Media Library” tabs.
Cancel Gallery: Click on the “Cancel Gallery” link from the actions on the left to exit the Edit Gallery page and cancel your image gallery.
Before inserting your gallery, you also have several Gallery Settings available in a pane on the right to control the following:
Links To: Controls whether the gallery thumbnails (on the published page/post) link to the image attachment page or directly to the source image file itself.
Columns: Set the number of columns you would like to have in your gallery. 3 Columns is the default settings, which is ideal for most sites.
Random Order: Enables your gallery to display your image thumbnails in a random order each time they are viewed on the site.
Size: Changes each image size in gallery. Available options are Thumbnail, Media, Large and Full Size.
Template: Changes the gallery template based on your created templates.
Editing Existing Galleries
Within the visual editor, the image gallery is displayed as a series of thumbnail images.
When you click any area of the image gallery, icon buttons appear top of the area. At any time, you can edit the images or settings of your gallery by clicking on the Edit button. You can remove the image gallery at any time by clicking on the Remove button.
Template
How to create and import templates and use them to style the galleries.
Templates are a great way to styling groups of galleries on your WordPress site. The Templates feature of the WordPress Gallery Extra allows you to style image galleries on your site.
Creating Template
Here’s how to create a template:
You need to go to Templates panel in WordPress Gallery Extra dashboard and click on the New Template button. Enter a name for the template in the opened dialog then hit the Enter.
Importing Template
Here’s how to import templates:
You need to go to Templates panel in WordPress Gallery Extra dashboard and click on the Import Template button. Enter your mouse to a Thumbnail and click on the Import button.
Note: You need to activate the WordPress Gallery Extra to import Templates.
Template Settings
Learn about all available WordPress Gallery Extra settings options and what they are doing.
Gallery Type: The gallery type that will be used when the gallery is output to the frontend.
Gallery Structure: By using this feature you can control the entire gallery’s skeleton structure. You need to use Pug (Jade) as structure.
Show Loading Indicator: Enable or disable the gallery loader.
Caption Source: Pull captions from either the attachment Title, Caption, Alt Text or Description.
Caption Custom Content: Use your own custom caption content. (HTML tags and shortcodes supported)
Caption Custom Content variables are:
Value
Description
%title%
Attachment Title field.
%caption%
Attachment Caption field.
%description%
Attachment Description field.
%alt%
Attachment Alt field.
%author%
Attachment Author Name.
%time_ago%
Human readable attachment upload time.
%year%
Attachment upload Year.
%month%
Attachment upload month (A full textual representation of a month, such as January or March).
%monthnum%
Attachment upload month (Numeric representation of a month, with leading zeros).
%day%
Attachment upload day of the month (A full textual representation of the day of the week).
%daynum%
Attachment upload day of the month (Day of the month with leading zeros).
%index%
Item index in gallery with leading zeros.
%custom_link%
Attachment Custom Link field.
%custom_link_target%
Attachment Custom Link Target field.
%image_file%
Attachment image file URL.
%thumb_file%
Attachment thumbnail file URL.
%attachment_page%
Attachment page URL.
%categories%
Attachment comma separated categories.
%tags%
Attachment comma separated tags.
Last row: Decide how to position the last row of images. Default the last row images are aligned to the left. You can also hide the row if it can’t be justified and aligned to the center or to the right.
Alignment: The horizontal alignment of the thumbnails inside the gallery.
Row Height: The preferred height of your gallery rows in pixel.
Max Row Height: A number (e.g 200) which specifies the maximum row height in pixels. Use -1px to remove the limit of the maximum row height. Alternatively, use a percentage (e.g. 200% which means that the row height cannot exceed 2 * Row Height)
Mosaic Type: Auto mosaic items or use attachments Columns and Rows Size fields.
Template Styling
Learn about all available WordPress Gallery Extra styling options and what they are doing.
Style: By using this feature you can set a preset style for thumbnails.
Border: Controls thumbnails borders size, style, color, and radius.
Shadow: Controls thumbnails box shadow offset, blur, spread, and color.
Use Placeholder: Enables your gallery to use attachments Placeholder Color field for overlay and thumbnail background color.
Spacing: The spacing or gap between thumbnails in the gallery.
Caption Position: Where the captions are displayed in relation to the thumbnail.
Overlay as Caption Background: Set overlay background as caption background.
Custom CSS: Allows you to add your own styles or override the default styles. LESS-CSS is alowed. Preboot and LESS DSS mixins supported. To use Preboot mixin, insert @import "preboot"; in first line and for LESS DSS, insert @import "dss"; in first line.
You can access styling options values in Custom CSS field using LESS variables. Possible variables are:
Styling options variables
Variable
Description
@spacing
The Spacing option value.
@border-weight
The Border Weight option value.
@border-style
The Border Style option value.
@border-color
The Border Color option value.
@border-radius
The Border Radius option value.
@border
The CSS Border property value.
@shadow-x
The Shadow X-Offset option value.
@shadow-y
The Shadow Y-Offset option value.
@shadow-blur
The Shadow Blur option value.
@shadow-spread
The Shadow Spread option value.
@shadow-color
The Shadow Color option value.
@shadow
The CSS box-shadow property value.
@icon-color
The Icon Color option value.
@icon-size
The Icon Size option value.
@caption-color
The Caption Color option value.
@overlay-type
The Overlay background type option value.
@overlay-background
The Overlay CSS background property value.
@overlay-start-color
The Overlay Background Start Color option value in gradient type.
@overlay-stop-color
The Overlay Background Stop Color option value in gradient type.
@overlay-orientation
The Overlay Background Orientation option value in gradient type.
Images Sizes
How to manage images size, quality and rebuild thumbnails.
This plugin allow create custom image sizes for your site. Override your theme sizes directly on the Images Sizes page.
1
2
3
4
5
6
1
The Image Size name
2
Image width in pixels
3
Image height in pixels
4
Whether to crop images to specified width and height or resize. You can specify positioning of the crop area.
5
Whether to show image size in post insertion or hide. You can specify positioning of the crop area.
6
Remove the image size
You can regenerate all the sizes you have just created and choose which one you wanted to regenerate.
1
2
3
4
1
Creates a zipped archive of your uploads directory and saves it in wp-content/backups/wordpress-gallery-extra/
2
Scans your uploads directory for thumbnails and deletes all thumbnails within your uploads directory.
3
Image sizes option to rebuild
4
Post types source thumbnails only to rebuild.
You can use the generated sizes directly into your galleries and insert images at the right size!
Images
Learn about all available Image options and what they are doing.
WordPress Gallery Extra will add new Settings & Features to your images in Media Library that you can control them as you wish. Such as tagging and categorizing images, Placeholder Color field, Custom URL field, and the mosaic gallery Row & Columns size.
Settings available in a pane on the right to control the following:
Tags: Refers to micro-categories for your blog, similar to including index entries for a page. Images with similar tags are linked together and galleries can be created with them.
Categories: The general topic the image can be classified in. Images with similar categories are linked together and galleries can be created with them.
Placeholder Color: Image placeholder color for lazy load and galleries overlay.
Custom URL: Point attachment to a custom URL.
Custom Target: Set a custom target for attachment.
Columns Size: Set columns size for attachment in mosaic gallery type.
Rows Size: Set rows size for attachment in mosaic gallery type.
Shortcode
Learn about WordPress Gallery Extra Shortcode and all its options.
The Gallery feature allows you to add one or more image galleries to your posts and pages using a simple Shortcode. Since WordPress 2.5 and up until 3.5, the gallery shortcode was commonly used in its most basic form:
[gallery]
Following 3.5, gallery shortcodes includes the image IDs by default. Like this:
[gallery ids="729,732,731,720"]
Specifying IDs in your shortcode allows you to include images in your gallery that aren’t necessarily “attached” to your post — that is to say, not uploaded from within your post or page. This flexibility allows you to create and embed any number of galleries containing any number of images!
Note: If you choose to just use the "barebones" version of the [gallery] shortcode in your post or page, only images that are "attached" to that post or page will be displayed.
Usage
There are several options that may be specified using this syntax:
[gallery option1="value1" option2="value2"]
You can also print a gallery directly in a template like so:
specify how to sort the display thumbnails. The default is “menu_order”. Options:
menu_order – you can reorder the images in the Gallery tab of the Add Media pop-up
title – order by the title of the image in the Media Library
post_date – sort by date/time
rand – order randomly
ID
order
specify the sort order used to display thumbnails. ASC or DESC. For example, to sort by ID, DESC:
[gallery order="DESC" orderby="ID"]
columns
specify the number of columns. The gallery will include a break tag at the end of each row, and calculate the column width as appropriate. The default value is 3. If columns is set to 0, no row breaks will be included. For example, to display a 4 column gallery:
[gallery columns="4"]
id
specify the post ID. The gallery will display images which are attached to that post. The default behavior, if no ID is specified, is to display images attached to the current post. For example, to display images attached to post 123:
[gallery id="123"]
size
specify the image size to use for the thumbnail display. Valid values include “thumbnail”, “medium”, “large”, “full” and any other additional image size that was registered with Images Sizes. The default value is “thumbnail”. The size of the images for “thumbnail”, “medium” and “large” can be configured in WordPress admin panel under Settings > Media. For example, to display a gallery of medium sized images:
[gallery size="medium"]
template_id
specify the gallery template ID that was created with Template Panel.
[gallery template_id="1"]
link
Specify where you want the image to link. The default value links to the attachment’s permalink. Options:
post – Link directly to image post
file – Link directly to image file
none – No link
[gallery link="file"]
include
comma separated attachment IDs to show only the images from these attachments.
[gallery include="23,39,45"]
exclude
comma separated attachment IDs excludes the images from these attachments. Please note that include and exclude cannot be used together.
[gallery exclude="21,32,43"]
categories
comma separated categories to show only the images from these categories.
[gallery categories="face, outdoor"]
tags
comma separated tags to show only the images from these tags.