Title: Celestial Lunar Phase Widget
Author: John Martin
Published: <strong>April 14, 2026</strong>
Last modified: April 14, 2026

---

Soek deur uitbreidings

![](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

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

[Laai Af](https://downloads.wordpress.org/plugin/celestial-lunar-phase.zip)

 * [Besonderhede](https://af.wordpress.org/plugins/celestial-lunar-phase/#description)
 * [Aanbevelings](https://af.wordpress.org/plugins/celestial-lunar-phase/#reviews)
 *  [Installation](https://af.wordpress.org/plugins/celestial-lunar-phase/#installation)
 * [Ontwikkeling](https://af.wordpress.org/plugins/celestial-lunar-phase/#developers)

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

## Beskrywing

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`

## Screenshots

 * [[
 * 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.

## Blokke

This plugin provides 1 block.

 *   Celestial Lunar Phase Widget

## Installation

 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.

## Kwel-vrae

### 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/

## Aanbevelings

There are no reviews for this plugin.

## Contributors & Developers

“Celestial Lunar Phase Widget” is oopbron sagteware. Die volgende mense het bygedra
tot die ontwikkeling van hierdie uitbreiding:

Contributors

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

[Translate “Celestial Lunar Phase Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/celestial-lunar-phase)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/celestial-lunar-phase/),
check out the [SVN repository](https://plugins.svn.wordpress.org/celestial-lunar-phase/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/celestial-lunar-phase/)
by [RSS](https://plugins.trac.wordpress.org/log/celestial-lunar-phase/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 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.

## Meta

 *  Version **1.1.0**
 *  Last updated **3 weke gelede**
 *  Active installations **Minder as 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/celestial-lunar-phase/)
 * Tags
 * [astronomy](https://af.wordpress.org/plugins/tags/astronomy/)[Gutenberg block](https://af.wordpress.org/plugins/tags/gutenberg-block/)
   [moon phase](https://af.wordpress.org/plugins/tags/moon-phase/)
 *  [Gevorderde Aansig](https://af.wordpress.org/plugins/celestial-lunar-phase/advanced/)

## Punte-toekennings

No reviews have been submitted yet.

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

[See all reviews](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/)

## Contributors

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

## Hulp

Got something to say? Need help?

 [Gaan na die hulp-forum](https://wordpress.org/support/plugin/celestial-lunar-phase/)