{"id":544,"date":"2025-10-20T17:16:01","date_gmt":"2025-10-20T21:16:01","guid":{"rendered":"https:\/\/scootercam.net\/notes\/?p=544"},"modified":"2025-10-20T17:18:54","modified_gmt":"2025-10-20T21:18:54","slug":"544","status":"publish","type":"post","link":"https:\/\/scootercam.net\/blog\/544\/","title":{"rendered":""},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">ScooterCam Sun &amp; Moon<\/h1>\n\n\n\n<p>WordPress plugin for displaying comprehensive sun and moon data including sunset\/moonset beauty predictions, phase calendars, arc visualizations, and viewing information.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Description<\/h2>\n\n\n\n<p>This plugin provides detailed astronomical information with beautiful visualizations:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Sunset\/Moonset Predictions<\/strong> &#8211; AI-powered beauty scores (0-10) based on cloud cover, humidity, visibility, and moon phase<\/li>\n\n\n\n<li><strong>Moon Phase Calendar<\/strong> &#8211; Visual timeline showing phases from last new moon to next new moon<\/li>\n\n\n\n<li><strong>Sun &amp; Moon Arcs<\/strong> &#8211; Real-time path visualizations showing current positions<\/li>\n\n\n\n<li><strong>Viewing Information<\/strong> &#8211; Optimal viewing times, recommendations, and technical data<\/li>\n\n\n\n<li><strong>Full Moon Data<\/strong> &#8211; Names, dates, and descriptions of last\/next full moons<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Installation<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Upload the <code>scootercam-sun-moon<\/code> folder to <code>\/wp-content\/plugins\/<\/code><\/li>\n\n\n\n<li>Activate the plugin through the &#8216;Plugins&#8217; menu in WordPress<\/li>\n\n\n\n<li>Ensure data files exist:\n<ul class=\"wp-block-list\">\n<li><code>\/home\/scootercam\/public_html\/wx\/moon_api_data.json<\/code><\/li>\n\n\n\n<li><code>\/home\/scootercam\/public_html\/wx\/predictor.json<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Use shortcodes in your posts or pages<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Shortcodes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Prediction Shortcodes<\/h3>\n\n\n\n<p><strong>Sunset Beauty Score<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_sunset_score]<\/code><\/pre>\n\n\n<p>[scootercam_sunset_score show_details=&#8221;false&#8221;]<\/p>\n\n\n\n<p>Displays tonight&#8217;s sunset quality prediction with score, rating, and contributing factors.<\/p>\n\n\n\n<p><strong>Moonset Beauty Score<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_moonset_score]<\/code><\/pre>\n\n\n<p>[scootercam_moonset_score show_details=&#8221;false&#8221;]<\/p>\n\n\n\n<p>Displays tonight&#8217;s moonset quality prediction with moon phase and illumination data.<\/p>\n\n\n\n<p><strong>Options:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>show_details<\/code> &#8211; Show\/hide contributing factors (default: <code>true<\/code>)<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Moon Data Shortcodes<\/h3>\n\n\n\n<p><strong>Moon Phase Calendar<\/strong><\/p>\n\n\n<p>[scootercam_moon_calendar]<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_moon_calendar]\n<\/code><\/pre>\n\n\n\n<p>Displays 6-cell calendar showing moon phases from last new moon to next new moon, with &#8220;Now&#8221; indicator highlighting current position in the lunar cycle.<\/p>\n\n\n\n<p><strong>Current Moon Phase<\/strong><\/p>\n\n\n<p>[scootercam_moon_current]<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_moon_current]\n<\/code><\/pre>\n\n\n\n<p>Shows current phase name, illumination percentage, age in days, zodiac signs, and moonrise\/moonset times.<\/p>\n\n\n\n<p><strong>Moon Viewing Information<\/strong><\/p>\n\n\n<p>[scootercam_moon_viewing]<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_moon_viewing]\n<\/code><\/pre>\n\n\n\n<p>Displays visibility rating, optimal viewing period, technical position data (altitude, azimuth, distance), and viewing recommendations.<\/p>\n\n\n\n<p><strong>Full Moon Data<\/strong><\/p>\n\n\n<p>[scootercam_full_moons]<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_full_moons]\n<\/code><\/pre>\n\n\n\n<p>Shows last and next full moons with traditional names and cultural descriptions.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Visualization Shortcodes<\/h3>\n\n\n\n<p><strong>Sun Path Arc<\/strong><\/p>\n\n\n<p>[scootercam_sun_arc]<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_sun_arc]\n<\/code><\/pre>\n\n\n\n<p>SVG visualization showing sun&#8217;s path across the sky with sunrise, solar noon, sunset times, and current position indicator.<\/p>\n\n\n\n<p><strong>Moon Path Arc<\/strong><\/p>\n\n\n<p>[scootercam_moon_arc]<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_moon_arc]\n<\/code><\/pre>\n\n\n\n<p>SVG visualization showing moon&#8217;s path with moonrise\/moonset times, current position, and phase graphic.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dashboard<\/h3>\n\n\n\n<p><strong>Complete Astronomy Dashboard<\/strong><\/p>\n\n\n<p>[scootercam_astronomy_dashboard]<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;scootercam_astronomy_dashboard]\n<\/code><\/pre>\n\n\n\n<p>Displays all components in a comprehensive, organized layout:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Sunset and moonset predictions side-by-side<\/li>\n\n\n\n<li>Moon phase calendar<\/li>\n\n\n\n<li>Sun and moon arc visualizations<\/li>\n\n\n\n<li>Current moon phase and viewing information<\/li>\n\n\n\n<li>Full moon data<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Data Files<\/h2>\n\n\n\n<p>The plugin requires two JSON data files:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">moon_api_data.json<\/h3>\n\n\n\n<p>Contains comprehensive moon and sun data:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Sun: sunrise, sunset, solar noon, day length<\/li>\n\n\n\n<li>Moon: phase, illumination, age, zodiac signs<\/li>\n\n\n\n<li>Moon events: moonrise, moonset, optimal viewing<\/li>\n\n\n\n<li>Upcoming phases: new moon, quarters, full moon with names\/descriptions<\/li>\n\n\n\n<li>Technical data: altitude, azimuth, distance, phase angle<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">predictor.json<\/h3>\n\n\n\n<p>Contains beauty prediction scores:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Sunset: score, rating, time, contributing factors<\/li>\n\n\n\n<li>Moonset: score, rating, time, moon data, contributing factors<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Admin Interface<\/h2>\n\n\n\n<p>Access the plugin settings at <strong>Settings \u2192 Sun &amp; Moon<\/strong> to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>View all available shortcodes with examples<\/li>\n\n\n\n<li>Check data file status<\/li>\n\n\n\n<li>Preview all components with live data<\/li>\n\n\n\n<li>Test individual shortcodes<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Styling<\/h2>\n\n\n\n<p>The plugin uses W3.CSS classes for styling. Color-coded score classes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>8-10<\/strong>: Green (Excellent\/Outstanding)<\/li>\n\n\n\n<li><strong>6-7<\/strong>: Light Green (Good\/Great)<\/li>\n\n\n\n<li><strong>4-5<\/strong>: Orange (Fair\/Moderate)<\/li>\n\n\n\n<li><strong>0-3<\/strong>: Red (Poor)<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">File Structure<\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>scootercam-sun-moon\/\n\u251c\u2500\u2500 scootercam-sun-moon.php    # Main plugin file\n\u2514\u2500\u2500 README.md                   # This file\n<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Requirements<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>WordPress 5.0 or higher<\/li>\n\n\n\n<li>PHP 7.0 or higher<\/li>\n\n\n\n<li>W3.CSS loaded on your site (or similar CSS framework)<\/li>\n\n\n\n<li>Data files must be generated by your weather\/astronomy scripts<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Data File Locations<\/h2>\n\n\n\n<p>Default paths (can be modified in plugin code):<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Moon data: <code>\/home\/scootercam\/public_html\/wx\/moon_api_data.json<\/code><\/li>\n\n\n\n<li>Predictor data: <code>\/home\/scootercam\/public_html\/wx\/predictor.json<\/code><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Changelog<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">1.0.0 &#8211; 2025-10-20<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Initial release<\/li>\n\n\n\n<li>Sunset\/moonset beauty predictions<\/li>\n\n\n\n<li>Moon phase calendar with &#8220;Now&#8221; indicator<\/li>\n\n\n\n<li>Sun and moon arc visualizations<\/li>\n\n\n\n<li>Current moon phase details<\/li>\n\n\n\n<li>Moon viewing information with recommendations<\/li>\n\n\n\n<li>Full moon data with traditional names<\/li>\n\n\n\n<li>Complete astronomy dashboard<\/li>\n\n\n\n<li>Admin preview interface<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Support<\/h2>\n\n\n\n<p>For issues, questions, or feature requests, visit <a href=\"https:\/\/scootercam.net\/\">scootercam.net<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">License<\/h2>\n\n\n\n<p>GPL v2 or later<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Credits<\/h2>\n\n\n\n<p>Developed by ScooterCam Icon assets located at <code>\/assets\/icons\/<\/code><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Screenshots<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Sunset Prediction<\/h3>\n\n\n\n<p>Shows tonight&#8217;s sunset quality with contributing weather factors.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Moon Phase Calendar<\/h3>\n\n\n\n<p>Visual timeline of the lunar cycle with current position highlighted.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Sun &amp; Moon Arcs<\/h3>\n\n\n\n<p>Real-time visualizations showing celestial paths across the sky.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Complete Dashboard<\/h3>\n\n\n\n<p>All components organized in a comprehensive astronomy view.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Pro Tip:<\/strong> Use <code>[scootercam_astronomy_dashboard]<\/code> for a complete astronomy page, or mix individual shortcodes for custom layouts!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>ScooterCam Sun &amp; Moon WordPress plugin for displaying comprehensive sun and moon data including sunset\/moonset beauty predictions, phase calendars, arc visualizations, and viewing information. Description This plugin provides detailed astronomical information with beautiful visualizations: Installation Shortcodes Prediction Shortcodes Sunset Beauty Score Displays tonight&#8217;s sunset quality prediction with score, rating, and contributing factors. Moonset Beauty Score &#8230; <a title=\"\" class=\"read-more\" href=\"https:\/\/scootercam.net\/blog\/544\/\" aria-label=\"Read more about \">Read more<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[38],"tags":[],"class_list":["post-544","post","type-post","status-publish","format-standard","hentry","category-plugins"],"_links":{"self":[{"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/posts\/544","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/comments?post=544"}],"version-history":[{"count":2,"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/posts\/544\/revisions"}],"predecessor-version":[{"id":547,"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/posts\/544\/revisions\/547"}],"wp:attachment":[{"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/media?parent=544"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/categories?post=544"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/scootercam.net\/blog\/wp-json\/wp\/v2\/tags?post=544"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}