=== VedIntel Astro Widgets ===
Contributors: vedintel, swankydigitaltools
Tags: vedic astrology, kundali, horoscope, panchang, birth chart
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.4
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed live Vedic birth charts, dashas, panchang, compatibility scores, and AI narratives anywhere in WordPress.

== Description ==

**VedIntel™ AstroAPI** brings Swiss Ephemeris-powered Vedic astrology to every WordPress site — as shortcodes, Gutenberg blocks, and interactive visitor forms.

= What you get =

* **6 Shortcodes** — drop Vedic astrology anywhere in posts, pages, or widgets
* **6 Gutenberg Blocks** — drag-and-drop in the block editor with live inspector controls
* **Interactive forms** — visitors enter their own birth data, result renders inline. No page reload.
* **AI narrative streaming** — Vedika reads the chart aloud, token by token (requires AI add-on)
* **3 visual themes** — Cosmic Dark, Clean Light, Minimal — match any site design
* **City autocomplete** — type a city name, lat/lon/timezone auto-fill
* **Secure proxy** — your API key never reaches the browser. All calls go server-to-server.

= Shortcodes =

**Interactive form (recommended for public sites):**
`[vedintel_form widget="chart"]`

**Static widgets (hardcoded birth data):**
`[vedintel_chart dob="01/10/1977" tob="11:40" lat="11" lon="77" tz="5.5"]`
`[vedintel_dasha dob="01/10/1977" tob="11:40" lat="11" lon="77" tz="5.5"]`
`[vedintel_panchang lat="28.61" lon="77.20" tz="5.5"]`
`[vedintel_compatibility m_dob="01/10/1977" m_lat="11" m_lon="77" m_tz="5.5" f_dob="15/03/1980" f_lat="19.07" f_lon="72.87" f_tz="5.5"]`
`[vedintel_ai_chart dob="01/10/1977" tob="11:40" lat="11" lon="77" tz="5.5"]`

= Get an API Key =

1. Sign up free at [vedintelastroapi.com](https://vedintelastroapi.com)
2. Go to **Dashboard → API Keys** and copy your key
3. Paste it in **Settings → VedIntel Astro** in your WordPress admin

The free plan includes 500 API calls/month — plenty for low-traffic sites. Paid plans start at $9/month.

= Powered by =

* Swiss Ephemeris — industry-standard astronomical computation (local, zero third-party dependency)
* Lahiri Ayanamsa (default) — most common in Indian Vedic practice
* Claude AI — narrative interpretations by Vedika (AI add-on required)

== Installation ==

1. Upload the `vedintel-astro` folder to `/wp-content/plugins/`
2. Activate the plugin in **Plugins → Installed Plugins**
3. Go to **Settings → VedIntel Astro**
4. Paste your API key and click **Test Key** to verify
5. Add a shortcode or block to any post or page

== Frequently Asked Questions ==

= Is my API key secure? =
Yes. Your API key is stored in `wp_options` (same as any WordPress setting) and all API calls are made server-to-server via the WordPress REST API proxy. It is never exposed in the browser or JavaScript source.

= Do visitors see my API key? =
No. The plugin includes a REST proxy (`/wp-json/vedintel/v1/proxy`) that adds your API key on the server before calling the VedIntel API.

= Which plan do I need? =
The free plan (500 calls/month) works with all widgets. AI narrative endpoints (`[vedintel_ai_chart]`) require an AI add-on on any paid plan.

= Does this work with page builders? =
Yes. The shortcodes work in any context that supports WordPress shortcodes — Elementor, Beaver Builder, Divi, WPBakery, etc.

= Can visitors enter their own birth data? =
Yes. Use `[vedintel_form widget="chart"]` (or any other widget type). A form renders, and when the visitor submits, the result appears inline with no page reload.

== Screenshots ==

1. Admin settings page — API key configuration, theme picker, shortcode reference
2. Cosmic Dark theme — birth chart with planet table and dasha card
3. Clean Light theme — same widget on a light site
4. Interactive form — visitor enters birth data, chart renders instantly
5. Compatibility widget — Ashtakoot score ring + koot breakdown
6. Gutenberg block editor — birth chart block with inspector controls
7. AI narrative widget — Vedika streaming chart reading

== External Services ==

This plugin connects to the VedIntel AstroAPI (vedintelastroapi.com) to compute and retrieve Vedic astrology data.

**What the service does:** Performs server-side Vedic astronomical computation (planetary positions, dashas, panchang, kundali matching, AI chart narratives) using Swiss Ephemeris.

**What data is sent and when:**
- Birth date, time, latitude, longitude, and timezone — sent when a shortcode or block renders astrology data, or when a visitor submits the interactive birth-data form.
- City name — sent when a visitor uses the city autocomplete field to look up coordinates.
- Your API key — sent with every request to authenticate your account. It is added server-side and never exposed to the browser.

No personally identifiable information beyond birth data is collected or stored by this plugin.

**Service provider:** VedIntel (vedintelastroapi.com)
**Terms of Service:** https://vedintelastroapi.com/terms
**Privacy Policy:** https://vedintelastroapi.com/privacy

== Changelog ==

= 1.0.4 =
* Fixed text domain: all 75 elements now use 'vedintel-astro-widgets' matching the plugin slug

= 1.0.3 =
* Fixed translators comment position — moved directly above esc_html__() call inside printf()

= 1.0.2 =
* Added translators comment for i18n compliance
* Added wp_unslash() before sanitize_text_field() on POST input
* Replaced date() with gmdate() to avoid timezone issues
* Reduced tags to 5 (Plugin Check compliance)

= 1.0.1 =
* Renamed plugin to VedIntel Astro Widgets
* Changed attribution branding default to opt-in (off by default)
* Added External Services disclosure to readme
* Added swankydigitaltools to contributors list

= 1.0.0 =
* Initial release
* 6 shortcodes: vedintel_chart, vedintel_dasha, vedintel_panchang, vedintel_compatibility, vedintel_ai_chart, vedintel_form
* 6 Gutenberg blocks with inspector controls
* 3 visual themes: Cosmic Dark, Clean Light, Minimal
* City autocomplete via geo-search endpoint
* Secure server-side REST proxy
* AI narrative streaming (NDJSON)
* Admin settings page with API key tester and shortcode reference
