Photogallery
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. Create two php files inside your theme’s directory: single-photogallery.php and single-photoalbum.php. single-photogallery.php gets called everytime a gallery is about to be viewed single-photoalbum.php gets called everytime a album is about to be viewed Now you have two options. You can register a custom design inside your theme’s function.php via e.g $kt_Photogallery->register_gallery_design() and call $kt_Photogallery->render() at an appropriated place inside your single-photogallery.php to render it depending on the user’s choice. You fetch albums, images and thumbnail details, and render consistent HTML for all albums and galleries. Refere to the PHP API section for further details on how to retrieve album IDs, image IDs and thumbnail details. Example A basic example for a custom gallery design # 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 ' '; if ($album_thumbnail) { echo ' '; } echo ' '; } } 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 ' '; } } } else { printf(__('The album %s does not contain any images', 'my-textdomain'), esc_html($post->post_title)); } } Basic integration into Twenty Fifteen: # single-photogallery.php or single-photoalbum.php get_header(); ?> ', ' '); ?> render(); ?> get_album_count ( [$gallery_ID] ) Returns the number of albums associated with a gallery Argument int|null $gallery_ID Optional – ID of a gallery. Defaults to the current ID if used inside the Loop Returns integer|boolean – Returns an integer on success, or false if $gallery_ID yields no gallery $kt_Photogallery->get_albums ( [$gallery_ID] ) Returns an array of album IDs associated with a gallery. Argument int|null $gallery_ID Optional – ID of a gallery. Defaults to the current ID if used inside the Loop Returns array|boolean – Returns an array of IDs on success, false if $gallery_ID yields no gallery $kt_Photogallery->get_image_count ( [$album_ID] ) Returns the number of images associated with an album Argument int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Returns integer|boolean – Returns an integer on success, or false if $album_ID yields no album $kt_Photogallery->get_images ( [$album_ID] ) Returns an array of image IDs associated with an album. Argument int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Returns array|boolean – Returns an array of IDs on success, false if $album_ID yields no album $kt_Photogallery->get_thumbnail ( [$album_ID, [$fallback] ] ) Returns the ID of the image (attachment) used as thumbnail for an album Argument int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Argument boolean $fallback Optional – if true and $album_ID yields no album the method returns the ID of the first image associated with the album. Default is true Returns integer|false – Returns an integer on success, false if $album_ID yields no album, no thumbnail is set or a fallback could not been resolved $kt_Photogallery->get_thumbnail_src ( [$album_ID, [$fallback] ] ) 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 int|null $album_ID Optional – ID of an album. Defaults to the current ID if used inside the Loop Argument boolean $fallback Optional – if true and $album_ID yields no album the method returns the ID of the first image associated with the album. Default is true Returns array|false – Returns an array on success, false if $album_ID yields no album, no thumbnail is set or a fallback could not been resolved $kt_Photogallery->register_album_design ( $key, $options ) $kt_Photogallery->register_gallery_design ( $key, $options ) Registers a custom design for albums and galleries respectively. The design will be available in the Design metabox during editing Returns boolean – returns true if the design was registered successfully, false on failure. Argument string $key Required – A key used as id inside HTML/CSS and for general identification Argument callable|array $options Required – A callback rendering the design on the frontend or an associative array: string label – The text for the label string icon – The image shown next to the label. Can be dashicons-*, an URL to an image or a base 64 encoded image string title – Text used inside the HTML title attribute, usually containing a description callback render ($post, $options) – 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 callback options ($current_options, $defaults, $post) – 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. array defaults – 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. callback filter ($current_options, $defaults, $post) – 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. $kt_Photogallery->render( [$auto_design] ) Main output method. Depending on the current post type the method prints out a design for a gallery or an album. Argument boolean auto_design optional – If set true and no design is found, take the first registered one and proceed. Default is true Returns boolean – Returns true on success, false otherwise
Top keywords
- album52×4.00%
- id42×3.23%
- gallery26×2.00%
- returns24×1.85%
- image23×1.77%
- post20×1.54%
- design19×1.46%
- array18×1.39%
- kt17×1.31%
- album id16×1.23%
- options16×1.23%
- kt photogallery-15×1.15%
Photo Gallery, Sliders, Proofing and Themes – NextGEN Gallery
WordPress Gallery Plugin NextGEN Gallery has been the industry’s standard WordPress gallery plugin since 2007 and continues to receive over 1.5 million new downloads per year. It’s easy to use for simple photo galleries, but powerful enough for the most demanding photographers, visual artists, and imaging professionals who need a comprehensive photo gallery solution. NextGEN Gallery offers complete WordPress gallery management with the ability to batch upload photos, import metadata, easily add, delete, rearrange photos and create an unlimited number of galleries. You can even simply provide a zip file or choose a folder to upload photos. But our photo gallery plugin doesn’t stop there! NextGEN Pro This plugin is the lite version of the NextGEN Gallery plugin, which offers all the gallery features you’ll need like photo albums, lightboxes, backups, search, sharing, filtering, print fulfillment, eCommerce, animations, and tons more. Click here to purchase the best photo gallery plugin for WordPress now! The free version of NextGEN gallery provides three main gallery styles (slideshow, thumbnail, and imagebrowser galleries) and two album styles (compact and extended), all of which come with a wide array of options for controlling size, style, timing, transitions, controls, lightbox effects, and more. Learn more about NextGEN WordPress Gallery Plugin features. The best gets better with full support for the Gutenberg block editor. Now you can add a photo gallery or album anywhere on your site, with a page builder type feel directly in the WordPress editor. We truly make creating, building, and editing galleries easy. Feature List We’ve built NextGEN Gallery to be extremely powerful and full of features. Albums Organize multiple photo galleries into albums for easy sorting and viewing Tags Group multiple images together with tags, with easy-to-update renaming and management eCommerce Sell images from your photo gallery, or sell entire galleries with our built in payment processing. Works with Stripe and PayPal. Slideshows Make your galleries automatically rotate through a series of images Themes Access 84+ different types of themes to showcase your galleries Animations Create visual interest with 25+ different types of animations for each gallery Watermarks Protect your work with image and text-based watermarks. Capabilities Customize who can read, edit, and publish galleries with refined permsisions controls Image Proofing Let your customers choose which photos to purchase and improve your workflow. Print Fulfillment Sell your photos and ship prints directly to customers with automated print lab fulfillment and zero commissions Auto Tax calculations Automatically calculate sales tax when required for your customers. Coupons Offer discounts and incentives to increase your gallery sales Lightroom Integration Automatically sync and create photo galleries from Adobe Lightroom into NextGEN Gallery without any need to update your website. Social Sharing Create viral social media opportunities when your images are optimized for Open Graph and X Image Commenting * Add deep engagement to your images within the lightbox to increase gallery engagement Deep Linking Link directly to a specific image from one of your galleries Frontend Search * Add powerful filtering for your gallery based on tags Hover Captions * Add social sharing, tiles, and descriptions for each image Digital Downloads Offer digital downloads of your images for free, or chage for them with our eCommerce gallery plugin Right Click Disable prevent images in your galleries from being downloaded with easy right click and drag/drop protection. Customization * We’ve built in lots of individual customizations for each of our features so that you can make NextGEN Gallery perfect for you As you can see, we’ve built a photo gallery plugin that is suitable for everyone! Want a specific or missing feature? Just let us know. NEXTGEN GALLERY DEMOS *Basic Thumbnail Gallery *Basic Slideshow Gallery *Basic Imagebrowser Gallery *Basic Compact Album *Basic List Album NEXTGEN PRO DEMOS *Photo Print Sales *Photo Proofing *Digital Downloads *Pro Mosaic Gallery *Pro Masonry Gallery *Pro Tile Gallery *Pro Filmstrip Gallery *Pro Lightbox About Imagely NextGEN Gallery is a WordPress gallery plugin maintained by Imagely. We’re the WordPress photography experts. In addition to NextGEN Gallery, NextGEN Plus, and NextGEN Pro, we also make WordPress themes for photographers, providing beautiful turnkey websites for photographers. Learn more or connect with us: *Imagely Website *WordPress Themes for Photographers *Turnkey Photography Sites *NextGEN Gallery Documentation Credits Copyright: Imagely 2016-2024 Shortcodes NextGEN Gallery offers an easy-to-use Insert Gallery Window, which means you never need to work with shortcodes again when inserting and manageing galleries – if you would prefer not too. If you do want to work with shortcodes, there is a powerful shortcode system as you’d expect of a popular WordPress gallery plugin. Learn About NextGEN Gallery Shortcodes. For more information, feel free to visit the official website for the NextGEN Gallery WordPress Gallery Plugin.