=== PinOdds ===
Contributors: skipseek
Tags: golf, odds, probabilities, majors, widget
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live fair-odds golf leaderboards — tournament-winner probabilities for the majors, whole field normalized to 100%.

== Description ==

Golf outright markets carry the fattest bookmaker margins in sports — a tournament field routinely "adds up" to 140% or more. PinOdds strips that margin: every surveyed bookmaker price for every player is aggregated, junk quotes are filtered, and the whole field is normalized so win probabilities total exactly 100%.

Drop the widget on any page and it renders the live probability leaderboard for the current major — The Masters, PGA Championship, U.S. Open, and The Open — updating quietly through the tournament. No bookmaker names, no betting links; a forecast, not a tout. See it live at [pinodds.com](https://pinodds.com).

Drop it anywhere:

* **Shortcode** — `[pinodds]` renders the live board. `[pinodds theme="light"]` matches light sites; `[pinodds limit="3"]` shows three events.
* **Block** — insert "PinOdds probabilities" from the editor; the settings sit in the block sidebar.

Site-wide defaults live under **Settings → PinOdds**. The widget is responsive, ships in dark and light themes, and sizes itself to its content.

== External services ==

This plugin embeds a widget served by **skipodds.com**, a SkipSeek AI service, via an iframe. The widget delivers the live probability data; without it the plugin displays nothing.

* What it is: the SkipOdds Index — de-vigged, aggregated win probabilities ([skipodds.com](https://skipodds.com)); this plugin serves the PinOdds view of it ([pinodds.com](https://pinodds.com)).
* What is sent: the embed iframe requests the widget from skipodds.com with your chosen sport, theme, and event count. The widget sets no cookies and runs no analytics on your visitors.
* Terms: [skipodds.com/terms](https://skipodds.com/terms) · Privacy: [skipodds.com/privacy](https://skipodds.com/privacy)

No other external requests are made. All plugin JavaScript is bundled locally.

== Installation ==

1. Install the plugin from the WordPress repo, or upload the `pinodds` folder to `/wp-content/plugins/`.
2. Activate the plugin through the Plugins menu.
3. Drop `[pinodds]` into any post or page, or insert the "PinOdds probabilities" block.

(Optional) Go to **Settings → PinOdds** to set the defaults.

== Frequently Asked Questions ==

= Where do the numbers come from? =

The SkipOdds Index surveys bookmaker prices for each event, averages them per outcome, and removes the bookmaker margin so the probabilities sum to 100%. It is an aggregate market read, not a prediction model.

= Is this a betting plugin? =

No. The widget shows probabilities only — no bookmaker names, no odds links, no betting calls to action. It is informational content.

= Which tournaments are covered? =

The four men's majors: The Masters, the PGA Championship, the U.S. Open, and The Open Championship. Each market appears automatically when books open it — usually weeks before the first tee.

= What happens between majors? =

The widget shows the next major once its market opens. Off-weeks display a quiet empty state rather than stale numbers.

== Changelog ==

= 0.1.0 =
* Initial release: [pinodds] shortcode, "PinOdds probabilities" block, dark + light themes, site-wide defaults, self-sizing iframe embed.
