Lunar Phase Plugin

Add a beautiful live moon phase display to your WordPress website.

The Lunar Phase Plugin displays the current lunar phase with a matching image, phase name, moonrise time, moonset time, and illumination. Perfect for astronomy sites, educators, and space enthusiasts.

What the Plugin Displays

  • Current lunar phase
  • Matching moon phase image
  • Phase name
  • Moonrise time
  • Moonset time
  • Illumination percentage
  • Location-based data

Key Features

  • Easy shortcode: [lunar_phase_widget]
  • Gutenberg block support
  • Clean, modern moon phase display
  • Local images bundled with plugin
  • Simple setup screen
  • Reliable API-powered data

Installation

  • Upload the plugin ZIP in Plugins → Add New
  • Activate the plugin
  • Go to Settings → Lunar Phase Widget
  • Enter your WeatherAPI key
  • Add the shortcode to any page or post

Shortcode

[lunar_phase_widget]

[lunar_phase_widget location="Winona, MN" title="Tonight\'s Moon" show_credit="no"]

[lunar_phase_widget date="2026-03-29" show_location="yes"]

Screenshots

Widget Display

Setup Screen

Support

Need help or want to report an issue?

  • Submit bug reports
  • Request new features
  • Get help with setup
  • Request customization

Please include your WordPress version, plugin version, theme, and screenshots when reporting issues.

Frequently Asked Questions

Does this plugin require an API?

Yes. It uses WeatherAPI to retrieve lunar data including moon phase, moonrise, and moonset times.

Does it work with blocks?

Yes. You can use either the Gutenberg block or shortcode.

Can I customize it?

Yes. Celestial Web Development offers customization and integration services.

About Celestial Web Development

Celestial Web Development specializes in WordPress development, customization, and hosting solutions.

Email: john@celestialwebdevelopment.com

Live Example

Current Lunar Phase
Waning Gibbous
Waning Gibbous
Elgin, Minnesota, United States of America
Moonrise 9:49 PM
Moonset 7:05 AM
Illumination 99%
Moon data by WeatherAPI. Phase images bundled locally.