=== W3 Relations Carousel for Elementor ===
Contributors: w3relations, shukur5674
Donate link: https://w3relations.com/
Tags: elementor, carousel, slider, slick-carousel, nested-elements
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create responsive Elementor slick carousels with native nested slides, allowing any widget to be added inside carousel slides.

== Description ==

**W3 Relations Carousel** is a feature-rich Elementor addon widget that integrates Elementor's native **Nested Elements API**. It enables you to create fully responsive, customizable slick carousels where every slide functions as a native container. You can drag and drop any Elementor widget—headings, images, buttons, forms, nested containers, or custom widgets—directly into any slide.

= Key Features =

* **Native Elementor Nested Elements Support**: Drag and drop any Elementor widget directly inside carousel slides.
* **Fully Responsive**: Configure independent **Slides to Show** and **Slides to Scroll** for Desktop, Tablet, and Mobile devices.
* **7 Arrow Navigation Positions**: Position carousel arrows anywhere:
  1. Left / Right (Classic sides)
  2. Top Left
  3. Top Center
  4. Top Right
  5. Bottom Left
  6. Bottom Center
  7. Bottom Right
* **Custom Navigation Icons**: Choose custom SVG or FontAwesome icons for Previous and Next arrows using Elementor Icons Manager.
* **Dot Pagination Controls**: Toggle dot navigation, customize dot sizes, active colors, normal colors, and top spacing.
* **Comprehensive Carousel Settings**:
  * Autoplay on/off with customizable Autoplay Speed (ms).
  * Infinite loop toggle.
  * Pause on hover toggle.
  * Customizable Animation Speed (ms).
* **RTL Support**: Built-in Right-to-Left language compatibility.
* **Seamless Editor Experience**: Complete editor-side slide scrolling and dot pagination support without breaking Elementor's drag-and-drop container system.

== Installation ==

1. Upload the `w3-relations-carousel` folder to the `/wp-content/plugins/` directory (or upload the `.zip` archive via **Plugins > Add New > Upload Plugin**).
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Open any page in the **Elementor Editor**.
4. Look for the **W3 Relations Carousel** widget in the **W3 Relations** category or search for "Carousel".
5. Drag and drop the widget onto your page and start adding Elementor widgets into the carousel slides!

== Frequently Asked Questions ==

= Does this plugin require Elementor? =
Yes, W3 Relations Carousel is an addon plugin designed specifically for Elementor (version 3.10+ recommended for Nested Elements API support).

= Can I put any widget inside a carousel slide? =
Yes! Thanks to Elementor's native Nested Elements API, each slide acts as a container. You can drag and drop any widget, layout container, image, heading, form, or shortcode inside.

= How do I change the number of visible slides on mobile? =
Select the **W3 Relations Carousel** widget, navigate to **Content > Carousel Settings**, and click the device icon next to **Slides to Show** to set different values for Desktop, Tablet, and Mobile.

= Is RTL supported? =
Yes, the plugin automatically detects your site's text direction and supports Right-to-Left (RTL) layouts.

== Screenshots ==

1. Elementor Editor experience with native slide containers.
2. Carousel settings panel showing responsive controls and 7 arrow positions.
3. Frontend rendered slick carousel with custom arrow styling and dots.

== Changelog ==

= 1.0.2 =
* Fix: Resolved issue where carousel JS & CSS were not loading on non-Elementor pages when rendered via header container shortcodes.
* Fix: Explicitly enqueued scripts on `wp_enqueue_scripts` and widget render for seamless shortcode rendering.
* Fix: Improved container margin reset styling for non-Elementor page rendering.

= 1.0.1 =
* Fix: Resolved issue where nested widgets inside slide containers were not rendering in the Elementor Editor.
* Fix: Improved active dot state synchronization and smooth scrolling in editor preview.

= 1.0.0 =
* Initial release of W3 Relations Carousel plugin.
* Native Elementor Nested Elements API integration.
* Responsive slide settings, 7 arrow positions, and custom styling options.
* Full editor preview and seamless drag-and-drop support.
