Title: Celestial Lunar Phase Widget
Author: John Martin
Published: <strong>2026 年 4 月 14 日</strong>
Last modified: 2026 年 5 月 21 日

---

搜索插件

![](https://ps.w.org/celestial-lunar-phase/assets/banner-772x250.png?rev=3509189)

![](https://ps.w.org/celestial-lunar-phase/assets/icon-256x256.png?rev=3509189)

# Celestial Lunar Phase Widget

 作者：[John Martin](https://profiles.wordpress.org/johnfoo/)

[下载](https://downloads.wordpress.org/plugin/celestial-lunar-phase.1.1.0.zip)

 * [详情](https://cn.wordpress.org/plugins/celestial-lunar-phase/#description)
 * [评价](https://cn.wordpress.org/plugins/celestial-lunar-phase/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/celestial-lunar-phase/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/celestial-lunar-phase/#developers)

 [支持](https://wordpress.org/support/plugin/celestial-lunar-phase/)

## 描述

Celestial Lunar Phase Widget helps WordPress sites display the current moon phase
in a polished astronomy card.

The plugin shows:

 * Current lunar phase name
 * Moonrise time
 * Moonset time
 * Illumination percentage
 * Bundled moon phase image matched to the returned phase
 * Optional location label
 * Optional WeatherAPI credit line

It includes both a classic shortcode and a Gutenberg block, so site owners can add
lunar data in the editor or in traditional content areas.

#### Ideal for

 * Astronomy and space science websites
 * Observing clubs and public outreach pages
 * Weather and nature blogs
 * Classroom and education sites
 * Hobbyist websites that want a live moon phase widget

#### Key features

 * Shortcode: `[celestial_lunar_phase_widget]`
 * Gutenberg block: **Celestial Lunar Phase Widget**
 * Eight bundled moon phase photos packaged locally
 * Default location and title settings
 * 12-hour or 24-hour time display
 * Per-location and per-date caching for better performance
 * No visitor geolocation in the browser, so your API key stays server-side

#### Support

Support and documentation are available at:
 https://celestialwebdevelopment.com/
lunar-phase-plugin/

### Blocks

#### Celestial Lunar Phase Widget

Display the current moon phase with a bundled moon image, phase name, moonrise, 
moonset, and illumination.

### External Services

This plugin connects to the following external service:

#### WeatherAPI

 * Service URL: `https://api.weatherapi.com/v1/astronomy.json`
 * What the service does: Returns moon phase, moonrise, moonset, and illumination
   data for the requested location and date.
 * When data is sent: Only when the block or shortcode is rendered and no cached
   response is available.
 * What data is sent: The site administrator’s WeatherAPI key, the configured location
   or override location, and the selected date.
 * Service provider: WeatherAPI
 * Terms of use: `https://www.weatherapi.com/terms.aspx`
 * Privacy policy: `https://www.weatherapi.com/privacy.aspx`

## 屏幕截图

 * [[
 * Front-end widget showing the current lunar phase, location, moonrise, moonset,
   and illumination.
 * [[
 * Settings screen for WeatherAPI key, default location, time format, and shortcode
   examples.

## 区块

该插件提供了 1 个区块.

 *   Celestial Lunar Phase Widget

## 安装

 1. Upload the plugin folder to `/wp-content/plugins/` or install the ZIP from **Plugins
    > Add New > Upload Plugin**.
 2. Activate the plugin.
 3. Go to **Settings > Celestial Lunar Phase Widget**.
 4. Enter your WeatherAPI key.
 5. Set a default location.
 6. Add the **Celestial Lunar Phase Widget** block or place `[celestial_lunar_phase_widget]`
    into a post, page, or widget area.

## 常见问题

### Does the plugin include moon images?

Yes. Eight moon phase images are bundled locally inside the plugin package.

### Does the plugin include a Gutenberg block?

Yes. Version 1.1.0 includes a dynamic Gutenberg block with editor controls for location,
date, title, and display options.

### Does the plugin need an API key?

Yes. The plugin uses WeatherAPI to retrieve moon phase, moonrise, moonset, and illumination
data.

### Does the plugin auto-detect each visitor location?

No. This version uses the saved default location or a block/shortcode override.

### Where can I get support?

Support is available at:
 https://celestialwebdevelopment.com/lunar-phase-plugin/

## 评价

此插件暂无评价。

## 贡献者及开发者

「Celestial Lunar Phase Widget」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ John Martin ](https://profiles.wordpress.org/johnfoo/)

[帮助将「Celestial Lunar Phase Widget」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/celestial-lunar-phase)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/celestial-lunar-phase/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/celestial-lunar-phase/)，或通过[RSS](https://plugins.trac.wordpress.org/log/celestial-lunar-phase/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/celestial-lunar-phase/)。

## 更新日志

#### 1.1.0

 * Added a dynamic Gutenberg block with editor preview.
 * Added WordPress.org screenshot assets and improved submission readme.
 * Updated plugin author, support, and company branding to Celestial Web Development.

#### 1.0.0

 * Initial release.

## 额外信息

 *  版本 **1.1.0**
 *  最后更新：**1 周前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 5.8 或更高版本 **
 *  已测试的最高版本为 **7.0**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/celestial-lunar-phase/)
 * 标签
 * [astronomy](https://cn.wordpress.org/plugins/tags/astronomy/)[Gutenberg block](https://cn.wordpress.org/plugins/tags/gutenberg-block/)
   [moon phase](https://cn.wordpress.org/plugins/tags/moon-phase/)
 *  [高级视图](https://cn.wordpress.org/plugins/celestial-lunar-phase/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/)

## 贡献者

 *   [ John Martin ](https://profiles.wordpress.org/johnfoo/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/celestial-lunar-phase/)