Global Gallery

Documentation for v6.3 and later


Introduction

Before going through documentation chapters, thanks for purchasing Global Gallery and trusting LCweb!

Need further help?

Open a ticket

Need a customization?

Ask for a quote

Installation

Settings Overview

The first step in order to use the plugin is check and save settings.
They are arranged and split to be as easy as possible to be configured. Each field has got its description giving contextual help.

The most important thing is to be sure plugin is ready to create thubmnails.
In first settings tab, last section is about Easy WP Thumbs status. Facing issues, please check the related FAQ

Various parts are going to be analysed through this documentation chapters.
On the very first installation there are three essential parts to check:

Elements maximum width

Is the variable used to calculate thumbnail sizes. Is important to set it properly, using the real maximum width where you're gonna place Global Gallery elements.

To avoid huge images by default it is set to 1200 pixels, but if you are using (for example) a fullwidth template, the proper value will be 1920px.

Layouts Section

Here you setup global gallery shapes for every layout. Image sizes can be changed individually (in gallery builder) while margins are fixed.

Is also important to understand how percentage height works (eg. for collection image): it is always referred to images width.
For example if they are 200px wide and you set an height of 50%, resulting images will be 100px high

Styling Section

It controls everything about galleries aspect: from overlays to filters.
You can take advantage of the 8 preset styles though: using them you'll override every styling option.

Additional Notes

Use thumbnails on admin side?

Global Gallery, by default, disables thumbnails on admin panel. This to avoid server overloads, specially on large galleries.
Enable it if your server is powerful or using few images per gallery.

Disable deeplinking?

Controls collection deeplink behavior. Should be enabled only if your theme already uses deeplinks

Use javascript in website's head?

Use this only if you are noticing some incompatibility

RTL mode?

Option to be used on RTL websites (for example hebrew ones)

Gallery Categories

Before creating galleries you may create categories to be assigned later.
They are optional and used by gallery collections.

Galleries Creation

In following sub-chapters you will learn how to create galleries using various sources.
However there are some common notes applying globally:

Desktop-like images selection

Remember you can bulk-select multiple images simply keeping the mouse clicked. As you'd do on your desktop

Thumbnails center

Every image added to the gallery has got a command to set its thumbnail's center

Easy-sorting mode

Sorting images could be a pain, specially if you have large galleries.
In builder's right column there's the "Easy sorting mode" button, changing builder's layout to be easier sorted.

Images link

You can turn gallery images in links. Linked images won't be opened in lightboxes.
Links behavior is set globally, in settings.

galler
Images frontend sorting

Is also possible to set a custom sorting for frontend images sorting.
Please note date sorting is available only for WP-based sources since bases onn images ID.

galler
Gallery preview
Gallery must be saved before checking its preview

WP Media Library

It's the default source, simply listing WP Media Library images.
Be careful to not delete images added to galleries or they won't load anymore!

It's surely the most direct way of creating a gallery but in most cases it's not the best options.
Often media library contains a lot of mixed site images then could be hard to find what you are searching for quickly.

WordPress Category

This source requires you to select a posts category.
Images will be fetched from posts belonging to that category

WordPress CPT Taxonomy

Similar to WP category, this source will scan your WP installation for taxonomies belonging to custom post types.
A good example are WooCommerce product categories.

Global Gallery Album

To avoid troubles updating the plugin, is strongly suggested to use a different galleries container folder.

In plugin settings, you can set a custom basepath where to pick images.
Be careful with these settings, base path and base url must be very precise. Path is relative to the server's one

Namespaces
Rember to use a proper namespace for albums folder name and images. Replace spaces with underscores and avoid special characters.
FTP alternative
FTP is surely the most straightforward way to use this source. However not everyone is able to manage FTP accesses or simply not everyone has got an FTP access.
You can use any WordPress plugin acting like files manager as a swift alternative. LIKE THIS
IPTC data
The plugin can handle image infos from IPTC data. System been tested with windows/osx properties editor and Adobe Lightroom

Flickr

Actually the plugin can fetch PUBLIC images.
There are multiple integrations:

Subject Example
user's set/album URL https://www.flickr.com/photos/lucastrings/albums/72157629032261075/
user's photostream URL https://www.flickr.com/photos/lucastrings/
tag URL https://www.flickr.com/photos/tags/landscape/

Instagram

Since June 2016 plugin's API only allows to fetch personal images. You can exclusively show your images with your token.

  1. Insert your instagram username
  2. Click on "Get your Instagram token" and authorize the app
  3. You will be moved to LCweb website. Pay attention to page URL, it contains your access token
  4. Copy the access token (eg. 219999952.7fc8464.4e999934dc54930a4ddeb4a2ea74cb1) and paste it in the related field
  5. Click on "connect"

Unfortunately Instagram returns only last images. To create larger galleries, use the auto-population system

Pinterest

Simply insert the board URL you want to fetch images from (eg. https://www.pinterest.it/dribbble/animation-inspiration/)

Unfortunately Pinterest returns only last 50 images. To create larger galleries, use the auto-population system

Facebook Pages

The Facebook page must be public to be connected to Global Gallery

  1. Click on manage connections, then on "add connection"
  2. Insert a name to identify the connection and then the page's URL
  3. Click on "submit"
  4. Connections dropdown will be reloaded and you will be able to select your newly created connection

Google+

Google+ source requires PHP 5.4 or later

  1. Click on manage connections, then on "add connection"
  2. Insert a name to identify the connection and your Google username (typically a Gmail e-mail address. The one you use for Gmail or Google+ for example)
  3. Click on "Get your Google+ token" and authorize the app
  4. You will be moved to LCweb website. Pay attention to page URL, it contains your access token
  5. Copy the access token (eg. 4%2FfgBnB2zlangcjdjlLw6c4a9pTweJfC_zRYSZd2shwhpLrUJXeD5eGkgPAUwFhcLAkC_MdY6d99fE8spSnKDncLR&scope=https%3A%2F%2Fpicasaweb.google.com%2Fdata%2F) and paste it in the related field
  6. Click on "submit"
  7. Connections dropdown will be reloaded and you will be able to select your newly created connection

Google Drive

Google+ source requires PHP 5.4 or later

Before connecting to your Drive you must:

  1. Create a folder IN ROOT named "globalgallery"
  2. Create subfolders (albums) and upload images. Subfolders name is totally up to you
  3. (IMPORANT) Use right click on every folder and element to set them public

Then:

  1. Click on manage connections, then on "add connection"
  2. Insert a name to identify the connection and your Google username (typically a Gmail e-mail address. The one you use for Gmail or Google+ for example)
  3. Click on "Get your Google+ token" and authorize the app
  4. You will be moved to LCweb website. Pay attention to page URL, it contains your access token
  5. Copy the access token (eg. 4%2FfgBnB2zlangcjdjlLw6c4a9pTweJfC_zRYSZd2shwhpLrUJXeD5eGkgPAUwFhcLAkC_MdY6d99fE8spSnKDncLR&scope=https%3A%2F%2Fpicasaweb.google.com%2Fdata%2F) and paste it in the related field
  6. Click on "submit"
  7. Connections dropdown will be reloaded and you will be able to select your newly created connection

Twitter

You can fetch images from:

user profiles remember to use the @ (eg. @_LCweb)
hashtags remember to use the # (eg. #lcweb)

Tumblr Blog

Just use the tumblr's website URL

Real Media Library

Global Gallery integrates with Real Media Library plugin.

  1. The plugin must be installed and you must have at least one folder
  2. Select it as gallery source
  3. Select the folder you want to use as source

NextGEN Gallery

Global Gallery integrates with NextGEN Gallery plugin.

  1. The plugin must be installed and you must have at least one gallery
  2. Select it as gallery source
  3. Select the gallery you want to use as source

RSS Feed

Just insert the RSS URL.
RSS structure must be valid to be properly handled.

Automatic Gallery Creation

Image Tags Filter

Each gallery image can be tagged: insert comma split tags in the related field and they will be used to setup a filtering system.
Please note this feature is not available for auto-populated galleries, since requires a manual immission.

imag

Once saved, be sure to have filters enabled in the Gallery Shortcode (check the related documentation's chapter to know more) and you will see those tags grouped and appearing on top of the gallery images.

imag

There are several tag aspects that can be managed in plugin settings: for example their sorting method or whether to show matched images count or also whether to ignore tags matching very few images (to avoid too many tag buttons).

In particular you can choose whether to perform the filter only on shown images or to search across pages.

WP Galleries Integration

Gallery Collection

You can wrap existing galleries into collections: a smart and quick way to group and filter them in a unique context.

  1. Click on a gallery image to add it to the collection
  2. You can optionally set it to have random images, display tags or also show watermarked images
  3. Optionally you may also link the gallery thumbnail. Obviously linked galleries won't bring to their images
  4. Also description is optional. It may contain HTML and the %IMG-NUM% placeholder, showing gallery images count
  5. By default the collection shows the first gallery image on its intial state. However you can also set a custom picture to represent the gallery

Lightboxes

Global Gallery offers you many lightboxes to display your images with.
Into settings, there's a specific tab to choose the one to be used and, accordingly to your choice, customization fields will be shown.

Lightboxes list:

LC-Lightbox Comments

Supported systems are Disqus and Facebook Comments

Disqus

Integration is really simple: just insert the shortname. Style, moderation and details are managed directly on Disqus

Facebook Comments

This requires multiple steps and more skills:

  • create a new app and paste its ID into the related field
  • Global Gallery inserts the Facebook meta into the website to link comments to your app
  • before launching comments, be sure to have set moderators here clicking on "settings"
    fb moderators

  • If everything is ok, moderators will see the moderation label on top of comments form and you will receive notifications through the app

Shortcodes

Global Gallery is also natively integrated with Elementor, Visual Composer and Cornerstone.
Using them you can skip the standard shortcode wizard and use the related plugin's tool.

From version 6.4 shortcode's wizard button has been moved among editor buttons to guarantee Gutenberg compatibility. Using Gutenberg, just add a "classic" block and use the shortcode wizard.

Shortcode wizard's button is placed right on top of every wordpress editor (managing pages, posts, etc)

shortcod

Gallery

Choose the gallery you want to use and click on "Insert Gallery".

Collection

Choose the collection you want to use and click on "Insert Collection".

Image-to-Gallery

This is a special shortcode showing a small image box, launching an entire gallery.

Before explaining how to insert it into your website would be better to understand how you can manage texts over shown images. Here are system-related options in settings page:

it

You can use a mix of

  • Plain text
  • HTML (then any FontAwesome icon)
  • Two special placeholders: %IMG-NUM% (showing gallery images count) and %GALL-TITLE% (showing gallery's title)

Once you understood this point, click on Global Gallery shortcode's wizard (explained in the related chapter) and select "image-to-gllery" from the dropdown.

itg shortcode

How many images to display?

Determines how many gallery images to show. The selected layout will be applied adapting to this number with only one exception:
"Main image with central overlay + two smaller on sides" layout will always show 3 images.

Images Width

This depends on "Box Width" and "How many imaegs" parameter. In fact, showing more than one image, they will be placed on two columns.
Then showing two images and setting a box width of 300px, you will have two 150px images.

Percentage Images Height

It is always referred to images width ans is useful to maintain the same aspect ratio also on small screens.
For example if your images are 300px wide and you set an height of 50%, they will be 150px high.

Custom overlay text

Here you can set a custom text for this specific implementation.
Supports everything has been explained before (text + HTM + placeholders)

Slider

Before explaining how to insert a slider, is important to check its settings: there you can manage global behaviors and how slider will look.

slide

Once everything's ok, click on Global Gallery shortcode's wizard and select "slider" from the dropdown.
Then just insert it chosing how you prefer it to be shaped.

slider settings

Just a quick note about slider's height: percentage value is always referred to slider width.
Useful to maintain the same aspect ratio also on small screens.

For example if you set an height of 50% and slider is 1000px wide, it will be 500px high.

Watermark System

The watermarking process is quite heavy and creates an exact copy of the original image on your server. Be careful using it on weak servers or having few available memory.

It also requires direct read/write permissions on your server: be sure to not have restrictions set by your hoster. Watermarked images will be cached in ../wp-contents/uploads/gg_watermarked

In plugin settings you find a related tab where to setup watermark:

watermar

A quick note about proportional sizing: if checked, watermark size will be adjusted to matched the image to affect.
For example if image is 1000x1000 pixels and you set a proportional image of 15% x 15%, the watermark will be 150x150 pixels.

Is extremely useful to avoid bad results using images having various aspect ratios and sizes.

Once setup you will be able to use the watermark option in shortcodes.
However is strictly recommended to create the watermark cache for the gallery we're going to use.

In fact, in every gallery builder, there's a big button to do so. In the right sidebar

watermar

Multilanguage

The plugin is 100% multilanguage for both front and back ends. If a translation of your language has been created, WordPress will automatically switch between languages.
Plus it is WPML certified and compatible with Polylang and qTranslate!

How to create a translation

If you have WPML + String Translation add-on or Polylang, you can simply scan the plugin and translate strings via its UI.

Otherwise: go in the plugin folder, then open the one named "languages" or "lang_admin".
Inside you'll find the default.pot file. It contains english strings to be translated.

If you want to create or customize one your language translation, follow these steps:

  1. Open the default.pot file with POedit
  2. Edit the catalog by inserting your data and setting translation's language
  3. Save the file with your language's i18n identifier and "gg_ml-" prefix (the italian example is gg_ml-it_IT)
  4. Go to plugin's folder ".. wp-content/plugins/global-gallery/languages" or ".. wp-content/plugins/global-gallery/lang_admin" and paste resulting .PO and .MO files

If you create new translations, please contact me at support@lcweb.it sending your .PO and .MO files.
Otherwise they will be lost in next updates. Thanks!

LCweb - Copyright © 2019 - All Rights Reserved