=== SosWoo Responsive Image Slider ===
Contributors: sudeshdinkar
Tags: slider, image slider, swiper, carousel, lightbox
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create responsive image sliders from your WordPress Media Library and display them anywhere with a simple shortcode.

== Description ==

SosWoo Responsive Image Slider is a lightweight WordPress plugin for creating responsive image sliders from your WordPress Media Library. Create and manage multiple sliders, configure autoplay and animation settings, choose horizontal or vertical movement, and display each slider on a post or page with a simple shortcode.

The plugin includes click-to-zoom and optional full-screen lightbox viewing. Its bundled Swiper library is loaded locally, so the slider does not depend on an external CDN. The responsive layout adapts to desktop, tablet, and mobile screens.

== Explore the Pro Version ==

Need more advanced ways to showcase your products, images, and videos? The **SosWoo Responsive Image Slider Pro** version adds features for creating richer, more interactive slider experiences.

Pro features include:

* Additional slider transition effects and thumbnail navigation.
* Image and video slides, including MP4, YouTube, and Vimeo content.
* Animated layers and shoppable hotspots.
* Enhanced zoom and touch interactions, including pinch and double-tap gestures.
* A license activation system and automatic updates for the Pro plugin.

The Pro version can be useful for business websites and WooCommerce stores that want more interactive product showcases. WooCommerce is optional; the slider can also be used on regular WordPress pages.

[Explore SosWoo Responsive Image Slider Pro](https://soswoo.com/woocommerce-plugin/soswoo-responsive-image-slider/).

== Features ==

* Create and manage multiple image sliders.
* Select images directly from the WordPress Media Library.
* Display sliders anywhere using a simple shortcode.
* Manual sliding with left/right navigation arrows.
* Automatic sliding with configurable slide delay.
* Configure animation speed.
* Choose horizontal or vertical slide direction.
* Click-to-zoom image viewing.
* Optional full-screen lightbox image viewing.
* Responsive display for desktop, tablet, and mobile screens.
* Option to keep or remove plugin data when the plugin is uninstalled.
* Swiper library is bundled locally with the plugin.

== Usage ==

After activating the plugin:

1. Go to **SosWoo Slider > Add New Slider**.
2. Enter a slider title and select the images you want to display.
3. Configure the available slider settings.
4. Save the slider.
5. Copy the generated shortcode.
6. Paste the shortcode into a post, page, or other supported WordPress content area.

The shortcode format is:

`[soswoo_slider id="123"]`

Replace `123` with the ID of the slider you want to display.

== Installation ==

1. Install the plugin through the WordPress Plugins screen, or upload the `soswoo-responsive-image-slider` folder to `/wp-content/plugins/`.
2. Activate **SosWoo Responsive Image Slider** through the **Plugins** screen.
3. Go to **SosWoo Slider > Add New Slider**.
4. Create your slider and copy its shortcode.
5. Add the shortcode to the post or page where you want the slider to appear.

== Frequently Asked Questions ==

= How do I display a slider? =

Create a slider under **SosWoo Slider > Add New Slider**, then copy its shortcode. For example:

`[soswoo_slider id="123"]`

Replace `123` with your slider ID.

= Can I create more than one slider? =

Yes. You can create and manage multiple sliders and use a different shortcode for each slider.

= Can the slider move automatically? =

Yes. The slider can be configured for automatic sliding, with settings for slide delay and animation speed.

= Can I use vertical sliding? =

Yes. The slider supports both horizontal and vertical slide directions.

= Does the plugin work on mobile devices? =

Yes. The slider is responsive and adapts to different screen sizes, including mobile devices.

= Does the plugin require an external CDN? =

No. The plugin includes the required Swiper CSS and JavaScript files locally.

= What happens to my slider data when I uninstall the plugin? =

The plugin provides an option to keep or remove its data when it is uninstalled. To remove the plugin data, disable the **Keep data on uninstall** option in **Slider Settings** before uninstalling.

== Screenshots ==

1. Slider Settings — Configure title display, manual or automatic operation, slide direction, timing, animation speed, image expansion mode, and uninstall data preferences.
2. Add New Slider — Create a slider, add image URLs using the Media Library, and generate a shortcode.
3. Slider Shortcodes — View created sliders, their IDs, and shortcodes, with options to search and delete sliders.
4. Upgrade to Pro — License activation screen for the Pro version.
5. Responsive Image Slider — Front-end slider with navigation arrows and responsive image display.
6. Full-Screen Lightbox — View a slider image in a full-screen lightbox with navigation controls.
7. Mobile Responsive View — Responsive slider display on a mobile screen.
8. Vertical Slider — Display images using the vertical slide direction.
9. Click to Zoom / Click to Shrink — Inline image zoom mode with click-to-zoom and click-to-shrink behavior.

== Third-Party Libraries ==

This plugin bundles **Swiper 14.3.0**, which is distributed under the MIT License.

Swiper is included locally in the plugin's `public/css` and `public/js` directories.

Source: https://github.com/nolimits4web/swiper
License: https://github.com/nolimits4web/swiper/blob/master/LICENSE

== Changelog ==

= 1.2.1 =
* Updated the bundled Swiper library from 11.0.0 to 14.3.0.
* Updated the plugin text domain to match the WordPress.org plugin slug.
* Updated bundled asset version references.

= 1.2.0 =
* Bundled Swiper locally instead of loading it from a CDN.
* Improved output escaping and input sanitization.
* Added safer redirect handling.
* Improved form-data handling and security checks.
* Improved uninstall data handling.

== Upgrade Notice ==

= 1.2.1 =
Updated the bundled Swiper library and corrected the plugin text domain for WordPress.org compatibility.

