=== PistonUI ===
Contributors: pistonui
Tags: elementor, widgets, slider, woocommerce, grid
Requires at least: 5.6
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

High-performance custom widgets for Elementor. Includes a Sliding Hero, WooCommerce grids, and more.

== Description ==
PistonUI provides a growing set of high-quality widgets designed for speed and flexibility. Perfect for creating stunning landing pages, product showcases, and engaging content sections without any coding knowledge.

**Core Widgets:**
* **Sliding Hero** - Beautiful full-width hero slider with multiple headings, descriptions, CTA buttons, and customizable overlay effects
* **Promo Banner** - Eye-catching promotional banners with flexible image positioning and customization options
* **Accordion** - Interactive FAQ/accordion widget with custom icons and smooth animations
* **TikTok Videos** - Display your TikTok videos in a responsive carousel with customizable items per screen size

**WooCommerce Widgets:**
* **Category Showcase** - Display WooCommerce product categories with custom images, titles, and product counts
* **Category Icons Grid** - Grid layout for category icons with hover effects
* **Products Grid** - Showcase products in a responsive grid with sorting and filtering options
* **Product Slider** - Dynamic product carousel with configurable columns and responsive breakpoints

All widgets include comprehensive style customization options, responsive design controls, and work seamlessly with Elementor's native features.

== Installation ==
1. Upload the plugin files to the `/wp-content/plugins/pistonui` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Ensure Elementor (and WooCommerce for Woo widgets) are activated.
4. Open Elementor and find widgets under the "🔥 PistonUI Widgets" category.

== PistonUI Dashboard ==

Access the PistonUI Dashboard from your WordPress admin menu to configure and customize the plugin settings.

**General Settings:**
* **Owl Carousel Assets** - Enable or disable Owl Carousel CSS and JavaScript site-wide. Toggle this off if you're already loading Owl Carousel elsewhere to avoid conflicts.
* **Bootstrap Grid** - Enable Bootstrap Grid v4 CSS for layout control. Disable if you don't need grid utilities or if you're using a different grid system.

**Widget Management:**
* **Enable/Disable Widgets** - Control which widgets appear in Elementor. Disable widgets you don't need to keep your Elementor panel clean and focused.
* **Core Widgets Control** - Toggle individual core widgets (Sliding Hero, Promo Banner, Accordion, TikTok Videos)
* **WooCommerce Widgets** - Manage WooCommerce-specific widgets. Only shown when WooCommerce is active.

**Support Tab:**
* Access documentation links
* View system information for troubleshooting
* Contact support team
* Report bugs on GitHub

The dashboard provides full control over which widgets are available, helping you optimize performance by loading only what you need.

== Features ==

**Performance Optimized:**
* Lightweight and fast-loading widgets
* On-demand asset loading
* Optional vendor library management
* Clean, minimal code without bloat

**Developer Friendly:**
* Well-structured, documented code
* Hooks and filters for customization
* Namespaced PHP classes
* WordPress coding standards compliant

**User Friendly:**
* Intuitive Elementor interface
* Real-time preview in editor
* Extensive customization options
* Responsive by default

**Flexible & Customizable:**
* Enable/disable widgets individually
* Control vendor assets
* Full style and typography controls
* Responsive breakpoint configuration

== Frequently Asked Questions ==

= Do I need Elementor Pro? =
No, PistonUI works perfectly with Elementor Free. Some advanced styling features may benefit from Pro but are not required.

= Does it work without WooCommerce? =
Yes! Core widgets (Sliding Hero, Promo Banner, Accordion, TikTok Videos) work without WooCommerce. WooCommerce-specific widgets only appear if WooCommerce is installed and activated.

= How do I control which widgets are loaded? =
Use the PistonUI Dashboard (WordPress Admin > PistonUI > Widgets tab) to enable or disable specific widgets. This helps optimize performance and keeps your Elementor panel organized.

= Can I customize the widgets? =
Yes! All widgets include comprehensive style controls including typography, colors, spacing, borders, backgrounds, and more. Every widget is fully responsive with device-specific options.

= Can I request a new widget? =
Yes! We're always looking to add useful widgets based on community feedback. You can open a support request or contact the plugin developer with your suggestions.

= Will this slow down my site? =
No, PistonUI is designed for performance. Widgets load only when used, vendor assets can be controlled, and the code is optimized for speed.

== Screenshots ==
1. Sliding Hero widget in action
2. WooCommerce Category Grid
3. Admin dashboard settings

== Changelog ==
= 1.0.0 =
- Initial release to WordPress.org

== External Services ==

= TikTok oEmbed =
- What: The TikTok Videos widget may request oEmbed data from TikTok to retrieve a video thumbnail.
- When: When a TikTok video is added without a custom thumbnail, at render time the server requests TikTok’s oEmbed endpoint to fetch metadata/thumbnail.
- Data sent: The TikTok video URL you provide in the widget is sent to TikTok’s oEmbed endpoint. The request originates from your server.
- Purpose: To automatically display a thumbnail image for the TikTok link.
- Terms: https://www.tiktok.com/legal/terms-of-service?lang=en
- Privacy: https://www.tiktok.com/legal/page/eea/privacy-policy/en