=== SlotReport – Slot Game Data ===
Contributors: slreport
Tags: slots, casino, rtp, igaming
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display online slot game data from the free slot.report API. Show RTP, volatility, max win and features with shortcodes or the Gutenberg block.

== Description ==

**SlotReport – Slot Game Data** connects your WordPress site to the [slot.report Slot Data API](https://slot.report/api/) — a free, open database of 5,600+ online slot games from 58 providers.

Display slot data on your site using shortcodes or the Gutenberg block editor. No API key required. No signup. No configuration.

= Features =

* **Slot Card** — Display a single slot with RTP, volatility, max win, features, mechanic and theme
* **Slot Table** — Show a filterable, sortable table of slots by provider, volatility or RTP
* **Inline Data** — Insert RTP values or slot counts anywhere in your content
* **Gutenberg Block** — Visual editor support with live preview
* **Caching** — API responses are cached for 6 hours to keep your site fast
* **No Dependencies** — Pure PHP, no external libraries

= Shortcodes =

**Single Slot Card:**
`[slot_card slug="gates-of-olympus"]`

**Slot Table:**
`[slot_table provider="hacksaw-gaming" limit="10" sort="max_win"]`
`[slot_table volatility="extreme" min_rtp="96" limit="20" sort="rtp"]`

**Inline RTP:**
`The RTP of Starburst is [slot_rtp slug="starburst"].`

**Slot Count:**
`We track [slot_count] slots from [slot_count provider="pragmatic-play"] Pragmatic Play games.`

= Data Coverage =

* 5,600+ slots from 58 providers
* RTP: 99% coverage
* Volatility: 97% coverage
* Max Win: 94% coverage
* Features: 96% coverage
* Updated weekly

= Supported Providers =

Pragmatic Play, Play'n GO, NetEnt, Red Tiger, BGaming, Hacksaw Gaming, Nolimit City, ELK Studios, Big Time Gaming, Quickspin, Relax Gaming, Blueprint Gaming, iSoftBet, Endorphina, Habanero, Booming Games, GameArt, Games Global, Betsoft, Thunderkick, Push Gaming, Yggdrasil Gaming, Gamomat, and 35 more.

== Installation ==

1. Upload the `slot-data-api` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu
3. Use the shortcodes or the Gutenberg block — no configuration needed

== Frequently Asked Questions ==

= Do I need an API key? =

No. The slot.report API is free and requires no authentication.

= How often is the data updated? =

The API data is updated at least once per week. The plugin caches responses for 6 hours.

= Can I customize the styling? =

Yes. All elements use CSS classes prefixed with `slot-data-`. Override them in your theme's stylesheet.

= What if the API is down? =

The plugin uses WordPress transient caching. Even if the API is temporarily unavailable, cached data will still be displayed.

== Screenshots ==

1. Slot Card showing Gates of Olympus data
2. Slot Table with Hacksaw Gaming slots sorted by max win
3. Gutenberg block editor with live preview

== External services ==

This plugin connects to the slot.report Slot Data API to retrieve online slot game data (name, RTP, volatility, max win, features, mechanics, themes). The data is used to display slot information on your WordPress site via shortcodes and the Gutenberg block.

The plugin sends HTTP requests from your WordPress server to `https://slot.report/api/v1/` whenever slot data is needed and not already cached. No visitor data, personal information, or tracking data is sent — only the requested API endpoint URL is accessed. Responses are cached on your server for 6 hours using WordPress transients.

This service is provided by slot.report:

* [Privacy Policy](https://slot.report/api/privacy-policy)
* [Terms of Service](https://slot.report/api/terms)

== Changelog ==

= 1.0.0 =
* Initial release
* Slot Card shortcode and Gutenberg block
* Slot Table shortcode with filtering and sorting
* Inline RTP and Slot Count shortcodes
* 6-hour response caching

== Upgrade Notice ==

= 1.0.0 =
Initial release.
