Skip to content
This repository has been archived by the owner on Jun 4, 2019. It is now read-only.

senlin/so-simple-gallery

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SO Simple Gallery

plugin version

May 14, 2016: No longer in active development, use at own risk

Last updated on 2016.4.23
requires at least WordPress 4.4
tested up to WordPress 4.5
Author: Piet Bos
Stable Version (via WordPress Plugins Repository)
Plugin homepage with Live Demo

The SO Simple Gallery plugin gives you a mini gallery with a beautiful CSS rollover effect using a simple shortcode.

Description

Inspired by a LinkedIn discussion and the Simple CSS Roll-over Image Gallery tutorial by Dudley Storey I decided to cook up the concept of it in a plugin.

It works with a Simple Gallery custom post type to which you can upload a maximum of 8 images using the Meta Box plugin. This is my 3rd "extension" for that plugin, which - if you have not yet installed it - will be semi-automatically added to your Plugins folder; just follow the on-screen instructions.

Once you have added images to your Simple Gallery you can add it to your Post or Page using a simple shortcode. This shortcode shows after you have published or updated the Simple Gallery. And you can also find the shortcode on the main Simple Galleries screen.

When you use the Visual Editor you will find a nice shortcode button that by clicking it adds [so-simple-gallery id=""] to your Post or Page content. Between the double quotes you only have to fill in the ID of the Simple Gallery you would like to add.

If you use the Text Editor instead, you can copy the shortcode from the main Simple Galleries screen and paste it into your Edit Post/Page screen.

If you would like to add a gallery to a template file, then you need to add the following code to it:

<?php if ( function_exists( 'sosg_shortcode' ) ) {
	echo do_shortcode( '[so-simple-gallery id="123"]' );
} ?>

where 123 is the ID of your Simple Gallery.

I used a dashicon to add a button to the Visual Editor and therefore you can use the SO Simple Gallery from WordPress version 3.9 and up (as that is the version where TinyMCE 4.x was rolled into Core).

Frequently Asked Questions

Why is the plugin showing an error message after activation?

This plugin is an Extension for the Meta Box plugin. If you don't have that installed, this plugin will not work. If you click on the link that shows with the error message you will go to a new page "Required Plugin" to install the Meta Box plugin.

I have an issue with this plugin, where can I get support?

Please open an issue here on Github

Known Limitations

  • The SO Simple Gallery looks best with a maximum of 5 landscape images OR when using portrait style image between 6 and 8 images.
    Mixing portrait and landscape image in one gallery is not a good idea.

  • If you are uploading images with different sizes then it is best to put the shortest images as the top image.
    The reason for that is that the first image always shows (to create the placeholder image), so even when you hover over the other images, that first image is still there.
    This can be solved with some javascript, but I first want to see if there are enough people that like this plugin, before I develop it further.

  • I have not yet included any Options to change things like size, background color, text color, add titles and what not.
    Again I would like to wait and see if there are enough people that like this plugin, before I develop it further.

  • Depending on what theme you use, adding a SO Simple Gallery to a full-width template does not always look great.

Contributions

This repo is open to any kind of contributions.

License

Donations

Connect with me through

Github

WordPress

Website

Changelog

1.3.0 (2016.4.23)

  • rewrite shortcode function and implement srcset
  • remove Aqua Resizer script, redundant now
  • adjust minimum version to WP 4.4
  • tested up to WP 4.5

1.2.0 (2015.12.17)

  • update TGM-Plugin-Activation class to 2.5.2 fixes issue #2

1.1.5 (2015.11.20)

  • revert to semantic versioning
  • [BUG FIX] fixed bug that visually removed the edit permalink from all post/page edit screens, should only be on simple gallery post type.

1.1.4 (2015.04.23)

1.1.3 (2015.04.09)

  • changed logos
  • new banner image for WP.org Repo by Kyle Szegedi

1.1.2 (2014.07.30)

  • added the check for the metabox plugin (all files were there, but had forgotten to build the check for it in)
  • get rid of ob_end_flush() error that sometimes occurs
  • tested up to WP 4.0-beta-2

1.1.1 (2014.05.08)

  • polishing
  • add documentation
  • add FAQs
  • add language file
  • add screenshots

1.0 (2014.05.04)

  • initial release

Screenshots

Add/edit Simple Gallery.

Simple Galleries main screen with shortcodes of existing galleries (backend).

Demo SO Simple Gallery (frontend).

Upgrade Notice

1.1.5 (2015.11.20)

  • revert to semantic versioning - this means that the update doesn't show in your Dashboard, because 2015.04.23 is a higher number than 1.1.5. There really is no other good way to do this other than to remove the plugin from the Repo and admit it again using a different name. That also would not help you as the plugin still would not show an update in your Dashboard. Therefore, many apologies for the inconvenience.

About

With the SO Simple Gallery plugin you can add a beautiful gallery to your Posts or Pages with a simple shortcode.

Resources

Stars

Watchers

Forks

Packages

No packages published