Astrology Suite for FreeAstroAPI

Description

Astrology Suite for FreeAstroAPI helps you publish astrology experiences that feel fast, clean, and easy to use:

  • Add interactive blocks directly in Gutenberg.
  • Add the same widgets with shortcodes in classic content, shortcode blocks, or shortcode-ready template areas.
  • Capture birth details with a built-in form (city autocomplete included).
  • Render natal chart, natal report, or both.
  • Offer simple sign widgets for Sun, Moon, Rising, and Midheaven.
  • Publish monthly ephemeris tables with selectable bodies, tropical/sidereal mode, optional local points, and CSV download.
  • Choose chart SVG/PNG themes from settings, customize each theme’s chart request body, or paste a custom chart_config JSON object.
  • Allow public visitor calculations, or restrict calculations to logged-in editors from the API settings tab.
  • Customize styling, ephemeris table colors, plugin background transparency, Past inputs visibility, and typography from plugin settings.
  • Reuse recent requests with a “Past inputs” dropdown (stored in browser local storage).

Included blocks:

  • astrology-suite/chart-only
  • astrology-suite/report-only
  • astrology-suite/chart-report
  • astrology-suite/simple-sign-sun
  • astrology-suite/simple-sign-moon
  • astrology-suite/simple-sign-rising
  • astrology-suite/simple-sign-midheaven
  • astrology-suite/ephemeris

Included shortcodes:

  • [astrology_suite mode="chart-report"]
  • [astrology_suite_chart_only]
  • [astrology_suite_report_only]
  • [astrology_suite_chart_report]
  • [astrology_suite_simple_sign_sun include_interpretation="true" interpretation_style="improved"]
  • [astrology_suite_simple_sign_moon include_interpretation="false"]
  • [astrology_suite_simple_sign_rising include_interpretation="true" interpretation_style="poetic"]
  • [astrology_suite_simple_sign_midheaven]
  • [astrology_suite_ephemeris]

External services

Astrology Suite for FreeAstroAPI connects to FreeAstroAPI (https://www.freeastroapi.com/) to autocomplete cities and generate astrology calculations used by the included blocks.

What is sent and when:

  • When someone types at least two characters into the city field, the plugin sends the typed city query and optional country filter to FreeAstroAPI over HTTPS so matching cities and timezones can be returned.
  • When a visitor submits a natal chart, report, simple-sign, or ephemeris form while public calculations are enabled, or when an authenticated editor submits while public calculations are disabled, the plugin sends the submitted astrology data and calculation options to FreeAstroAPI over HTTPS. This may include the optional name field, birth date, birth time, city name, latitude, longitude, timezone, interpretation settings, enabled extra bodies, selected ephemeris month/year, selected ephemeris bodies, zodiac type, the requested calculation mode, and whether minor aspects were requested.
  • Calculation requests also include the site’s configured FreeAstroAPI key in the server-to-server request header so FreeAstroAPI can authenticate the request. The API key is not sent to the visitor’s browser.
  • The plugin does not store visitor birth data in WordPress by default. The optional “Past inputs” feature stores recent successful requests only in the visitor’s local browser storage.

FreeAstroAPI Terms of Service: https://www.freeastroapi.com/terms
FreeAstroAPI Privacy Policy: https://www.freeastroapi.com/privacy
FreeAstroAPI Chart Designer: https://www.freeastroapi.com/dashboard/chart-designer
FreeAstroAPI Ephemeris Docs: https://www.freeastroapi.com/docs/western/ephemeris

Screenshots

  • Frontend chart and report widget with saved birth input, generated natal wheel, and styled form controls.
  • Frontend natal report sections with Ascendant, Midheaven, and planet interpretation cards.
  • Frontend aspect dynamics table rendered below the report.
  • API settings screen with the FreeAstroAPI key field and service disclosure.
  • Report settings screen for report length, tables, angles, and chart print controls.
  • Style settings screen for colors, background transparency, border radius, typography, labels, and form controls.

Installation

  1. Upload the plugin folder to /wp-content/plugins/, or install via WordPress plugin upload.
  2. Activate Astrology Suite for FreeAstroAPI in the Plugins screen.
  3. Get a FreeAstroAPI key and add it in Settings > Astrology Suite.
  4. Add Astrology Suite blocks in the block editor.
  5. Or add Astrology Suite shortcodes in shortcode-ready content.

FAQ

Do I need an API key?

Yes. Add your key in Settings > Astrology Suite.

Who can submit calculation requests?

By default, public visitors can submit astrology calculation forms. Site admins can disable public calculations in Settings > Astrology Suite > API to restrict natal chart, report, simple-sign, and ephemeris calculations to logged-in users who can edit posts. City autocomplete remains public.

Is user birth data stored by default?

No server-side storage is performed by default. The “Past inputs” list is kept in the visitor’s local browser storage.

Can I style the widgets?

Yes. Use plugin settings for typography/colors and target documented CSS classes for theme-level customization.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Astrology Suite for FreeAstroAPI” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.3.0

  • Added astrology-suite/ephemeris block and [astrology_suite_ephemeris] shortcode.
  • Added /wp-json/astrology-suite/v1/western/ephemeris REST proxy for FreeAstroAPI monthly table grids.
  • Added ephemeris frontend with month navigation, body selectors, optional city-based local points, tropical/sidereal mode, CSV download, and plugin-matched table styling.
  • Added Ephemeris Style settings for table grid, header, badge, today row, retrograde, ingress, and station colors.

0.2.9

  • Added an API setting to allow public visitor calculations while keeping the FreeAstroAPI key server-side.
  • Changed the API key field to “leave blank to keep current key” so the saved key is not echoed into admin page HTML.
  • Split settings saves by tab to avoid hidden-field key exposure and accidental cross-tab option persistence.
  • Optimized frontend requests so chart-only calls only chart SVG, report-only calls only natal calculation, and chart-report calls both.
  • Sanitized upstream SVG chart responses before returning them to the frontend.
  • Added explicit “Customize this body” and “Reset to preset” controls for per-theme chart API bodies.

0.2.8

  • Added per-theme FreeAstroAPI chart request body editors for chart themes.
  • Chart preview PNGs and frontend SVG chart requests now use the selected theme body.
  • Updated Custom Chart help text for SVG/PNG chart body fields such as display_settings, fixed_stars, and chart_config.

0.2.7

  • Added a Custom Chart settings tab with chart theme presets and FreeAstroAPI-generated PNG preview cards.
  • Added an advanced custom chart_config JSON textarea for configs generated in FreeAstroAPI Chart Designer.
  • Chart SVG requests now use the selected preset or custom chart_config.

0.2.6

  • Added shortcode support for all Astrology Suite widgets.
  • Added generic [astrology_suite mode="..."] shortcode plus named [astrology_suite_*] shortcodes.
  • Added legacy [openastro], [openastro_*], [freeastro], and [freeastro_*] shortcode aliases.

0.2.5

  • Added astrology-suite/* block names and /wp-json/astrology-suite/v1/* REST routes.
  • Kept openastro/* blocks and /wp-json/openastro/v1/* routes as legacy compatibility aliases.
  • Updated Help and CSS docs to use Astrology Suite naming.

0.2.4

  • Improved the city autocomplete dropdown with richer rows, country filters, and keyboard selection.

0.2.3

  • Updated natal chart SVG generation to use FreeAstroAPI’s current /api/v1/natal/chart/ endpoint.
  • Improved default widget form styling for cleaner inputs, buttons, and past-input controls.

0.2.2

  • Renamed the plugin to Astrology Suite for FreeAstroAPI for WordPress.org review.
  • Updated the text domain and approval-ready plugin slug to astrology-suite-freeastroapi.

0.2.1

  • Documented the required FreeAstroAPI external service usage, data sent, and terms/privacy links.
  • Moved upstream requests to the documented FreeAstroAPI API domain.
  • Added authenticated-user protection for API-key-backed calculation routes.
  • Added privacy-policy helper text for site owners.

0.2.0

  • Added Astrology Suite for FreeAstroAPI unified widget blocks and settings improvements.
  • Improved input and display customization options.
  • Added and refined simple sign widgets.