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.
• Add a daily horoscope widget using sign, date, and timezone controls.
• Add a personalized horoscope widget using birth details, city autocomplete, target date, and personal transit context.
• Add a Western/Vedic astrology bot widget using birth details, city autocomplete, FreeAstroAPI MCP tool calls, and Gemini-generated chat answers.
• Use explicit 24-hour birth-time controls (00–23) instead of browser-local AM/PM labels.
• Let visitors mark birth time as unknown on natal chart/report forms, sending time_known: false to FreeAstroAPI.
• Localize frontend UI labels and validation text, and choose the natal interpretation response language from settings.
• 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, bot chat colors, plugin background transparency, Past inputs visibility, and typography from plugin settings.
• Add optional birth context, thematic interpretation groups, and clickable planet aspect links that open matching FreeAstroAPI interpretation blocks without using the psychological report flow.
• 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
• astrology-suite/daily-horoscope
• astrology-suite/personalized-horoscope
• astrology-suite/astrology-bot

Included shortcodes:

• [astrology_suite mode="chart-report"]
• [astrology_suite mode="chart-report" language="vi"]
• [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]
• [astrology_suite_daily_horoscope]
• [astrology_suite_personalized_horoscope]
• [astrology_suite_astrology_bot]

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. The Astrology Bot also connects to Google Gemini to generate chat answers.

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, ephemeris, daily horoscope, personalized horoscope, or astrology bot 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, horoscope sign/date/timezone, horoscope target date, chat message/history/profile, the requested calculation mode, and whether minor aspects were requested.
• Astrology bot requests may send the chat message, recent chat history, selected Western/Vedic system, and submitted birth profile to FreeAstroAPI MCP and Google Gemini over HTTPS.
• 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.
• Astrology bot answer requests include the site’s configured Gemini API key in the server-to-server request header. The Gemini 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
FreeAstroAPI Daily Sign Horoscope Docs: https://www.freeastroapi.com/docs/western/daily-sign
FreeAstroAPI Daily Personal Horoscope Docs: https://www.freeastroapi.com/docs/western/daily-personal
FreeAstroAPI Western Natal Docs: https://www.freeastroapi.com/docs/western/natal
FreeAstroAPI Astrology Bot: https://www.freeastroapi.com/astrology-bot
Google Gemini API Key Docs: https://ai.google.dev/gemini-api/docs/api-key