=== Scoremer: Football Livescore, Tables and Fixtures ===
Contributors:      Scoremer, harrybai520
Tags:              football, soccer, live score, fixtures, world cup
Requires at least: 5.8
Tested up to:      6.9
Requires PHP:      7.4
Stable tag:        1.0.3
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Display 7 distinct Scoremer football statistics widgets on your WordPress site — including livescores, fixtures, tables, and more.

== Description ==

**Scoremer: Football Livescore, Tables and Fixtures** lets you embed extensive real-time football data from [Scoremer.com](https://www.scoremer.com/) directly on any post, page, or widget area of your WordPress site. 

= Features =

* **Centralized Settings** — Configure global defaults for background color, font color, and language from the WordPress Settings menu.
* **Seven Unique Widgets** — Embed exactly what you need using 7 powerful shortcodes:
    * `[scoremer_fifa_worldcup_tables]`
    * `[scoremer_fifa_worldcup_fixtures]`
    * `[scoremer_table lid="0"]` 
    * `[scoremer_live lid="0"]` 
    * `[scoremer_fifa_world_ranking]`
    * `[scoremer_top_goalscorers l="All first divisions worldwide"]`
    * `[scoremer_most_valuable_players]`
* Overridable Shortcode Attributes: Change colors or languages on-the-fly for specific instances.
* Lightweight — no jQuery dependency, no admin scripts on the front end.
* Zero data collection — the plugin does not store or transmit any personal data.

= Product Demo =
View [Scoremer Widgets](https://www.scoremer.com/widgets)

= Shortcode Parameters =

`[scoremer_live lid="42" bg="2F8162" color="FFF" lang="en" width="100%" height="500"]`

Available parameters (shortcode attributes):

* `lid` (default: `0`) — League ID (Required for `scoremer_table` and `scoremer_live`)
* `l` (default: `All first divisions worldwide`) — League Name (Specifically for `scoremer_top_goalscorers`)
* `bg` (default: Global Settings) — Background hex color (without `#`)
* `color` (default: Global Settings) — Font hex color (without `#`)
* `lang` (default: Global Settings) — Language code (en, zh, tw, es, fr, de, pt, it, ja …)
* `width` (default: `100%`) — iframe width (can be %, px, or vw)
* `height` (default: `500`) — iframe height in pixels

= Privacy =

This plugin embeds content from https://www.scoremer.com. Visitors' browsers will connect to the Scoremer servers when the widget is displayed. Please review [Scoremer's Privacy Policy](https://www.scoremer.com/privacy) for details.

== Installation ==

= Automatic Installation (Recommended) =

1. Go to **Plugins → Add New** in your WordPress admin area.
2. Search for **Scoremer: Football Livescore, Tables and Fixtures**.
3. Click **Install Now** and then **Activate**.

= Manual Installation =

1. Download the plugin ZIP file.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Upload the ZIP and click **Install Now**.
4. Activate the plugin.

= Usage Instructions =

1. Go to **Settings → Scoremer Widgets** from your WordPress Dashboard.
2. Configure your site's default Colors and Language.
3. Open any post or page editor.
4. Insert a **Shortcode** block or paste directly into the Classic Editor.
5. Use one of the 7 provided shortcodes, e.g., `[scoremer_fifa_world_ranking]` or `[scoremer_live lid="39"]`.

== Frequently Asked Questions ==

= Does this plugin work with the Classic Editor? =

Yes! You can use any of the shortcodes in the classic editor text area.

= Is the data real-time? =

Yes. The widget iframes fetch live, real-time data directly from Scoremer.com each time the page is loaded.

= How do I find the correct League ID (`lid`)? =

You can find proper League IDs directly on [Scoremer.com](https://www.scoremer.com/widgets) when generating a preview widget.

= Which languages are supported? =

English (en), Traditional Chinese (zh-tw), Simplified Chinese (zh-cn), Spanish (es), French (fr), German (de), Portuguese (pt), Italian (it), Japanese (ja), Korean (ko), and more.

== Screenshots ==

1. The Global Settings Panel under Settings -> Scoremer Widgets.
2. A Live Score widget rendered on the front end.
3. A FIFA World Cup ranking widget.

== Changelog ==

= 1.0.1 =
* Initial release.

= 1.0.2 =
* AI analysis notice for Live Score widget

= 1.0.3 =
* Add "Get free league id" tips

== Upgrade Notice ==

= 1.0.1 =
Initial release — no upgrade steps required.

= 1.0.2 =
Initial release — no upgrade steps required.

= 1.0.3 =
Initial release — no upgrade steps required.
