stleary

<p>This plugin displays data of interest to amateur astronomers. It is calculated from user-provided location and date information.<br />
The plugin is called from a WordPress shortcode, and the parameters are specified in the shortcode. The following parameters are<br />
required, in any order:</p>
<ul>
<li><strong>lat</strong> : Lattitude of location in fractional degrees (e.g. 30.8910). Positive is north, negative is south of equator</li>
<li><strong>long</strong> : Longitude of location in fractional degrees (e.g.-98.4265). Positive is east, negative is west of the UTC line</li>
<li><strong>timezone</strong> : Timezone name, must be value recognized by PHP. See <a href="http://php.net/manual/en/timezones.php" rel="nofollow ugc">http://php.net/manual/en/timezones.php</a></li>
</ul>
<p>These parameters are optional:</p>
<ul>
<li><strong>name</strong> : The name of the location to be calculated</li>
<li><strong>days</strong> : The number of days of data to display. Must be a value from 1 to 10. Defaults to 3 if not specified. </li>
</ul>
<p><strong>Shortcode Examples:</strong></p>
<ul>
<li>stars-at-night name=Chennai lat=13.08 long=80.26 timezone=Asia/Kolkata days=1</li>
<li>stars-at-night name=”COE Observing Field” lat=30.891 long=-97.4265 timezone=America/Chicago days=10</li>
</ul>
<p>You can also display the individual data tables via more specific shortcodes:</p>
<ul>
<li>stars-at-night-sun-moon name=”Mount Kilimanjaro” lat=-2.55 long=37.55 timezone=Africa/Nairobi</li>
<li>stars-at-night-planets name=”Ushuaia” lat=-54.8 long=-68.33 timezone=America/Argentina/Ushuaia</li>
<li>stars-at-night-iss name=”Mount Burnett Observatory” lat=-37.9 long=145.4 timezone=Australia/Melbourne days=7</li>
</ul>
<p>The output consists of simple HTML tables:</p>
<ul>
<li>Sun/Moon table: The times for sunrise, sunset, moonrise, moonset, morning astronomical twilight, and evening astronomical twilight for the specified days (max 10 days).</li>
<li>Planets table: The times and visibility for the planets, for the current day.</li>
<li>ISS table: The times and directions for visible ISS passes over the specified days (max 10 days).</li>
<li>(REMOVED) Iridium flares table: The times and directions for visible Iridium flares over the specified days (max 7 days).</li>
</ul>
<p>You can view the plugin in action here: <a href="http://johnjleary.com/notforlong" rel="nofollow ugc">http://johnjleary.com/notforlong</a></p>
<p><strong>Credits and Acknowledgements:</strong></p>
<ul>
<li>Lunar images by <a href="mailto://Dan@danmorgan.org" rel="nofollow ugc">Dan Morgan</a>. Used with permission. <a href="http://DanMorgan.org" rel="nofollow ugc">http://DanMorgan.org</a>.</li>
<li>WordPress framework and sunrise/sunset algorithm: https://github.com/bengreeley/sunrisesunset</li>
<li>Moonrise and Moonset class (with a correction for timezone): http://dxprog.com/entry/calculate-moon-rise-and-set-in-php</li>
<li>Moon phase class: https://github.com/solarissmoke/php-moon-phase</li>
<li>Planetary, ISS and Iridium Flare tables are obtained by sending GET requests to: http://heavens-above.com (HTTP API used with permission)</li>
<li>Per-table shortcodes implemented by Peter Lieverdink</li>
</ul>
<h3>Contributors</h3>
<p>stleary<br />
Peter Lieverdink</p>


The Stars at Night

Stars-at-night displays astronomical data for a specified location and date.

Sandun Malinga

<p>SolarDawn Sunrise & Sunset Widget adds a responsive frontend card for sunrise and sunset information. It works in posts, pages, widget areas, Gutenberg shortcode blocks, and page builders through the <code>[solardawn_sunrise_sunset]</code> shortcode.</p>
<p>The widget can use a default country/state/city dropdown selection, manual latitude/longitude, shortcode location attributes, or optional visitor country detection by public IP. Sunrise, sunset, twilight, and daylight details are calculated locally from the selected coordinates and timezone, then cached with WordPress transients.</p>
<p>Features include:</p>
<ul>
<li>Sunrise and sunset times</li>
<li>Solar noon</li>
<li>Day length</li>
<li>Golden hour morning and evening</li>
<li>Blue hour morning and evening</li>
<li>Civil, nautical, and astronomical twilight</li>
<li>Light, dark, and sunrise gradient themes</li>
<li>Country, state, and city dropdowns generated from the bundled location JSON</li>
<li>Automatic latitude, longitude, and timezone detection from selected locations</li>
<li>Optional visitor country detection, disabled by default</li>
</ul>
<h3>Shortcode Examples</h3>
<p>Default settings:</p>
<pre><code>[solardawn_sunrise_sunset]
</code></pre>
<p>Country:</p>
<pre><code>[solardawn_sunrise_sunset country="Sri Lanka"]
</code></pre>
<p>Country, state, and city without manual coordinates:</p>
<pre><code>[solardawn_sunrise_sunset country="Sri Lanka" state="Western" city="Colombo"]
</code></pre>
<p>City search within a country:</p>
<pre><code>[solardawn_sunrise_sunset country="Japan" city="Tokyo"]
</code></pre>
<p>Manual coordinates:</p>
<pre><code>[solardawn_sunrise_sunset lat="6.9271" lon="79.8612" timezone="Asia/Colombo"]
</code></pre>
<p>Custom title:</p>
<pre><code>[solardawn_sunrise_sunset country="United States" title="Today's Sun Times"]<h3>Privacy</h3>
</code></pre>
<p>This plugin calculates sunrise and sunset data locally from the selected latitude, longitude, timezone, and date.</p>
<p>Visitor country detection is disabled by default. When an administrator enables visitor country detection, the plugin sends the visitor IP address to ipapi.co to estimate the visitor’s country. If visitor country detection is disabled, no request is sent to ipapi.co.</p>
<p>The plugin does not store the full IP address in the database. It stores only a salted hash in the transient key and caches the detected country for 12 hours.</p>
<h3>External services</h3>
<p>This plugin can use one external service only when an administrator explicitly enables automatic visitor country detection.</p>
<p>Service name: ipapi</p>
<p>Service URL: <code>https://ipapi.co/</code></p>
<p>Purpose: Used only to estimate the visitor’s country when the admin enables automatic visitor country detection.</p>
<p>Data sent: The visitor IP address is sent to ipapi.co when country auto-detection is used.</p>
<p>When data is sent: Only when the widget/page loads and the auto-detect country feature is enabled.</p>
<p>If auto-detection is disabled, no request is sent to ipapi.co.</p>
<p>Terms of Service: <code>https://ipapi.co/terms/</code></p>
<p>Privacy Policy: <code>https://ipapi.co/privacy/</code></p>
<h3>Live Demo</h3>
<p>You can view a live sunrise and sunset calculator here:</p>
<p><a href="https://earthpulsenow.com/sunrise-sunset" rel="nofollow ugc">Live Sunrise and Sunset for your location Calculator</a></p>
<h3>Zip Packaging Instructions</h3>
<ol>
<li>Confirm the plugin folder is named <code>solardawn-sunrise-sunset-widget</code>.</li>
<li>Confirm the main plugin file is <code>solardawn-sunrise-sunset-widget.php</code>.</li>
<li>Zip the folder itself, not only the files inside it.</li>
<li>The final zip should contain <code>solardawn-sunrise-sunset-widget/solardawn-sunrise-sunset-widget.php</code> at the top level.</li>
<li>Upload the zip from WordPress Admin > Plugins > Add New > Upload Plugin.</li>
</ol>
<h3>Testing Checklist</h3>
<ul>
<li>Activate the plugin on WordPress 5.8 or newer.</li>
<li>Confirm Settings > SolarDawn Sun Widget loads for administrators.</li>
<li>Save settings in country mode and confirm the shortcode renders.</li>
<li>Select a country, state, and city and confirm latitude, longitude, and timezone update automatically.</li>
<li>Test a shortcode with <code>country</code>, <code>state</code>, and <code>city</code> attributes and confirm it renders without manual coordinates.</li>
<li>Save settings in manual coordinate mode and confirm latitude, longitude, and timezone are used.</li>
<li>Confirm visitor country detection is disabled by default.</li>
<li>Enable visitor country detection and confirm the privacy note is visible in settings before using it.</li>
<li>Confirm the widget works in default country mode without calling ipapi.co.</li>
<li>Confirm ipapi.co is contacted only after visitor country detection is enabled.</li>
<li>Confirm the widget renders in a post, page, Gutenberg shortcode block, and widget area.</li>
<li>Check mobile layout below 680px width.</li>
<li>Confirm no hidden footer or header links are added.</li>
</ul>
<h3>WordPress.org Submission Checklist</h3>
<ul>
<li>GPLv2 or later license is declared in the plugin header and readme.</li>
<li>No hidden backlinks are present.</li>
<li>No attribution link is rendered by the plugin.</li>
<li>Optional IP geolocation behavior is documented.</li>
<li>Inputs are sanitized and output is escaped.</li>
<li>Admin settings use the WordPress Settings API and nonces from <code>settings_fields()</code>.</li>
<li>Remote requests use <code>wp_remote_get()</code> only for the opt-in ipapi.co country detection feature.</li>
<li>Assets are enqueued with WordPress APIs.</li>
<li>No external CSS frameworks, font dependencies, or JavaScript libraries are required.</li>
<li>Plugin files are namespaced/prefixed with <code>solardawn</code> or <code>SolarDawn</code>.</li>
</ul>


SolarDawn Sunrise & Sunset Widget

Display sunrise, sunset, day length, solar noon, golden hour, blue hour, and twilight times for selected locations.

The Stars at Night vs SolarDawn Sunrise & Sunset Widget