Social Gallery

Social Gallery Plugin Setup

The Social Gallery Plugin starts working as soon as you have installed it, for a lot of users no configuration will ever be necessary. However if you want to turn off or on specific parts of the plugin or tweak it you have several options.Before we look at each of the options please take a look at this key, it explains the names we will use to refer to each part of the Social Gallery viewer.

Social Gallery Key:

Social Gallery Plugin Key

The options are discussed in more detail below, all of the following options are available for tweaking on the “Social Gallery” admin page, accessible by clicking Social Gallery from the admin screen:


The first option on the configuration screen lets you choose which images Social Gallery should work on (images which when clicked should load into Social Gallery.) Here you have two options:


Which Images to use Social Gallery Plugin for

“All post images” matches any image wrapped inside a link in your post. That is any linked image inside a WordPress content wrapper.


“Specific CSS Selector” – Choosing this option allows you to specify a specific CSS selector to apply Social Gallery too. If you only want a specific image or number of images to work with Social Gallery then this setting lets you specify these. An example of use would be if you had a specific gallery you wanted to enable the Social Gallery Plugin for then you could assign each linked image with the class “socialGalleryThis”, adding that class to this option would then enable Social Gallery for this class only.



A linked image HTML in this example:

A Linked Image HTML Example

…the corresponding option in the Social Gallery Configuration:

Adding a CSS selector Example

You can read more about this later in this document under “Anatomy of Social Gallery

2. Social Header

At the top of the sidebar the social header is a key part of the Social Gallery plugin, using the following options you can change the way it looks:

Social Header Options

Un-ticking “Show Social Header” hides the header.

The drop down allows you to select:

· Site Img & Link – this is the default, showing a small logo, the blog name and the blog bi-line underneath it.

· Site Link – this allows you to show just the blog name at the top of the sidebar.

· Custom HTML – this setting shows another text box and allows you to specify your own html to be shown in the header of the sidebar. *Note adding your own HTML may affect the way the plugin appears; please do check your changes after adding.


3. Picture Description

Picture Description Option

This tick box allows you to control whether or not the image title is shown as a “Picture Description”. For example, if this box is ticked (default) and the following image HTML was in a post:

Post HTML example

…the description shown against the image would be “Your Image Title”.


4. Social Buttons

Under “Social Buttons” you can turn on and off the social aspects of the Social Gallery Plugin.

Social Button Options

Un-ticking any of these will hide the relative button as shown on the key. If you intend to un-tick any of these please do read the next point.

Social Additions for V1.2: 

  • “Show fan faces” – by ticking / unticking this you can now show or hide the faces of people who have liked the page
  • Facebook App ID – by specifying a Facebook App ID here you can now use your own Facebook App for likes and comments. Read more about this here.
  • Disqus Commenting – see more below:


Disqus Comments

As well as Facebook comments, Social Gallery now supports Disqus comments (for those who don’t know Disqus is a popular system for recording comments on webpages.) You can turn Disqus comments on by ticking the box as follows. Before you do so please read the associated note’s and bare in mind the following key points:

  1. You can only use Facebook or Disqus for comments, not both.
  2. Currently Disqus doesn’t naturally support AJAX, until they do this addition is Experimental.
  3. You will need to register at and obtain a “shortname”. Click here to read how.

Using Disqus Comments instead of Facebook Comments

5. Social Scripts

Should you not require any of the JavaScript that the Social Gallery includes by default you can disable these here.

Include which scripts?

If you un-tick any of these while leaving the corresponding previous option ticked, you will need to include the appropriate script yourself (e.g. if you un-tick Facebook JavaScript here but you want to include Facebook like/send buttons or Facebook comments then you will need to have the Facebook connect JavaScript included elsewhere in your theme/blog.)

If you already have Facebook like/tweet/pin buttons on your website you may need to uncheck these. Otherwise you will not need to change anything here.


6. Picture Bar

The picture bar is the blacked bar shown along the bottom of your image in the Social Gallery plugin.

Picture Bar Options

You can disable/enable it by un-ticking/ticking “Show Picture Bar”.

You can also choose what title to show on the picture bar, you can choose from “Image Title”, “Page Title”, “Blog Title”:

Image Title” shows the title attribute of the clicked image

Page Title” shows the web page title

Blog Title” shows your blogs title


7. Lightbox Colourings

To integrate more specifically into your WordPress blogs theme we have included the option to tweak the background of the Lightbox used by Social Gallery (this is the shaded area layered over your existing content behind the Social Gallery.)

Lightbox Colour Choices

Here you can set the background colour with any HTML HEX colour. You can generate the code for this here. The default for this plugin is black (000000.)

You can also set the opacity of the background. You can use any value between 0 and 1. 0 = transparent, 1 = non-transparent. The default for this plugin is 0.8.


8. General Options

The following two options are under “General” on the Social Gallery Plugin configuration screen:

General Config Options

Show Previous/Next Navigation” turns the left/right navigation within the Social Gallery on/off. (This navigation only shows when there is more than one image associated with the plugin on the page.) Ticking/un-ticking also turns on/off left and right keyboard navigation.

Include Social Gallery Plugin Link” indicates whether or not you want to leave the link back to in the bottom right hand corner of the Social Gallery. If you do like the plugin then we appreciate you leaving it on as it helps us out, but there’s no requirement.