=== Downtack Lotteries ===
Contributors: downtackcom
Tags: lottery, lotteries, widget, block, usa
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fetches lottery results from an external API and displays them via a customizable Gutenberg block and classic widget.

== Description ==

Downtack Lotteries connects to a configurable API endpoint to retrieve US lottery results and jackpot data, then displays them on your site using a flexible Gutenberg block or classic widget.

**Features:**

* Displays lottery results organized by state or by game.
* Shows winning numbers, current jackpot, next draw jackpot, and next draw date.
* Supports filtering by specific states and/or games.
* Option to group multiple plays under a single game heading.
* Full custom HTML template with placeholders (`{game_name}`, `{numbers}`, `{jackpot}`, etc.).
* Conditional template tags: `[if placeholder]...[/if placeholder]`.
* Iterative template tag: `[plays]...[/plays]` to loop over multiple draws.
* Custom CSS per widget/block instance.
* Optional bottom HTML area per widget/block instance.
* Configurable date format, jackpot decimal places, thousands separator, and decimal separator.
* Automatic data synchronization via WP-Cron (every 5 minutes).
* Manual sync button in the plugin settings.

== External services ==

This plugin connects to an API to obtain lottery results, it's needed to show updated information in the included widget.
The service is provided by "Downtack.com": [terms of use](https://downtack.com/en/wp-terms-of-use.html).

== Installation ==

1. Upload the `downtack-lotteries` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Settings > Downtack.com - Lotteries** to enter your API endpoint and API key.
4. Click **Sync API Data** to fetch the initial dataset.
5. Add the **Lottery Results** block via the Gutenberg editor, or the **Lottery Results Widget** via **Appearance > Widgets**.

== Frequently Asked Questions ==

= Where do I get an API key? =

You need an account at [Downtack.com](https://downtack.com/en) to obtain an API endpoint and key.

= How often is the lottery data refreshed? =

Data is automatically fetched from the API every 5 minutes via WP-Cron. You can also trigger a manual sync at any time from the plugin settings page.

= Can I customize how results are displayed? =

Yes. Each block or widget instance supports a custom HTML template with data placeholders. You can also apply custom CSS per instance.

= What placeholders are available in the custom template? =

* `{game_name}` — Name of the lottery game.
* `{play_name}` — Type of draw/play.
* `{draw_date}` — Date of the last draw.
* `{numbers}` — HTML block of winning numbers.
* `{jackpot}` — Current jackpot amount.
* `{next_draw_jackpot}` — Estimated next jackpot.
* `{next_draw_date}` — Date of the next draw.

Wrap content in `[if placeholder]...[/if placeholder]` to show it only when the value is non-empty. Wrap play rows in `[plays]...[/plays]` to iterate over multiple draws.

= Which games does the API cover? =

The API provides lottery results for a wide range of countries and regions, including:

* All US Lotteries
* Canada
* Mexico
* European Lotteries (UK, Ireland, Italy, Germany, Spain, France, Belgium, Portugal, and more)
* South Africa
* Brazil
* Argentina
* Australia
* New Zealand

== Screenshots ==

1. Plugin settings page with API configuration and documentation.
2. Gutenberg block inspector controls.
3. Frontend output showing lottery results by state.
