=== GetBirthChart – Birth Chart Calculators ===
Contributors: getbirthchart
Tags: astrology, birth-chart, natal-chart, horoscope, zodiac
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a Birth Chart, Moon Sign, Rising Sign, and Big Three astrology calculator to WordPress, powered by the GetBirthChart API.

== Description ==

GetBirthChart – Birth Chart Calculators adds ready-to-use astrology calculators to any WordPress page or post, so visitors can generate their own birth chart without leaving your site.

A birth chart, also called a natal chart, is a map of where the Sun, Moon, and planets were positioned at the exact moment someone was born. This plugin’s Birth Chart calculator asks a visitor for their birth date, time, and place, then returns those placements in plain language — including the sign each planet was in at birth.

For visitors who want a quicker answer, the plugin also includes three focused calculators. Moon Sign covers the sign that shapes emotional instincts. Rising Sign covers the sign that was climbing the horizon at the moment of birth, which needs an exact birth time to calculate. Big Three combines Sun, Moon, and Rising into a single result.

All calculations run on the GetBirthChart API — this plugin does not calculate astrology in PHP. If a visitor doesn’t know their exact birth time, they can mark it unknown; the plugin will not guess or substitute noon, and it explains clearly which results, like Rising sign, need a known time to calculate.

A GetBirthChart API key is required. Create one in the GetBirthChart developer dashboard and add it under Settings → GetBirthChart.

= Calculators included =

* **Birth Chart** – Sun, Moon, Rising, and full planet placements.
* **Moon Sign** – the Moon’s placement at birth, with an honest note when the exact sign can’t be confirmed without a birth time.
* **Rising Sign** – the sign on the eastern horizon at birth (requires an exact birth time).
* **Big Three** – Sun, Moon, and Rising together in one compact result.

= Features =

* Embed any calculator with a shortcode, or add the GetBirthChart Calculator block in the editor.
* Choose a default calculator type and theme (inherit your site’s styles, or a clean light theme) from Settings → GetBirthChart.
* Unknown birth-time handling — visitors without an exact time still get a result, with a clear note about what could not be calculated.
* A simple, fluid calculator form that fits comfortably on both desktop and mobile pages.
* Calculations run through the GetBirthChart API, not in WordPress — your server never guesses or calculates astrology itself.
* Your API key is stored as a WordPress option and used only in server-side requests; it is never sent to the visitor’s browser.
* Built-in request throttling on the calculator endpoint to protect your API usage.
* A one-click connection test in Settings → GetBirthChart to confirm your API key is working.
* Does not save visitor birth data, or calculation results, in your WordPress database.

== Installation ==

1. Install and activate the plugin, either from Plugins → Add Plugin, or by uploading the plugin zip.
2. Go to Settings → GetBirthChart and add your GetBirthChart API key. Create one at https://getbirthchart.com/developers/.
3. Add a calculator to any page or post — search for "GetBirthChart Calculator" in the block inserter, or use a shortcode:
   * `[getbirthchart]` for the default calculator
   * `[getbirthchart type="moon-sign"]`
   * `[getbirthchart type="rising-sign"]`
   * `[getbirthchart type="big-three"]`
4. Publish the page.

== Frequently Asked Questions ==

= Is the calculator free? =

The plugin is free. It requires a GetBirthChart API key, created in the GetBirthChart developer dashboard, to calculate results.

= Does it require a GetBirthChart account? =

Yes. You’ll need an API key from the GetBirthChart developer dashboard, entered once under Settings → GetBirthChart.

= Does it work without an exact birth time? =

Yes, for Birth Chart, Moon Sign, and Big Three — mark the birth time as unknown and the plugin will skip anything that needs it rather than guessing. The Rising Sign calculator always needs an exact birth time, since Rising sign can’t be determined without one.

= Where are birth calculations performed? =

On the GetBirthChart API, not in WordPress. Your site sends the birth information a visitor enters to GetBirthChart over an authenticated request and displays the result it returns.

= Does this plugin store visitor birth data? =

No. This plugin does not save a visitor’s birth date, birth time, birth place, or calculation results in the WordPress database. GetBirthChart’s handling of the data it receives is described in its Privacy Policy.

= Can I add more than one calculator to a page? =

Yes. Add the shortcode or block as many times as you like, each with its own calculator type.

= Does it work on mobile? =

Yes. The calculator form is a simple, fluid layout that adapts to narrow screens without extra configuration.

= What calculators are available? =

Birth Chart, Moon Sign, Rising Sign, and Big Three. See "Calculators included" above for what each one returns.

= Does it use AI? =

No. Results come from the GetBirthChart calculation engine, not from AI-generated text.

= Can visitors see my API key? =

No. The key is stored as a WordPress option and used only in server-side requests.

== Screenshots ==

1. A GetBirthChart calculator embedded in a WordPress page.
2. A Birth Chart result — Sun, Moon, Rising, and planet placements.
3. Settings → GetBirthChart, where you add your API key and choose defaults.
4. Adding the GetBirthChart Calculator block in the editor.

== Changelog ==

= 0.1.0 =
* Birth Chart, Moon Sign, Rising Sign, and Big Three calculators.
* GetBirthChart API-key settings and a server-side connection test.
* Secure server-side GetBirthChart API proxy.
* Unknown birth-time handling.
* Documentation aligned with the `gbc-astro` 1.13.0 natal contract; plugin version remains 0.1.0.

== Upgrade Notice ==

= 0.1.0 =
Initial release.

== External Services ==

This plugin connects to the GetBirthChart API to calculate astrology results.

When a visitor uses a GetBirthChart calculator, information entered into the calculator — such as birth date, birth time, and birth place — may be sent to GetBirthChart for processing. Birth place is resolved through GetBirthChart’s places search so the calculation can use coordinates and timezone.

The site owner’s GetBirthChart API key is used server-side to authenticate natal calculation requests and is not intentionally exposed to site visitors.

Connection tests from Settings → GetBirthChart send an authenticated request to the GetBirthChart natal API to confirm the stored key. That test does not run a full chart calculation.

The plugin does not send installation telemetry or unrelated site data.

GetBirthChart:
https://getbirthchart.com/

Privacy Policy:
https://getbirthchart.com/privacy/

Developers:
https://getbirthchart.com/developers/

Methodology:
https://getbirthchart.com/methodology/
