=== Iris Theme Kit ===
Contributors: zephyrwp
Donate link: https://irisai.cloud
Tags: elementor, widgets, ai, theme-companion
Requires at least: 6.4
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.1
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 registers a library of custom Elementor widgets designed for magazine and editorial publishing layouts, plus a lightweight post-reactions feature that stores counts in post meta so it survives theme changes.

This plugin requires the Elementor page builder to be installed and active. It is designed for Iris AI themes (such as Vamika) but works with any theme — widgets include their own bundled styling.

= 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)
* An Iris AI theme such as Vamika (recommended for best results)

== Installation ==

1. Make sure the Elementor plugin is installed and active.
2. Upload the `iris-theme-kit` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugin screen.
3. Activate the plugin through the Plugins screen in WordPress.
4. Open any page with Elementor and look for the "Vamika" widget category in the panel.

== Frequently Asked Questions ==

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

Yes. The widgets render their own markup and bundled styles, so they work on any theme. They are designed to match the visual language of Iris AI themes (like Vamika), but no additional CSS is required for other themes.

= 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? =

After activation, look for the "Vamika" category in the Elementor widget panel when editing any page.

== 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.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.0.0 =
Initial release.
