=== SPOSCOR Core ===
Contributors: powereight
Tags: sports, scoreboard, match, score, results
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish match results on your WordPress site. Works with any sport, and takes about five minutes to learn.

== Description ==

**SPOSCOR Core** turns a match result into a clean scoreboard on your site.

It works on its own. The built-in **Generic Match** type covers any sport where two sides score across periods — futsal, volleyball, handball, dodgeball, a school sports day. Create a match, type the scores, paste one shortcode into a page. That is the whole workflow.

Most result pages on club and league sites are a PDF, a photo of a whiteboard, or a table someone rebuilds by hand every week. This plugin exists to replace that.

= What it does =

* **Any sport, no configuration** — Generic Match works the moment you activate the plugin
* **One-line shortcode** — paste `[sposcor_scorecard id="123"]` into any post or page
* **Period-by-period scores** — two periods by default, extendable for extra time
* **Team identity** — name, abbreviation, colour, and a logo as a monogram, emoji, or uploaded image
* **Match status** — scheduled, live, final, postponed, cancelled
* **Highlights** — record key moments alongside the score
* **Mobile-first admin** — built for entering scores on a phone at the venue, with large tap targets and no horizontal scrolling
* **Voice input** — tap the microphone and say the score
* **Theme-safe output** — front-end styles are inline, so your theme and the scoreboard are not fighting each other
* **WCAG 2.1 AA** — colour is never the only carrier of meaning
* **Translation ready** — Japanese and Spanish translations included

There is no limit on how many matches you create.

= Optional sport plugins =

Core keeps the admin screens deliberately small. If you want features built around one specific sport, install a sport plugin alongside it:

* **Baseball SPOSCOR** — inning-by-inning scoreboard, automatic top/bottom detection, lineups
* **Soccer SPOSCOR** — halves and extra time, formations, cards, goal timeline
* **Basketball SPOSCOR** — quarters and overtime, player statistics

Sport plugins add their own screens for tournaments, standings and design options, and they replace the Generic Match menu while they are active. They are entirely optional — Core does not require any of them, and none of them are needed for Core to work.

= Shortcodes =

* `[sposcor_scorecard id="123"]` — full scorecard with the score for each period
* `[sposcor_result id="123"]` — compact result card

Both can be used more than once on the same page, which is the usual way to publish a day's results.

= Who it is for =

* Local clubs and amateur teams
* Tournament and league organisers
* Federations and associations
* School and youth sports
* Anyone currently publishing results as a PDF

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/sposcor-core/`, or install through the Plugins screen in WordPress
2. Activate the plugin
3. Open **SPOSCOR** in the admin menu and add your first match
4. Copy the shortcode shown on the match screen into any post or page

== Frequently Asked Questions ==

= Do I need a sport plugin to use this? =

No. SPOSCOR Core works on its own. The built-in Generic Match type handles any sport with two sides and a score per period. Sport plugins are optional and add screens tuned to one particular sport.

= Which sports does Generic Match handle? =

Any sport where two sides score across periods. It uses neutral period labels rather than sport-specific terms, so it fits volleyball, futsal, handball, dodgeball, school events and much else.

= Can I show results on more than one page? =

Yes. The shortcodes work in posts, pages, widgets and templates, and several can sit on the same page.

= Will it clash with my theme? =

Front-end output uses inline styles rather than a stylesheet, so theme CSS does not override it and it does not override theme CSS.

= Is it translated? =

Japanese and Spanish are bundled. English is the source language, and the plugin is fully translation-ready if you would like to contribute another language.

= Does the admin work on a phone? =

That is what it was designed for. Buttons are large, score fields open the numeric keyboard, and there is a microphone button for entering scores by voice.

= Where do I report a bug? =

Please use the support forum on this page.

== Screenshots ==

1. Full scorecard on the front end, with period-by-period scores and a live status badge
2. The same scorecard on a phone — no horizontal scrolling
3. The match editor. Team names, venue, status and scores in one screen, with the shortcodes ready to copy
4. Full and compact layouts on a single page

== Changelog ==

= 1.0.0 =
* First release on WordPress.org
* Generic Match type for use with any sport
* Period-by-period score entry with extra time support
* Team abbreviations, colours and logos
* Mobile-first admin with voice score entry
* Japanese and Spanish translations
* WCAG 2.1 AA accessibility

== Upgrade Notice ==

= 1.0.0 =
First public release.
