=== CVM Fixture Sync for PlayHQ ===
Contributors: cvmediaau
Tags: playhq, sportspress, fixtures, sports, import
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: sportspress
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manually import PlayHQ fixtures into SportsPress, with team, venue and grade mapping support.

== Description ==

CVM Fixture Sync for PlayHQ is a usable manual fixture importer for clubs using PlayHQ and SportsPress.

Configure your PlayHQ connection, map PlayHQ grades to SportsPress leagues, choose a team filter, preview matching fixtures, and run an import. Imported fixtures can create or update SportsPress events, link teams and taxonomies, create missing teams and venues, and optionally import team logos.

Lite has no licence key, licence activation, commercial updater, background schedule, or hidden paid implementation. Imported PlayHQ metadata is preserved to support a future upgrade.

[Documentation](https://www.cvmedia.com.au/docs/) | [CV Media](https://cvmedia.com.au/) | [Upgrade to Pro/Premium](https://www.cvmedia.com.au/products/?utm_source=lite)

== External services ==

This plugin connects to the PlayHQ API at `https://api.playhq.com` only when an administrator loads seasons or grades, previews fixtures, runs an import, or imports a team logo.

The configured PlayHQ API key and tenant are sent as request headers. Depending on the request, the organisation ID, season ID, grade ID or pagination cursor is sent to retrieve seasons, grades, teams, fixtures and club logo URLs. The returned data is used to create or update SportsPress content on the WordPress site. No data is sent to CV Media by this plugin.

Use of the PlayHQ service is subject to PlayHQ's [API documentation](https://support.playhq.com/hc/en-us/articles/23949453276572-How-To-Use-PlayHQ-API-s), [terms](https://www.playhq.com/terms-of-use) and [privacy policy](https://www.playhq.com/privacy-policy).

== Requirements ==

* WordPress 5.8 or later.
* PHP 7.4 or later.
* SportsPress installed and active.
* A valid PlayHQ API key and access to the relevant organisation/season.

== Installation ==

1. Upload the `cvm-fixture-sync-for-playhq` folder to `/wp-content/plugins/`, or install the plugin ZIP in Plugins > Add New.
2. Activate SportsPress, then activate CVM Fixture Sync for PlayHQ.
3. Open CVM Fixture Sync for PlayHQ in WordPress admin.
4. Enter the PlayHQ API key and organisation ID, confirm AFL as the sport, then load and select a season.
5. Select a SportsPress season, configure grade mappings and add a team filter.
6. Preview matching events before running the manual import.

== Frequently Asked Questions ==

= Does Lite require a licence key? =

No. Lite runs without a licence key and contains no licence activation code.

= Does Lite automatically sync fixtures or results? =

No. Lite imports fixtures only when an administrator runs the manual import. Auto sync, results, ladders, player stats and advanced sync options are available in separate paid plugins.

= Will uninstalling delete imported content? =

No. Deactivation and uninstall preserve settings and all imported SportsPress events, teams, venues and other customer content. Uninstall removes only Lite API-discovery transients.

= Can I upgrade without re-importing? =

Yes. Lite preserves compatible PlayHQ metadata on imported SportsPress content. Lite settings use a separate, uniquely prefixed option to avoid conflicts with other plugins.

= Where can I get documentation or support? =

See the [CV Media documentation](https://www.cvmedia.com.au/docs/) or visit [CV Media](https://cvmedia.com.au/).

== Upgrade Notice ==

PlayHQ Sync Pro/Premium adds automated syncing and paid data workflows. [Compare and upgrade](https://www.cvmedia.com.au/products/?utm_source=lite).

== Changelog ==

= 1.0.1 =

* Published the correct Lite build for the WordPress.org release.

= 1.0.0 =

* Initial WordPress.org-ready release.
* Added fixture preview and manual import.
* Added grade mappings, team/venue overrides, filters and basic settings.
* Added compatible SportsPress event, team, venue and PlayHQ metadata handling.
* Added simple manual import logs and upgrade guidance.

== License ==

CVM Fixture Sync for PlayHQ is licensed under GPL-2.0-or-later. See LICENSE.txt for the full GNU General Public License version 2 text.
