| SuperSlider Extension Guide |
To ensure your extension is setup correctly, please make sure you read through this extension guide thoroughly. Before you start
Have a look at the extension demo site to see if this extension meets your needs. This extension is created for Joomla 1.5 and is not compatible with Joomla 1.0. Also note that this extension uses transparency effects that may not be supported in Internet Explorer 6. InstallationTo install the SuperSlider module, use the following steps.
The extension will now be successfully installed, so you can proceed to the next step. Uploading ImagesBefore you can use the SuperSlider module on your Joomla! website, you need to upload some images. The SuperSlider module can be used for most native web image formats, so you may use JPG, GIF or PNG files for your images. It is recommended that you keep all your slider images at a fixed height and width so that your slider behaves consistently. You may use Joomla's built in media manager or an FTP application to upload the images to your site. The images can be located anywhere on your server, but it is recommended to keep them under the images/stories/ folder. In our example we have uploaded images into a folder called topslider under images/stories/. Once you have successfully uploaded a few images to a folder, you may proceed to the next step. Setting the Image directory and SequenceThis step is mandatory and the SuperSlider module will not behave properly if these values are incorrect.
Images Folder (required)The images folder is the directory path where the images were uploaded in the previous step. Ideally, this should be located in a sub folder under the images/stores folder of your joomla website. The value for the images folder should not have a leading or trailing forward slash (/). Image Width (required)This is the width of the slider. All images should have the same width as specified under this parameter for the slider to behave consistently. The width is set in pixels. Image Height (required)This is the height of the slider. All images should have the same width as specified under this parameter for the slider to behave consistently. The height is set in pixels. Transition Duration (optional)This is the time in milliseconds when transitioning from one slide to the next. You may change this value to speed up, or slow down the speed of the slider. A lower value makes the slides move faster, whilst a higher value will slow down the movement of the slides. The default value is set to 400. Image Sequence (required)This is required to set the sequence or order in which the slides are displayed. You will need to enter the file name of each slide image on one line. Go to the next line by pressing the key on a PC or key on Mac. The order is specified in a top-to-bottom approach, so the first slide to be displayed should be in the first line. There is no need to re-enter the path of the image as that has been set using the images folder above. 
Configuring the ModuleThe SuperSlider module has several configuration options to allow you to customize the look and feel as well as the functionality of your slider to fit your Joomla! website. Figure 1. Shows the available module options you can use to customize the appearance and functionality of the module. The following is a list of available options you can use to customize the the module: Titles
Show TitlesThe show titles option allows one to enable or disable the display of titles on the SuperSlider module. TitlesEach slide can have an optional title used to describe your slide. If you enable the Show Titles option, you will need to enter a title for each slide that you are using. You will need to enter the title for the slides in the same order as the images entered in the previous steps on a new line. Go to the next line by pressing the key on a PC or key on Mac. Do not worry if your title is long and wraps to the next line. Captions
Show CaptionsThe show titles option allows one to enable or disable the display of captions on the SuperSlider module. CaptionsEach slide can have an optional caption used to describe your slide. If you enable the Show Titles option, you will need to enter a caption for each slide that you are using. You will need to enter the caption for the slides in the same order as the images entered in the previous steps on a new line. Go to the next line by pressing the key on a PC or key on Mac. Do not worry if your caption is long and wraps to the next line. LinksThe SuperSlider module has the ability to allow links on each slide. The following options allow you to set how the links are enabled, the target window, and the urls. 
Enable LinksThis option allows you to specify if links should be enabled on the SuperSlider module. The options are:
Link TargetThe link target allows you to specify how links behave. Links can be set to open in the current frame or open in a new window. Link URLsEach slide can have an optional link that can be set to open when clicked. If you enable the links, you will need to enter a URL for each slide that you are using. External links should be preceeded by http:// .You will need to enter the URL for the slides in the same order as the images entered in the previous steps on a new line. Go to the next line by pressing the key on a PC or key on Mac. Do not worry if your URL is long and wraps to the next line. 
StylingThe SuperSlider module comes with several options that allow you to style the module to match your websites look and feel. Use the following style options to set your desired style: Select StyleThere are 3 separate built in styles for the SuperSlider to use. Click on the images below to view a live demo of each of the styles in action.
Navigation TypeChoose between 3 available navigation types:
Display Next / Previous ButtonsThis option allows you to specify whether the next and previous buttons are displayed on hover or always visible. Display NavigationThis option allows you to specify whether the navigation links (numbers / titles / thumbnails) are displayed on hover or always visible. Titles and CaptionsThis option allows you to specify whether the titles and captions are displayed on hover or always visible. Thumbnail Sizes
If you choose to use thumbnails as the navigation, you can specify a maximum size in width or height that the thumbnail can occupy. This option is required if one is using the thumbnails option only. The SuperSlider module generates thumbnails automatically, and these are stored in a subfolder called jj_thumbnails under your sliders images folder. If you change this value and the thumbnails are not updated, you may need to delete the generated thumbnails for new ones to be created. Useful TipsDo you have any tips or tricks that you have done with the SuperSlider? Let us know and we will publish them here!            |
Once you have uploaded all your images into a folder on your server, you will need to set up the image directory path, image size (height and width) and sequence of the images.
