=== Sports Live Scores Widgets ===
Contributors: tipstercompetition
Tags: livescores, sports, football, widget, shortcode
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed live football scores on WordPress with global plugin defaults, reusable widget profiles, shortcode support, and theme-aware color customization.

== Description ==

Sports Live Scores Widgets lets WordPress site owners embed live football score widgets on posts and pages.

The plugin includes:

* Global plugin settings for theme, widget height, live/results behaviour, and color customization
* Reusable widget profiles for league-focused, country-focused, or global live score pages
* Shortcode support for flexible manual placement
* Live preview in the WordPress admin
* Automatic profile slug generation from the profile title, including `-1`, `-2`, and so on for duplicates
* Support for global live score pages and filtered league pages without repeating long league lists in page content

This plugin is designed for site owners who want live score widgets without managing sports-feed credentials, API integrations, or frontend widget code themselves.

== External Service ==

This plugin relies on the Tipster Competition live scores service to function.

It loads processed live score widgets from:

* `https://tipstercompetition.com`

What is sent or loaded:

* When the widget renders, the browser loads widget assets from `https://tipstercompetition.com/widget/loader.js`
* The widget requests processed live score output using widget display settings such as selected leagues, theme, height, and display options
* In the admin area, the preview loads the same hosted widget service so site owners can tune settings before publishing

Personal data and registration:

* The plugin does not require site owners to register an account
* The plugin does not require an API key
* The plugin does not ask site owners or visitors for names, email addresses, or profile details
* Standard web requests to the service may include technical request data such as IP address, browser headers, and requested URLs as part of normal HTTP communication

Service policies:

* Privacy Policy: https://tipstercompetition.com/privacy
* Terms of Use: https://tipstercompetition.com/terms

== Installation ==

1. Upload the plugin to the `/wp-content/plugins/` directory, or install it through the WordPress plugins screen.
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Open `Sports Widgets` in the WordPress admin.
4. Configure the global widget defaults and color settings.
5. Create one or more widget profiles for the league pages, country pages, or global live scores pages you want to publish.
6. Add `[sports_livescores]` to use the global defaults, or use a profile-based shortcode such as `[sports_livescores profile="premier-league"]`.

== Frequently Asked Questions ==

= Do I need to register an account? =

No. The plugin does not require site owners to register for an account or enter an API key.

= Does the plugin collect user details? =

The plugin does not request names, email addresses, passwords, or user profile information from site owners or visitors. Standard web requests to the hosted service may include technical connection data such as IP address and browser headers.

= Why does this plugin use a remote service? =

The live score data comes from a licensed paid feed that must be processed server-side before use. The plugin cannot legally or technically expose direct raw feed access to WordPress sites, so it connects to the hosted processed live scores service instead.

= Can I use one configuration for the whole site and different leagues on specific pages? =

Yes. Keep the appearance defaults centrally in the plugin settings, then create reusable widget profiles for each league, country, or live scores page you want to embed.

= Can I still use shortcodes manually? =

Yes. The plugin supports `[sports_livescores]` and shortcode attributes for manual placement.

= How do I manage league IDs without repeating them in shortcodes? =

Create a widget profile in the plugin settings and store the league IDs there. The shortcode then only needs the generated profile slug, for example `[sports_livescores profile="premier-league"]`.

= How are profile slugs created? =

Each profile slug is generated automatically from the profile title. If a slug already exists, the plugin adds `-1`, `-2`, and so on. For example, two profiles titled `Premier League` would become `premier-league` and `premier-league-1`.

== Shortcode Examples ==

Global live scores page:

`[sports_livescores]`

Explicit global live scores mode:

`[sports_livescores show_all_live="true"]`

Profile-based league page:

`[sports_livescores profile="premier-league"]`

Profile-based global page:

`[sports_livescores profile="global-live"]`

Theme override:

`[sports_livescores profile="premier-league" theme="light"]`

Height override:

`[sports_livescores profile="premier-league" max_height="800"]`

Manual league ID override when needed:

`[sports_livescores league_ids="148,525,782" show_all_live="false"]`

== Changelog ==

= 1.0.1 =

* Initial release
* Global widget settings
* Reusable widget profiles with auto-generated slugs
* Color customization with live preview
* Shortcode support for live score widgets
