=== Iris Theme Kit ===
Contributors: zephyrwp
Donate link: https://irisai.cloud
Tags: elementor, widgets, ai, theme-companion
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Elementor widgets and editorial tools for themes by Iris AI.

== Description ==

Iris Theme Kit is the official companion plugin for Iris AI WordPress themes. It provides Vamika-specific Elementor widgets, Gutenberg blocks and reader tools for the Iris AI theme and other block themes, plus shared post reactions that survive theme changes.

Elementor is required only for the Vamika widget library. The Iris block library works with the Iris AI theme and other WordPress block themes. Shared reactions remain available on classic themes.

= Widgets Included =

**Homepage Widgets**

* **Hero** — Full-width hero section with headline, subtitle, and call-to-action
* **Featured Stories** — Dynamic story grid pulling from recent or featured posts
* **Features** — Highlight grid for editorial product features
* **Newsletter** — Email signup section with customisable heading and description
* **Semantic Search** — AI-powered search interface for archive discovery

**About Page Widgets**

* **About Intro** — Mission statement section with decorative layout
* **About Story** — Timeline or narrative section for brand history
* **About Team** — Team member grid with bios and optional Iris AI descriptions

**Services Page Widgets**

* **Services Hero** — Split-layout hero with illustration and call-to-action
* **Services Tracks** — Alternating feature rows for service offerings
* **Services Work Examples** — Bento grid showcasing portfolio items
* **Services Engagements** — Timeline-style cards for engagement types
* **Services Stats** — Scrolling metrics marquee
* **Services CTA** — Full-width call-to-action banner
* **Services Page** — All-in-one widget combining all service sections

**Contact Page Widgets**

* **Contact Intro** — Header section with contact details and social links
* **Contact Form** — Styled contact form section

= Requirements =

* WordPress 6.4 or higher
* PHP 7.4 or higher
* Elementor (free or Pro) when using Vamika
* Vamika, the Iris AI theme, or another WordPress block theme

== Installation ==

1. Upload the `iris-theme-kit` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugin screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. On Vamika, install Elementor and look for the "Vamika Theme" category.
4. On the Iris AI theme or another block theme, use the Iris blocks in the block editor and configure reader tools under Iris Theme Kit.

== Frequently Asked Questions ==

= Does this plugin work without an Iris AI theme? =

Yes. Iris blocks can be inserted manually in other WordPress block themes, and shared reactions work on classic themes. Vamika Elementor widgets are intentionally registered only while Vamika is active.

= Does this plugin work with Elementor Free? =

Yes. All widgets are compatible with the free version of Elementor. No Elementor Pro features are required.

= Does this plugin require the Iris AI plugin? =

No. Some widgets include optional Iris AI integration points (team bios, services brief), but these features are hidden automatically when the Iris AI plugin is not installed. The widgets work fully without it.

= Where do I find the widgets in Elementor? =

When Vamika is active, look for the "Vamika Theme" category in the Elementor widget panel.

== Screenshots ==

1. Homepage built with Hero, Featured Stories, and Newsletter widgets.


== External Resources ==

This plugin does not load any resources from external CDNs or third-party services.

All fonts (Bricolage Grotesque, Fraunces, JetBrains Mono) are bundled locally
in the plugin under assets/fonts/ and served from the site's own domain.
No visitor data is sent to any external service by this plugin.

== Credits ==

* Bricolage Grotesque font by Mathieu Triay — SIL Open Font License 1.1.
* Fraunces font by Undercase Type — SIL Open Font License 1.1.
* JetBrains Mono font by JetBrains — SIL Open Font License 1.1.
* All inline SVG illustrations are original works included under this plugin's GPL license.

== Changelog ==

= 1.1.0 =
* Added a multi-theme architecture with a self-contained Iris AI block-theme module.
* Added Iris Gutenberg blocks, block hooks, starter patterns, editorial tools, and reader tools.
* Added theme-aware dashboard sections so Vamika settings, Iris block-theme controls, and shared classic-theme features are shown only where they apply.
* Restricted the Vamika Elementor widget category and bundled widget assets to Vamika and its child themes.
* Enabled manual Iris Gutenberg blocks on external block themes while keeping automatic block insertion and block hooks opt-in outside the Iris AI theme.
* Added normalized active-theme detection helpers for Vamika, the Iris AI theme, and child-theme compatibility.
* Added a shared translation language catalog used by the dashboard, editor controls, and Translate Post block.
* Added dashboard-controlled primary, secondary, and highlight colors for Iris block surfaces.
* Added the collapsible animated Iris tools orb and remembered reader toolbar state.
* Updated dashboard counts, feature cards, resources, documentation, and status labels to reflect the active theme accurately.
* Preserved hidden settings when switching between supported themes.
* Added a major UI refresh across all Iris AI blocks and the floating selection toolbar.
* Reading Progress is now a fixed vertical side rail. It reveals itself only while the reader is inside the article body and slides away near the top and the end; estimated read time and the Iris key takeaway appear in a hover tip.
* Added automatic light/dark theming via prefers-color-scheme, plus full prefers-reduced-motion support.
* Added an animated typing indicator in every Iris chat surface.
* Refreshed chat surfaces, tool cards, dock styling, controls, responsive layouts, dark mode, and interactive states.
* Vamika support, the existing Elementor widget category, demo content, and Vamika bridge script require no migration.

= 1.0.1 =
* Stable maintenance release following the initial plugin launch.

= 1.0.0 =
* Initial release.
* 17 custom Elementor widgets for editorial layouts.
* Shared SVG illustration helpers for service page visuals.
* Post reactions feature (loved / made me think / shared / saved) with AJAX
  handler, cookie-based duplicate prevention, and theme-side render helper
  `iris_theme_kit_render_reactions()`.
* Full internationalisation support.

== Upgrade Notice ==

= 1.1.0 =
Separates Vamika Elementor features from Iris block-theme tools, improves external block-theme safety, and adds shared translation and block-color controls. Recommended for all Vamika, Iris AI theme, and third-party block-theme installations.

= 1.0.1 =
Previous stable maintenance release.
