=== OI Contest Schedule ===
Contributors: hanyixuanten
Requires at least: 6.4
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPL-3.0-only
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Display upcoming OI contests in the WordPress dashboard or on a page.

== Description ==

OI Contest Schedule reads the public contest feed generated by OI-contest-fetch and displays active contests with local times and live countdowns.

The plugin adds an Upcoming OI Contests widget to the WordPress dashboard. Use the `[oi_contest_schedule]` shortcode in a post, page, or Shortcode block to show the schedule on the front end.

Shortcode options:

* `[oi_contest_schedule limit="10"]` controls the number of contests, from 1 to 50.
* `[oi_contest_schedule compact="true"]` uses the compact dashboard-style layout.

== Installation ==

1. Upload the `oi-contest-schedule` directory to `/wp-content/plugins/` or install the generated ZIP archive.
2. Activate OI Contest Schedule through the Plugins screen.
3. Open the WordPress dashboard to see the widget, or insert `[oi_contest_schedule]` into a page.

== External Services ==

This plugin requests the public `contests_all.json` file from GitHub Raw Content when its five-minute WordPress transient cache expires. The request is required to obtain the latest contest schedule. No visitor content, account data, or cookies are sent by the plugin. Standard request metadata, such as the website server IP address and the plugin user-agent string, is visible to GitHub.

* Data source: https://raw.githubusercontent.com/hanyixuanten/OI-contest-fetch/master/contests_all.json
* GitHub Terms of Service: https://docs.github.com/en/site-policy/github-terms/github-terms-of-service
* GitHub Privacy Statement: https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement

== Frequently Asked Questions ==

= Which contests are shown? =

The plugin shows contests whose end time is still in the future, including contests currently running. Finished contests are omitted.

= Which time zone is used? =

Dates are formatted in the visitor's browser time zone using the browser internationalization API.

= Can I use another data URL? =

Developers can replace the URL with the `oics_contest_data_url` filter.

== Changelog ==

= 0.1.0 =

* Add the upcoming contest dashboard widget.
* Add the `[oi_contest_schedule]` shortcode with limit and compact options.
* Add local-time formatting, countdowns, platform colors, and transient caching.