Extra Gallery

Downloads: 8966
Category: Plugin
Compatible with: GetSimple 3.3 - 3.3

Last Updated: February 22, 2018
Tags: gallery multi language cropping thumbnail images galleries extra
Author: mganko
Author Website: http://flexphperia.net/
Support: Support Forum

(3.4) 20 Votes

Plugin Description:

Extra Gallery is a backend plugin for creating galleries, with advanced features like: custom fields, thumbnails cropping, multi language content, easy image browsing. It can be installed in GS more than once (multi instances) to use it with different settings on each copy. Created galleries are available as structured PHP arrays to use in theme.

Version history:

1.09 - fixed some bugs: renumbering rows after row removal, adding first image broken, thumbnail sizes wrong
1.08 - new security settings, allows you to lock specified galleries for deletion and disable creating new galleries
1.07 - added buttons that allows to add images between rows
1.06 - bug fixes, added image rows numbers
1.05 - bug fixes
1.04 - bug fixes
1.03 - new image size validator: validate image width or height by specified ranges
1.02 - some bug fixes, when no thumbnail do not display partial filename path
1.01 - some bug fixes, new gallery image resolution validation
1.00 - initial upload

Configuration description:

Gallery title - if not disabled it will be displayed on gallery list.

Gallery name - unique name of gallery.

Languages - provide languages key names to turn on multilanguage edition of gallery title and custom fields.

Additional info - use it to show some important informations for users when in gallery edition.

Fields - you can define custom fields for gallery items. Available field types: text, textarea, select, checkbox, WYSIWYG editor.
Every field can be set as required and have its own label displayed next to it.

Thumbnails - up to 2 thumbnails can be enabled. User can create thumbnail by cropping image selected image.
Every thumbnail can be set as required, and have its own label. There is also possibility to set its width and height, both of it or any of them.
Thumbnail can be set to be automatically cropped when image is added to gallery.

How Extra Gallery data is stored:

All data is stored in ExtraGallery directory in GS data dir.
Subfolders description:
admin-thumbs - cache for preview thumbnails displayed in gallery and in image browser used to add gallery images. When source image is deleted via GS file tab also its thumbnail is deleted.
galleries - xml files with galleries.
settings - xml files with gallery settings
thumbs - all thumbnails created by cropping image via plugin interface. Unused thumbnail files are automatically deleted when gallery is saved or deleted.

Plugin multi instancing:

If you wish to have more than one Extra Gallery tab, follow these instructions:

  • Duplicate main Extra Gallery file (ExtraGallery.php) and name it like this: ExtraGallery-1.php where "1" is a number of instance. Use only numbers greater than 0 as instance numbers.
  • Activate new plugin in GS plugin tab.
  • New link to new plugin instance configuration should apear.

Accessing galleries in your theme:

To return gallery array use function call:

eg_return_gallery($name = null, $language = null, $instanceNum = 0)

Parameters: $name - gallery name to return, or null value to return all galleries in associative array.
$language - language key as definied in plugin configuration, if not provided it will return first defined labguage.
$instanceNum - plugin instance number, if not provided it will be first instance.

Returned array is self-explanatory:

array(3) {
  ["name"]=>
  string(7) "galeria"
  ["title"]=>
  string(4) "Test"
  ["items"]=>
  array(1) {
    [0]=>
    array(10) {
      ["filename"]=>
      string(27) "uploads/galeria-foty/01.jpg"
      ["width"]=>
      int(1050)
      ["height"]=>
      int(740)
      ["thumb-0"]=>
      array(3) {
        ["filename"]=>
        string(52) "ExtraGallery/thumbs/galeria-foty/01-fill-200-300.jpg"
        ["width"]=>
        int(200)
        ["height"]=>
        int(300)
      }
      ["thumb-1"]=>
      array(3) {
        ["filename"]=>
        string(0) "ExtraGallery/thumbs/galeria-foty/01-10-0-200-300-200-300.jpg"
        ["width"]=>
        int(100)
        ["height"]=>
        int(150)
      }
      ["field-0"]=>
      string(10) "Test text"
      ["field-1"]=>
      string(4) "text"
      ["field-2"]=>
      bool(true)
      ["field-3"]=>
      string(0) ""
      ["field-4"]=>
      string(0) ""
    }
  }
}

Translations:

  • English
  • Polish

Screenshots:

image

image

image

image

image

image

Install Instructions:

  • Unpack zip archive to your plugins folder
  • Enable the plugin in GS Admin

Archived Versions:

These are old versions of this file. Please use with caution as they are probably out of date and no longer supported. ShowHide