=== Date Duration Calculator ===
Contributors: epitomsolutions
Tags: date calculator, time difference, date duration, wordpress plugin
Requires at least: 5.0
Tested up to: 6.7
Stable tag: 1.2
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple and efficient calculator to find the duration between two dates, displaying results in years, months, and days.

== Description ==

Date Duration Calculator is a user-friendly WordPress plugin that allows your website visitors to easily calculate the time duration between any two dates. Perfect for event planning, age calculation, project timelines, and more.

= Key Features =

* Easy-to-use interface for calculating date durations
* Support for both AD and BC dates
* Displays results in years, months, and days format
* Shows total number of days between dates
* Mobile-responsive design
* RTL language support
* Clean, modern interface
* Works with any WordPress theme
* No coding required - just use a simple shortcode

= How to Use =

1. Install and activate the plugin
2. Add the shortcode `[date-duration-calculator]` to any post or page
3. Select your dates and click calculate
4. Get instant results showing the duration between dates

= Use Cases =

* Calculate age or time since historical events
* Plan project timelines and durations
* Calculate time between important dates
* Educational purposes for history lessons
* Event planning and scheduling
* Age verification purposes

= Professional Features =

* AJAX-powered calculations (no page reload)
* Clean, semantic HTML5 markup
* Accessibility-ready with ARIA labels
* Translation-ready
* Cross-browser compatible
* Performance optimized

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/date-duration-calculator` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the shortcode `[date-duration-calculator]` in your posts or pages

== Frequently Asked Questions ==

= How do I add the calculator to my page? =

Simply add the shortcode `[date-duration-calculator]` to any post or page where you want the calculator to appear.

= Does it support BC dates? =

Yes, the calculator supports both AD and BC dates, allowing you to calculate durations for historical dates.

= Is it mobile-friendly? =

Yes, the calculator is fully responsive and works well on all devices including mobile phones and tablets.

= Can I customize the styling? =

Yes, you can override the default styles using your theme's CSS. The plugin uses standard CSS classes that you can target.

= Does it work with page builders? =

Yes, you can use the shortcode in any page builder that supports shortcodes.

= Is it translation-ready? =

Yes, the plugin is fully translation-ready and supports RTL languages.

== Screenshots ==

1. Main calculator interface showing date inputs and calculation button
2. Example calculation result showing years, months, and days
3. Mobile view of the calculator
4. Calculator with BC date selection

== Changelog ==

= 1.2 =
* Added RTL support
* Improved mobile responsiveness
* Enhanced accessibility features
* Fixed date validation issues
* Added better error handling
* Improved BC date calculations

= 1.1 =
* Added BC/AD date support
* Improved error handling
* Added total days calculation
* Fixed minor styling issues
* Added accessibility improvements

= 1.0 =
* Initial release

== Upgrade Notice ==

= 1.2 =
This version adds RTL support, improves mobile responsiveness, and fixes BC date calculations. Update recommended for all users.

== Privacy Policy ==

This plugin does not collect or store any user data. All calculations are performed locally in the user's browser.

For more information, please visit our [privacy policy](https://epitomesolutions.org/privacy).

== Support ==

For support questions, bug reports, or feature requests, please use our [support forums](https://wordpress.org/support/plugin/date-duration-calculator) or visit [epitomesolutions.org](https://epitomesolutions.org).

== Credits ==

* Created by epitomesolutions
* Icons by [Dashicons](https://developer.wordpress.org/resource/dashicons/)
* Testing by WordPress community