JUX Social Gallery

From JoomlaUX Wiki
Jump to: navigation, search

Introduction

Purpose

This document supports JoomlaUX customers in using Social Gallery Module.

Scope

  • www.joomlaux.com
  • JoomlaUX’s customers

Definitions, Abbreviations and Acronyms

No.
Name
Description

1

Joomla

The most popular Open Source Content Management System, written by PHP.

2

Facebook

Facebook social network

3

Instagram

Instagram social network

4

Google+

Google+ social network

5

Flickr

Flickr social network

Overview

JUX Social Gallery is a simple lightweight photo gallery module for Joomla driven by your existing online photo gallery.

The module grabs all your albums and images from an online source or feed and displays them on your site or within individual blog posts. It allows you to browse albums and galleries, or display just one gallery at a time.

You can take a photo with your phone, post to Facebook, Instagram, Google Plus or Flickr and it is automatically added to your site as well.

Brief features:

  • Support Joomla 2.5 and Joomla 3.x.
  • Automatically add your photo from Facebook, Instagram, Google+ or Flickr to your site.
  • Fully Responsive: Display the same on any devices.
  • Compatible with Tablet, Smart Phone.
  • Flexible Configuration: Easily control any setting & information in backend.
  • Able to set Album limit, Photo limit and other settings.
  • Allow displaying Single Album, or including, or excluding the Albums IDs that limits the results to the specified albums.
  • Support jQuery noConflict.


Screenshot

Backend

  • Tabs Options
JUX Social Gallery Basic-Options.png
  • Facebook Options
JUX Social Gallery Facebook-Options.png


  • Instagram Options
JUX Social Gallery Instagram-Options.png
  • Google + Options
JUX Social Gallery Google-Options.png
  • Flickr Options
JUX Social Gallery Flickr-Options.png


Frontend

  • Facebook
JUX Social Gallery Facebook-Social.png
  • Instagram
JUX Social Gallery Instagram-gallery.png



  • Google+
JUX Social Gallery Google-Album.png
  • Flickr
JUX Social Gallery Flickr-Album.png

Configuration

Social Gallery Installation

Requirements

Server Requirements

Social Gallery has several system requirements as follow:

You have to ensure that your system has already installed, XML and Zlib-Support built into your PHP.

PHP should be compiled with support for https (openSSL) and cURL.

PHP Safe Mode should be turned off.

Client Requirements

This module can run well on major browsers such as: Internet Explorer (version 9+), Firefox, Chrome, Opera 9+, and Safari. JavaScript must be activated.

Installation

Download

After purchasing our product, you’ll see the download link at Social Gallery product page:

http://joomlaux.com/products/social-gallery.html

Note: If there is any problem, please contact us via E-mail: contact@joomlaux.com.

Package Preparation

Unpack the installation package that you downloaded to your computer. You’ll see these files:


licence.txt

readme.txt

Modules

mod_jux_social_gallery xxx.zip

Module:

  • mod_ jux_social_gallery xxx.zip.

Social Gallery module Installation

Go to Administrator site => “Extension” => “Extension Manager” in the Top Menu.

In “Upload Package File” block, please Upload & Install our extension:

  • mod_jux_social_gallery x.x.x.zip
JUX Social Gallery Install-Module.png

Manage Social Gallery module

Basic Options

JUX Social Gallery Basic-Options.png
  • Default Tab Index => Default Tab will be focused on by default.
  • Social Icon => Show/Hide Social icons
  • Caption Length => Length of caption displayed. Default is 500 character limit.
  • Width (px) => Width of Social Gallery. Default is 100%.

Facebook Options

JUX Social Gallery Facebook-Options.png
  • Facebook => Select SHOW to display your Facebook Wall Post.
  • Facebook Title => Title of Facebook gallery. Default is Facebook
  • Facebook ID => Your Facebook ID. EX: JoomlaUX
  • Show Album Mode => Show all your albums or show but include albums/exclude albums or only show one album.
  • Album Limit => An integer to limit the number of albums initially loaded. Default is 20.
  • Album ID => Adding the album ID here if you choose Album Mode as Show Single Album.
  • Album IDs (when Album mode is Include Album) => Example (Album a, Album b): 111111111,222222222. There should be a comma to separate between IDs (no space). If leaving it blank, default is getting all your albums.
  • Album IDs (when Album mode is Exclude Album) => Example (Album a, Album b): 111111111,222222222. There should be a comma to separate between IDs (no space) of excluded albums. If leaving it blank, default is getting all your albums.
  • Limit => An integer to limit individual Gallery results by. Default is 20.

Instagram Options

JUX Social Gallery Instagram-Options.png
  • Instagram => Select SHOW to display your Instagram.
  • Instagram Title => Title of Instagram gallery. Default is Instagram.
  • Instagram ID => Instagram ID is the number represents your account.
  • Limit => An integer to limit individual Gallery results by. Default is 20.

Google+ Options

JUX Social Gallery Google-Options.png
  • Google+ => Select SHOW to display your google+
  • Google+ Title => Title of Google+ gallery. Default is Google+
  • Google+ UserID => Google+ UserID is the number represents your account.
  • Show Album Mode => Show all your albums or show but include albums/exclude albums or only show one album.
  • Album Limit => An integer to limit the number of albums initially loaded. Default is 20.
  • Album ID => Adding the album ID here if you choose Album Mode as Show Single Album.
  • Album IDs (when Album mode is Include Album) => Example (Album a, Album b): 111111111,222222222. There should be a comma to separate between IDs (no space). If leaving it blank, default is getting all your albums.
  • Album IDs (when Album mode is Exclude Album) => Example (Album a, Album b): 111111111,222222222. There should be a comma to separate between IDs (no space) of excluded albums. If leaving it blank, default is getting all your albums.
  • Limit => An integer to limit individual Gallery results by. Default is 20.

Flickr Options

JUX Social Gallery Flickr-Options.png
  • Flickr => Select SHOW to display your Flickr
  • Flickr Title => Title of Flickr gallery. Default is Flickr
  • Flickr UserID => Flickr ID is the string of letters represents your account.
  • Show Album Mode => Show all your albums or show but include albums/exclude albums or only show one album.
  • Album Limit => An integer to limit the number of albums initially loaded. Default is 20.
  • Album ID => Adding the album ID here if you choose Album Mode as Show Single Album.
  • Album IDs (when Album mode is Include Album) => Example (Album a, Album b): 111111111,222222222. There should be a comma to separate between IDs (no space). If leaving it blank, default is getting all your albums.
  • Album IDs (when Album mode is Exclude Album) => Example (Album a, Album b): 111111111,222222222. There should be a comma to separate between IDs (no space) of excluded albums. If leaving it blank, default is getting all your albums.
  • Limit => An integer to limit individual Gallery results by. Default is 20.

Advanced Options

JUX Social Gallery Advanced-Options.png
  • Module Class Suffix => A suffix to be applied to the CSS class of the module. This option allows individual module styling.
  • Enable jQuery => On/Off jQuery loader. Turn it off if your site already has jQuery loaded.
  • Enable noConflict => On/Off noConflict. Turn it on to prevent conflict with Joomla’s Mootools.
  • Set Style => Setting the style using CSS.
  • Custom Css => Custom CSS template.

User Manual

Change Social Gallery information and options

Go to Extensions =>Module Manager

JUX Social Gallery Manager-Social-Gallery.png

And then, change the Module’s information and options:

JUX Social Gallery Module-Information.png

Tips

  • In this section, we’ll provide the configuration of our Demo site. You can use it as example for your site.
  • Make desired albums viewable by setting albums on Facebook, Google+ and Picasa to Public. Facebook Pages are always viewable to the public.
  • You should use a social gallery for a page (webpage) so this page will run faster.

Note:

  • Facebook personal profile pages are never visible to the public, so you can’t use Facebook personal profiles but Facebook Fan pages.
  • Note that if your site has high traffic, Flickr is probably not right for you, as Flickr will limit the amount of requests.

Basic Options

JUX Social Gallery Basic-Options.png

Note that if you choose a Social Network in Default Tab Index, for example, Facebook, then in Facebook Options you must choose SHOW for Facebook. If you select Facebook as Default Tab Index but HIDE Facebook, it won’t display when it initially loads.

Facebook Options

JUX Social Gallery Facebook-Options.png

Select SHOW to display your Facebook Wall post.

Change Facebook ID by your Facebook ID.

Instagram Options

JUX Social Gallery Instagram-Options.png

Select SHOW to display your Instagram. Look up your Instagram User ID then paste into Instagram ID.

Google+ Options

JUX Social Gallery Google-Options.png

Select SHOW to display your Google+. Google+ UserID is the number represents your account.

Flickr Options

JUX Social Gallery Flickr-Options.png

Select SHOW to display your Flickr.

Flickr ID is the string of letters represents your account.

Guide to get ID and Album ID for Social Gallery

How to get your Facebook ID and find the album ID

  • Facebook ID is the string of letters represents your account.

EX: https://www.facebook.com/Joomlaux Facebook ID is: Joomlaux


  • To get Album ID click here:

https://developers.facebook.com/tools/explorer?method=GET&path=joomlaux%3Ffields%3Dalbums.fields(id%2Cname)

JUX Social Gallery Face-Find-AlbumID.png


Then change the “Joomlaux” by your Facebook account then click Submit button you’ll get all your albums’ IDs.



How to get your Intagram’s user ID

Instagram ID is the number represents your account. If you don’t know how to get it, please do these steps:

  1. Go to http://jelled.com/instagram/lookup-user-id
  2. Input your username and hit enter. You’ll get your ID:
JUX Social Gallery instagram ID.png

How to find your Google+ ID and find the album ID

  • Your Google+ ID for your profiles is the long string of numbers present in the URL of our profile.

Here’s a screenshot:

JUX Social Gallery Google-Plus-Profile-ID.jpg
  • To get Album ID, please sign in your Google+ account then click album that shared publicly then copy Album ID from address URL.
JUX Social Gallery google-find-albumid.png

How to get your Flickr ID and find Album ID

  • Flickr ID is the ID represents your account. It has the format: xxxxx@N0x. If you don’t know how to get it, please follow these steps:
  1. Sign in your account Flickr here: http://www.flickr.com/
  2. Your Flickr ID is the string presents in the URL of your profile.
JUX Social Gallery Flickr-ID.png

=> If you don't see Flickr ID in the URL of your profile you use idGettr to find the Flickr ID number.


  • To get Album ID you sign in your Flickr account then click Sets button and click album that you want to get ID then copy Album ID in the URL. Please follow these steps:

1. Click Sets button. Then click album that you want to get ID

JUX Social Gallery Flickr-AlbumID-Sets.png



2. You’ll get Album ID here:

JUX Social Gallery Flickr-AlbumID.png