This chapter will gives you general instructions on how to install the slider and setup the options. Later chapters will be more detailed if needed.
What files do I need to upload to my server?
Please upload the rs-plugin folder to your server. In this folder you will find the following subfolders containing all of the items content:
Issues for Slider Revolution Responsive jQuery Plugin. To avoid duplicates, please search before submitting a new issue. Advanced search. 4 open, 6 total. 1 open, 1 total. Response rate% 1st response. 2 year graph, updates weekly. Slider Revolution will adjust its size and the size of its content automatically. But similar to responsive websites, content often looks best when its setup specifically for multiple devices. Grid Width & Grid Height. LayerSlider Responsive jQuery Slider Plugin. LayerSlider is an advanced Responsive jQuery Slider Plugin with the famous Parallax Effect and hundreds of transitions! You can use LayerSlider to create a breathtaking Image Slideshow, Banner Rotator or Content Slider to your site! It is SEO and mobile friendly, it has tons of features and customizable options.
- js
- css
- assets
You could use your own jQuery but we recommend loading it directly from the Google ressources (see later in this documentation).
You will find many examples in your downloaded zip under the examples&sources folder..
Implement the jQuery
Add the following lines to your HTML Head:
Add Revolution js and css files to your HTML page
Create a Container for the Banner
Responsive Style
This Style allows you to creat predefined container sizes, undependent from sourrounding container, and create Medai Query (Browsr Size) Dependent responsive alterantives.
It requests
- a container with predefined Width and Height Attributes,
- Media Query dependent Sizing. - this should be always with the same proportion. Means Width/Height should always have the same result !!!
Put this in your CSS File (i.e) :
FullWidth Style
This Style allows you to have the banner always fit in the maximum width of the Sourrounding Container.
It requests:
- a Fluid wrapping container (which will always change the size depending on browser size. I.e. width:100% etc..
Put this in your CSS File
FullScreen Style
This Style allows you to have a banner always fit in the maxium screensize. In Some option you can select containers which will reduce the height of the banner with the height of the container. See examples.
It requests:
- a fullwidth and fullheight wrapping container
Put this in your CSS File
Create Your First Slides
Create an Unordered list inside the banner container where each <li> element will correspond to one slide.
Call the jQuery Plugin to build the Slider (Options need to be set of course...)
The Documentation
- Created: 06/22/2012
- latest Update: 06/28/2012
- By: ThemePunch
- Email: info@themepunch.com
For support please checkout http://themepunch.ticksy.com !
Install
This chapter will gives you general instructions on how to install the slider and setup the options. Later chapters will be more detailed if needed.
00 What files do I need to upload to my server?
Please upload the rs-plugin folder to your server. In this folder you will find the following subfolders containing all of the items content:
- js
- css
- assets
You could use your own jQuery but we recommend loading it directly from the Google ressources (see later in this documentation).
You will find an exampleindex.html and index-fullwidth.html in your downloaded zip.
01 Implement the jQuery
Add the following lines to your HTML Head:
02 Add Revolution js and css files to your HTML page
03 A Create the surrounding DIV for your Slider (Responsive, none Full Width)
03 B Create the surrounding DIV for your Slider (Responsive, Full Width Slider)
04 Put an unordered list inside to hold the different slides as list elements
05 Call the jQuery Plugin to build the Slider
Markup
The items markup uses javascript/jQuery to transform a block of HTML markup into the slider, all customization is done trough the use of HTML5 data attributes and CSS. The markup is valid for HTML5 rules and the content will be fully indexed by search engines. The general structure of markup follows this schema:
01 Two surrounding DIVs are the basic holder for your Slider:
To get more know about the fullwidth and/or responsive containers, see our style.css examples.
02 An unordered list inside holds the different slides as list elements
Layout
01 The Default parameters of the Plugin
- delay The time one slide stays on the screen in Milliseconds (Default: 9000)
- startheight Basic Height of the Slider in the desktop resolution in pixel, other screen sizes will be calculated from this (Default: 490) It should be similiar to the settings of the style sheet. If you use a fullwidth banner, ti will deinfe the max. Height of the banner by resizing of the browser. The banner wont ne heigher than this value.
- startwidth Basic Width of the Slider in the desktop resolution in pixel, other screen sizes will be calculated from this (Default: 890) It should be similiar to the settings of the style sheet. If you use a fullwidth banner, ti will deinfe the max. Width of the banner by resizing of the browser.
- hideThumbs Time after that the Thumbs will be hidden(Default: 200),
- navigationType Display type of the navigation bar (Default:'none')
Options:
bullet
thumb ** In Fullwidth version thumbs wont be displayed if navigation offset set to shwop thumbs outside of the container ! Thumbs must be showen in the container!
none
both - navigationArrows Display position of the Navigation Arrows (Default: 'nexttobullets')
Options:
nexttobullets
verticalcentered ** By navigation Type Thumb arrows always centered or none visible
none - navigationStyle Look of the navigation bullets (Default: 'round')
Options:
round
square
navbar ** If you choose navbar, we recommend to choose Navigation Arrows to nexttobullets - touchenabled Enable Swipe Function on touch devices (Default: 'on')
Options:
on
off - navOffsetHorizontal The Bar is centered but could be moved this pixel count left(e.g. -10) or right (Default:0) ** By resizing the banner, it will be always centered !!
- navOffsetVertical The Bar is bound to the bottom but could be moved this pixel count up (e. g. -20) or down (Default: 20)
- shadow The Shadow display underneath the banner
Options:
0 No Shadow
1
2
3 - onHoverStop Stop the Timer when hovering the slider
Options:
on
off - thumbWidth the basic Width of one Thumbnail (only if thumb is selected. Default:100)
- thumbHeight the basic Height of one Thumbnail (only if thumb is selected Default 50)
- thumbAmount the amount of the Thumbs visible same time (only if thumb is selected)
** All Thumbs will be hidden in smallest Responsive Level, and in smaller level default size is reseted to 60x30px. Can be modificated in the settings.css file) - fullWidth on/off It turns on the Horizontal Centering of Images in FullWidth version. In Case the Image is bigger then the container width, it fits the image with its height in the container and centers horizontally.
- stopAtSlide -1 or 1 to 999. Stop at selected Slide Number. If set to -1 it will loop without stopping. Only available if stopAfterLoops is not equal -1 !
- stopAfterLoops -1 or 0 to 999. Stop at selected Slide Number (stopAtSlide) after slide looped 'x' time, where x this Number. If set to -1 it will loop without stopping. Only available if stopAtSlide not equal -1 !
02 Slider items
- data-transition The appearance transition of this slide
Options:
boxslide
boxfade
slotzoom-horizontal
slotslide-horizontal
slotfade-horizontal
slotzoom-vertical
slotslide-vertical
slotfade-vertical
curtain-1
curtain-2
curtain-3
slideleft
slideright
slideup
slidedown
fade
random
slidehorizontal
slidevertical
papercut
flyin
turnoff
cube
3dcurtain-vertical
3dcurtain-horizontal - data-masterspeed Set the Speed of the Slide Transition. Default 300, min:100 max:2000.
- data-slotamount The number of slots or boxes the slide is divided into. If you use boxfade, over 7 slots can be juggy.
- data-link A link on the whole slide pic
- data-delay A new Dealy value for the Slide. If no delay defined per slide, the dealy defined via Options will be used
- data-thumb An Alternative Source for thumbs. If not defined a copy of the background image will be used in resized form
- an image <img> as Background Image / Main Image with Data of the thumb
OR - a colored background image AND a coloredbg caption which is full width/height defined !!
Each List item can include:
- some <div>s containing captions (class='caption'), this could contain embedded video iframes also
03 Captions
- color class example big_white, big_orange, medium_grey (check the style.css of the example for details)
- animation class
Options:
sft - Short from Top
sfb - Short from Bottom
sfr - Short from Right
sfl - Short from Left
lft - Long from Top
lfb - Long from Bottom
lfr - Long from Right
lfl - Long from Left
fade - fading
randomrotate- Fade in, Rotate from a Random position and Degree - data-x The horizontal position in the standard (via startwidth option defined) screen size (other screen sizes will be calculated)
- data-y vertical position in the standard (via startheight option defined) screen size (other screen sizes will be calculated)
- data-speed duration of the animation in milliseconds
- data-start after how many milliseconds should this caption start to show
- data-easing special easing effect of the animation
Options:
easeOutBack
easeInQuad
easeOutQuad
easeInOutQuad
easeInCubic
easeOutCubic
easeInOutCubic
easeInQuart
easeOutQuart
easeInOutQuart
easeInQuint
easeOutQuint
easeInOutQuint
easeInSine
easeOutSine
easeInOutSine
easeInExpo
easeOutExpo
easeInOutExpo
easeInCirc
easeOutCirc
easeInOutCirc
easeInElastic
easeOutElastic
easeInOutElastic
easeInBack
easeOutBack
easeInOutBack
easeInBounce
easeOutBounce
easeInOutBounce
04 Videos
Full Screen Video
In order to play FullWidth Videos, use the class 'fade fullscreenvideo' in the caption where you embeded the iFrame. Use and and and for best effect. The Width and height of the iFrame should be 100% !
In case you wish to use autoplay, just use the parameter in the div where you embeded the iFrame.
05 Banner Timer
Responsive Basic
Responsive means that the slider will adjust to every screen width.
Fullwidth
This slider can go fullwidth too. We have added an index-fullwidth.html example for you in the zip.
Please note the basic change in the markup.
The surrounding containers are:
The CSS is not splitted with Media-Queries but has a basic 100% value for width:
API Functions and Events
The slider offers a public API which you can use to control component inside the Slider from within your own scripts. To access this api, use the following code.
You can see in the example index-responsive-API.html how to use the different functions, and how to get the trigered Events.
Once this is done you may use any of the following functions:
- api.revpause() - Stops the Timer and autoplay
- api.revresume() - Starts the Timer and resume to autoplay
- api.revprev() - Change to previous slide
- api.revnext() - Change to next slide
- api.revshowslide(n) - Change to the slide with index Nr. (n)
- api.revmaxslide() - Show the amount of slides
Or you may use any of the following Events:
- revolution.slide.onchange - Event is triggered when Slide has been rotated
- revolution.slide.onpause - Event is triggered when Slider is on Pause
- revolution.slide.onresume - Event is triggered when Slider is back from Pause
- revolution.slide.onvideoplay - Event is triggered when YouTube or Vimeo Video has been started (only Online Mode !)
- revolution.slide.onvideostop - Event is triggered when YouTube or Vimeo Video has been stopped or Slide has been rotated (only Online Mode !)
- revolution.slide.onstop - - Event is triggered when slider has been stopped due the Loop and stop at Slide parameters
Licenses
Jquery Image Slider
Used Assets
Css Responsive Slider
- Template demo images licensed from Fotolia for preview usage. Please do not attempt to rip the images from the preview!
- cssAnimate Plugin Great and Simple cssAnimate jQuery Plugin
- WaitForImages jQuery Plugin
Support
Free Jquery Slider
If you face problems with the installation or customization of our product please do not hesitate to contact us via our support ticket system: