"ARI Smart Content - Nivo Slider" module shows a responsive image slider in module positions. The module can be enabled/disabled and configured on "Extensions → Module Manager" page on Joomla! backend. The module offers the following parameters:
- Images is a main and required parameter. It is used to select the data source which will be used to select images which will be shown into the slider. If a data source is not selected, the module will show nothing. It is possible to select data sources from Media data section.
- Use constant ID if the parameter is set to 'Yes', slider container will have the constant ID based on module ID. It can be useful for caching or other purposes.
- Load method is used to specify load method on client side. If it is set to 'On Load', the slider will be created when page and all resources (images, styles and etc.) are loaded by a browser. If it is set to 'DOM Ready', the slider will be created immediately when page is loaded (it doesn't wait till all resources are loaded, they will be loaded in parallel). In other words, 'DOM Ready' event occurs before 'On Load' and if possible it is preferable to use it instead of 'On Load'. This parameter can be useful to resolve conflict with some 3rd party extensions, if the extension doesn't work properly when it's set to 'DOM Ready', try to switch it to 'On Load'.
- Module Class Suffix will be applied to the CSS class of the module. This allows for individual module styling.
- Width is width of the slider. If Responsive parameter is set to "Yes", this value will be used as maximum width. Possible values: 500, 100% and etc.
- Height is height of the slider. If Responsive parameter is set to "Yes", this parameter will be ignored and height will be calculated automatically.
- Responsive is used to specify should be slider responsive or not. If it is responsive then slider size will be adapted to screen size.
- Link target is used to specify where links (to images or to pages) will be open when a user clicks by a slider image.
- Custom link target is used to specify a custom target (for example frame name) if values from Link target parameter are not suitable.
- Theme is used to choose a theme.
- CSS Styles is used to specify additional CSS styles. It is possible to use {$id} predefined variable which will be replaced with ID of slider container. For example the following code show a border around the slider:
#{$id} {border:1px solid red;}
"Lightbox integration" section contains parameters which are used to integrate the slider with a lightbox extension. If the slider is integrated with a lightbox extension, images (or web pages) will be shown into the lightbox when a user clicks by a slider image. It will work if the selected data source contains thumbnails and images and the slider shows thumbnails (see Use thumbnails parameter) or links to web pages are defined for images in the data source (for example in description file for Local images). The section contains the following parameters:
- Lightbox integration is used to select a lightbox application which will be integrated with the slider. If the parameter is set to "None", the extension will be not integrated with a lightbox extension. The selected lightbox application should be installed and enabled.
- Lightbox width is width of the lightbox. This parameter is used if a web page (it is not applied for images) is shown into the lightbox. Possible values: 400, 80% and etc.
- Lightbox height is height of the lightbox. This parameter is used if a web page (it is not applied for images) is shown into the lightbox. Possible values: 400, 80% and etc.
- Grouping items if the parameter set to "Yes", it will be possible to navigate between images (pages) into the lightbox.
- Background color is a background color which will be used for content which is shown into the lightbox. It is supported only by Sexy Lightbox application.
"Slider parameters" section contains parameters which are used to customize the slider. The following parameters are supported:
- Fix transparent background set this parameter to "Yes" if you use images with transparent background to do animation effects more smoothly.
- Disable mouse click if this option is enabled the slider will ignore mouse click by an image. Don't enable this option if you want to use the slider with a lightbox extension.
- Transition effect is used to choose transition effect. Set this parameter to "Random" if you want to use random transition effects.
- Number of slices is used to specify number of slices for transition effects.
- Box columns is used to specify number of columns for "box" transition effects.
- Box rows is used to specify number of rows for "box" transition effects.
- Zoom factor is used for 'Ken burns' effect to define start zoom level. The extension adds 100% to the defined value to calculate start zoom. For example if the parameter is set to 60 then start zoom level will be 160%.
- Animation speed is used to specify animation speed in milliseconds.
- Pause time is used to specify pause time in milliseconds.
- Start slide index is used to specify zero-based start slide index.
- Random start slide is used to specify should the slides show random slide on load or not.
- Show navigation arrows is used to enable/disable navigation arrows (next/prev).
- Show slides navigation is used to enable/disable navigation buttons for each image.
- Keyboard navigation is used to enable/disable keyboard navigation. If the parameter is enabled, it is possible to use keyboard arrow buttons to move to next/prev slide.
- Pause on mouse over is used to specify stop slideshow or not on mouse over.
- Auto rotate is used to enable/disable ability to change slides automatically.
- Endless auto scrolling is used to specify should the slider shows images in endless way in auto mode or stops when reaches the last image.
"Slides parameters" section contains parameters which are used to define some parameters for images which are shown in the slider:
- Use thumbnails is used to specify need to use thumbnails (if the selected data source contains thumbnails) instead of original images or not.
- Default description is used to define description which will be associated with slider's images if it is not specified into the data source.
- Default link is used to define link which will be associated with slider's images if it is not specified into the data source.
- Show preview thumbnails if this option is enabled, the slider will show preview of image on mouse over navigation button.