=== Top Goalscorers Widget for Scoremer ===
Contributors:      Scoremer
Tags:              football, soccer, scoremer, goalscorers, block
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 Scoremer football statistics widgets on your WordPress site — including top goalscorers, live scores, and more.

== Description ==

**Top Goalscorers Widget for Scoremer** lets you embed live football statistics from [Scoremer.com](https://www.scoremer.com/) directly on any post, page, or widget area of your WordPress site.

= Features =

* **Gutenberg block** — drag-and-drop the *Top Goalscorers Widget for Scoremer* block from the Embed category.
* **Shortcode** — use `[scoremer_top_goalscorers]` anywhere classic editor is used.
* Configurable background colour, font colour, language, league filter, and height.
* Lightweight — no jQuery dependency, no admin scripts on the front end.
* Zero data collection — the plugin does not store or transmit any personal data.

= Shortcode Parameters =

`[scoremer_top_goalscorers bg="2F8162" color="FFF" lang="en" league="All first divisions worldwide" height="500"]`

| Parameter | Default | Description |
|-----------|---------|-------------|
| bg        | 2F8162  | Background hex colour (without #) |
| color     | FFF     | Font hex colour (without #) |
| lang      | en      | Language code (en, zh-tw, zh-cn, es, fr, de, pt, it, ja, ko …) |
| league    | All first divisions worldwide | League filter |
| height    | 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 **Top Goalscorers Widget for Scoremer**.
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.

= Using the Block =

1. Open the post or page editor.
2. Click the **+** block inserter and search for *Scoremer*.
3. Insert the **Top Goalscorers Widget for Scoremer** block.
4. Adjust colours, language, league, and height in the block settings panel.

= Using the Shortcode =

Paste `[scoremer_top_goalscorers]` into any post, page, or text widget.

== Frequently Asked Questions ==

= Does this plugin work with the Classic Editor? =

Yes — use the `[scoremer_top_goalscorers]` shortcode.

= Is the data real-time? =

Yes. The iframe fetches live data directly from Scoremer.com each time the page is loaded.

= Can I display a specific league? =

Yes — set the `league` attribute in the shortcode or choose a league in the block settings panel.

= 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 Top Goalscorers Widget for Scoremer block in the Gutenberg editor.
2. The widget rendered on the front end.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release — no upgrade steps required.
