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.
- Choose chart SVG/PNG themes from settings, customize each theme’s chart request body, or paste a custom chart_config JSON object.
- Customize styling and typography from plugin settings.
- Reuse recent requests with a “Past inputs” dropdown (stored in browser local storage).
Included blocks:
astrology-suite/chart-onlyastrology-suite/report-onlyastrology-suite/chart-reportastrology-suite/simple-sign-sunastrology-suite/simple-sign-moonastrology-suite/simple-sign-risingastrology-suite/simple-sign-midheaven
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]
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 logged-in user who can edit posts submits a natal chart, report, or simple-sign form, the plugin sends the submitted birth 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, the requested calculation mode, and whether minor aspects were requested.
- For protected calculation requests, the plugin also sends the site’s configured FreeAstroAPI key in the server-to-server request header so FreeAstroAPI can authenticate the request.
- 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
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, border radius, typography, labels, and form controls.
Installation
- Upload the plugin folder to
/wp-content/plugins/, or install via WordPress plugin upload. - Activate Astrology Suite for FreeAstroAPI in the Plugins screen.
- Get a FreeAstroAPI key and add it in Settings > Astrology Suite.
- Add Astrology Suite blocks in the block editor.
- 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?
-
For security, natal chart, report, and simple-sign calculations are limited to logged-in users who can edit posts on the site. 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.
ContributorsTranslate “Astrology Suite for FreeAstroAPI” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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.
- Restricted API-key-backed calculation routes to authenticated users who can edit posts.
- 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.