LNH Lunar Calendar is a simple yet powerful plugin that allows you to easily insert a detailed Lunar-Solar calendar block anywhere on your WordPress site using a shortcode. The plugin is designed with a modern, responsive interface and provides accurate information about the lunar date, Can Chi (Stem-Branch), and dynamic Zodiac Hours calculated for each specific day.
This is an essential tool for websites targeting a Vietnamese audience, helping to enrich content and provide a culturally relevant experience.
Key Features:
Flexible Shortcode: Use [lnh_lunar_calendar] to display the calendar with various options.
Multiple Layouts & Themes:
widget: A compact block, perfect for sidebars or footers.
full: Displays a full monthly calendar with an integrated details header.
inline: Shows date information in a single, clean line.
theme="dark": A beautiful dark mode is available for all layouts.
Smart Interaction: Users can click any day in the full calendar to see its detailed information (including Zodiac Hours) updated instantly in the header.
Dynamic Zodiac Hours: The Zodiac Hours (Giờ Hoàng Đạo) are accurately calculated for each day based on its Earthly Branch (Địa Chi).
Easy Customization: Allows users to translate basic text strings (like "Day", "Month", "Year"...) directly from the settings page.
Accurate & High-Performance: Uses a verified astronomical algorithm for date conversion and the smart Transients API for caching to ensure the fastest page load times.
Responsive Design: Displays beautifully on all devices, from desktops to mobile phones, including abbreviated weekday names on smaller screens.
Upload the lnh-lunar-calendar folder to the /wp-content/plugins/ directory.
Activate the plugin through the 'Plugins' menu in WordPress.
Go to Settings > LNH Lunar Calendar to customize default settings and translations.
Use the shortcode [lnh_lunar_calendar] in your posts, pages, or widgets.
2.8.5
Feature: Added a beautiful dark mode (theme="dark") for the full calendar layout.
2.8.3
Fix: Resolved a critical bug where calendar navigation (next/prev month) would fail if the mbstring PHP extension was not enabled on the server.
2.8.2
Tweak: Weekday headers in the full calendar now automatically switch to single-letter abbreviations on mobile devices for a cleaner look.
2.8.1
Tweak: Added a current-day class to the present day in the full calendar for easier styling.
2.8.0
Major Feature: Implemented dynamic Zodiac Hours. The auspicious hours are now accurately calculated for each day based on its specific Earthly Branch (Chi).
2.7.0
Feature: Integrated a widget-like details header directly into the layout="full" view for a more comprehensive experience.
2.6.1
Fix: Resolved a JavaScript Invalid URL error by rewriting the navigation logic to be more robust.
2.5.1
Fix: Corrected a bug where the month's Can Chi (Stem-Branch) was missing on the initial load and showed "undefined" on click.
2.5.0
Fix: Updated plugin to comply with
WordPress.org guidelines, including author information, English readme, and proper code prefixing.
1.0.0
Initial release.