jquery.themepunch.tools.min.js jquery.themepunch.revolution.js jquery.themepunch.revolution.min.js
For support please checkout http://themepunch.com !
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.
Please upload the rs-plugin folder to your server. In this folder you will find the following subfolders containing all of the items content:
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..
Add the following lines to your HTML Head:
<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js></script>
<!-- jQuery REVOLUTION Slider --> <script type="text/javascript" src="rs-plugin/js/jquery.themepunch.tools.min.js"></script> <script type="text/javascript" src="rs-plugin/js/jquery.themepunch.revolution.min.js"></script> <!-- REVOLUTION BANNER CSS SETTINGS --> <link rel="stylesheet" type="text/css" href="rs-plugin/css/settings.css" media="screen" />
<div class="bannercontainer"> <div class="banner">...</div> </div>
This style allows you to let the wrapping Container decide how big (in width) your Slider will be. The Height will be auto calculated based on the Slider Width
Put this in your CSS File (i.e) :
.bannercontainer { width:100%; position:relative; padding:0; } .banner{ width:100%; position:relative; }
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:
Put this in your CSS File
.bannercontainer { width:100%; position:relative; padding:0; }
Create an Unordered list inside the banner container where each <li> element will correspond to one slide.
<ul> <!-- THE BOXSLIDE EFFECT EXAMPLES WITH LINK ON THE MAIN SLIDE EXAMPLE --> <li data-transition="boxslide" data-slotamount="7" data-link="http://www.google.de"> <img src="images/slides/image1.jpg"> <div class="caption sft big_white" data-x="400" data-y="100" data-speed="700" data-start="1700" data-easing="easeOutBack">KICKSTART YOUR WEBSITE</div> <div class="caption sfb big_orange" data-x="400" data-y="142" data-speed="500" data-start="1900" data-easing="easeOutBack">WITH SLIDER REVOLUTION!</div> <div class="caption lfr medium_grey" data-x="510" data-y="210" data-speed="300" data-start="2000">UNLIMITED TRANSITIONS</div> </li> ... </ul>
(Dont need to set all Options. These are only for Demonstrating all settings)
<script type="text/javascript"> jQuery(document).ready(function() { jQuery('.banner').revolution({ delay:9000, startwidth:960, startheight:500, startWithSlide:0, fullScreenAlignForce:"off", autoHeight:"off", minHeight:"off", shuffle:"off", onHoverStop:"on", thumbWidth:100, thumbHeight:50, thumbAmount:3, hideThumbsOnMobile:"off", hideNavDelayOnMobile:1500, hideBulletsOnMobile:"off", hideArrowsOnMobile:"off", hideThumbsUnderResoluition:0, hideThumbs:0, hideTimerBar:"off", keyboardNavigation:"on", navigationType:"bullet", navigationArrows:"solo", navigationStyle:"round", navigationHAlign:"center", navigationVAlign:"bottom", navigationHOffset:30, navigationVOffset:30, soloArrowLeftHalign:"left", soloArrowLeftValign:"center", soloArrowLeftHOffset:20, soloArrowLeftVOffset:0, soloArrowRightHalign:"right", soloArrowRightValign:"center", soloArrowRightHOffset:20, soloArrowRightVOffset:0, touchenabled:"on", swipe_velocity:"0.7", swipe_max_touches:"1", swipe_min_touches:"1", drag_block_vertical:"false", parallax:"mouse", parallaxBgFreeze:"on", parallaxLevels:[10,7,4,3,2,5,4,3,2,1], parallaxDisableOnMobile:"off", stopAtSlide:-1, stopAfterLoops:-1, hideCaptionAtLimit:0, hideAllCaptionAtLilmit:0, hideSliderAtLimit:0, dottedOverlay:"none", spinned:"spinner4", fullWidth:"off", forceFullWidth:"off", fullScreen:"off", fullScreenOffsetContainer:"#topheader-to-offset", fullScreenOffset:"0px", panZoomDisableOnMobile:"off", simplifyAll:"off", shadow:0 }); }); </script>
Each Slide (<li> </li>) MUST include a main image which is added as a simple <img> tag at the first level. It can be a Simpe image, a colored or transparent image, or dummy image as lazy load version.
<img src="images/slides/slide13.jpg" >
<img src="images/slides/transparent.png" style="background-color:#56e34a" >
<img src="images/slides/dummy.jpg" data-lazyload="images/slides/slide13.jpg">
<img src="images/slides/slide13.jpg" data-bgrepeat="repeat" data-bgfit="normal" data-bgposition="center center">
<img src="images/slides/slide13.jpg" data-bgrepeat="no-repeat" data-bgfit="contain" data-bgposition="center center">
<img src="images/slides/slide13.jpg" data-bgrepeat="no-repeat" data-bgfit="cover" data-bgposition="center center">
<img src="images/slides/slide13.jpg" data-bgrepeat="no-repeat" data-bgfit="cover" data-bgposition="right bottom">
<img src="images/kenburns1.jpg" alt="kenburns1" data-bgposition="left bottom" data-kenburns="on" data-duration="2000" data-ease="Power4.easeInOut" data-bgfit="200" data-bgfitend="100" data-bgpositionend="center top">
Each <li> (slide) can include unlimited amount of Captions. Caption are simple html markups with iframe, image, heading , paragraph and any other tags. Each Caption must be wrapped via a <div class="caption"></div>.
Each Caption has some special classes and some data- attributes, to set animation type, position, speed, easings etc.
To Define Loop animations, everything which comes inside the Layer need to be wrapped with a div container where you can set the different Loop Animation Details
<div class="rs-wave" data-speed="2" data-angle="0" data-radius="20" data-origin="50% 50%"> <img src="images/dummy.png" alt="" data-lazyload="images/newwave1.png"> </div>
<div class="rs-pulse" data-easing="Power4.easeInOut" data-speed="2" data-zoomstart="1" data-zoomend="0.95"> <img src="images/dummy.png" alt="" data-lazyload="images/cloud1.png"> </div>
<div class=" rs-pendulum" data-easing="Power1.easeInOut" data-startdeg="-6" data-enddeg="6" data-speed="2" data-origin="50% 75%"> <img src="images/dummy.png" alt="" data-lazyload="images/cloud1.png"> </div>
<div class=" rs-slideloop" data-easing="Power3.easeInOut" data-speed="0.5" data-xs="-5" data-xe="5" data-ys="0" data-ye="0"> <img src="images/dummy.png" alt="" data-lazyload="images/cloud1.png"> </div>
<div class=" rs-rotate" data-easing="Power1.easeInOut" data-startdeg="-6" data-enddeg="6" data-speed="2" data-origin="50% 75%"> <img src="images/dummy.png" alt="" data-lazyload="images/cloud1.png"> </div>
You can add now Static Layers to your Slider. Static Layers are defiend outside the Layers (since they are independent of any other elements and slides).
You will need to define the Start and End Slide and as always the start and end time where the Layer becomes visible, or hides again.
<ul> ...your slides and layers... </ul> <div class="tp-static-layers"> <!-- LAYER NR. 1 --> <div class="tp-caption customin customout tp-static-layer" data-x="center" data-hoffset="100" data-y="bottom" data-voffset="0" data-customin="x:50;y:150;z:0;rotationX:0;rotationY:0;rotationZ:0;scaleX:0.5;scaleY:0.5;skewX:0;skewY:0;opacity:0;transformPerspective:0;transformOrigin:50% 50%;" data-customout="x:0;y:0;z:0;rotationX:0;rotationY:0;rotationZ:0;scaleX:0.75;scaleY:0.75;skewX:0;skewY:0;opacity:0;transformPerspective:600;transformOrigin:50% 50%;" data-speed="800" data-start="700" data-startslide="1" data-endslide="4" data-end="1800" data-easing="Power4.easeOut" data-endspeed="500" data-endeasing="Power4.easeIn" style="z-index: 3"><div class="rs-wave" data-angle="90" data-distance="40" data-radius="40" data-speed="2"><img src="images/woman.png" alt=""></div> </div> </div>
The slider can play Vimeo, YouTube and HTML5 (videoJs) Videos, in boxed and "FullSlide" size. Via the Embeded API's the Slider will be paused, and restarted from the VideoPlayers. To use the Video Files in Slider see the following instructions.
Each Video file has the same data- options like:
Boxed version
YouTube Video will be added within a caption due an iframe. The Following example shows an iFrame embeded YouTube Video in a caption (460px X 259px), i.e.:
<div class="caption fade " data-autoplay="true" data-autoplayonlyfirsttime="true" data-thumbimage="yourpath/yourimage" data-nextslideatend="false" data-x="130" data-y="70" data-speed="500" data-start="10" data-easing="easeOutBack"> <iframe src="http://www.youtube.com/embed/T8--OggjJKQ?enablejsapi=1&html5=1&hd=1&wmode=opaque&controls=1&showinfo=0;rel=0;" width="460" height="259"></iframe> </div>
You may need to use the origina=http://yourdomain or origin=https://yourdomain for YT Api issues !
<div class="caption fade fullscreenvideo" data-autoplay="true" data-autoplayonlyfirsttime="true" data-thumbimage="yourpath/yourimage" data-nextslideatend="true" data-x="0" data-y="0" data-speed="500" data-start="10" data-easing="easeOutBack"> <iframe src="http://www.youtube.com/embed/T8--OggjJKQ?enablejsapi=1&html5=1&hd=1&wmode=opaque&controls=1&showinfo=0;rel=0;" width="100%" height="100%"></iframe> </div>
You may need to use the origin=http://yourdomain or origin=https://yourdomain for YT Api issues !
Boxed version
YouTube Video will be added via Options. The Following example shows an embeded YouTube Video which is loaded only on Demand. in a caption (460px X 259px), i.e.:
<div class="tp-caption sfl fadeout tp-videolayer" data-x="center" data-hoffset="134" data-y="center" data-voffset="-6" data-speed="600" data-start="1000" data-easing="Power4.easeOut" data-endspeed="500" data-endeasing="Power4.easeOut" data-autoplay="true" data-autoplayonlyfirsttime="true" data-nextslideatend="true" style="z-index: 8" data-ytid="T8--OggjJKQ" data-videoattributes="enablejsapi=1&html5=1&hd=1&wmode=opaque&showinfo=0&rel=0" data-videocontrols="controls" data-videowidth="640" data-videoheight="360"> </div>
You may need to use the origina=http://yourdomain or origin=https://yourdomain for YT Api issues !
<div class="tp-caption sfl fadeout fulllscreenvideo tp-videolayer" data-x="0" data-y="0" data-speed="600" data-start="1000" data-easing="Power4.easeOut" data-endspeed="500" data-endeasing="Power4.easeOut" data-autoplay="true" data-autoplayonlyfirsttime="true" data-nextslideatend="true" style="z-index: 8" data-ytid="T8--OggjJKQ" data-videoattributes="enablejsapi=1&html5=1&hd=1&wmode=opaque&showinfo=0&rel=0" data-videocontrols="controls" data-videowidth="100%" data-videoheight="100%"> </div>
You may need to use the origin=http://yourdomain or origin=https://yourdomain for YT Api issues !
<div class="caption fade " data-autoplay="true" data-nextslideatend="false" data-x="190" data-y="110" data-speed="500" data-start="10" data-easing="easeOutBack"> <iframe src="http://player.vimeo.com/video/29298709?title=0&byline=0&portrait=0;api=1" width="460" height="259"></iframe> </div>
<div class="caption fade fullscreenvideo" data-autoplay="true" data-nextslideatend="true" data-x="0" data-y="0" data-speed="500" data-start="10" data-easing="easeOutBack"> <iframe src="http://player.vimeo.com/video/29298709?title=0&byline=0&portrait=0;api=1" width="100%" height="100%"></iframe> </div>
Vimeo Video API works only Online. It will not work well on Localhost due some Sandbox Security reason. Please always test it Online. Vimeo Video will be added via Options. The Following example shows an embeded Vimeo Video which is loaded only on Demand in a Layer (460px X 259px), i.e.:
Boxed version
<div class="tp-caption sfl fadeout tp-videolayer" data-x="center" data-hoffset="134" data-y="center" data-voffset="-6" data-speed="600" data-start="1000" data-easing="Power4.easeOut" data-endspeed="500" data-endeasing="Power4.easeOut" data-autoplay="true" data-autoplayonlyfirsttime="true" data-nextslideatend="true" style="z-index: 8" data-vimeoid="29298709" data-videoattributes="enablejsapi=1&html5=1&hd=1&wmode=opaque&showinfo=0&rel=0" data-videocontrols="controls" data-videowidth="640" data-videoheight="360"> </div>
<div class="tp-caption sfl fadeout fulllscreenvideo tp-videolayer" data-x="0" data-y="0" data-speed="600" data-start="1000" data-easing="Power4.easeOut" data-endspeed="500" data-endeasing="Power4.easeOut" data-autoplay="true" data-autoplayonlyfirsttime="true" data-nextslideatend="true" style="z-index: 8" data-vimeoid="29298709" data-videoattributes="enablejsapi=1&html5=1&hd=1&wmode=opaque&showinfo=0&rel=0" data-videocontrols="controls" data-videowidth="100%" data-videoheight="100%"> </div>
The HTML5 Files are only loaded if the html5 video markup exist.
Boxed Version (i.e.)
<div class="caption randomrotate " data-x="20" data-y="80" data-speed="300" data-start="2100" data-easing="easeOutExpo" data-autoplay="true" data-nextslideatend="false"> <video class="" controls preload="none" width="600" height="240" poster="http://video-js.zencoder.com/oceans-clip.png" > <source src="http://video-js.zencoder.com/oceans-clip.mp4" type='video/mp4' /> <source src="http://video-js.zencoder.com/oceans-clip.webm" type='video/webm' /> <source src="http://video-js.zencoder.com/oceans-clip.ogv" type='video/ogg' /> <track kind="captions" src="demo.captions.vtt" srclang="en" label="English" /> </video> </div>
<div class="caption randomrotate fullscreenvideo" data-x="0" data-y="0" data-speed="300" data-start="2100" data-easing="easeOutExpo" data-autoplay="true" data-nextslideatend="true"> <video class="" controls preload="none" width="100%" height="100%" poster="http://video-js.zencoder.com/oceans-clip.png" > <source src="http://video-js.zencoder.com/oceans-clip.mp4" type='video/mp4' /> <source src="http://video-js.zencoder.com/oceans-clip.webm" type='video/webm' /> <source src="http://video-js.zencoder.com/oceans-clip.ogv" type='video/ogg' /> <track kind="captions" src="demo.captions.vtt" srclang="en" label="English" /> </video> </div>
Boxed version
<div class="tp-caption sfl fadeout tp-videolayer" data-x="center" data-hoffset="134" data-y="center" data-voffset="-6" data-speed="600" data-start="1000" data-easing="Power4.easeOut" data-endspeed="500" data-endeasing="Power4.easeOut" data-autoplay="true" data-autoplayonlyfirsttime="false" data-nextslideatend="true" data-videowidth="640" data-videoheight="320" data-videopreload="meta" data-videomp4="http://themepunch.com/revolution/wp-content/uploads/2014/05/among_the_stars.mp4" data-videowebm="http://themepunch.com/revolution/wp-content/uploads/2014/05/among_the_stars.webm" data-videocontrols="none" data-forcecover="0" data-forcerewind="off" data-aspectratio="16:9" data-volume="mute" data-videoposter="http://themepunch.com/revolution/wp-content/uploads/2014/05/video_space_cover.jpg" > </div>
<div class="tp-caption sfl fadeout fulllscreenvideo tp-videolayer" data-x="0" data-y="0" data-speed="600" data-start="1000" data-easing="Power4.easeOut" data-endspeed="500" data-endeasing="Power4.easeOut" data-autoplay="true" data-autoplayonlyfirsttime="false" data-nextslideatend="true" data-videowidth="100%" data-videoheight="100%" data-videopreload="meta" data-videomp4="http://themepunch.com/revolution/wp-content/uploads/2014/05/among_the_stars.mp4" data-videowebm="http://themepunch.com/revolution/wp-content/uploads/2014/05/among_the_stars.webm" data-videocontrols="none" data-forcecover="1" data-forcerewind="on" data-aspectratio="16:9" data-volume="mute" data-videoposter="http://themepunch.com/revolution/wp-content/uploads/2014/05/video_space_cover.jpg"> </div>
In case you wish to show a single image instead of the Slider on Slower Browsers / mobiles, please simple use the aimg and aie8, amobile data attributes as shown here
<div class="tp-banner" data-aimg="../examples&source/images/slidebg1.jpg" data-aie8="enabled" data-amobile="enabled">...
Responsive means that the slider will adjust to every screen width. The Sourrounding Container Size will define the Max width of the Slider. The Height will be auto calculated.
.bannercontainer { width:100%; position:relative; padding:0; } .banner{ width:100%; position:relative; }
You can use the Slider also in FullScreen mode. It will need to have the possiblity to use the full width of the screen, means do not wrap it in any boxed container. For Fullscreen simple use the following markups and styles:
The markup could look like:
<div class="fullscreen-container"> <div class="fullscreenbanner"> </div> </div>
The Style has 100% width and height simple.
.fullscreen-container { width:100%; position:relative; padding:0; }
var tpj=jQuery; tpj.noConflict(); tpj(document).ready(function() { if (tpj.fn.cssOriginal!=undefined) tpj.fn.css = tpj.fn.cssOriginal; var api = tpj('.banner').revolution( ....
Used Assets
If you face problems with the installation or customization of our product please do not hesitate to contact us via our support ticket system: