Daniel Menȝies

This plugin is meant primarily for theme developers.
This plugin allows to collect photos from the the Media Manager and arrange them into albums. 
These albums can be combined into galleries. 
Both albums and galleries can be added to a theme’s navigation menu.
Note that this plugin does not provide any CSS formatting and JavaScript for frontend presentation of galleries and albums. You have to format them yourself and integrate necessary JavaScript libraries, e.g Lightbox, yourself. This plugin merely gives a framework for gallery and album creation via custom post types and registration of designs for a frontend presentation.
If you found a bug or have any questions, complains or suggestions please feel free to contact me.
Theme Integration
You have to write post type template files for your theme in order for an album or gallery to work. 
This gives Theme developers the most control over a frontend presentation and users a convenient way to create galleries through the WordPress dashboard. 
If you install this plugin, create albums and galleries and include them into your theme’s menu, you will be disappointed, since nothing will happen.
<ol>
<li>Create two php files inside your theme’s directory: <code>single-photogallery.php</code> and <code>single-photoalbum.php</code>.
<ul>
<li><code>single-photogallery.php</code> gets called everytime a gallery is about to be viewed</li>
<li><code>single-photoalbum.php</code> gets called everytime a album is about to be viewed</li>
</ul>
</li>
<li>Now you have two options.
<ul>
<li>You can register a custom design inside your theme’s <code>function.php</code> via e.g <code>$kt_Photogallery->register_gallery_design()</code> and call <code>$kt_Photogallery->render()</code> at an appropriated place inside your <code>single-photogallery.php</code> to render it depending on the user’s choice.</li>
<li>You fetch albums, images and thumbnail details, and render consistent HTML for all albums and galleries.</li>
</ul>
</li>
<li>Refere to the PHP API section for further details on how to retrieve album IDs, image IDs and thumbnail details.</li>
</ol>
Example
A basic example for a custom gallery design
<pre><code># functions.php

$kt_Photogallery->register_gallery_design ('my_gallery_design', array(
 'label' => __('My Gallery Design', 'my-textdomain'),
 'icon' => 'dashicons-format-gallery',
 'title' => __('This is my custom gallery design', 'my-textdomain'),
 'render' => 'render_my_gallery_design'
));

$kt_Photogallery->register_album_design ('my_album_design', array(
 'label' => __('My Album Design', 'my-textdomain'),
 'icon' => 'dashicons-format-image',
 'title' => __('This is my custom album design', 'my-textdomain'),
 'render' => 'render_my_album_design'
));

function render_my_gallery_design ($post) {
 global $kt_Photogallery;
 $album_IDs = $kt_Photogallery->get_albums($post);
 if ($album_IDs) {
 foreach ($album_IDs as $album_ID) {
 $album_thumbnail = $kt_Photogallery->get_thumbnail_src($album_ID);
 echo '<a href="' . get_permalink($album_ID) . '">';
 if ($album_thumbnail) {
 echo '<img src="' . $album_thumbnail[0] . '" alt />';
 }
 echo '</a>';
 }
 } else {
 printf(__('The gallery %s does not contain any albums', 'my-textdomain'), esc_html($post->post_title));
 }
}

function render_my_album_design ($post) {
 global $kt_Photogallery;
 $image_IDs = $kt_Photogallery->get_images($post);
 if ($image_IDs) {
 foreach ($image_IDs as $image_ID) {
 $image = get_post($image_ID);
 if ($image) {
 $image_src = wp_get_attachment_image_src($image_ID, 'medium');
 if (!$image_src) {
 $image_src = wp_get_attachment_image_src($image_ID, 'full');
 }
 echo '<img src="' . $image_src[0] . '" alt />';
 }
 }
 } else {
 printf(__('The album %s does not contain any images', 'my-textdomain'), esc_html($post->post_title));
 }
}
</code></pre>
Basic integration into <a href="https://wordpress.org/themes/twentyfifteen" rel="ugc">Twenty Fifteen</a>:
<pre><code># single-photogallery.php or single-photoalbum.php
get_header();
?>
<div id="primary" class="content-area">
 <main id="main" class="site-main" role="main">
 <?php
 while (have_posts()) {
 the_post();
 ?>
 <article class="hentry">
 <header class="entry-header">
 <?php
 the_title('<h1 class="entry-title">', '</h1>');
 ?>
 </header>
 <div class="entry-content">
 <?php
 $kt_Photogallery->render();
 ?>
 </div>
 </article>
 <?php
 }
 ?>
 </main>
</div>
<?php
get_footer();
</code></pre>
Language & Translation
This plugin is in English (en_US) by default but comes with a German (de_DE) po-file. 
There is also a pot file containing untranslated strings so you can use it if you wish to translate this plugin. 
See also <a href="https://developer.wordpress.org/plugins/internationalization/localization/#using-localizations" rel="nofollow ugc">Using Localizations</a>. 
And especially <a href="http://www.cssigniter.com/ignite/wordpress-poedit-translation-secrets/" rel="nofollow ugc">WordPress – Poedit: Translation Secrets</a>.
If you want your translation included in the next version of Photogallery, don’t hesitate and let me know.
<ol>
<li>Get <a href="http://poedit.net" rel="nofollow ugc">Poedit</a>.</li>
<li>Open the the pot file with Poedit and translate it.</li>
<li>Save a copy as e.g <code>kt-photogallery-fr_FR.po</code> in <code>/wp-content/plugins/kt-photogallery/language</code>. The mo-file will be created automatically by Poedit if you ticked the checkbox in the preferences.</li>
</ol>
PHP API
I have included a number of functions for fetching album, image and thumbnail IDs associated with a gallery or album. 
Please note that all methods starting with an underscore are considered internal and are not documented here. Although some are publicly accessible you should not use them directly unless you know what you are doing.
You do not have to create a new kt_Photogallery instance, there is already one in the global namespace. 
Access all public methods via <code>$kt_Photogallery</code>.
<ul>
<li>
<code>$kt_Photogallery->get_album_count ( [$gallery_ID] )</code> 
Returns the number of albums associated with a gallery 
Argument <code>int</code>|<code>null $gallery_ID</code> Optional – ID of a gallery. Defaults to the current ID if used inside the Loop 
Returns <code>integer</code>|<code>boolean</code> – Returns an integer on success, or <code>false</code> if <code>$gallery_ID</code> yields no gallery
</li>
<li>
<code>$kt_Photogallery->get_albums ( [$gallery_ID] )</code> 
Returns an array of album IDs associated with a gallery. 
Argument <code>int</code>|<code>null $gallery_ID</code> Optional – ID of a gallery. Defaults to the current ID if used inside the Loop 
Returns <code>array</code>|<code>boolean</code> – Returns an array of IDs on success, <code>false</code> if <code>$gallery_ID</code> yields no gallery
</li>
<li>
<code>$kt_Photogallery->get_image_count ( [$album_ID] )</code> 
Returns the number of images associated with an album 
Argument <code>int</code>|<code>null $album_ID</code> Optional – ID of an album. Defaults to the current ID if used inside the Loop 
Returns <code>integer</code>|<code>boolean</code> – Returns an integer on success, or <code>false</code> if <code>$album_ID</code> yields no album
</li>
<li>
<code>$kt_Photogallery->get_images ( [$album_ID] )</code> 
Returns an array of image IDs associated with an album. 
Argument <code>int</code>|<code>null $album_ID</code> Optional – ID of an album. Defaults to the current ID if used inside the Loop 
Returns <code>array</code>|<code>boolean</code> – Returns an array of IDs on success, <code>false</code> if <code>$album_ID</code> yields no album
</li>
<li>
<code>$kt_Photogallery->get_thumbnail ( [$album_ID, [$fallback] ] )</code> 
Returns the ID of the image (attachment) used as thumbnail for an album 
Argument <code>int</code>|<code>null $album_ID</code> Optional – ID of an album. Defaults to the current ID if used inside the Loop 
Argument <code>boolean $fallback</code> Optional – if <code>true</code> and <code>$album_ID</code> yields no album the method returns the ID of the first image associated with the album. Default is <code>true</code> 
Returns <code>integer</code>|<code>false</code> – Returns an integer on success, <code>false</code> if <code>$album_ID</code> yields no album, no thumbnail is set or a fallback could not been resolved
</li>
<li>
<code>$kt_Photogallery->get_thumbnail_src ( [$album_ID, [$fallback] ] )</code> 
Returns an ordered array with values corresponding to the (0) url, (1) width, (2) height and (3) scale of the thumbnail associated with an album. 
Argument <code>int</code>|<code>null $album_ID</code> Optional – ID of an album. Defaults to the current ID if used inside the Loop 
Argument <code>boolean $fallback</code> Optional – if <code>true</code> and <code>$album_ID</code> yields no album the method returns the ID of the first image associated with the album. Default is <code>true</code> 
Returns <code>array</code>|<code>false</code> – Returns an array on success, <code>false</code> if <code>$album_ID</code> yields no album, no thumbnail is set or a fallback could not been resolved
</li>
<li>
<code>$kt_Photogallery->register_album_design ( $key, $options )</code>
</li>
<li>
<code>$kt_Photogallery->register_gallery_design ( $key, $options )</code> 
Registers a custom design for albums and galleries respectively. 
The design will be available in the Design metabox during editing 
Returns <code>boolean</code> – returns <code>true</code> if the design was registered successfully, <code>false</code> on failure. 
Argument <code>string $key</code> Required – A key used as id inside HTML/CSS and for general identification 
Argument <code>callable</code>|<code>array $options</code> Required – A callback rendering the design on the frontend or an associative array:
<ul>
<li><code>string label</code> – The text for the label</li>
<li><code>string icon</code> – The image shown next to the label. Can be <code>dashicons-*</code>, an URL to an image or a base 64 encoded image</li>
<li><code>string title</code> – Text used inside the HTML title attribute, usually containing a description</li>
<li><code>callback render ($post, $options)</code> – Callback rendering the design on the frontend. The arguments passed are the current post as a WP_Post instance and an associative array of the options straight from the database</li>
<li><code>callback options ($current_options, $defaults, $post)</code> – Callback for additional form fields, should echo HTML. The arguments passed are an associative array of the options straight from the database, the default options as second argument and the current post as a WP_Post instance as third.</li>
<li><code>array defaults</code> – Associative array containing default values for options. Its keys are used during saving so you should generate HTML form fields using its keys and provide a callback for filtering.</li>
<li><code>callback filter ($current_options, $defaults, $post)</code> – Callback for filtering the options before they are saved. This callback is called every time a post is saved. The arguments passed are the default options merged with the values from the current request, the default options as second argument and the current post as a WP_Post instance as third. The callback must return an associative array otherwise no options are stored.</li>
</ul>
</li>
<li>
<code>$kt_Photogallery->render( [$auto_design] )</code> 
Main output method. Depending on the current post type the method prints out a design for a gallery or an album. 
Argument <code>boolean auto_design</code> optional – If set <code>true</code> and no design is found, take the first registered one and proceed. Default is <code>true</code> 
Returns <code>boolean</code> – Returns <code>true</code> on success, <code>false</code> otherwise
</li>
</ul>

Photogallery

Freemius

Serhii Pasyuk

<h4>Gallery Plugin</h4>
It’s not necessary to hire a developer to create a WordPress gallery. All you need is <a href="https://woowgallery.com/" rel="friend nofollow ugc">WoowGallery</a>, a drag & drop photo gallery plugin that’s EASY, FAST and POWERFUL.
WoowGallery is highly optimized for web and server performance because we understand the importance of speed when it comes to image and gallery load times, as well as SEO and conversion. 
With WoowGallery you can show the blog posts on your website and display them in a masonry layout with tags filter. You can customize the way your posts look and manage settings like the featured image, the content you want to display, etc. 
WooCommerce Products in a masonry layout looks fantastic. You can show any post type in a gallery with a link to their pages.
<blockquote>
Free version includes everything you need and expect from the gallery: 
 albums, tags, social media integration, various templates and layouts, lazy load, content galleries with your posts, dynamic galleries, and tons more.
</blockquote>
And with our widget you can put your best work anywhere on the page. Easily add it to your page via Elementor Editor, Classic Editor, Gutenberg or any other editor which support widgets or shortcodes.
<h4>Drag & Drop Builder</h4>
WoowGallery adapts to your workflow and allows you to create in minutes. By using our easy to use drag and drop builder, you can upload your photos, rearrange them, and create an impressive gallery with just a few clicks.
You can also create and edit right from the WordPress Gutenberg block editor. 
If you’ve struggled with complex plugins that take video tutorials to learn, you’re going to love WoowGallery.
<blockquote>
With WoowGallery Premium you can 
 create WooCommerce integrations, create Standalone gallery pages, add Standalone views inside Dynamic galleries, create presets for skins, etc.
</blockquote>
<h4>Mobile Ready, SEO Friendly and Optimized for Speed</h4>
Our solution is 100% responsive and mobile-friendly by default. We optimized every query on the front-end and the back-end to ensure maximum speed.
<h4>Sharing and Selling Photos Made EASY</h4>
Social media integrations, and WooCommerce store integration.
<h4>Built-in Feature List</h4>
<ul>
<li>Gutenberg Blocks for WordPress 5.0+</li>
<li>Drag & Drop Photo Gallery Builder</li>
<li>100% Responsive – Mobile Friendly</li>
<li>Beautiful Skins for Customization</li>
<li>Albums – Easily organize your collections, choose cover photos, and more.</li>
<li>Featured Content Gallery – Easily create displays based on posts, pages, products, testimonials, portfolios, and other custom post types.</li>
<li>Dynamic Gallery – Create content from various different sources (WordPress, Flagallery…). Show specific media category or folder from other plugins like: “Media Library Assistant”, “FileBird”, “Real Media Library”, etc.</li>
<li>Video Support – Not just for photos! You can add local videos and link your photos with video from YouTube and Vimeo.</li>
<li>Slideshow – Add beautiful slideshows with autoplay, manual controls, and more.</li>
<li>WooCommerce Product Integration – Replace default WooCommerce product display template with our skin.</li>
<li>Image Tags – Organize your WordPress photos with tags for easy search and display that are also filterable.</li>
<li>Social Sharing – Share your photos on Facebook, Twitter and Pinterest.</li>
<li>Image Protection – Protect your images from theft by disabling right mouse click.</li>
<li>Lazy Load – Load large collections with lazy loading to improve page speed and user experience.</li>
<li>Deeplinking – Make your content SEO friendly and easily link to individual items.</li>
<li>FullScreen Display – Take advantage of the native fullscreen and Lightbox display.</li>
<li>Photo Zoom – Zoom images for up close browsing.</li>
<li>EXIF Meta Data – Display your EXIF data including camera model, aperture, shutter speed, and more.</li>
<li>Downloads – Ability to download your images and collections with an easy to use download button.</li>
</ul>
<h4>Premium Feature List</h4>
<ul>
<li>WooCommerce Integration – Instantly display and sell your photos with the most popular eCommerce software on the web.</li>
<li>Standalone Gallery – Create independent galleries that are not tied to your posts.</li>
<li>Password Protection – Prevent unauthorized access to your standalone galleries.</li>
<li>Skin Presets – Speed up the creation process by saving your default settings.</li>
<li>Custom CSS Styles – Customize your portfolio by adding custom CSS and styles.</li>
<li>Want us to add something else? Suggest a feature and we’ll get it added!</li>
</ul>
<blockquote>
When it comes to WordPress media plugins, WoowGallery has no equal.
</blockquote>
<h4>Demos</h4>
Amron skin:
<ul>
<li><a href="https://woowgallery.com/examples/simple-photo-gallery/" rel="friend nofollow ugc">Simple Photo Gallery</a></li>
<li><a href="https://woowgallery.com/examples/woowgallery-albums/" rel="friend nofollow ugc">Albums Display</a></li>
<li><a href="https://woowgallery.com/examples/woocommerce-dynamic-gallery/" rel="friend nofollow ugc">WooCommerce Showcase</a></li>
</ul>
MultiGrid skin:
<ul>
<li><a href="https://woowgallery.com/examples/youtube-gallery/" rel="friend nofollow ugc">YouTube Video Display</a></li>
<li><a href="https://woowgallery.com/examples/urban-grid/" rel="friend nofollow ugc">Grid Layout</a></li>
<li><a href="https://woowgallery.com/examples/justified/" rel="friend nofollow ugc">Justified Layout</a></li>
<li><a href="https://woowgallery.com/examples/urban-masonry/" rel="friend nofollow ugc">Masonry Layout</a></li>
</ul>

WoowGallery

Я хочу поблагодарить всех, кто принимал участие в разработке этого плагина. Он вышел очень классным и, я надеюсь, у этой галереи будет много поклонников. Также, спасибо всем, кто будет оставлять положительные отзывы, которые вдохновляют разработчиков совершенствовать свой продукт и дальше.

I want to thank everyone who participated in the development of this plugin. It came out to be very cool and, I hope, this gallery will have many fans. Also, thanks to everyone who will leave positive feedback that inspire developers to improve their product further.

Спасибо всем! Thank you all!

Fastest, easiest to use multifunctional image gallery plugin. Create Featured Posts Gallery, Dynamic Content Gallery, Albums!

Photogallery vs WoowGallery