Description
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.
Installation
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 in your posts, pages, or widgets. Here are some examples:
For the compact widget view: [lnh_lunar_calendar]
For the full monthly calendar: [lnh_lunar_calendar layout= »full »]
For a single line of text: [lnh_lunar_calendar layout= »inline »]
To use the dark theme: [lnh_lunar_calendar layout= »full » theme= »dark »]
FAQ
-
How do I use the shortcode?
-
You can insert the shortcode into any WordPress text editor. Here are some examples:
Basic Widget: [lnh_lunar_calendar]
Full Month Calendar: [lnh_lunar_calendar layout= »full »]
Using the Dark Theme: [lnh_lunar_calendar layout= »full » theme= »dark »]
-
How does the interactive feature work?
-
The layout= »full » shortcode automatically includes a detailed header. When you click on any day in the calendar grid, this header will update to show the detailed information for the selected day. If you also place a [lunar_calendar] widget on the same page, it will be updated as well.
-
Can I translate words like « Day », « Month », « Monday », etc.?
-
Yes. Go to Settings > LNH Lunar Calendar > Translate. Here you can enter custom translations for the text strings displayed on the front end.
Avis
Il n’y a aucun avis pour cette extension.
Contributeurs & développeurs
« LNH Lunar Calendar » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs
Traduisez « LNH Lunar Calendar » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal
2.8.6
Fix: Resolved a critical bug where calendar month navigation failed on WordPress 7.0 due to nonce being cached inside the Transient API, causing it to become stale and fail verification.
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.