Official JSN ImageShow v2

Quick Start Guide

(for version 2.5+)

This documentation is release under Creative Commons Attribution-Non-Commercial-Share Alike 3 Unported

Licence. You are free to print this document for convenient usage.

Copyright © 2006 - 2010 http://www.joomlashine.com

 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Table of Contents
Official JSN ImageShow v2 Quick Start Guide ................................................................................................ 1
Table of Contents .................................................................................................................................................................2
Introduction ...........................................................................................................................................................................3
Step 1. Extension Installation ...........................................................................................................................................4
SEF Extensions Configuration .......................................................................................................................... 4
Step 2. Content Preparation ..............................................................................................................................................5
Creating a Showlist .............................................................................................................................................5
Creating a Showcase .........................................................................................................................................6
Install Sample Data (optional) ........................................................................................................................... 7
Step 3. Gallery presentation..............................................................................................................................................8
Presentation as component via menu item.....................................................................................................9
Presentation as module in position ................................................................................................................10
Presentation as plugin in article’s content.....................................................................................................11
What’s next?........................................................................................................................................................................13
Give a feedback ................................................................................................................................................13

2
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Introduction

Thank you for your interest in JSN ImageShow extension. We really appreciate your choice and truly wish our
product will bring more value to your website and business.

We highly recommend you read our documentations in following order for the best understanding:

 JSN ImageShow Quick Start Guide – This document will tell you minimum steps to get the extension
works out of the box.

 JSN ImageShow Configuration Manual - This document gives you a detailed description of every
product feature. You will use this document as a reference every time you want to configure your product.

This document assumes that you already have installed Joomla! CMS with sample data and JSN ImageShow
extension downloaded.

3
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Step 1. Extension Installation

In the download package you can find extension installation file called jsn_imageshow_XXX_2.Y.zip, where
XXX is the extension edition and YY is the extension version you have. This is standard Joomla! 1.5.x extension
installation file which can be installed in Joomla! administration normally as following:

 In Joomla! administration go to menu Extensions -> Install/Uninstall

 Once you are on Extension Manager click Browse button and select extension installation file
jsn_imageshow_XXX_2.Y.zip. After that click on button Upload File & Install.

 Installation file will be uploaded to your server and installed in Joomla! CMS.

SEF Extensions Configuration

You can skip this section if you do not use any SEF extensions. If you are using any external SEF component, then
you should configure it to by pass JSN ImageShow component. Bellow is an example of bypassing JSN
ImageShow component in SEF extensions sh404SEF.

 In Joomla! administration go to menu Components -> sh404sef -> Control panel

 Next, on Control Panel page, choose tab Configuration and click sh404sef Configuration

 Next, on appeared modal window choose tab By component, locate row imageshow and set all drop down
lists to Skip.

 Push Save button on the top toolbar.

4
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Step 2. Content Preparation

Creating a Showlist

Showlist stores information about what images to display. JSN ImageShow v2 is able to connect to various image
sources and use images directly from there. Image details like title and description are also used from the original
source, but user has the choice to set his own details which will be stored in local database. User can have multiple
showlists connected to multiple image sources.

Now, let’s create a showlist with images taken from local image folder on your website. Please make following
steps:

 Prepare the images you want to add in your showlist and put them all in some folder on your server. For
example: /images/stories/myphotos/

 In Joomla! administration panel, go to menu Components -> JSN ImageShow -> Showlists

 Next, on Showlists Manager page hit button New

 Next, on Showlist Settings page fill fields Title, then push button Apply and Manage Image

 Next, on Showlist Images Manager page do following:

o Push button Select Image Source.

o Select Image Folder in field set Local image folder, then push button Use selected source.

o In appeared modal window select Add all images from selected folder(s), then select the folder
myphotos in the list and push Ok.

 Now, you are back on Showlist Images Manager page. Here make sure all images are properly added and
click button Close.

You have just created the showlist ready for presentation.

5
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Creating a Showcase

Showcase stores information about how to display images. JSN ImageShow v2 provides 69 parameters for user to
configure the look and feel of the gallery. User has control of almost everything starting from overall appearance
ending fine tuned elements like thumbnails, etc. User can create multiple showcases for different type of
presentation and use them to show multiple showlists.

Now, let’s create a simple showcase with all default preconfigured parameters. Please make following steps:

 In Joomla! administration panel, go to menu Components -> JSN ImageShow -> Showcases

 Next, on Showcases Manager page hit button New

 Next, on Showcase Settings page fill fields Title, then push button Save

You have just created the showcase ready for presentation.

6
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Install Sample Data (optional)

JSN ImageShow has very useful feature of installing sample data with 2 predefined showcases and 3 showlists
with images stored in JoomlaShine.com public Picasa account. The sample data feature can really save your time
when testing JSN ImageShow.

To perform sample data installation please make following steps:

 Make sure you do not have any valuable showlist and showcase configured.

 In Joomla! administration panel, go to menu Components -> JSN ImageShow -> Configuration &
Maintenance.

 On the left menu, select Sample Data Installation

 On the right panel, select the appropriate installation method. The process is very simple and
straightforward, so just follow the onscreen instruction.

o Remote installation – In this method, JSN ImageShow will get sample data package from our
server and perform installation. This is recommended method and you should try it first.

o Local installation – In this method, you will need to download sample data package to your
computer and then use it for installation. You should try this method only when the Remote
installation method is failed due to unavailability of internet connection.

Now, you have installed sample data ready for presentation.

7
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Step 3. Gallery presentation

You can present your gallery in 3 different ways: via component (menu item), module (in any module position)
and content plugin (inside any article). Let take a look at each method.

8
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Presentation as component via menu item

This method allows you to create menu item, clicking on which will lead to the page with gallery presented. Let’s
create a menu item called Image Slideshow in menu mainmenu. Please make following steps:

 In Joomla! administration panel, go to menu Menus -> mainmenu

 Next, on Menu Item Manager push button New

 Next, on menu item type selection page, look under Internal Link and select JSN ImageShow ->
Standard Gallery Layout

 Next, menu item settings page, set parameters as following:

a. Title: Image Slideshow

b. Published: Yes

 On the right, in panel Parameters (Basic), set parameters as following and

a. Showlist: the showlist you have created on Step 2.

b. Showcase: the showcase you have created on Step 2.

 Push button Save

Now you can get back to front-end of your website, click on menu item Image Slideshow and see your gallery in
all beauty.

9
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Presentation as module in position

This method allows you to show your gallery in any module position presented in the template. Let’s create a
module called Image Slideshow Module and put it on position promo. Please make following steps:

 In Joomla! administration panel, go to menu Extensions -> Module Manager

 Next, on Module Manager page, push button New and then select JSN ImageShow

 Next, on Module settings page, set parameters as following:

o Title: Image Slideshow Module

o Show Title: No

o Enabled: Yes

o Position: promo (or any other position you want)

 On the right, in panel Module Parameters, set parameters as following:

o Showlist: the showlist you have created on Step 2.

o Showcase: the showcase you have created on Step 2.

 Push button Save

10
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

Presentation as plugin in article’s content

This method allows you to show your gallery in any article. You can show gallery as it is or as a link, click on
which will open gallery in modal window. Let’s add gallery to sample article called Welcome to Joomla!. Please
make following steps:

 In Joomla! administration panel, go to menu Content -> Article Manager -> Welcome to Joomla!

 Next, on article settings page, put cursor to the place where you want to insert the gallery and input plugin
syntax {imageshow sl=1 sc=1 w=500 h=400 /}. Here:

o sl – the id number of the showlist you created in Step 2. You can recheck that id number by going to
menu Components -> JSN ImageShow -> Showlists

11
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

o sc - the id number of the showcase you created in Step 2. You can recheck that id number by going
to menu Components -> JSN ImageShow -> Showcases

o w – the width of gallery area. This parameter is optional. If not specified, the parameter Overall
Width defined in showcase will be used.

o h - the height of gallery area. This parameter is optional. If not specified, the parameter Overall
Height defined in showcase will be used.

 If you want to show gallery in modal window opened by a link, then input syntax {imageshow sl=1
sc=1}Click here to see gallery presentation in modal window{/imageshow}. All plugin parameters are
the same as described above.

 Next, push button Save

Now you can go to front-end of your website to see how gallery is presented in the article.

12
 Joomla! extension JSN ImageShow v2 Quick Start Guide © http://www.joomlashine.com

What’s next?
Congratulations, now you have basic understanding about how JSN ImageShow works. Your next step is to read
JSN ImageShow Configuration Manual. In that manual you will find detailed description about all extension
features and you can quickly apply them to your website.

Give a feedback

We are continuously working on new releases of our products and would really appreciate any of your comments,
feedbacks. Feel free to drop us a line at Feedback Page.

13