=== WordPress Gallery Extra ===
Contributors: iprodev
Donate link: https://iprodev.com/donate/
Tags: wordpress gallery, wordpress gallery plugin, gallery plugin, slider plugin, justified gallery, justified, masonry gallery, mosaic gallery, photo gallery, image gallery, image grid
Requires at least: 4.0
Requires PHP: 5.3.3
Tested up to: 4.9
Stable tag: 2.0.3
License: Regular License
License URI: https://codecanyon.net/licenses/terms/regular

The most intuitive and extensible gallery management tool ever created for WordPress.

== Description ==

>[Examples](https://wgextra.iprodev.com/showcase/ "Live examples") | [Features](https://wgextra.iprodev.com/features/ "All features") | [Documentation](https://wgextra.iprodev.com/documentation/ "Documentation") | [All Video tutorials](https://support.iprodev.com/knowledgebase_category/wordpress-gallery-extra/ "Watch all video tutorials") | [Support](https://support.iprodev.com/ "Free support")

The most intuitive and extensible gallery management tool ever created for WordPress.

**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**](https://wgextra.iprodev.com/) 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.

= WordPress Gallery Extra Features =

* [Columns Gallery](https://wgextra.iprodev.com/features/columns-layout/)
* [Justified Gallery](https://wgextra.iprodev.com/features/justified-layout/)
* [Masonry Gallery](https://wgextra.iprodev.com/features/masonry-layout/)
* [Mosaic Gallery](https://wgextra.iprodev.com/features/mosaic-layout/)
* [Slider Gallery](https://wgextra.iprodev.com/features/slider-layout/)
* Clean and modern Design
* Drag and Drop Gallery Builder
* Ajax Themes Compatibility
* Translation ready
* Beautiful Templates for Customization
* Powerful Template Manager
* WPML ready
* Responsive design
* [Custom Links](https://wgextra.iprodev.com/features/custom-links/ "You decide what happens on a thumbnail click.")
* [Video Gallery Support](https://wgextra.iprodev.com/features/video-gallery-support/ "Play YouTube, Vimeo, Instagram and Self-hosted media at the click of a thumbnail.")
* [Audio Gallery Support](https://wgextra.iprodev.com/features/audio-gallery-support/ "Play Self-hosted and SoundCloud audio at the click of a thumbnail.")
* [Group Items](https://wgextra.iprodev.com/features/group-items/ "One thumbnail can open multiple medias.")
* [Retina Ready](https://wgextra.iprodev.com/features/responsive-images/)
* [Image Tags](https://wgextra.iprodev.com/features/display-images-by-taxonomy/)
* [Image Categories](https://wgextra.iprodev.com/features/display-images-by-taxonomy/)
* [Image Sizes Manager (Premium)](https://wgextra.iprodev.com/features/image-sizes-manager/ "Every images is in your control")
* [Thumbnails Regenerator (Premium)](https://wgextra.iprodev.com/features/image-sizes-manager/ "Every images is in your control")
* [Hover Effects (Premium)](https://wgextra.iprodev.com/features/hover-effects/ "Be artistic with special effects!")
* [Parallax hover Tilt Effect (Premium)](https://wgextra.iprodev.com/features/tilting-effect/ "Stunning, impressing and high performance 60+fps parallax hover tilting effect to wonder your visitors.")
* [Grid Loading Effects (Premium)](https://wgextra.iprodev.com/features/grid-loading-effects/ "Stunning and impressing grid loading effects to wonder your visitors.")
* [Fixed aspect ratio with Smart Crop (Premium)](https://wgextra.iprodev.com/features/fixed-aspect-ratio-with-smart-crop/ "Choose fixed thumbnail aspect ratio for an uniform grid.")
* [Custom Links (Premium)](https://wgextra.iprodev.com/features/custom-links/ "You decide what happens on a thumbnail click.")
* [Lazy Loading (Premium)](https://wgextra.iprodev.com/features/lazy-load/ "Significantly speed up image-heavy galleries and takes no time at all to enable.")
* Easy style editor
* More than 2 dozen Demos
* Single click Template import
* Top Notch Support
* Strong SEO foundation
* Compatible with major SEO plugins
* Custom CSS for Templates
* Regular Updates and Improvements
* Free Lifetime Updates

== Installation ==

= WordPress Plugin Uploader =
You can install WordPress Gallery Extra via the WordPress plugin uploader without unzipping the file:

1. Log into your WordPress admin panel
1. Navigate to _Plugins > Add New_
1. Click _Upload_
1. Click _Choose File_ and select the `wp-gallery-extra.zip` file.
1. Click _Install Now_.
1. Navigate to your Control Panel: Plugins
1. Under **WordPress Gallery Extra**, click Activate

= FTP =
You can also install WordPress Gallery Extra via FTP:

1. Extract the .zip file you downloaded.
1. Find the `wp-gallery-extra` folder (this directory is created when you unzip the file).
1. Upload the `wp-gallery-extra` folder to your `wp-content/plugins` directory.
1. Navigate to your Control Panel: Plugins
1. 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.

== Frequently Asked Questions ==

= Support Included? =

Once purchased you get support and lifetime updates for **WordPress Gallery Extra**.

We are very dedicated to offer the best support experience possible and our track record shows that we do something right: Our support forum is a vibrant place to get support, offer feedback and help others.

= Do you have documentation or tutorials? =

Yes. See **WordPress Gallery Extra** [Documentation](https://wgextra.iprodev.com/documentation/) and [Knowledge Base](https://support.iprodev.com/knowledgebase_category/wordpress-gallery-extra/).

= What about Refunds? =

If you have any issues in 30 days from purchase date with **WordPress Gallery Extra** and we couldn't fix it, we will return your money.

= Will WordPress Gallery Extra work with my theme? =

Part of what makes the **WordPress Gallery Extra** plugin so popular is its flexibility – it works with the vast majority of premium and free themes, without requiring any coding.

= Are the galleries flash based? =

No, **WordPress Gallery Extra** uses **Javascript (J-Query)** based displays to ensure compatibility across the widest range of displays possible.

= Are the galleries mobile friendly? =

Yes, since we use Javascript rather than flash, **WordPress Gallery Extra** is compatible with **Android**, **iOS**, **Windows Mobile**, and **Blackberry**. All galleries are responsive and retina ready.

= Can I upload multiple images at once? =

Yes, you can batch upload entire galleries at a time.

= Can I add a watermark to the images? =

No, but you can use [this free plugin](https://en-gb.wordpress.org/plugins/image-watermark/) to add watermark to your images.

= Can I customize the lightbox? =

Yes, the lightbox can be configured with multiple options directly from the **WordPress Gallery Extra** Settings.

= Can I add HTML to the captions? =

Yes, caption areas are fully HTML capable and supports dynamic variables.

= Can I add an external links to galleries? =

Yes, every image has its fields where you can add a link, title, caption, description for each image.

Since the captions are fully HTML capable, you can add external links and any other type of mark up you wish.

= Is WordPress Gallery Extra multilingual? =

Yes, the **WordPress Gallery Extra** plugin has been translated into dozens of languages and `.pot` file for translations included.

= Is WordPress Gallery Extra translation ready? =

Yes, WordPress Gallery Extra has full translation and localization support via the `wordpress-gallery-extra` textdomain.

= Is there some limits for adding images? =

There is no any limits for gallery images amount. You can add as many images to your gallery as you want.

= Is it possible to use HTML in image description? =

Yes, you can use HTML tags inside images title, caption, alt, and description fields.

= How to insert gallery into WordPress page or post? =

You can go to the post or page editor and there using Add Media button and Create Gallery with chosen images then insert it into your WordPress post or page. The other means is, that you can insert your gallery manually using shortcode, which you can find instructions in [documentation](https://wgextra.iprodev.com/documentation/).


== Changelog ==

= 2.0.3 =
* **Added:** _**Default Template**_ option that allows you to set a prebuilt template as default template for all galleries in Settings page.
* **Fixed:** playing issue for audio slides in _Slider Gallery Type_.
* **Fixed:** _Admin Dashboard_ appearance issues.
* **Fixed:** some bugs and stability improvements.

= 2.0.2 =
* **Optimized:** getting posts for generating grids.
* **Fixed:** 'wgextra' shortcode rendering.

= 2.0.0 =
* **Introduced:** _**Slider**_ gallery type with powerful options, [take a look at here](https://wgextra.iprodev.com/features/slider-layout/).
* **Added:** _**Group Support**_ for galleries.
* **Added:** _**Responsive**_ options to achieve best layout experience on every devices.
* **Added:** _**Focus-Point**_ feature that allows you to tag the subject in an image and ensures it is not lost during cropping.
* **Added:** _**Thumbnail Ratio**_ option in _Templates_ page.
* **Added:** _**Default Image**_ option in _Templates_ page.
* **Added:** _**Thumbnail Size**_ option in _Templates_ page.
* **Added:** _**Visibility**_ option for items elements with 30+ new entrances & exits effects.
* **Added:** _**Vertical Align**_ option in _Templates_ page for Columns galleries.
* **Added:** _**Use low-res preview image**_ option in _Templates_ page for Lazy Load image placeholder.
* **Added:** _**Media Taxonomies**_ option in _Settings_ page.
* **Added:** _**Capture Placeholder Color**_ option in _Settings_ page.
* **Added:** _**Capture IPTC Metadata**_ option in _Settings_ page.
* **Added:** _**Audio Player Type**_ option in _Settings_ page.
* **Added:** _**Focus Point**_ option in _Settings_ page.
* **Added:** _**Items per page**_ option in _Settings_ page.
* **Added:** 10+ new thumbnail effects.
* **Added:** _**Pagination**_ for templates and sources.
* **Optimized:** _**Template Styling**_ User Interface & structure for better experience and more customization.
* **Optimized:** _**Audio Player**_ User Interface for better experience.
* **Optimized:** _**Image Sizes Manager**_ to control registered image sizes better.
* **Optimized:** _**Lazy load**_ to be smarter to load thumbnail size.
* **Changed:** _**Horizontal**_ gallery type to _**Slider**_.
* **Fixed:** Custom CSS file recreate after update the plugin.
* **Fixed:** Lightbox Caption show bug in simple template.
* **Fixed:** Writing Custom CSS file issue on many servers.
* **Fixed:** PhotoSwipe Issue with WooCommerce.
* **Fixed:** some bugs and stability improvements.

= 1.2.1 =
* **Optimized:** _**Audio Player**_ for mobile devices.
* **Fixed:** _**Audio Player**_ visualizer on retina ready displays.
* **Fixed:** activation bug in php versions lower that 7.
* **Fixed:** some bugs and stability improvements.

= 1.2.0 =
* **Upgraded:** `js-phpize` to version _1.10.0_ from _1.5.1_
* **Upgraded:** `pug-php` to version _2.6.4_ from _2.6.0_
* **Added:** _**fancyBox3**_ lightbox plugin to open images in lightbox mode.
* **Added:** _**PhotoSwipe**_ lightbox plugin to open images in lightbox mode.
* **Added:** _**Magnific Popup**_ lightbox plugin to open images in lightbox mode.
* **Added:** _**Load Library**_ option in _Settings_ page.
* **Added:** _**Debounce Resize**_ option in _Settings_ page.
* **Added:** _**Custom CSS class**_ option in _Template Settings_ page.
* **Added:** _**Grid Loading Animation**_ option in _Template Settings_ page.
* **Added:** _**Lazy Load**_ feature to preload images in viewport only.
* **Added:** _**More Icons**_ to the icons list.
* **Added:** _**Video Support**_ for galleries.
* **Added:** _**Icon custom field**_ in the WordPress Media Library where you set up photos.
* **Changed:** _**Show Loading Indicator**_ option to _**Loading Type**_ _Template Settings_ page.
* **Fixed:** A bug in Tilt effect on start the grid.
* **Fixed:** Showing Loading indicator for galleries.
* **Fixed:** some bugs and stability improvements.

= 1.1.0 =
* **Upgraded:** `js-phpize` to version _1.5.1_ from _1.3.0_
* **Upgraded:** `pug-php` to version _2.6.0_ from _2.5.9_
* **Added:** Tilt effect to tilting items with many options in _Templates › Settings_.
* **Added:** _Gallery Link_ option to gallery holder class list.
* **Optimized:** Attachment _Custom Link_ option in gallery view.
* **Fixed:** HTML structure for outer _Caption Holder_.
* **Fixed:** _Border Color_ bug in generating styles.
* **Fixed:** Overlay Gradient _Colors_ LESS variable bug in generating styles.
* **Fixed:** Masonry refresh on window resize.

= 1.0.0 =
* First commit of the plugin
