=== PCIO Year Wheel ===
Contributors:      pcio
Author:            PCIO
Author URI:        https://www.pcio.dk
Plugin URI:        https://www.pcio.dk/pcio-year-wheel/
Donate link:       https://www.paypal.com/donate/?hosted_button_id=DFM2JV8JKTTM6
Tags:              calendar, events, year, wheel, annual
Requires at least: 6.2
Tested up to:      7.0
Requires PHP:      8.1
Stable tag:        1.0.0
License:           GPL2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Visualise recurring annual events on a beautifully animated SVG year wheel. Full admin CRUD and a simple shortcode.

== Description ==

PCIO Year Wheel lets you maintain a list of recurring annual events (birthdays, anniversaries, seasonal deadlines, public holidays …) identified by month and day of month. Events are stored in a lightweight custom database table and displayed on an animated SVG wheel on the front end.

**Animated wheel**

* 365-day ring with month arcs colour-coded by season.
* Wheel rotates slowly anti-clockwise — today's date stays at the top, marked with a pointer.
* Each event appears as a dot on the ring. Hover a dot to see the event title, date and description in a tooltip.
* When multiple events fall close together they are staggered on different radii so none are hidden.
* Hub shows the total number of events at a glance.
* Fully responsive — scales to any container width.

**Internationalisation**

Translations are handled through the standard WordPress `.po`/`.mo` system (text domain `pcio-year-wheel`). A Danish (`da_DK`) translation is included. Month names, abbreviations, the today label and tooltip date format are all translatable.

**Admin features**

* List view — table of all events with Edit and Delete actions.
* Add / Edit form — create or update events with month, day, title and description.
* About page — inline documentation with screenshots.

**Front-end shortcode**

Place `[year_wheel]` in any page, post or widget to embed the animated wheel. No configuration required.

== Installation ==

1. Upload the `pcio-year-wheel` folder to `wp-content/plugins/`.
2. Activate the plugin through the *Plugins* menu in WordPress.
3. Navigate to **Year Wheel** in the left-hand admin menu to add your events.
4. Add `[year_wheel]` to any page or post to display the animated wheel.

== Screenshots ==

1. Animated SVG year wheel — today at the top, events as coloured dots.
2. Admin event list — add, edit and delete recurring annual events.

== Frequently Asked Questions ==

= How do I display the wheel on a page? =

Add the shortcode `[year_wheel]` to any page, post or widget area. No configuration is required.

= Where do I manage events? =

Navigate to **Year Wheel** in the WordPress admin menu. From there you can add, edit and delete events.

= Does it cost anything? =

The plugin is free. If you find it useful, you are welcome to support further development:

[Donate](https://www.paypal.com/donate/?hosted_button_id=DFM2JV8JKTTM6)

= How do I uninstall? =

Deactivate and delete the plugin from the WordPress admin. To also remove the data, drop this table from your database (replace `wp_` with your actual table prefix):

* `wp_year_wheel_events`

== Upgrade Notice ==

= 1.0.0 =
Initial release. No upgrade steps required.

== Changelog ==

= 1.0.0 =
* Initial release — animated SVG wheel, full CRUD admin, `[year_wheel]` shortcode, Danish translation.
