=== FWD Linear Slider ===
Contributors: futurewebdesign
Donate link: https://fwdapps.net/p/ls/
Tags: slider, image slider, 3d slider, woocommerce, gallery
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A responsive 3D linear slider powered by Three.js and GLSL shaders, with premium distortion effects and full WordPress/WooCommerce integration.

== Description ==
**FWD Linear Slider** is a next-generation WordPress slider built with WebGL, Three.js, and custom GLSL shaders.
It creates fluid, organic item distortion while keeping setup simple through a built-in presets and galleries manager.

Use it for product showcases, portfolios, hero sections, and immersive visual storytelling.

== Links ==
- Homepage: <a href="https://fwdapps.net/p/ls/" target="_blank">https://fwdapps.net/p/ls/</a>
- Demos: <a href="https://fwdapps.net/p/ls/#demos" target="_blank">https://fwdapps.net/p/ls/#demos</a>
- Features: <a href="https://fwdapps.net/p/ls/#features" target="_blank">https://fwdapps.net/p/ls/#features</a>
- WordPress Documentation: <a href="https://fwdapps.net/p/ls/wordpress-documentation.php" target="_blank">https://fwdapps.net/p/ls/wordpress-documentation.php</a>
- JavaScript Documentation: <a href="https://fwdapps.net/p/ls/javascript-documentation.php" target="_blank">https://fwdapps.net/p/ls/javascript-documentation.php</a>
- Buy WP & Woo Plugin: <a href="https://fwdapps.net/product/linear-slider-wp" target="_blank">https://fwdapps.net/product/linear-slider-wp</a>
- Support: <a href="https://fwdapps.net/contact" target="_blank">https://fwdapps.net/contact</a>

== Highlights ==
- Responsive layout for desktop and mobile.
- Three.js + GLSL powered rendering and effects.
- Lazy initialize on scroll for better performance.
- Built-in presets manager and galleries manager.
- WooCommerce product gallery replacement support.

== Main Features ==
<h1>Responsive Layout</h1>
<p>Fully responsive and adaptable regardless of which device is used.</p>

<h1>Desktop & Mobile Optimized</h1>
<p>Linear Slider will adapt to any screen size and any device, wheater you are using a mobile phone (IOS, Iphone, Android) or on your desktop browser.</p>

<h1>Lazy Scrolling/Loading</h1>
<p>Option to initialize Linear Slider only when it becomes visible on scroll, preventing initialization if it's in an off-screen section. Linear Slider will load when the user scrolls to the section containing it.</p>

<h1>Multiple Display Types</h1>
<p>The slider can be displayed using a responsive layout or an "afterparent" mode, which allows it to adapt based on the size of the parent element.</p>

<h1>Customizable Size</h1>
<p>The slider size (width and height) can be set to any dimensions you need, and the Linear Slider can be added anywhere within your page content.</p>

<h1>Parallax</h1>
<p>Optional parallax scrolling effect.</p>

<h1>Preloader</h1>
<p>Optional animated preloader.</p>

<h1>Two Bending Vertices Type</h1>
<p>The central distortion can has two type, <a href="https://fwdapps.net/p/ls/preset-2.php" target="_blank">semicircular arc bending</a> or <a href="https://fwdapps.net/p/ls/preset-1.php" target="_blank">rotation bending</a>.</p>

<h1>Caption</h1>
<p>Optional captions for slider items, fully customizable with your own CSS styling.</p>

<h1>Opacity Strength</h1>
<p>Adjustable opacity effect for slider items when not selected or non dragged.</p>

<h1>Customizable Item Scale And Gap</h1>
<p>The minimum and maximum scale of items, as well as the gap between them, can be set.</p>

<h1>Mouse Rotation</h1>
<p>Optional mouse <a href="https://fwdapps.net/p/ls/preset-3.php" target="_blank">slight animated rotation effect</a> based on the mouse position.</p>

<h1>Item Noise Animation</h1>
<p>Optional item noise animation, the items will add a flag like customizable animation, <a href="https://fwdapps.net/p/ls/preset-7.php" target="_blank">example here</a>.</p>

<h1>Scroll Speed Strength</h1>
<p>Adjustable drag speed for smooth, responsive slider control with the mouse.</p>

<h1>Scroll Scale Strength</h1>
<p>Adjustable scroll scale strength to control how items scale during scrolling.</p>

<h1>Distortion Curve</h1>
<p>Adjustable item distortion curve as the slider is dragged, <a href="https://fwdapps.net/p/ls/preset-4.php" target="_blank">example here</a>.</p>

<h1>Fluid Post-Processing effect</h1>
<p>Intro fluid effect, <a href="https://fwdapps.net/p/ls/preset-6.php" target="_blank">example here</a>.</p>

<h1>Post Processing</h1>
<p>Various post-processing effects included—mouse ripple, fluid distortion, grid effect, afterimage, bulge, and more.</p>

== Installation ==
1. Upload the plugin folder to the `/wp-content/plugins/` directory.
2. Activate the plugin from the WordPress Plugins screen.
3. Open **FWD Linear Slider** in the WordPress admin menu.
4. Create or edit a preset and a gallery.
5. Add the shortcode in any page, post, or block.

== Shortcode ==
Basic example:

[fwdls preset_name="Preset 1" gallery_name="Gallery 1"]

== WooCommerce Integration ==
The plugin can replace the default WooCommerce single product gallery with a selected Linear Slider preset/gallery when configured via shortcode settings.

== Frequently Asked Questions ==

= Does it work with Gutenberg? =
Yes. You can add the shortcode in any block, including the Shortcode block.

= Is it mobile friendly? =
Yes. It is responsive and optimized for touch interactions.

= Can I customize effects without coding? =
Yes. Most visual and motion options are available in the presets manager.

== Development ==
This plugin’s full source code is publicly available for transparency and verification.  
Developed and maintained by [FutureWebDesign](https://fwdapps.net).

- [Source code & build tools](https://fwdapps.net/d/js/ls.zip) — includes original uncompiled files and Vite build configuration.
- Distributed plugin uses a compiled build generated by Vite for optimal performance.

