=== SunMoon_RiseSet ===

Plugin Name: SunMoon_RiseSet
Plugin URI: https://maforge49.freeboxos.fr
Description: WordPress astronomy plugin for calculating and displaying Sun and Moon ephemerides.
Version: 1.1.8
Stable tag: 1.1.8
Tags: astronomy, sun, moon, ephemeris, observatory
Author: Emmanuel TANGUY F4AWZ
Author URI: https://maforge49.freeboxos.fr
Contributors: f4awz
Text Domain: sunmoon-riseset
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Calculate and display Sun and Moon ephemerides, including rise, set, phase, illumination, and day length information.

== Description ==

SunMoon_RiseSet is a WordPress plugin for calculating and displaying astronomical information about the Sun and Moon.

It provides:
* Sunrise and sunset times, as well as day length, based on the selected location.
* Moonrise and moonset times for monitoring lunar cycles.
* Current lunar phase and illumination information.

The plugin is designed to be simple to use and follows WordPress best practices for validated settings, escaped output, and caching.

The `[sunmoon-riseset]` shortcode displays the astronomy widget anywhere on the site. You can optionally specify a custom latitude and longitude, for example: `[sunmoon-riseset lat="47.5078" lng="-0.5878"]`.

== Installation ==

1. Download the plugin.
2. In the WordPress administration area, go to **Plugins > Add New > Upload Plugin**.
3. Select the plugin ZIP file.
4. Click **Install Now**.
5. Activate the plugin.
6. Go to **Settings > SunMoon_RiseSet** to configure the default latitude, longitude, and time zone.
7. Add the `[sunmoon-riseset]` shortcode to the desired page or post.

== Frequently Asked Questions ==

= Does the plugin require any special configuration? =

No. A default latitude, longitude, and time zone for Angers, France are provided. You can change them under **Settings > SunMoon_RiseSet**.

= Is the plugin compatible with Elementor? =

Yes. The `[sunmoon-riseset]` shortcode can be added to an Elementor Shortcode or Text widget, or to the WordPress block editor using the Shortcode block.

= What are the requirements? =

WordPress 6.0 or later and PHP 7.4 or later.

= Are plugin data removed during uninstallation? =

By default, no. Your settings are retained if you reinstall the plugin. You can enable the **Delete data** option under **Settings > SunMoon_RiseSet** to permanently remove the plugin settings and cache during uninstallation.

== Screenshots ==

1. Main plugin display.
2. Settings page.
3. Shortcode usage example.

== Changelog ==

= 1.1.8 =
* Invalidated old cached ephemerides after the lunar calculation correction.
* Moonrise/moonset now use the corrected lunar calculation immediately after update.


= 1.1.5 =
* Reworked Moon rise/set calculation: correct local-date handling, rigorous topocentric RA correction, lunar semidiameter, and 1-minute root search.


= 1.1.4 =
* Amélioration majeure des calculs lunaires : théorie de Meeus chapitre 47 avec 60 termes de longitude/distance et 60 termes de latitude, parallaxe topocentrique et recherche des passages à 5 minutes.


= 1.1.4 =

* Renamed the shortcode to `[sunmoon-riseset]`.
* Updated all plugin documentation and shortcode references.
* Incremented the plugin version to 1.1.4.

= 1.1.0 =

* Added an uninstall option to delete or retain plugin data.
* Added validation and sanitization for latitude, longitude, and time zone settings.
* Added caching to avoid recalculating astronomical data on every display.
* Added handling for polar day and polar night conditions in sunrise and sunset calculations.
* Fixed an edge case in lunar age calculation.
* Added a Settings link to the Plugins page.
* The stylesheet is loaded only on pages using the shortcode.
* Prepared the plugin for translation.

= 1.0.0 =

* Initial release.
* Added the main astronomy features.

== Upgrade Notice ==

= 1.1.4 =
The shortcode is now `[sunmoon-riseset]`. Update your pages and posts that used the previous shortcode.

= 1.1.0 =
Added data cleanup options and various fixes. Update recommended.

= 1.0.0 =
Initial release.

== Privacy ==

This plugin does not collect personal data. It stores only the location settings entered on the site (latitude, longitude, and time zone) and a temporary cache of astronomical calculations. No data is transmitted to third-party services.

== Credits ==

Developed by Emmanuel TANGUY F4AWZ.

Site: https://maforge49.freeboxos.fr
