Title: Celestial Lunar Phase Widget Author: John Martin Published: 2026 年 4 月 14 日 Last modified: 2026 年 9 月 25 日 --- 搜尋外掛 ![](https://ps.w.org/celestial-lunar-phase/assets/banner-772x250.png?rev=3563439) ![](https://ps.w.org/celestial-lunar-phase/assets/icon-256x256.png?rev=3563439) # Celestial Lunar Phase Widget 由 [John Martin](https://profiles.wordpress.org/johnfoo/) 開發 [下載](https://downloads.wordpress.org/plugin/celestial-lunar-phase.2.3.0.zip) * [詳細資料](https://tw.wordpress.org/plugins/celestial-lunar-phase/#description) * [使用者評論](https://tw.wordpress.org/plugins/celestial-lunar-phase/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/celestial-lunar-phase/#installation) * [開發資訊](https://tw.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 * Astronomical dawn time * Astronomical dusk time * Illumination percentage * Bundled Moon phase image matched to the phase * Optional location label * Optional calculation/source note Version 2.3 uses local astronomy calculations and adds automatic Moon image orientation by hemisphere. The plugin can rotate the bundled lunar imagery for Northern Hemisphere observers, with manual Northern, Southern, and Original orientation overrides in Settings. #### Key features * Local astronomy calculations; no API key required * Moonrise and moonset times * Astronomical dawn and dusk display * Current lunar phase and illumination percentage * Bundled Moon phase photos packaged locally * Location lookup helper for admin setup * Browser geolocation helper for admin setup * Timezone dropdown to prevent typos and date-shift errors * Latitude, longitude, timezone, and optional elevation settings * Shortcode: `[celestial_lunar_phase_widget]` * Gutenberg block: **Celestial Lunar Phase Widget** * 12-hour or 24-hour time display * Per-location and per-date caching for better performance * Admin notice after update if location settings need to be completed * Automatic Moon image orientation based on configured latitude * Manual Northern Hemisphere, Southern Hemisphere, and Original image orientation options #### Support Support and documentation are available at: https://celestialwebdevelopment.com/ lunar-phase-plugin/ ### External Services This plugin performs all lunar phase, moonrise, moonset, astronomical dawn, and astronomical dusk calculations locally. It does not send visitor data to an astronomy API. The optional **Lookup Location** button on the admin settings page uses the OpenStreetMap Nominatim geocoding service to convert a place name into latitude and longitude. This lookup is only triggered by an administrator clicking the button in wp-admin. The query entered by the administrator is sent to Nominatim for geocoding. The service may receive the searched location text, your site’s server IP address, and standard request metadata. Service provider: OpenStreetMap Nominatim Terms: https://operations.osmfoundation. org/policies/nominatim/ Privacy: https://osmfoundation.org/wiki/Privacy_Policy The **Use My Current Location** button uses the browser’s built-in geolocation prompt. Coordinates are only saved after the administrator clicks **Save Changes**. ## 螢幕擷圖 [⌊Frontend lunar phase widget display.⌉⌊Frontend lunar phase widget display.⌉[ Frontend lunar phase widget display. [⌊Plugin settings screen.⌉⌊Plugin settings screen.⌉[ Plugin settings screen. ## 適用於區塊編輯器 這個外掛提供 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 a city, state, address, or place name and click **Lookup Location**, or use** Use My Current Location**. 5. Verify the timezone dropdown and save changes. 6. Add the **Celestial Lunar Phase Widget** block or place `[celestial_lunar_phase_widget]` into a post, page, or widget area. ## 常見問題集 ### Does the plugin require an API key? No. Version 2.2 calculates the Moon phase, moonrise, moonset, astronomical dawn, and astronomical dusk locally. No WeatherAPI key or external astronomy data service is required. ### Why do I need latitude and longitude? Moonrise, moonset, dawn, and dusk are location-specific. Version 2.2 uses the configured latitude, longitude, and timezone to calculate the correct local values. The settings page includes Location Lookup and Use My Current Location helpers to make this easier. ### What happens when upgrading from an older API-based version? After the update, WordPress admins will see a notice asking them to complete the new location settings. The widget will display a safe setup message until latitude, longitude, and timezone are saved. Use Location Lookup or Use My Current Location from the settings page. ### Why might times differ from Timeanddate.com or other services? Moonrise and moonset times can differ between services because of location precision, elevation, terrain/horizon assumptions, atmospheric refraction, and calculation methods. ### Does the plugin include Moon images? Yes. Eight Moon phase images are bundled locally inside the plugin package. ### Why does the Moon image orientation change? Version 2.3 can orient the bundled Moon image for the observer’s hemisphere. Automatic mode uses the configured latitude. The bundled images use a Southern Hemisphere orientation, so Northern Hemisphere display is rotated 180 degrees. This is a practical hemisphere representation; the Moon’s exact apparent angle also varies with date, time, latitude, and position in the sky. ### Does the plugin include a Gutenberg block? Yes. The plugin includes a dynamic Gutenberg block with editor controls for location label, date, title, and display options. ## 使用者評論 ![](https://secure.gravatar.com/avatar/abf60e80e5104afd9890a05adf602689ac832b1ef592757c20c624642e4de845? s=60&d=retro&r=g) ### 󠀁[Highly recommended!](https://wordpress.org/support/topic/highly-recommended-801/)󠁿 [astrobobo](https://profiles.wordpress.org/astrobobo/) 2026 年 9 月 26 日 Excellent widget, simple to set up, essential for every astronomy related web page– Moon phase, rise/set time combined with astronomical dusk & dawn, exactly what I have been looking for all these years! Highly recommended! Extra kudos to the author for replying to my e-mail and implementing a suggestion I made! [ 閱讀全部 1 則使用者評論 ](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/) ## 參與者及開發者 以下人員參與了開源軟體〈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/)。 ## 變更記錄 #### 2.3.0 * Added automatic moon image orientation based on hemisphere. * Added manual orientation options (Automatic, Northern Hemisphere, Southern Hemisphere, Original). * Improved WordPress.org metadata (5 tags, shorter description). * Tested up to WordPress 7.0. * Various usability improvements. #### 2.2.3 * Updated WordPress compatibility and plugin header metadata. * Removed production debug logging flagged by the Plugin Check tool. * Added translator context for the localized calculation credit. * Limited directory tags and shortened the plugin description. #### 2.2.0 * Added Location Lookup helper using OpenStreetMap Nominatim from the admin settings page. * Added timezone dropdown with common timezones and all IANA timezone identifiers. * Improved setup guidance and admin notice language for upgrades from API-based versions. * Kept local astronomy calculations only; WeatherAPI remains removed. #### 2.1.0 * Removed WeatherAPI mode and API key settings. * Added local-only astronomy calculations. * Added admin notice when latitude, longitude, or timezone settings are missing after update. * Kept browser geolocation helper for easier setup. * Updated branding and documentation for Celestial Web Development. #### 2.0.9 * Fixed local date handling for the configured observing timezone. * Shortened astronomical twilight labels to Dawn and Dusk. #### 2.0.8 * Improved moonrise and moonset calculations using a SunCalc-style algorithm. * Improved phase and illumination calculation. #### 2.0.2 * Added local calculation diagnostics and safer timezone handling. #### 2.0.0 * Added local astronomy calculation mode for moonrise and moonset. * Changed local sun times display to astronomical dawn and astronomical dusk. * Added latitude, longitude, timezone, and elevation settings. * Added browser geolocation helper in admin. #### 1.1.0 * Added Gutenberg block support. * Added bundled WordPress.org assets and screenshots. #### 1.0.0 * Initial release. ## 中繼資料 * 版本 **2.3.0** * 最後更新 **4 天前** * 啟用安裝數 **40+** * WordPress 版本需求 ** 5.8 或更新版本 ** * 已測試相容的 WordPress 版本 **7.0.6** * PHP 版本需求 ** 7.4 或更新版本 ** * 語言 * [English (US)](https://wordpress.org/plugins/celestial-lunar-phase/) * 標籤: * [astronomy](https://tw.wordpress.org/plugins/tags/astronomy/)[moon](https://tw.wordpress.org/plugins/tags/moon/) [widget](https://tw.wordpress.org/plugins/tags/widget/) * [進階檢視](https://tw.wordpress.org/plugins/celestial-lunar-phase/advanced/) ## 評分 5 星，滿分為 5 星 * [ 1 個 5 星使用者評論 ](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/celestial-lunar-phase/reviews/?filter=1) [撰寫評分](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/)