=== Live Odds Feed ===
Contributors: GamblingSite.com
Tags: betting, odds, sports, gambling, sportsbook
Requires at least: 5.0
Tested up to: 6.4
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 live betting odds from The Odds API for NFL, NBA, MLB, and NHL games with moneyline, spreads, and totals.

== Description ==

Live Odds Feed is a WordPress plugin that integrates with The Odds API to display real-time betting odds from major US sportsbooks (DraftKings, FanDuel, and BetMGM) directly on your WordPress site.

**Features:**

* Real-time odds for NFL, NBA, MLB, and NHL
* Display moneyline, point spreads, and totals
* Filter by sport with easy-to-use tabs
* Modern, sleek "Neon Bookmaker" design
* Intelligent caching to minimize API calls
* Configurable cache duration
* Admin settings page to manage API key
* Simple shortcode integration
* Responsive design for mobile and desktop
* WordPress REST API integration

**Supported Sportsbooks:**

* DraftKings
* FanDuel
* BetMGM

**Supported Sports:**

* NFL (American Football)
* NBA (Basketball)
* MLB (Baseball)
* NHL (Ice Hockey)

== Installation ==

1. Upload the `live-odds-feed` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to 'Live Odds Feed' in the admin menu
4. Enter your Odds API key (get one free at https://the-odds-api.com)
5. Configure your settings
6. Add the shortcode `[live_odds_feed]` to any page or post

== Usage ==

**Basic Usage:**
```
[live_odds_feed]
```

**With Sport Parameter:**
```
[live_odds_feed sport="basketball_nba"]
```

**Available Sport Keys:**
* americanfootball_nfl
* basketball_nba
* baseball_mlb
* icehockey_nhl

== Frequently Asked Questions ==

= Do I need an API key? =

Yes, you need a free API key from The Odds API (https://the-odds-api.com). The free tier provides sufficient requests for testing and small sites.

= How often are odds updated? =

Odds are cached for the duration you set in the settings (default 5 minutes). You can configure this from 30 seconds to 1 hour. The plugin also provides a manual refresh button.

= Which sportsbooks are included? =

The plugin displays odds from DraftKings, FanDuel, and BetMGM - three major US-regulated sportsbooks.

= Does this work on mobile? =

Yes, the plugin is fully responsive and works great on mobile devices, tablets, and desktops.

= How do I clear the cache? =

The cache automatically cleans old entries every hour. You can also manually refresh odds using the refresh button on the frontend.

== Screenshots ==

1. Live odds display with sport filters
2. Detailed odds cards showing moneyline, spreads, and totals
3. Admin settings page
4. Mobile responsive view

== Changelog ==

= 1.0.0 =
* Initial release
* Support for NFL, NBA, MLB, NHL
* DraftKings, FanDuel, BetMGM odds
* Moneyline, spreads, and totals markets
* Intelligent caching system
* Admin settings page
* Shortcode support

== Upgrade Notice ==

= 1.0.0 =
Initial release of Live Odds Feed plugin.

== Technical Details ==

**API Integration:**
* Uses The Odds API v4
* REST API endpoints
* Intelligent caching with WordPress transients
* Custom database table for cache storage

**Performance:**
* Lightweight (~100KB total)
* Efficient caching mechanism
* Minimal API calls
* Optimized CSS and JavaScript

**Security:**
* Nonce verification
* Capability checks
* Data sanitization and validation
* Secure API key storage

== Support ==

For support, please visit https://gamblingSite.com/support

== Credits ==

* Design inspired by modern trading terminals
* Powered by The Odds API (https://the-odds-api.com)
* Built with WordPress best practices
