=== EthioTime ===
Contributors: ethioall
Donate link: https://ethioall.com/donate_me
Tags: ethiopian calendar, ethiopian date, amharic, ethiopian time, geez
Requires at least: 5.6
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

EthioTime provides a robust Ethiopian Calendar conversion, display shortcodes, and an admin dashboard widget.

== Description ==

The EthioTime plugin integrates the Ethiopian (Ge'ez) calendar system into WordPress.

The Ethiopian calendar, known as the *Amete Lidet*, differs from the Gregorian calendar. Its day begins at sunrise (6:00 AM Gregorian), and it has 12 months of 30 days, plus a 13th month (*Pagume*) of five or six days. This plugin handles the conversion logic automatically.

== Features ==

* **Calendar Conversion:** Converts dates between the Gregorian and Ethiopian calendar systems.
* **Shortcode Generator:** Create and manage custom shortcodes in the admin area to display dates. For example: `[et-dt-shortcode slug="my-ethio-date"]`.
* **Live Clock:** Display a real-time updating Ethiopian clock on your site's front end.
* **Custom Templates:** Design date and time outputs using tokens like `[Month Amharic]` and `[Day Amharic]`.
* **Dashboard Widget:** See the current Ethiopian date and time on your WordPress admin dashboard.
* **Custom CSS:** Add custom styles that only load when your shortcodes are present.

This plugin is designed for websites needing culturally accurate Ethiopian date and time displays.

== Installation ==

1.  **Download:** Download the plugin ZIP file or search for "EthioTime" in the WordPress admin plugin search.
2.  **Upload & Activate:** Upload the plugin file via the WordPress Plugins menu and click **Activate**. If manually uploading via FTP, place the entire `ethiotime` folder into the `/wp-content/plugins/` directory.
3.  **Configuration:** Navigate to the new menu item **Settings > EthioTime**.
4.  **Create:** Use the **Shortcodes** and **Format Templates** tabs to define your custom date/time outputs. Copy the generated shortcode to any post, page, or widget.

== Screenshots ==

1.  The main Shortcode Generator tab in the admin settings, showcasing the ability to select templates and configure wrapper elements.
2.  The Live Clock output on the front-end of the website, demonstrating the real-time update functionality.
3.  The Templates Tab for defining custom date formats using tokens like `[Month Amharic]` and `[Day Amharic]`.
4.  The EthioTime dashboard widget, showing the current date and live time upon login.

== Frequently Asked Questions ==

= What does the EthioTime plugin do? =
EthioTime adds functionality for displaying and converting to the Ethiopian calendar system within WordPress, using shortcodes, a live clock, and a dashboard widget.

= Can I display both Gregorian and Ethiopian dates together? =
Yes. You can create custom templates that show both calendar systems side by side using the template tokens available in the plugin.

= Does EthioTime support leap years in the Ethiopian calendar? =
Yes. The plugin correctly handles Ethiopian leap years (Pagume 6) according to the Ethiopian calendar system.

= Can I use EthioTime in widgets? =
Yes. Any shortcode created with EthioTime can be used in WordPress text widgets, posts, pages, or theme files.

== Changelog ==

= 1.0.0 =
* Initial stable release.
* Added Shortcode Generator and Template Engine.
* Implemented live clock dashboard widget and frontend shortcode output.
* Full Ethiopian-to-Gregorian and Gregorian-to-Ethiopian conversion using PHP classes.
* Admin UI for managing shortcodes, templates, and custom CSS.