AstroWay – Astrology, Birth Chart & Horoscope Widgets
| 开发者 | astrowayteam |
|---|---|
| 更新时间 | 2026年7月13日 20:28 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | MIT |
| 版权网址: | 版权信息 |
详情介绍:
Add astrology and horoscope widgets to any WordPress page or post via shortcodes or Gutenberg blocks: natal and birth charts, synastry, Tarot, Numerology, Human Design, moon phase and daily horoscopes.
Free and open source. No account, no API key, and no credit card required. The core widgets render out of the box in anonymous mode (30 requests/hour per visitor IP), which is enough for most blogs and small sites. Need more volume? A free API key (still no card) raises the limit to 10,000 calls/month, and paid plans are optional and only unlock advanced Pro widgets.
Under the hood the widgets are powered by api.astroway.info, with 700+ endpoints covering Western, Vedic, Hellenistic, Chinese and Mayan astrology, Tarot (Rider-Waite, Marseille, Lenormand), Numerology (Pythagorean, Chaldean, Kabbalistic, Tamil), Human Design and AI horoscopes.
安装:
- Upload the plugin via Plugins → Add New, or unzip into
/wp-content/plugins/. - Activate through the Plugins menu.
- (Optional) Settings → AstroWay → paste your API key for higher rate limits and Pro features.
- Add a shortcode to any page:
[astroway_natal date="1990-05-15" time="14:30" lat="50.45" lon="30.52"].
屏幕截图:
![Natal chart widget on the frontend, rendered via `[astroway_natal date="…" time="…" lat="…" lon="…"]`. Includes zodiac wheel, planets with retrograde markers, and major aspects.](https://cdn.jsdelivr.net/wp/astroway/assets/screenshot-5.png)
常见问题:
Is AstroWay free? Are there any hidden costs?
Yes. The plugin is free and open source, and the core widgets work with no account, no API key, and no credit card. They render in anonymous mode (30 requests/hour per visitor IP), which is plenty for most blogs and small sites. If you need higher limits, a free API key (still no card) gives you 10,000 calls/month. Paid plans are optional and only unlock advanced Pro widgets; anything you have already added keeps working.
How do I add a horoscope or birth chart to WordPress?
Drop a shortcode into any page or post — for example [astroway_natal date="1990-05-15" time="14:30" lat="50.45" lon="30.52"] for a natal (birth) chart, or [astroway_daily_horoscope sign="leo"] for a daily horoscope. Every widget is also a Gutenberg block: Natal Chart, Daily Horoscope, Moon Phase, Human Design Bodygraph, and Daily Tarot.
Do I need an API key?
No. The plugin works without a key in anonymous mode (30 requests/hour per visitor IP). For higher limits and Pro features, get a free key at api.astroway.info.
What data is sent to api.astroway.info?
Birth data (date, time, city, coordinates) for chart calculation. No data is stored on your site beyond standard WP caching.
Can I use this on multiple sites?
Yes for the free anonymous tier. Paid API keys are bound to a single domain by default; you can change the bound domain self-service from the API dashboard at api.astroway.info/dashboard.
Is my visitors' data stored anywhere?
No personal data is stored on api.astroway.info. Birth data (date, time, city, lat/lon) is processed in-memory for chart calculation and the result is returned. The plugin caches results locally on your WordPress site (WP transients) to reduce repeat API calls; the cache contains chart output only, no PII beyond what was submitted via shortcode arguments.
How do I report a bug or request a feature?
For plugin issues: file an issue at https://github.com/astroway/astroway-wp-plugin/issues. For API or billing questions: contact support via your dashboard at api.astroway.info/dashboard.
更新日志:
0.8.3
- New Settings panel "Domain binding" — shows current domain attached to the key + input to request rebinding via POST /v1/auth/keys/domain-change. Manual fallback link to api dashboard if the endpoint returns an error.
- Closes admin enhancements stack (v0.8.0-v0.8.3).
- New Settings panel "Feature matrix" — visual grid of features × tiers with checkmarks. Highlights the current tier's column. Reads from
Tier::matrix()so addon-registered features appear automatically.
- New Settings panel "Spend cap" — local mirror of the monthly USD ceiling configurable at api.astroway.info/dashboard/billing. Stored as integer 0..100000 in OPTION_KEY['spend_cap_usd'].
- New Settings panel "Render mode" with radio toggle: Auto (default) / Force iframe / Force client. Stored in OPTION_KEY['render_mode']. RendererDecisions wiring lands when native client widgets ship in v1.1+.
- First piece of admin enhancements stack (v0.8.0-v0.8.3).
- Per-shortcode tier guards: each core
astroway_*shortcode is now wrapped withTier::can( $feature ). Locked shortcodes render an inline "Pro feature" CTA. Behavior matches v0.7.2 block-side gating — v1 shortcodes remain anonymous-accessible.
- New
Tier::render_upgrade_cta( $feature )returns a styled CTA panel with feature label + upgrade button linking to api.astroway.info/dashboard/upgrade. Filterable viaastroway_upgrade_cta_htmlfor theme/addon customization. - Block + shortcode guards (v0.7.2/v0.7.3) refactored to call the helper. Closes the v0.7.x tier-gating stack and pre-v1.0 blocker B3.
- Fix: free and anonymous installs now receive updates via WordPress.org again. The bundled paid-tier update channel was registering for every install and suppressing the standard update check; it is now correctly limited to paid API keys, so one-click updates work for everyone else.
- Per-block tier guards: each registered Gutenberg block is now wrapped with
Tier::can( $feature ). Locked blocks render an inline "Pro feature" CTA instead of the widget. All v1 blocks remain accessible to anonymous users (matrix default); guards activate for v1.x+ Pro blocks.
- New
Tier::can( string $feature ): boolchecks whether current tier can access a feature. - New
Tier::matrix(): arrayreturns feature → allowed tiers map, filterable viaastroway_tier_matrixso addons can declare their own features. - Default matrix: v1 widgets (natal, daily_horoscope, moon_phase, bodygraph, daily_tarot) anonymous-OK; synastry/solar_return/lunar_return/progressions/native_render paid-only; ai_chat/transit_alerts pro+.
- New utility class
AstroWayWPPluginTierwithTier::current()resolving the user's plan from cached /v1/auth/keys/me response (30 min TTL). Returns anonymous/free/indie/starter/pro/business/internal. - AddonAPI::current_tier() refactored as facade delegating to Tier::current(). First piece of tier-gating subsystem (v0.7.x).
- New developer guide
docs/addon-development.mddocuments the v0.6.x Addon Hooks API + AddonAPI reference + minimal working example. - New example addon scaffold
docs/example-addon/shows shortcode registration + tier check + widget declaration. - Closes the Addon Hooks API atomic stack v0.6.0-v0.6.5. Track 3 addon plugins can now develop against a stable surface.
- New public class
AstroWayWPPluginAddonAPI— BC-locked stable surface for addon developers. Methods:register_widget(),current_tier(),api_base(),has_key(),cache_key(). Internal classes (RendererDecisions, ApiClient, Cache, Admin) remain unstable.
- New filter:
astroway_widgetslets addons append entries to the widget registry without touching core. Useful for new shortcodes/blocks that map to api/v1/embed/*endpoints.
- New action:
astroway_register_blocksfires at end of Blocks::register_assets_and_blocks(). Addons hook here to call register_block_type() for their own astroway/* Gutenberg blocks.
- New action:
astroway_register_shortcodesfires at end of Shortcodes::register(). Addons hook here to call add_shortcode() for their own astroway_* shortcodes.
- New action:
astroway_initfires early in plugin boot, signalling addons that core classes are loaded and they can hook into upcoming registration actions. - First atomic piece of the Addon Hooks API (v0.6.0-v0.6.5). Unlocks third-party addon ecosystem.
- Admin: new "Update channel" panel on the API Key page shows current channel (A/B), whether PUC library is loaded, whether an API key is set, and last update check timestamp.
- Closes the Channel B atomic stack v0.5.0-v0.5.5. Plugin meets the v1.0 "Channel B custom updater" stability gate condition.
- Channel B update checks now send Cache-Control: no-cache + Pragma: no-cache headers, ensuring fresh response from astroway.info even if a transit cache sits between WP and the server.
- "View details" modal verified to render correctly with PUC defaults — pulls changelog/sections from update.json.
- Channel B custom updater wired via plugin-update-checker — registers against https://astroway.info/wp-plugin/update.json with the saved API key carried as ?key= query arg.
- When PUC is absent or the server endpoint is unreachable, wp.org Channel A continues to deliver updates as before.
- Follow-up hotfix on v0.5.7: also guards require_once for class-updater.php and class_exists() checks around Updater::boot() / ElementorLoader::boot(). All forward-version dependencies in the main plugin file and Plugin::boot() now degrade gracefully if the corresponding includes/ files aren't bundled in the current ZIP.
- Hotfix on top of v0.5.6: the main plugin file required class-tier.php / class-addon-api.php / elementor.php unconditionally, but those classes only ship in later versions and were missing from the v0.5.6 ZIP — every page load fatal-erred. Those three require_once calls are now guarded by file_exists() so older ZIPs load cleanly. Also wraps Tier::current() in class_exists() for the same reason.
- No behavior change for v0.5.6 features (review prompt + anonymous rate-limit guard) — they keep working as designed.
- Added a one-time review prompt in WP admin shown 14 days after activation, dismissible per-user.
- Anonymous rate-limit guard: when the api responds that the public 30/h-per-IP limit is exhausted, the plugin now skips rendering the iframe (no more raw JSON error visible to visitors) and surfaces a one-time admin notice pointing the site owner at a free API key. Paid tiers and any configured API key skip the probe entirely. The probe itself is cached for 5 minutes in a transient so it adds at most one extra api hit per site every five minutes.
- Bundled YahnisElsts/plugin-update-checker v5.6 library at includes/lib/plugin-update-checker/ — autoloaded via load-v5p6.php. Foundation for v0.5.3 Channel B update hook.
- No new user-visible behavior. PUC is loaded but no update checker instance is created yet.
- Channel B download endpoint live at astroway.info/wp-plugin/download/{version}/ — 302-redirects paid-tier keys to versioned ZIP on GitHub Releases.
- update.json now returns full download_url field for paid tiers.
- No user-visible plugin code change. Plugin-side update hooks land in v0.5.3.
- Channel B server endpoint deployed at astroway.info/wp-plugin/update.json — paid-tier auto-update infrastructure (first of 6 atomic pieces, v0.5.0-v0.5.5).
- No user-visible plugin code change. Plugin-side updater hooks land in v0.5.3.
- CI/Tests infrastructure: PHPUnit unit tests + WPCS lint via GitHub Actions matrix (PHP 8.1-8.4 full test, 7.4/8.0 syntax compat)
- Refactor: input sanitization extracted as public statics on Shortcodes class (no behavior change, enables addon reuse)
- No user-visible changes — pure foundation for upcoming addon ecosystem (v0.6.0)
- New: live Status panel on the API Key admin landing — plan / credits / period / domain pulled from /v1/auth/keys/me (30 min transient cache)
- New:
langattribute on all 5 shortcodes (e.g.[astroway_natal date="..." lang="ru"]) — 21 api-supported locales - New: Language Inspector dropdown on all 5 Gutenberg blocks — uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id
- Default lang resolves to the WP site locale; invalid codes silently fall back, no user-facing error
- Status panel handles all 5 states: valid / suspended / revoked / invalid_key / api_down with per-state color accent
- Requires api.astroway.info v2.33.0+ for /v1/auth/keys/me; falls back to legacy /v1/keys/usage with "Limited data" notice on older self-hosted api
- No regressions on v0.2.3 — existing shortcodes/blocks without
lang=render in site default exactly as before
- All 3 subpages share one hero (brand + status badge + CTAs); only title and tagline vary per page
- Right sidebar restored (Resources + System + quote) in a 1fr + 280px grid
- Buttons read as buttons in both light panels and the dark hero (ghost variant + on-dark override)
- Shortcode reference cards gain proper panel-body inset
- New: city → lat/lon/IANA-tz helper on the Shortcodes page (server-side proxy to app.astroway.info atlas + click-to-copy snippet)
- Type tokens drop bundled webfont declarations — pure ui-sans-serif/system-ui stack, multi-script coverage via OS fonts
- 20 bundled translations: uk, de_DE, ru_RU, pl_PL, es_ES, pt_BR, hi_IN, fr_FR, ko_KR, it_IT, ja, id_ID, tr_TR, nl_NL, ro_RO, cs_CZ, vi, ar (RTL), el, hu_HU
- Translation filenames corrected to {textdomain}-{locale}.mo + explicit load_plugin_textdomain call
- Admin UI split into 3 submenu pages: API Key (default landing), Settings, Shortcodes
- API Key landing rebuilt with 3-tier comparison (Anonymous / Free key / Paid), state badge, key form, prominent CTAs
- Settings page focused on diagnostics: Connection ping, Cache stats + purge, System info with Copy diagnostic button
- Shortcodes page rebuilt as expanded reference cards (description + copyable code + params table + Gutenberg block hint per shortcode)
- JS split per-page (api-key / settings / shortcodes), reducing payload on each admin screen
- Settings page promoted to a top-level admin menu item with a custom brand icon (star inside orbit ring, single-path SVG)
- Activation notice rebranded with a cosmic-gradient mark, two CTAs (Get free API key / Open Settings), and persistent dismiss (fix for a latent bug where the dismiss action did not survive page reloads)
- Settings page fully redesigned with an observatory aesthetic — hero with owl-moon logo, four numbered panels (API key / Connection / Cache / Shortcodes), right-side Resources / System / quote aside, paper-warm cards with gold hairlines
- Shortcode rows copy-to-clipboard on click
- ASTROWAY_WP_PLUGIN_VERSION constant auto-derived from the plugin header via get_file_data — single source of truth, simpler release pipeline
- Settings page under Settings → AstroWay (API key input, Verify Key, Test Connection, Cache controls, shortcode reference, Diagnostics)
- API key field accepts both sandbox (aw_test_) and live (aw_live_) keys
- All keyed requests now carry X-Api-Key + X-AstroWay-Site-URL headers (lazy domain bind support)
- Plugin row links: Settings + Get API Key (with ?source=wp_plugin)
- Activation notice CTA URL includes ?source=wp_plugin for referrer-source tracking
- New transient cache layer (prefix astroway_v1_) with purge button + stats
- Verify Key gracefully falls back to /v1/keys/usage until api ships /v1/auth/keys/me (Block A)
- MVP — 5 iframe shortcodes via /v1/embed/* (works without API key, 30/hr per IP)
- 5 Gutenberg blocks with ServerSideRender
- Vanilla CSS theme-overridable via CSS vars (--astroway-*)
- i18n .pot + EN/UK/DE/PL base translations
- Graceful 429 handler with 'Get free API key' admin notice
- Initial scaffold (pre-release). Plugin header + PSR-4 autoload + activation hooks. No shortcodes yet — first functional release planned as 0.1.0.