LayerSlider WP - The WordPress Parallax Slider from Kreatura Media

# LayerSlider WP 3.6.2

## The WordPress Parallax Slider

### Documentation

- Overview
  - Thank you
  - Features
  - Changelog
- Requirements
  - WordPress
  - Browser Support
- Installation
  - Installation via WP plugin installer
  - Installation via FTP
- How do I update the plugin?
  - Is there any auto-update mechanism?
  - How do I update the plugin?
  - How do I get the new features of an update?
- How to translate the plugin
- Backward compatibility since version 3.5
- Credits
- The rest of this documentation
- Documentation for Developers
- Contact

### Overview

## This is a WordPress plugin of the LayerSlider! You can create as many layers and sublayers as you want. You can use unlimited images with links. The script is very user-friendly, you can add global settings or local (per slide) settings to each layer or sublayer. You can change delay times, easing types, durations and much more.

### Thank you

Thank you for purchasing this product. If you have any questions that are beyond the scope of this documentation, please feel free to email us.

### Features

- 5 displaying modes (normal, responsive, full-width, full-width + responsive & full-width + responsiveUnder.
- Smart resizing and repositioning image, video and also text sublayers in responsive modes including font-sizes, line-heights, etc.)
- Unlimited types of usage (image slider, image slider with text, content slider, video gallery slider, mixed content slider, etc...)
- Unlimited variations of animations (sliding from / to 4 directions or fading in / out (sublayers only) with countless easing types and sublayers can slide or fade out before other sublayers appear)
- 3 types of navigation controls (thumbnail mode, hover thumbnails with buttons & buttons only) with auto hide feature
- Use with ANY content you want (images, HTML elements, Flash movies, YouTube videos, etc.)
  (best view with semi-transparent PNG images or CSS3 styled HTML elements)
- Unlimited number of layers / sublayers
- Stunning WYSIWYG editor (Real-time dragging, reordering, styling, duplicating, disabling layers and sublayers) with real-time preview feature!
- Deep linking
- Automatic slideshow feature (optional: Backwards-Slideshow) with start with a random layer feature
- Random slideshow feature
- Smart features for full screen sliders (responsiveUnder & sublayerContainer)
- Image preload feature
- Auto-play embedded YouTube and Vimeo videos (configurable)
- Auto-pause slideshow while videos are playing
- Auto-preview images to YouTube and Vimeo videos
- Loops feature
- Customizable UI
- Per-layer settings with rel or style tags
- Easy link to another layer or to an URL
- Powerful API with callback functions
- Keyboard navigation
- Touch control for mobile devices (iOS tested)
- yourLogo feature with link option
- Skin support with 8 pre-defined skins
- SEO friendly
- Multiple browser support (IE 7+, Safari 3+, iOS Safari, Chrome 3+, Firefox 3+, Opera 10+)
- Detailed Documentation with examples
- Sample Sliders included
- Free future updates and support!

### Changelog

3.6.2

- Bug fix: fixed an issue with the WP content filters messing with the inline Javascript code in some themes

3.6.1

- Improvement: added support for the new WP 3.5 Media Library with bulk image uploading
- Bug fix: fixed the global background image option
- Bug fix: fixed the navigation buttons on RTL sites

3.6.0

- New features
  - Multisite ready with network-wide activation and handling new sites in the network
  - Localization ready, you can translate the entire plugin, including the admin user interface
  - Support for translation plugins (like qTranslate) to create multilingual sliders
  - Skin editor, you can now modify the LayerSlider WP skins from your WordPress admin area
- Improvements
  - Workaround for the duplicating init code
  - Better compatibility with WordPress 3.5 (fixed buttons, colorpicker, etc...)
  - Improved debug mode
- Bug fixes
  - Some minor bug fixes

3.5.0

- New features
  - Added two types of fully customizable thumbnail navigation
  - Ability to set custom thumbnail image for thumbnail navigation
  - Added three new skins
  - Thumbnail navigation added to all (new and old) skins
  - Added randomSlideshow feature
  - Added responsiveUnder feature for full width sliders (slider will switch into responsive mode when you reduce the screen size under a given size)
  - Added sublayerContainer feature for full width sliders (sublayers are positioned inside a centered container)
  - Added hoverPrevNext feature (prev and next buttons will shown only on hover)
  - Added hoverBottomNav feature (bottom navigation will shown only on hover)
  - Added debug mode
- Improvements
  - Huge performance improvements
  - For a faster and more reliable solution, the new version uses different data storage
  - Deleting a slider won't rearrange their IDs anymore
  - Compatibility for the upcoming WordPress 3.5 version
  - Better handling of deep linking, the page won't scroll away now
  - Changes in the sample sliders
  - Replaced the skin text field with a select box which automatically detects new skins
- Bug fixes
  - Fixed slideDelay when animateFirstLayer is enabled
  - Fixed slideIn and slideOut animations when there is only one layer in the slider
  - Fixed yourLogo percentage positioning
  - The slider won't fail to load when the skin isn't available now
  - Restored sliderStyle field to apply your custom style setting on the slider
  - Positioning sublayers in the WYSIWYG editor with percentage values is now fixed
  - Fixed relative URLs option
- Other
  - Added documentation for developers

3.0.2

- moved the plugin resources to the head because a lot of themes doesn't trigger wp_footer()
- fixed notices in debug mode

3.0.1

- fixed a packaging issue

3.0.0

- New features
  - Entirely new admin user interface
  - Built-in Preview feature in the WYSIWYG Editor
  - Added smart resizing in responsive modes: resizing and repositioning image, video and also text(!) sublayers in responsive mode including font-sizes, line-heights, etc.)
  - Included free sample sliders
  - Better documentation included with the WP contextual help menus
  - Duplicating and disabling sliders, layers and sublayers
  - 'Show until' feature (sublayers can now fade / slide out before other sublayers appear)
  - Deep linking feature
  - Option to start with a random layer
  - Adding IDs for layers
  - Added text fields for HTML default element attributes such as title or alt
- Improvements
  - Option to use absolute or relative URLs for images
  - Modified LayerSlider API make easier your job if you want to create something unique
  - Changes in importing sliders, it is now just adding the new ones and leave the old sliders
  - Positioning with percentage values is more reliable
  - LayerSlider WP now generate less code and they are only included when necessary
  - We now adding special classes to the slider GUI elements, so you can make more complex skins
  - Preventing WordPRess to wrap your sublayers in <code> or <p> elements
  - Workaround for the post_max_vars issue, LayerSlider WP now can handle unlimited number of layers and sublayers
- Bug fixes
  - Flickering when the slider loading is now fixed
  - Fixed the IE tooltip issue
  - Fixed the white gap between the layers when the slider commencing slide change
  - Fixed linkTo feature

2.0.0

- added loops feature
- added autoPlay feature for embedded YouTube and Vimeo videos
- added autoPauseSlideshow feature while videos are playing
- added auto-preview image feature to YouTube and Vimeo videos
- added linkTo feature
- added import / export feature
- you can now easily add an ID to any sublayer
- LayerSlider WP is now parsing shortcodes
- added some GUI improvements
- included two new skins
- touch control now can be disabled
- changed one layer mode (not duplicating it now)
- fixed a wrong variable
- fixed a wrong function in forceResponsive mode
- fixed yourLogo style settings, reset and yourLogoTarget
- fixed global background setting
- fixed saving method
- changed from absolute to relative URLs
- https aware
- fixed a bug when a new image sublayer is reordered
- fixed a bug in forceResponsive mode
- the bottom side of the slider (next to the controls) is now clickable
- a lot of minor bugfixes and improvements

1.8.0

- facelifted admin page for better usage
- added an option to style your LayerSlider container from admin
- added "auto" options by default to slidedirection and slideoutdirection properties of sublayers
- added forceResponsive feature (LayerSlider WP now can "get out" from your wp theme, so it's width can be real responsive now)
- changed back to normal PHP opening tags from short opening tags
- fixed the "create new slider" width bug
- fixed some animations
- reset buttons now real-time modifying backgrounds
- added background-images of layers to preload
- modified some CSS styles
- some parts of the source code rewritten
- added yourLogoLink feature
- added yourLogoTarget feature
- added noskin feature

1.7.0

- fixed fading bug (sublayers now appears if sliding in after fading out)
- fixed preload bug with sublayers with gradient backgrounds
- fixed working delayout of layers (From now, if you add a delayout to a layer, sublayers of that layer will be animating out immediately, but the layer (and the next layer) will be delayed by the delayout time of the current layer. So, you can animate out all sublayers BEFORE the parent layer will begin the animation.)
- fixed imagepreload bug
- added an option to animating the first slide instead of fading in
- the script is now fully responsive! (You can add % instead of pixels to left and top properties of sublayers and width or height properties of LayerSlider container.)
- fixed globalimage bug
- added LayerSlider API Callback functions to WYSIWYG editor
- added yourLogo feature (You can now display your fixed logo above the LayerSlider container.)
- some minor bugfixes and improvements

1.6.0

- now supports any HTML content with CSS styling!
- now sublayers supports fading transition
- added slideoutdirection property to sublayers
- added global background color / background image support
- added a possibility to name and reorder layers
- fixed LayerSlider widget
- fixed '1px gap' bug
- fixed one layer bug
- fixed empty sublayer bug
- fixed swing, linear and easeInOutQuint animations
- fixed hover on pause / stop bug
- fixed wrong directions of animations if navigating by slidebuttons
- fixed durationout property for sublayers
- fixed reordering sublayers

1.5.1

- minor bugfixes

1.5.0

- first release

### Requirements

### WordPress

- WordPress 3.3+

### Browser Support

- Mozilla Firefox 3+
- Google Chrome 10+
- Safari 3+
- iOS Safari
- Opera 10+
- Internet Explorer 7+

Note: in old browsers some animations (for example fading the transparent PNGs) are missing, but the plugin is fully functional.

### Installation

#### Installation via WP plugin installer

1. Extract the plugin package on your machine that you downloaded from CodeCanyon.
2. Hover over the plugins menu item on your left sidebar in your WordPress admin area and select "Add New".
3. In the new page click on the "Upload" menu item on top of the page.
4. Choose the "layersliderwp-3.6.2.installable.zip" file that you extracted from the downloaded package and click "Install Now".
5. WordPress may ask you to type your FTP login credentials to install the plugin. Click on "Proceed" when you finished.
6. The plugin is now installed, click on the "Activate Plugin" button.

#### Installation via FTP

1. Extract the plugin package on your machine that you downloaded from CodeCanyon.
2. Find the "layersliderwp-3.6.2.installable.zip" file in the extracted content and extract it also.
3. Open your favourite FTP application and connect and navigate to your "/wp-content/plugins/" folder
4. Copy over the extracted "layersliderwp-3.6.2.installable.zip" file
5. Navigate to your plugins page on your WordPress admin area and click the "Activate" button below LayerSlider WP

### How do I update the plugin?

#### Is there any auto-update mechanism?

WordPress only supports auto-updates for plugins installed from their own plugins depository. Although, there are ways to support auto-updates for plugins downloaded from CodeCanyon, it isn't that reliable since the WP Dev. Team isn't offer any official API to developers. You have to update the plugin manually by download it again from your CodeCanyon downloads page. It is, of course, free of charge. You should check it sometimes because we are relesing updates for our items regularly.

#### How do I update the plugin?

If you downloaded the most recent version, you can go ahead to deactivate and remove the old version, then install the new one. Your sliders and settings are in the database, removing the plugin won't touch them. The new version always has backward compatiblity, so you don't have to worry about anything.

#### How do I get the new features of an update?

Depending on the default settings, you may have to enable or disable some settings related with the new features. If you experience an unwanted behaviour change after an update, it is always a good idea to check the settings of your sliders, because there are probably new options to control these changes.

### How to translate the plugin

LayerSlider WP is translation and localization ready, you can easily translate the entire plugin for your native language. To do this, please follow the steps below:

- Download Poedit
  Poedit is a multiplatform application which you can use to translate .PO files easily and compile them into .MO files. You can download it from here.
- Start translating
  Launch Poedit and open the default .PO file (LayerSlider-en_US.po) for editing. It can be found in your "/wp-content/plugins/LayerSlider/languages/" folder. When you open this file, you will have a list of the all the available strings for translating. When you save your work, Poedit will generate an MO file, WordPress will use this file to load your translation.
- Use your translation
  When you finished, you need to rename your new .PO and .MO files, so WordPress will be able to identify the corresponsing language that you made your work for. You have to include in their file name the name of the plugin followed by a dash and the language and country identifier spearated with an underscore. Here you can find all the language codes, and here are the country identifiers. For example, your new files will be: LayerSlider-fr_FR.po and LayerSlider-fr_FR.mo.
  After that, you need to copy your new files into your "/wp-content/plugins/LayerSlider/languages" folder.
  And that's it, you are ready to go. Please note that your WordPress installation needs to be set to the extact same locale as you specified in your file names. This settings can be found in your wp-config.php file. If you are using WordPress in your native language, you don't have to worry about this setting.
- Publish your work
  If you translated the plugin, you can help to other users from your country. You can send us the .PO and .MO files, and we will include them in the next update of the plugin, so your translations will be available for every other users. Our email address is: contact@kreaturamedia.com

### Backward compatibility since version 3.5

The new version of LayerSlider WP is fully compatible with older versions of the plugin. However, in version 3.5 there are major changes under the hood that you should know about.
If you install the plugin for the first time, you don't have to read this section of the documentation.

- Converting the plugin data for version 3.5 and above
  LayerSlider WP 3.5 uses a different data storage which is faster and more reliable. The plugin requires you to convert your data associated with the plugin and it will prompt you with a banner on the top of your WP admin page. It is fully automatic, your sliders and settings will remain still, it only takes a click on the "Convert Data" button.
- Importing from older versions
  The new data storage doesn't affect importing, LayerSlider WP 3.5 and above accepts any export codes, even from older versions. However, if you want to import sliders from older installations, it isn't a bad idea to update the plugin first, then export your sliders, although it isn't necessary.

### Credits

- We are using FatCow's icon theme. This is an amazing set of beautiful icons, you should check it out. Thanks guys for made this available for us, we love your work!

### The rest of this documentation

This documentation only covers the basic things you need to know such as the plugin installation. We are using the WordPress contextual help menus to integrate our documentation directly into the admin area where you will work on your sliders. It is much more convenient for everybody, and also, you can access to the documentation quickly. And because it is contextual, it only shows the things you will need to work with.
You can find the rest of our documentation in the LayerSlider WP admin area. You can access it with the "Help" menu item on the top right corner of the page.

### Documentation for Developers

If you are a developer, you probably want to check out our documentation for integrating LayerSlider WP into your theme. Please click here.

### Contact us!

## If you like our works.
If you need a help in using one of our CodeCanyon items.
If you have a great idea which we can work together.