Plagins | Плагин «Фаза Луны» для WordPress

🌙 Плагин «Фаза Луны» для WordPress — реальные астрономические данные прямо на сайте

Хотите добавить на свой сайт виджет, который в реальном времени показывает текущую фазу Луны, её освещённость, расстояние до Земли, возраст лунного цикла и знак зодиака? Плагин Moon Phase делает именно это — без внешних API, без подписок и без лишнего кода. Все расчёты выполняются прямо на сервере по классическим астрономическим формулам.

Что отображает виджет

После установки и активации плагина достаточно вставить шорткод [moon_phase] в любую страницу или запись. Виджет автоматически рассчитает и покажет следующее:

Графическое изображение Луны — нарисованное через Canvas: корректное отображение освещённой и тёмной стороны, с кратерами и лунным ореолом. Картинка всегда соответствует реальной фазе.
Название фазы — Новолуние, Растущий серп, Первая четверть, Растущая Луна, Полнолуние, Убывающая Луна, Последняя четверть или Убывающий серп.
Освещённость (%) — процент видимой освещённой поверхности Луны с визуальным прогресс-баром.
Расстояние до Земли (км) — рассчитывается с учётом эллиптичности лунной орбиты. Варьируется от ~356 000 до ~406 000 км.
Возраст Луны (дни) — количество дней, прошедших с последнего новолуния (от 0 до 29,53 дней).
Лунный знак зодиака — знак, в котором находится Луна по эклиптической долготе, с символом (♈ Овен, ♉ Телец и так далее).
Дата и время — отображаются живые часы, которые тикают прямо на странице. Часовой пояс настраивается через атрибут шорткода.
Шкала лунного цикла — мини-лента с четырьмя ключевыми фазами и ползунком, показывающим текущее положение Луны в цикле.

Астрономия под капотом

Плагин не использует сторонних сервисов и не делает внешних запросов. Все вычисления — это реализация алгоритмов из классической астрометрии:

Юлианская дата и число Юлианских столетий от эпохи J2000.0.
Средняя долгота Луны и Солнца, средние аномалии, аргумент широты и средняя элонгация по формулам Джина Мюса (Astronomical Algorithms).
Расстояние рассчитывается через разложение в ряд возмущений с учётом семи главных членов.
Эклиптическая долгота Луны вычисляется с поправками на аномалию, элонгацию и широту — на её основе определяется знак зодиака.

Точность расчётов достаточна для практического применения: ошибка по фазе не превышает 1–2%, по расстоянию — единицы километров.

Установка плагина

Скачайте файл moon-phase.zip.
В панели WordPress перейдите в Плагины → Добавить новый → Загрузить плагин.
Выберите ZIP-архив и нажмите Установить.
После установки нажмите Активировать плагин.

Использование шорткода

Вставьте шорткод туда, где хотите видеть виджет:

[moon_phase]

По умолчанию используется часовой пояс Europe/Moscow. Чтобы задать другой — укажите атрибут timezone:

[moon_phase timezone="Europe/Kiev"]

[moon_phase timezone="Asia/Yekaterinburg"]

[moon_phase timezone="Europe/London"]

Допустимо любое значение из стандартного списка часовых поясов PHP (полный список на php.net).

Технические требования

WordPress 5.0 и выше
PHP 7.4 и выше
Современный браузер с поддержкой Canvas API (все актуальные браузеры)
Интернет-соединение не требуется — всё работает локально на сервере

Состав плагина

moon-phase.php — основной файл плагина: регистрация шорткода, астрономические расчёты, HTML-разметка виджета.
moon-phase.css — стили виджета: тёмная тема с золотистым акцентом, адаптивная вёрстка для мобильных устройств.
moon-phase.js — JavaScript: Canvas-рендеринг изображения Луны, живые тикающие часы.

Пример отображения

Виджет выглядит следующим образом:

Тёмный блок с заголовком «Фаза Луны» и золотистым оформлением.
Слева — круглое изображение Луны, нарисованное на Canvas с правильной геометрией фазы, кратерами и ореолом.
Справа — шесть строк с параметрами, каждая с иконкой, меткой и значением.
Внизу — шкала цикла с четырьмя ключевыми точками и ползунком текущей позиции.
В подвале — процент завершения синодического месяца.

Часто задаваемые вопросы

Данные обновляются в реальном времени или только при загрузке страницы?
Фаза, освещённость, расстояние и знак зодиака рассчитываются на сервере в момент открытия страницы. Живыми (тикающими) в браузере остаются только часы — секунды, минуты и часы. Для обновления остальных данных достаточно обновить страницу.

Почему значения могут немного отличаться от других источников?
Разные сервисы используют разные астрономические модели и часовые пояса. Плагин даёт расчёт по UTC-времени сервера с поправкой на указанный часовой пояс. Небольшие расхождения в пределах 1–3% по освещённости и ±500 км по расстоянию — норма для упрощённых алгоритмов.

Можно ли разместить несколько виджетов на одной странице?
Да. Каждый шорткод [moon_phase] генерирует независимый виджет с уникальным идентификатором.

Влияет ли плагин на скорость загрузки сайта?
Минимально. CSS и JS подключаются только на страницах, где присутствует шорткод. Общий объём файлов — менее 15 КБ.

Плагин распространяется бесплатно. Исходный код открыт для изучения и модификации.