=== WordPress Gallery Plugin === Contributors: maxfoundry, arcware, johnbhartley, AlanP57 Tags: albums, gallery, image, images, media, flash, foto, fotoalbum, photo, photos, photo albums, picture, pictures, responsive wordpress gallery, thumbmail, thumbnails, wordpress gallery, wordpress gallery plugin, responsive wordpress gallery plugins, responsive, slideshows, image slider, nivo, image slide plugin, photo slider, responsive slideshow, responsive slider plugin, slideshow plugin, wordpress picture slider, wordpress responsive slider, wordpress slider, website gallery, youtube, youtube video, youtube videos, youtube gallery, youtube video galleries, nextgen, nextgen gallery, media library, media uploader, images, image folders, responsive lightbox, swipebox, prettyphoto, fancybox, nivo lightbox, image lightbox Requires at least: 3.9 Tested up to: 4.3 Stable tag: 4.21 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Responsive WordPress Gallery plugin with built in Slider and Lightbox == Description == You deserve a WordPress responsive gallery plugin that doesn't frustrate you as you use it - you want a WP gallery plugin that is actually a joy to use. Other gallery plugins claim to be the best simply because they've been around the longest and have the most downloads. But we know better. MaxGalleria helps change the game by giving users a streamlined experience for creating and managing responsive WordPress galleries that look great on any device. = Useful Info = * What Is a [WordPress Gallery Plugin?](http://maxgalleria.com/?utm_source=wordpress&utm_medium=whatis&utm_content=what-is-wordpress-gallery-platform&utm_campaign=repo) * [How to Upgrade to MaxGalleria 2.0](http://maxgalleria.com/blog/upgrade-maxgalleria-2-0/?utm_source=wordpress&utm_medium=upgrade2&utm_content=how-to-upgrade-maxgalleria-2&utm_campaign=repo) = A Responsive WordPress Gallery for All Devices = From iPhones to iPads to Androids to desktops, MaxGalleria provides a great viewing experience no matter the device your galleries are seen on. = Responsive Lightbox = MaxGalleria includes 2 excellent options to add lightbox to WordPress image galleries, lightbox to WordPress image links and lightbox to WordPress video links (YouTube, Vimeo) MaxGalleria ships with a complete integration of the fully featured [Magnific Popup](http://dimsemenov.com/plugins/magnific-popup/) responsive lightbox by Dmitry Semenov. It is also fully compatible by selecting a simple option box and recommends at installation the [Responsive Lightbox](https://wordpress.org/plugins/responsive-lightbox/) plugin by dFactory. These plugins allows users to view larger versions of images and galleries in a lightbox (overlay) effect optimized for mobile devices. Responsive Lightbox includes 6 responsive lightbox scripts (SwipeBox, prettyPhoto, FancyBox, Nivo Lightbox, Image Lightbox, Tos "R" Us) = Superior Workflow = From lightboxes to sliders to layouts MaxGalleria provides a highly streamlined user interface that makes it as straightforward as possible to create and manage your galleries. = Import NextGEN Galleries = Frustrated with the NextGEN Gallery plugin? You're not alone. As the best alternative to NextGEN Max Galleria lets you Import your NextGEN with just a couple clicks. = Use Only What You Need = Don't get bogged down with useless features. MaxGalleria gives you all the essentials, then lets you pick and choose [enhanced functionality](http://maxgalleria.com/?utm_source=wordpress&utm_medium=enhanced&utm_content=enhanced-functionality&utm_campaign=repo). = Ready-Made Templates = MaxGalleria includes several [gallery layouts and skins](http://maxgalleria.com/?utm_source=wordpress&utm_medium=layoutsskins&utm_content=gallery-layouts-skins&utm_campaign=repo), each with plenty of options to customize your galleries just how you like. = Built for Developers = The MaxGalleria gallery platform was created with developers in mind. You'll find countless [actions and filters](http://maxgalleria.com/documentation/?utm_source=wordpress&utm_medium=actions&utm_content=actions-filters&utm_campaign=repo) to make your heart sing. = Addons to Enhance Your Gallery Experience = Many people will find the core MaxGalleria plugin all they will ever need; however, some people will want to take their gallery experience further. And to do help them do that, there are several addons available: = Layout Addons = * [Albums](http://maxgalleria.com/shop/maxgalleria-albums/?utm_source=wordpress&utm_medium=albums&utm_content=albums&utm_campaign=mgrepo) - Organize your galleries into albums * [Image Carousel](http://maxgalleria.com/shop/maxgalleria-image-carousel/?utm_source=wordpress&utm_medium=imagecarousel&utm_content=image-carousel&utm_campaign=mgrepo) - Turn your galleries into carousels * [Image Showcase](http://maxgalleria.com/shop/maxgalleria-image-showcase/?utm_source=wordpress&utm_medium=imageshowcase&utm_content=image-showcase&utm_campaign=mgrepo) - Showcase your high-resolution images * [Image Slider](http://maxgalleria.com/shop/maxgalleria-image-slider/?utm_source=wordpress&utm_medium=imageslider&utm_content=image-slider&utm_campaign=mgrepo) - Turn your galleries into sliders * [Video Showcase](http://maxgalleria.com/shop/maxgalleria-video-showcase/?utm_source=wordpress&utm_medium=videoshowcase&utm_content=video-showcase&utm_campaign=mgrepo) - Showcase your videos * Masonry - Display images in a [Pinterest](http://maxgalleria.com/shop/maxgalleria-masonry?utm_source=wordpress&utm_medium=masonry&utm_content=masonry&utm_campaign=mgrepo) like grid = Media Sources = * [Facebook](http://maxgalleria.com/shop/maxgalleria-facebook/?utm_source=wordpress&utm_medium=facebook&utm_content=facebook&utm_campaign=mgrepo) - Add Facebook photos to your galleries * [Instagram](http://maxgalleria.com/shop/maxgalleria-instagram/?utm_source=wordpress&utm_medium=instagram&utm_content=instagram&utm_campaign=mgrepo) - Add Instagram images to your galleries * [Vimeo](http://maxgalleria.com/shop/maxgalleria-vimeo/?utm_source=wordpress&utm_medium=vimeo&utm_content=vimeo&utm_campaign=mgrepo) - Add Vimeo videos to your galleries * [Flickr](http://maxgalleria.com/shop/maxgalleria-flickr/?utm_source=wordpress&utm_medium=flickr&utm_content=flickr&utm_campaign=mgrepo) - Pull in images from your Flickr stream * [Slick Carousel for WordPress](http://maxgalleria.com/shop/slick-carousel-wordpress/?utm_source=wordpress&utm_medium=slick&utm_content=slick&utm_campaign=mgrepo) - The Last Carousel You'll ever need! = Media Library Extended = [Media Library Plus](http://maxgalleria.com/media-library-plus/?utm_source=wordpress&utm_medium=mlp&utm_content=mlp&utm_campaign=mgrepo) (MLP) comes standard with MaxGalleria. MLP lets you add and build new folders to organize your media. If you want to create a media folder for a specific gallery or album, copy all of the images you want to use into the folder. Then easily load those images into a MaxGalleria gallery. Everything is organized in a more logical manner for galleries and albums. MLP sits on top of the WordPress Media Library and adds functionality to it. = Features at a Glance = MaxGalleria is stuffed full of all the features and functionality you need to easily create and manage your image and video galleries in WordPress. * Responsive WordPress galleries * Unlimited number of galleries * Native integration with WordPress media manager and extensions with our included Media Library Plus * Select multiple images from media manager * Add images from your computer * Import galleries from NextGEN * Featured images for gallery thumbnail * YouTube video support * Lightbox effects with captions and custom sizes * Custom classes and rel attribute for thumbnails * Bulk edit functionality * Include/exclude media from galleries * Adjustable thumbnail column layouts * Square, landscape, and portrait thumbnail shapes * HTML in thumbnail captions * HTML descriptions above or below galleries * Drag-and-drop reordering of media * Shortcode for galleries * Shortcode for gallery thumbnails * Media button to insert gallery shortcodes into posts/pages * Galleries created with custom post type * Changeable slug for gallery post type * Categories and tags support * Default settings * SEO friendly captions, alt text, and titles * Compatible with WordPress Multisite * Localized strings are translation-ready * Image Tiles template and skins * Video Tiles template and skins * Developer hooks (actions and filters) * Multiple galleries on any post/page * Exclude galleries from search results * Widgets for galleries and gallery thumbnails Support We work hard to give timely support during the week. And we give support when we're on during the weekend If you like MaxGalleria please leave us a ★★★★★ rating [here](https://wordpress.org/support/view/plugin-reviews/maxgalleria#postform). A huge thank you from MaxFoundry in advance! == Screenshots == There are too many screenshots to list here, but you can [see all of them on the MaxGalleria website](http://maxgalleria.com/?utm_source=wordpress&utm_medium=mgrepo&utm_content=see-all-on-maxgalleria-website&utm_campaign=plugin). == Installation == For automatic installation: 1. Login to your website and go to the Plugins section of your admin panel. 1. Click the Add New button. 1. Under Install Plugins, click the Upload link. 1. Select the plugin zip file from your computer then click the Install Now button. 1. You should see a message stating that the plugin was installed successfully. 1. Click the Activate Plugin link. For manual installation: 1. You should have access to the server where WordPress is installed. If you don't, see your system administrator. 1. Copy the plugin zip file up to your server and unzip it somewhere on the file system. 1. Copy the "maxgalleria" folder into the /wp-content/plugins directory of your WordPress installation. 1. Login to your website and go to the Plugins section of your admin panel. 1. Look for "MaxGalleria" and click Activate. == Frequently Asked Questions == = Does MaxGalleria come with documentation? = Yes. All documentation, which includes QuickStart Guides and developer hooks references, [can be found here](http://maxgalleria.com/documentation/?utm_source=wordpress&utm_medium=faq-doc&utm_content=found-here&utm_campaign=faq-doc). = Do I have to buy any of the addons to fully enjoy MaxGalleria? = No. The MaxGalleria core plugin contains plenty of functionality to keep even the most die-hard gallery user happy. But for those looking to enhance their gallery experience with layouts for [Albums](http://maxgalleria.com/shop/maxgalleria-albums/?utm_source=wordpress&utm_medium=albums&utm_content=faq-albums&utm_campaign=faq-albums),  [Sliders](http://maxgalleria.com/shop/maxgalleria-image-slider/?utm_source=wordpress&utm_medium=faq-slider&utm_content=faq-image-slider&utm_campaign=faq-slider) or media sources like [Instagram](http://maxgalleria.com/shop/maxgalleria-instagram/?utm_source=wordpress&utm_medium=faq-insta&utm_content=instagram&utm_campaign=faq-insta) or [Flickr](http://maxgalleria.com/shop/maxgalleria-flickr/?utm_source=wordpress&utm_medium=faq-flickr&utm_content=flickr&utm_campaign=faq-flickr) then [MaxGalleria addons](http://maxgalleria.com/shop/category/addons/?utm_source=wordpress&utm_medium=faq-buy&utm_content=maxgalleria-addons&utm_campaign=faq-buy) are the perfect choice. = Why do I need a Google Developer API Key to add Youtube videos to a gallery? = Google has recently depreciated the use of the Youtube API version 2 which MaxGalleria uses. We have updated MaxGalleria version 3.1.8 to use version 3 of the API. The new API provides new features for application developers. And it also requires programs accessing Youtube data, such as thumbnails, titles and captions, to have a Google Developer API Key. MaxGalleria users will now be directed to obtain a Google Developer API Key in order to add new videos to their galleries. Existing galleries are not effected by this change. To obtain an API key visit this page for instructions: [http://maxgalleria.com/youtube-api-key/](http://maxgalleria.com/youtube-api-key/) = How do I activate and use the Maxgalleria Media Library Plus? = Version 4.05 of Maxgalleria includes Media Library Plus for organizing your images into folders. Go to MaxGalleria > Settings > Media Library. Check and save Activate Media Library. Click [here](http://maxgalleria.com/maxgalleria-media-library-plus/) to learn more. == Changelog == = 4.21 = * Added folder sync function to the Media Library Plus * Fix problem with incorrect path to image in the new srcset parameter with MLP = 4.20 = * Created new menu for Media Library Plus so other plugins can add submenus to the Media menu = 4.19 = * Add support for user defined uploads folder * Added code to handle attachment_id in attachement URLs = 4.18 = * Renamed the 'settings' class on the Maxgalleria Settings page (in admin/setting.php) to 'mg-settings' to avoid CSS conflict with another plugin * Updated maxgalleria.css with the new 'mg-settings' class. * Changes made to the readme file = 4.17 = * Added facebook like and share buttons * Added code to update theme customizer data if a file used by the customizer is moved by MLP = 4.16 = * Add scan for folders in uploads directory during initial scan on plugin activation * Changes made to the readme file = 4.15 = * Removed unneeded hook for text domain. = 4.14 = * Added way to disable the TGMPA library by adding "define('TGMPA_OFF', true);" (without the double quotes) to the wp-config.php file * Fixes to MLP = 4.13 = * Added review announcement = 4.12 = * Gave unique names to some AJAX function which were conflicting with other plugins; replaced home_url with site_url for sites that run WP in a sub folder = 4.11 = * Updated to the repository description = 4.10 = * Added code to make use of the dFactory Responsive Lightbox plugin. To use, (1) install, activate and configure the Responsive Lightbox plugin, (2) in gallery options select 'Original Image' for 'Thumbnail Click Opens' and check 'Use dFactory Resposive Lightbox' and (3) click the Update button. = 4.09 = * Fixed pagination problems with default permalinks = 4.08 = * Fixes to the media library folder CSS = 4.07 = * Fixes to the media library folder scanning process = 4.06 = * Now loading media library plus scripts and styles when the media library plus page is displayed = 4.05 = * Updates to the readme file = 4.01 = * Updated repository info = 4.0 = * Media Library Plus added * Added test for Windows server when getting the server URL * Added code to save and restore current author data when displaying a gallery = 3.1.8 = * Added a setting in Youtube settings for Google Developer API Key * Modified Youtube add on to use the Youtube API 3 for accessing video data * In image tiles template added test for wp_error after an image is resized. = 3.1.7 = * Added code to strengthen against XSS attacks * Removed enabled related videos and enable HD playback from the video edit box as these are not used by the magnific popup * Removed unneeded code checking 'navigate by image click option' in video tiles javascript * Added check if the current user can manage options before showing Maxgalleria update notice * Added option to video and image tiles to show images in descending order = 3.1.6 = * Removed references to lightbox_video_size option which is not longer used. * Updated the translation files. * Test for 'httpref' in case it is not present. * Fixed missing maxfoundry logo. = 3.1.5 = * Added test for groupby clause in for the media attachment query. = 3.1.4 = * Added instructions on the video add box to use only youtube page links instead of embedded links * Added code to convert embedded links to page links when new youtube videos are added = 3.1.3 = * Added option to turn of links for image tiles = 3.1.2 = * Fixed NextGen import error * The single-maxgalleria.php template is now copied to the child theme if one is in use * Single-maxgalleria.php will be copied to the new theme when themes are switched * Added logging to a maxgalleria.txt file in the wp-admin folder when Maxgalleria is activated = 3.1.1 = * Fixed missing link to the support page = 3.1.0 = * Added Magnific Popup in place of FancyBox * Added ATTACHMENT_QUERY_OFF to shut off media attachment query modification. To use put define('ATTACHMENT_QUERY_OFF', true); in your wp-config.php above the line that says /* That's all, stop editing! Happy blogging. */ * Added PRESERVE_MAXGALLERIA_TEMPLATE to (1) prevent the coping of the file single-maxgalleria.php to the site's current theme folder when MaxGalleria is activated and (2) prevent single-maxgalleria.php from being deleted when MaxGalleria is deactivated. To us put define('PRESERVE_MAXGALLERIA_TEMPLATE', true); in your wp-config.php above the line that says /* That's all, stop editing! Happy blogging. */ = 3.0.3 = * Fixed uninitialized variable * Fixed incorrect value in deleting unneed postmeta record = 3.0.2 = * Added Slick for Wordpress to the MaxGalleria dashboard promo = 3.0.1 = * Added test for querying attachments before adding group by * Fixed problem with lightbox opening image pages when more than one gallery is on a page * Added user recommend CSS to fix problem with video thumbnails * Added fix for when the option 'Organize my uploads into month- and year-based folders' is off * Updated .pot and .mo languages files = 3.0.0 = * Fixed the duplicate pointer issues * Added a class check for Gantry issue * Removed position relaitve from simplemodal for videos = 2.6 = * Added information about addons * Updated to fix conflict with Gantry Framework * Fixed issue where, if already in library, image would get duplicated * Fixed incorrect variable in Lazy Load threshold = 2.5 = * Lazy loading option along with Lazy Load threshold = 2.4 = * Added CSS to fix video responsiveness * Added class check to prevent redeclaration of MaxGalleryOptions = 2.3 = * Fixed the jQuery Fancybox issue * Updated CSS for odd line-breaks * Added pagination * Some plugin_url cleanup * Fixed YouTube HTTP, HTTPS issues = 2.2.2 = * Added hidden saves_count field back in with the template option. * Removed unnecessary wpdb->prepare statement when activating with multisite. * Used esc_attr in Image Tiles and Video Tiles templates for alt and title attributes. = 2.2.1 = * Fixed issue where importing galleries from NextGEN resulted in no images being displayed. * Fixed issue where checkbox options weren't being saved correctly. * Added media count to meta box title for both image and video galleries. = 2.2.0 = * Added gallery and gallery thumbnail widgets (a separate addon is no longer required). = 2.1.0 = * Added support for YouTube videos (a separate addon is no longer required). * Improved user experience by using tabs for gallery options instead of accordions. = 2.0.1 = * Made the Image Tiles and Video Tiles templates the defaults for image and video galleries, respectively. * Added settings for default templates to the General Settings page. * Added margin-top and margin-bottom styles for LI elements in Image Tiles and Video Tiles templates. = 2.0.0 = * Initial version of the MaxGalleria WordPress Gallery Platform. == Upgrade Notice == = 2.2.2 = Minor fixes.