=== Nepali Date Utilities === Contributors: ashokbasnet Tags: nepali date, bikram sambat, nepali calendar, post date, shortcode Requires at least: 5.0 Tested up to: 7.1 Requires PHP: 7.4 Stable tag: 1.1.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Nepali Date Utilities converts English (AD) dates to Nepali (BS) for posts, comments, shortcodes, blocks, and a monthly post calendar. == Description == Nepali Date Utilities converts English (AD) dates to Nepali (BS) for posts, comments, shortcodes, blocks, and a monthly post calendar. It helps Nepali sites show Bikram Sambat dates consistently across WordPress. **Features** * Convert post and modified dates to Nepali * Convert comment dates * Bilingual display (BS + AD) * Devanagari or Arabic numerals * Home / front page modes: default format, relative “time ago”, or hide * Shortcodes: `[ndu_today_date]`, `[ndu_date_ago]`, `[ndu_convert]`, `[ndu_post_calendar]` * Classic “Today Date in Nepali” widget (optional format) * Gutenberg blocks: **Nepali Today Date** and **Nepali Post Calendar** * Monthly BS post calendar with navigation, dual dates, optional post links, and accent color * Admin converter: English ↔ Nepali * Live format preview and format presets in settings **Shortcodes** * `[ndu_today_date]` — today’s date * `[ndu_today_date format="y m d, l"]` — custom format * `[ndu_date_ago]` — relative time for the current post * `[ndu_convert date="2024-10-31" from="eng" format="y m d"]` — AD → BS * `[ndu_convert date="2081-07-15" from="nep"]` — BS → AD * `[ndu_post_calendar]` — monthly BS calendar * `[ndu_post_calendar year="2081" month="7" lang="english" show_post_links="1" accent="#c62828"]` — calendar with options **Format tokens** * `y` — year (e.g. २०८१) * `m` — month name (e.g. कार्तिक) * `d` — day number * `l` — weekday * `H` / `h` — hour (24h / 12h) * `i` — minute * `s` — second * `a` — period of day (बिहान / दिउँसो / साँझ / राति) **PHP helpers** `ndu_today_date()`, `ndu_get_date_ago()`, `ndu_format_nepali_date( $timestamp, $format )` Supported conversion range: AD 1944–2033 / BS 2000–2099. == Installation == 1. Upload the plugin folder to `/wp-content/plugins/nepali-date-utilities`, or install via Plugins → Add New. 2. Activate **Nepali Date Utilities**. 3. Go to **Settings → Nepali Date Utilities** to configure display options, try the converter, or preview the post calendar. == Frequently Asked Questions == = Does this replace English dates site-wide? = When “Convert dates to Nepali” is enabled, post, modified, and comment dates use your Nepali format. You can switch to bilingual mode to show both BS and AD. = Can I convert a specific date? = Yes. Use the Converter tab in settings, or the `[ndu_convert]` shortcode. = How do I show a Nepali post calendar? = Use `[ndu_post_calendar]`, or insert the **Nepali Post Calendar** block. Configure year, month, language, post links, and accent color. Arrows navigate between BS months. = Is there a Gutenberg block? = Yes. Insert **Nepali Today Date** or **Nepali Post Calendar** and configure options in the block sidebar. == Screenshots == 1. Display settings with live preview, format presets, and About 2. Post Calendar tab with shortcode docs and live BS calendar preview 3. Instant AD ↔ BS converter 4. Help & shortcodes — format tokens and usage examples 5. Nepali post dates on the front end == Changelog == = 1.1.0 = * Redesigned settings UI (Settings API) with Display, Converter, Post Calendar, and Help tabs * Live format preview and format presets * Shared date formatter; safer conversion (no fatal errors on out-of-range dates) * Unicode Devanagari numerals; optional Arabic numerals * Bilingual BS + AD display mode * Comment date conversion * Home and front page date behavior * Improved period-of-day labels (बिहान / दिउँसो / साँझ / राति) * Shortcodes: format attribute on today date, `[ndu_date_ago]`, `[ndu_convert]`, `[ndu_post_calendar]` * Gutenberg blocks: Nepali Today Date, Nepali Post Calendar * BS post calendar with month navigation, dual dates, post links, accent color * Widget format field * Requires PHP 7.4+; WordPress 5.0+ = 1.0.16 = * Maintenance release == Upgrade Notice == = 1.1.0 = Settings UI refresh plus bilingual dates, comment dates, converter, shortcodes, Today Date block, and BS post calendar. Requires PHP 7.4+.