=== Calio Addon for Elementor - Widgets, Slider & Extensions ===
Contributors: sermedias
Tags: elementor, elementor addons, widgets, woocommerce, product slider
Requires at least: 6.7
Tested up to: 7.0
Requires PHP: 8.2
Stable tag: 1.11
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Build flexible Elementor pages and faster store workflows with modular widgets, WooCommerce elements, dashboard tools, and lightweight extensions.

== Description ==

Calio Addon extends Elementor with a growing collection of creative widgets, practical site-building extensions, and optional WooCommerce admin tools. It is built for designers, freelancers, agencies, and store owners who want more layout options inside Elementor and quicker store checks inside WordPress without loading every feature on every page.

The plugin includes content widgets, post widgets, team widgets, navigation widgets, pricing widgets, data/table widgets, gallery widgets, chart widgets, an image comparison widget, and a WooCommerce product slider. It also includes optional WordPress Dashboard tools for WooCommerce inventory, order revenue monitoring, customer geography insights, traffic attribution summaries, and inline product management. Each module is designed to work inside the familiar WordPress or Elementor workflow, with controls for typography, colors, spacing, borders, icons, responsive behavior, data visibility, and layout details where the module needs them.

= Why use Calio Addon? =

* Modular widget control: Enable only the widgets and extensions you need from the Calio admin dashboard.
* Dashboard widget control: Enable or disable optional Calio dashboard tools from the same module settings area.
* Lightweight loading: Conditional asset loading helps avoid unnecessary frontend scripts and styles.
* Elementor-native workflow: Controls are added directly inside Elementor, so you can build and preview visually.
* WooCommerce ready: Showcase products with a flexible product slider powered by Elementor's registered Swiper assets.
* Store admin helpers: Monitor low stock, revenue risk, recent customer geography, traffic sources, and product prices from focused admin screens.
* Practical design tools: Add accordions, tabs, buttons, headings, galleries, tables, pricing sections, team layouts, post layouts, and more.
* Site utility extensions: Add effects such as wrapper links, sticky content, scroll fill, reveal/parallax behavior, and glass-style filters.

= Free Elementor widgets included =

* Accent Headline: Create highlighted headings with flexible text styling.
* Accordion: Display collapsible content sections for FAQs and structured content.
* Advanced Button: Build call-to-action buttons with icon, layout, and hover controls.
* Advanced Heading: Create styled headings with prefix, main, and suffix text options.
* Animated Link: Add interactive text links with underline, reveal, glitch, slide, and hand-drawn hover styles.
* Business Hours: Show opening hours and schedules in a clean layout.
* Breadcrumbs: Show Home, parent pages, archive context, and the current page in a customizable breadcrumb trail.
* Call Out: Highlight offers, announcements, or important messages.
* Countdown: Add countdown timers for launches, events, and promotions.
* Cube Slider: Create visual slider layouts with a cube-style effect.
* Fancy Chart: Display chart data with configurable visual styles.
* Fancy Tabs: Organize related content into tabbed sections.
* Feature List: Present features with icons, titles, and descriptions.
* Feature List Simple: Add compact feature rows for quicker layouts.
* Filterable Gallery: Display image galleries with category filtering.
* Image Comparison Slider: Compare before and after images with draggable handle, labels, overlay color, and transition speed controls.
* Image Flow: Create flowing image layouts for visual sections.
* Image Gallery: Build responsive galleries with Elementor controls.
* Kinetic Card: Add interactive card layouts for featured content.
* Mega Menu: Build richer navigation experiences for Elementor sites.
* Multicolumn Pricing Table: Compare plans and pricing in multiple columns.
* Navbar: Add customizable navigation bars.
* Post Carousel: Showcase posts in a carousel layout.
* Post Grid: Display posts in a clean grid.
* Post Timeline: Present posts or content in a timeline format.
* Posts Tab: Group post lists by tabs for easier browsing.
* Progress Pie: Show circular progress indicators.
* Stylish List: Create styled lists with icons and spacing controls.
* Table: Add static or external CSV table data to Elementor pages.
* Team Member: Highlight individual team profiles.
* Team Slider: Display team members in a slider.
* WooCommerce Slider: Showcase store products with product query, badge, price, button, image, and navigation controls.

= Free extensions included =

* Glass Filter: Add glass-style visual treatment to supported elements.
* Scroll Fill Effect: Animate fill-style effects while scrolling.
* Wrapper Link: Add links to sections, containers, or supported elements.
* Reveal / Parallax: Add reveal and parallax-style motion effects.
* Sticky Content: Keep selected content visible while scrolling.

= WooCommerce product slider =

Calio Addon includes a free WooCommerce Slider widget for Elementor. You can display latest products, featured products, sale products, best-selling products, top-rated products, or manually selected products. The widget includes product image, title, category, price, sale badge, rating, add-to-cart action, view product action, carousel navigation, responsive slide controls, and skin/layout options.

= WooCommerce dashboard and admin tools =

Calio Addon includes optional WooCommerce-focused dashboard tools that can be enabled or disabled from the Calio module settings. These tools are designed for store owners who want quick operational checks without opening several different admin pages.

Included dashboard and admin tools:

* Dashboard Widgets Manager: Control which Calio dashboard cards are active on the WordPress Dashboard.
* Calio Addon Overview: Review enabled widgets, active module counts, version details, and recent changelog highlights.
* Live Inventory HUD: Monitor product and variation stock levels, highlight low-stock items, search by product name or SKU, refresh with AJAX, and export inventory to CSV in the browser.
* Order Processing Monitor: Review seven-day revenue totals for completed, pending, and at-risk orders, with cached calculations, progress bars, risk highlighting, and a filtered at-risk order link.
* Marketing Intelligence HUD: View recent-order geography rankings and WooCommerce attribution source summaries with tabbed views and CSV export.
* Inline Products: Manage products from a dedicated admin page with searchable and sortable product rows, inline regular/sale price editing, pagination, variation support, and description modals.

= More widgets in Calio Pro =

Calio Pro is available as a paid companion plugin for users who want additional creative widgets, advanced WooCommerce layouts, interactive content sections, and more motion-focused Elementor components.

Selected Pro widgets include:

* Advanced Accordion
* Advanced Icon Box
* Advanced Progress Bar
* Background Slider
* Bento Grid Posts
* Bouncing QR Code
* Calendar
* Card Deck
* Card Slider
* Circle Info
* Content Timeline
* Data Table
* Fancy Text
* Flipbook PDF Reader
* Flip Gallery
* Flow Step
* Horizontal Timeline
* Image Reveal Menu
* Instagram Feed
* Interactive Dock Menu
* Interactive Tabs
* Interactive Team Accordion
* Logo Carousel
* Marquee
* Motion Spotlight
* Narrative Layers
* Product Showcase Slider
* Scrolling Transition
* Simple Animated Menu
* Store Locator
* Team Showcase
* Testimonial Grid
* Timed Slider
* Typing Text
* Unfold
* WooCommerce Cart Page
* WooCommerce Grid
* WooCommerce Product Grid
* WooCommerce Product Marquee

= Built for control and maintainability =

The Calio admin dashboard lets you enable or disable widgets, extensions, and dashboard tools individually, search modules by name or category, and review basic requirement checks for WordPress, PHP, Elementor, and WooCommerce-dependent modules. This keeps the editing and admin experience focused and helps avoid loading features you do not plan to use.

Third-party libraries:

* Chart.js (MIT): https://www.chartjs.org/
* Swiper (MIT): bundled by Elementor and used through Elementor's registered script/style handles.

Source code and build tools:

The deployed JavaScript and CSS assets are generated from the readable source files included in `assets/src`. Development tooling is based on `@wordpress/scripts`. The plugin does not load non-service JavaScript or CSS from third-party CDNs.

External services:

Calio Addon can connect to external services only when an administrator configures and initiates the related feature.

* Google Calendar API (optional): Used by the API settings screen to connect a Google Calendar account through OAuth and cache calendar metadata for calendar-related widgets. When the administrator starts the connection, authorization codes and tokens are exchanged with Google over HTTPS, and calendar list/user profile data may be requested from Google APIs. Terms: https://policies.google.com/terms Privacy: https://policies.google.com/privacy
* Public Google Sheets CSV (optional): The Table widget can fetch a public Google Sheet CSV URL entered by the site editor. The requested sheet URL is sent to Google only when that data source is selected.
* Freemius SDK (optional opt-in): Used for account, support, update, licensing, and upgrade flows. The SDK is WordPress.org compliant and asks for user consent before collecting usage/account data. Terms: https://freemius.com/terms/ Privacy: https://freemius.com/privacy/

== Installation ==

1. Install via the WordPress Plugins screen or upload the plugin folder to your site's configured plugins directory.
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Ensure Elementor is installed and active.
4. Open `Calio` in the WordPress admin menu to manage widgets and extensions.

== Frequently Asked Questions ==

= Does this plugin require Elementor? =

Yes. Elementor must be installed and active.

= Can I disable widgets I do not use? =

Yes. Open the Calio dashboard and toggle widgets/extensions individually.

= Does the plugin load all assets globally by default? =

No. Conditional loading is enabled by default. You can switch to global loading in Other Settings.

== Changelog ==

= 1.11 =

* Added a free Image Comparison Slider widget with before/after images, editable labels, draggable handle controls, overlay color and transition speed options.
* Added a free Breadcrumbs widget for Elementor with page hierarchy, posts, archives, separator, alignment, color, typography, spacing, and Home visibility controls.
* Added a free Animated Link widget for Elementor with 20 Calio hover styles, URL controls, responsive alignment, colors, typography, padding, line thickness, line offset, and transition speed controls.
* Added a Dashboard Widgets manager for enabling or disabling Calio cards on the main WordPress Dashboard.
* Added the Live Inventory HUD for WooCommerce with product and variation stock monitoring, low-stock prioritization, instant search, AJAX refresh, and browser-based CSV export.
* Added the Order Processing Monitor with seven-day revenue totals, risk highlighting, cached calculations, and HPOS-compatible at-risk order filtering.
* Added the Marketing Intelligence HUD with recent-order geography rankings, WooCommerce attribution source insights, tabbed views, CSV export, and 15-minute caching.
* Added the Inline Products WooCommerce admin page with paginated search, sorting, safe inline price editing, description modals, and responsive animated styling.

= 1.10 =

* Added a free WooCommerce Slider widget powered by Elementor's registered Swiper assets.
* Added product query controls for latest, featured, sale, best-selling, top-rated and manual product selections.
* Added product card controls for badges, ratings, prices, short descriptions, add-to-cart actions, arrows, dots and autoplay.
* Added Freemius parallel activation metadata so Calio Pro can run as a paid companion while Calio Free remains the WordPress.org package.
* Expanded the WordPress.org readme description with clearer widget, extension, WooCommerce, and module-control details.
* Added a Calio Pro overview section to explain the paid companion widget set from the free plugin listing.
* Updated the public plugin title with clearer Elementor, widget, slider, and extension keywords for WordPress.org discovery.

= 1.03 =

* Completed another WordPress.org-focused hardening pass for escaping, nonce validation, path handling, and package contents.
* Updated Freemius integration packaging and admin/debug output handling while preserving opt-in service behavior.
* Fixed a Plugin Check escaping report for the Table widget wrapper attributes.
* Rebuilt release metadata for the next WordPress.org upload package.

= 1.02 =

* Hardened WordPress.org review areas including output escaping, safe remote requests, package hygiene, and source transparency.
* Improved modular asset loading and moved admin menu behavior into an enqueued build asset.
* Updated release metadata and compatibility information for the next Calio Addon package build.

= 1.01 =

* Fixed WordPress.org review findings for enqueued inline assets, output escaping, and Settings API sanitization.
* Removed non-GPL-compatible bundled motion vendor files from the free plugin package.
* Added Sermedias as the WordPress.org contributor/owner username.

= 1.0.0 =

* Initial public release.
* Added modular widget manager and extension manager.
* Added core widget set including Accordion, Fancy Tabs, Fancy Chart, Feature Lists, and post widgets.
* Added utility extensions for scroll effects, wrapper links, sticky content, and reveal/parallax.
