manifest / media / sha-simple-gallery

Simple CPT Gallery

Gallery for posts/pages based on Custom Post Types

by Andrew Sh · github.com/ndrew-sh/sha-simple-gallery

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/ndrew-sh/sha-simple-gallery/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/ndrew-sh/sha-simple-gallery ↗

Simple image gallery based on Custom Post Types/Taxonomy and Fancybox

This plugin allow to create simple gallery and output it with shortcode or Gutenber block.

Installation
Usage
Customization
Filters

Installation

Clone this repo or upload and unzip archive to wp-content/plugins directory. Enable plugin.

Usage

Under admin area, go to CPT Gallery.
Add Gallery. Each gallery supports number of images per row, thumbnail size (customizable) and gallery name/description display.
Add Images. Plugin use post Featured image as gallery image. To change images order in gallery, set post date (images ordered by date).
Use shortcode [cptgallery id=GALLERY_ID] (or copy it from Galleries page) on any page/post. For Gutenberg editor, add gallery block from SHA Plugins group.

Customization

If you want to add your own thumbnail size, use WP add_image_size() function.
To override gallery template, copy public/templates/elements/shortcode.phtml from plugin folder to sha-simple-gallery/shortcode.phtml in your theme folder.

Filters

sha_sgal_settings

Override default gallery settings.

$default_settings = array(
  'default'               => 4,
  'variants'              => array(
      '2' => __( '2 images', 'sha-sgal' ),
      '3' => __( '3 images', 'sha-sgal' ),
      '4' => __( '4 images', 'sha-sgal' ),
      '5' => __( '5 images', 'sha-sgal' ),
      '6' => __( '6 images', 'sha-sgal' )
  ),
  'default_thumb_size'    => 'medium',
  'default_full_size'     => 'large',
  'load_js'               => true,
  'load_css'              => true,
  'fancybox_css'          => 'https://cdn.jsdelivr.net/npm/@fancyapps/ui@6.0/dist/fancybox/fancybox.css',
  'fancybox_js'           => 'https://cdn.jsdelivr.net/npm/@fancyapps/ui@6.0/dist/fancybox/fancybox.umd.js'
);

default - default amount of pictures per row
variants - possible amounts of pictures per row in amount => label format
default_thumb_size and default_full_size - size of the thumbnail and full picture (add your with add_image_size())
load_js and loac_css - load plugin styles and scripts (you can disable loading if you want to use them in your own files)
fancybox_css and fancybox_js - CDN styles and script for Fancybox Lib

sha_sgal_cpt_labels

Override labels in register_post_type().

sha_sgal_cpt_tax_labels

Override labels in register_taxonomy().

sha_gallery_block_data

Override data, sent to Gutenberg block.