內容簡介
RoxyAPI 外掛可將占星術、印度占星術、人類設計、數字學等多種占卜功能整合至 WordPress 網站，透過 Gutenberg 區塊和短碼輕鬆使用，無需額外設置或計算程式碼，適合希望提供多元占卜內容的網站。
【主要功能】
• 提供西方占星術、印度占星術等多種占卜系統
• 支援即時計算與顯示，無需帳號註冊
• 兼容各種佈景主題，SVG 圖表自動調整
• 提供互動式訪客表單，收集出生資訊
• 包含 18+ 區域和 258+ 端點的 API
• 提供免費每日使用配額，適合測試與預覽
外掛標籤
開發者團隊
② 後台搜尋「RoxyAPI: Astrology, Vedic, Forecast, Human Design, Numerology」→ 直接安裝（推薦）
📦 歷史版本下載
原文外掛簡介
RoxyAPI adds Astrology, Vedic, Forecast, Human Design, Chinese Astrology and Feng Shui readings to any WordPress post, page or widget, as Gutenberg blocks and shortcodes. Drop one on a page and it renders a real reading, server side, the moment you activate the plugin. No account, no setup, no calculation code to write. Start free, then add an API key when you go live.
One API key. 18+ domains. 258+ endpoints. Most astrology plugins cover one system. RoxyAPI covers the whole stack, so you build the entire experience without stitching services together:
Western astrology: natal and birth charts, daily, weekly, monthly, and yearly horoscopes, synastry with a house overlay, compatibility, transits, and moon phases
Vedic astrology: kundli, KP charts, panchang, Vimshottari dasha, divisional charts, nakshatras, yogas, gochara transits, and the Bhava Bala and Bhav Chalit house readings
Forecast: cross-domain timelines, transit forecasts, solar returns, and significant dates
Human Design: full bodygraph with type, authority, profile, centers, channels, gates, variables, and penta
Chinese astrology: the BaZi Four Pillars chart, Day Master strength, ten year luck pillars, the Chinese zodiac sign with daily readings and compatibility, the 24 solar terms, and the Chinese almanac day (Tong Shu)
Feng shui: the Kua number with Eight Mansions directions, the nine palace Flying Star chart, bagua sectors, and annual afflictions
Mesoamerican astrology: the Tzolkin day sign, the Mayan chart with Haab and Long Count, a Long Count converter, daily and monthly readings, nawal compatibility, and the Aztec tonalpohualli
Vastu: entrance pada, the Vastu Purusha Mandala, plot analysis, Ayadi, room compliance, and griha pravesh dates
Numerology: Life Path, Expression, Soul Urge, and Personality numbers
Kabbalah: gematria with every spelling shown, name and birth profiles, the 72 names, the Tree of Life, and the Hebrew letters
Tarot: single card, three card, Celtic Cross, and custom spreads
Plus: biorhythm, Ayurveda, I Ching, crystals, dream interpretation, and angel numbers
Every chart is calculated by Roxy Ephemeris and verified against NASA JPL Horizons, with readings in your site language. One key, one plan, no per-domain fees.
Frequently asked, answered up front
Do I need an account to try it? No. Blocks and shortcodes render readings straight after activation on a free daily allowance.
Do I need to know astrology to use it? No. Every reading arrives calculated and formatted, so you place a block and pick your options.
Is the birth chart accurate? Charts come from Roxy Ephemeris and are verified against NASA JPL Horizons.
Can visitors enter their own birth details? Yes. Leave the attributes off a reading that takes details and it renders a form; the submission is processed server side.
Do I have to write shortcodes? No. RoxyAPI, Create a reading asks a few questions and writes the shortcode for you to paste.
Does it work with my theme? Yes. Charts are SVG and follow your light or dark theme through CSS custom properties.
Where does my API key live? On your server only. It is never sent to the browser.
Free to start. Add a key when you go live.
Every reading works the moment you activate the plugin, with no account. A free daily allowance, shared across your site, covers casual traffic so you can build and preview complete pages at no cost. When you are ready for production, add a RoxyAPI API key and the daily limit is removed. There is no separate paid plugin and no locked reading types: the same blocks and shortcodes cover every domain whether or not a key is set. A key simply lifts the daily cap, covers production traffic, and keeps all 18+ domains live under one key. Pick a plan at https://roxyapi.com/pricing.
Also built in:
Gutenberg blocks and shortcodes for every reading, plus a visitor form mode for interactive inputs like birth details
Pythagorean numerology, full 78 card tarot, and a 2,000+ entry dream symbol dictionary
Interactive SVG charts and cards that follow your light or dark theme automatically
Readings in English, German, Hindi, Spanish, Turkish, Portuguese, French, and Russian, following the site language or one setting
Parent Astrology Section wrapper block that sets the zodiac sign for the Horoscope blocks placed inside it
Server side caching with per endpoint TTL to keep your API quota low
API key stays server side. Never exposed to the browser.
About the service this plugin connects to
This plugin is a thin WordPress interface to RoxyAPI, a third-party paid service operated at https://roxyapi.com. The astrology, tarot, numerology, and other calculations all run on RoxyAPI servers. A small free daily allowance lets the plugin display readings without an account; a RoxyAPI API key is required for production use and removes the daily limit. Pricing and plan tiers are listed at https://roxyapi.com/pricing. Terms of Service: https://roxyapi.com/policy/terms. Privacy Policy: https://roxyapi.com/policy/privacy.
The plugin itself is GPLv2 or later and the source is available at https://github.com/RoxyAPI/sdk-wordpress.
Shortcode examples
Every reading is a shortcode, and what you put inside the brackets decides what your visitors see.
Ask your visitor. Leave the details out and the reading shows a form. Visitors enter their own birth date, sign, name or year, and their reading appears on the same page.
[roxy_natal_chart] asks for a birth date, time and city
[roxy_calculate_luck_pillars] asks for a birth date, time, timezone and gender
[roxy_get_annual_flying_stars] asks for a year
Show a set reading. Put every detail in the shortcode and every visitor sees the same reading, with no form.
[roxy_calculate_luck_pillars date="1990-06-15" time="14:30" timezone="Asia/Shanghai" gender="male"]
[roxy_get_annual_flying_stars year="2026"]
Add mode="form" to keep the form even when details are set, or mode="static" so a placement never shows a form.
Readings that need nothing. Some readings take no details and show straight away, such as [roxy_moon_phase], [roxy_get_daily_hexagram] and [roxy_cast_celtic_cross].
Every shortcode, with the details it takes and a sample to copy, is listed in your dashboard under RoxyAPI, Shortcodes. Rather not type one? Open RoxyAPI, Create a reading, answer a few questions and copy the finished shortcode, or try the same builder online first: https://roxyapi.github.io/sdk-wordpress/
Hero shortcodes
[roxy_horoscope sign="aries"]
[roxy_horoscope sign="aries" period="yearly"]
[roxy_horoscope sign="aries" period="monthly" date="2026-10-01"]
[roxy_natal_chart birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York"]
[roxy_kundli birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_panchang date="2026-04-28" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_mangal_dosha birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_kp_chart birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_moon_phase]
[roxy_bodygraph birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York"]
[roxy_tarot_card spread="three" question="What should I focus on this week"]
[roxy_tarot_yes_no question="Should I take the new job"]
[roxy_numerology name="Ada Lovelace" birth_date="1815-12-10"]
[roxy_life_path birth_date="1990-05-15"]
[roxy_biorhythm birth_date="1990-05-15" target_date="today"]
[roxy_angel_number number="1111"]
[roxy_crystals_by_zodiac sign="aries"]
Four heroes take no attributes: the three two-person compatibility readings render a visitor form for both people, and the forecast timeline renders a visitor form for the birth details and an optional date window:
[roxy_synastry]
[roxy_gun_milan]
[roxy_compatibility]
[roxy_forecast]
Long-tail shortcodes
A matching shortcode exists for every endpoint in the spec. A sample across the domains:
Western astrology: [roxy_calculate_aspects date="1990-07-15" time="14:30:00" timezone="UTC"], [roxy_get_weekly_horoscope sign="aries"] and [roxy_get_yearly_horoscope sign="aries"]
Vedic astrology: [roxy_get_hora date="2026-02-03" latitude="17.385044" longitude="78.486671" timezone="UTC"] and [roxy_calculate_drishti date="2026-02-03" time="12:00:00" latitude="17.385044" longitude="78.486671" timezone="UTC"]
Forecast: [roxy_generate_digest] (renders a visitor form, no attributes)
Human Design: [roxy_generate_bodygraph date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"], [roxy_calculate_variables date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"], plus the two chart [roxy_calculate_connection] and [roxy_calculate_penta] which render visitor forms and take no attributes
Chinese astrology: [roxy_generate_bazi_chart date="1990-06-15" time="14:30:00" timezone="Asia/Shanghai"], [roxy_get_zodiac_animal id="dragon"] and [roxy_get_almanac_day date="2026-02-17"]
Feng shui: [roxy_calculate_kua_number date="1985-07-15" gender="male"] and [roxy_get_annual_flying_stars year="2026"]
Numerology: [roxy_calculate_expression full_name="Ada Lovelace"]
Tarot: [roxy_cast_celtic_cross question="What should I know about this path"]
I Ching: [roxy_get_daily_hexagram]
Crystals: [roxy_get_crystal id="amethyst"]
Dreams: [roxy_search_dream_symbols q="water"]
Location: [roxy_search_cities q="berlin"]
Readings follow your WordPress site language automatically. To pick a language yourself, open the RoxyAPI menu, Branding tab, and set the reading language. Some of the long tail shortcodes above also take a lang attribute, for example [roxy_get_crystal id="amethyst" lang="es"], but the headline readings take the site or Branding setting instead.
Want the chart on its own, without the written report? Open the RoxyAPI menu, Display tab, and turn on Written readings. Every reading on the site then shows its chart, tables, and values with the written text left out. To set it for one placement instead of the whole site, add hide_readings="1" to that shortcode, for example [roxy_natal_chart birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York" hide_readings="1"]. Passing hide_readings="0" keeps the written text on that placement even when the site setting is on.
