[![GPLv3 License](https://img.shields.io/badge/License-GPL%20v3-yellow.svg)](https://opensource.org/licenses/) ![GitHub Tag](https://img.shields.io/github/v/tag/vincentbitter/fcm-for-sportlink?label=Plugin) # ⚽ Football Club Manager for Sportlink **Automatically import Sportlink data into the Football Club Manager WordPress plugin.** This plugin bridges the gap between Sportlink and [Football Club Manager](https://github.com/vincentbitter/football-club-manager), enabling seamless synchronization of teams, players, and matches directly into your WordPress site. --- ## πŸš€ Features - πŸ”„ Automatic import of KNVB data from Sportlink - πŸ‘₯ Update team rosters and player profiles - πŸ–ΌοΈ Download player photos from Sportlink - πŸ“… Sync match schedules and results - πŸ† Import league standings (coming soon!) - πŸŽ‚ Import birthdays - πŸ‘¨β€βš–οΈ Import referees - πŸ› οΈ Easy integration with Football Club Manager - 🧩 Manual import to apply changes faster and test the integration --- ## πŸ“‹ Requirements - WordPress 6.8 or higher - PHP 7.4 or higher - [Football Club Manager](https://wordpress.org/plugins/football-club-manager/) plugin installed and activated --- ## πŸ“¦ Installation You can install the plugin in one of two ways: ### Option 1: Download a Release 1. Visit the [Releases page](https://github.com/vincentbitter/fcm-for-sportlink/releases). 2. Download the latest `.zip` file. 3. In your WordPress dashboard, go to **Plugins β†’ Add New β†’ Upload Plugin**. 4. Upload the `.zip` file and activate the plugin. ### Option 2: Clone the Repository (development version) 1. Open your terminal and run: ``` git clone https://github.com/vincentbitter/fcm-for-sportlink.git ``` 2. Upload the cloned folder to your WordPress `/wp-content/plugins/` directory. 3. Activate the plugin via the WordPress admin dashboard. --- ## πŸ”§ Configuration After activation, navigate to **Football Club Manager β†’ Sportlink** in your WordPress dashboard. Enter the Sportlink Client ID of your football club and choose if you want to sync automatically. --- ## πŸ”’ Privacy & External Services This plugin connects to the [Sportlink API](https://data.sportlink.com) to retrieve up-to-date information about teams, players, and matches. The plugin sends the **Sportlink client ID** and previously received **team IDs** from Sportlink, but will never transmit any WordPress content, configuration, files, or user data. Please check the [Terms of Service](https://sportlinkservices.freshdesk.com/nl/support/solutions/folders/9000176717) and [Privacy Policy](https://www.sportlink.nl/privacybeleid/) of Sportlink for more information. --- ## πŸ“œ Changelog See what’s new in each release on the [Changelog page](https://github.com/vincentbitter/fcm-for-sportlink/blob/main/CHANGELOG.md) or on the [Releases page](https://github.com/vincentbitter/fcm-for-sportlink/releases). --- ## ❓ FAQ ❔ **What is Sportlink, and why should I integrate it with Football Club Manager?** Sportlink is a platform used by many Dutch football clubs to manage match schedules, team data, and results. Integrating it with Football Club Manager allows you to automatically display up-to-date information on your WordPress site without manual input. ? **Is this plugin developed or supported by Sportlink?** No. This plugin is an independent project and is not developed, endorsed, or affiliated with Sportlink. It is designed to integrate with Sportlink's data services, but all development and support are provided by the open-source community. ❔ **Do I need coding experience to use this plugin?** Not at all! Once installed and configured, the plugin handles the data import automatically. You just need access to your WordPress dashboard and Sportlink Client ID. ❔ **How often does the plugin sync data from Sportlink?** Data is synchronized hourly. ❔ **What kind of data is imported from Sportlink?** - Team rosters and player profiles - Player photos - Match schedules and results - League standings _(coming soon!)_ - Birthdays ❔ **Why are not all players of my club are imported?** Only public profiles from Sportlink are imported. The Sportlink API doesn't provide access to the names of players that are not set to public in Voetbal.nl. Please ask your members to set their profile to public so it is shown in both Voetbal.nl and on your website. ❔ **Birthdays are all in 1900, is this a bug?** It's not a bug, unfortunately. Sportlink only exposes the day and month via their API. That's why the year is set to 1900. Using this year, makes sure FCM won't show the age, as it excludes all years <= 1900. The import will never override dates of birth, so it's safe to complete the date of birth by filling in the year yourself. ❔ **Why are not all birthdays set in Football Club Manager while they are available in Sportlink?** Sportlink only exposes birthdays for the next 21 days. That's why the import needs to be done frequently. Ideally, via the automated import job. If a birthday is missing that is in the next 21 days, make sure you synchronized the data. This can be done manually or via the automated import. ❔ **Can player photos still be uploaded in WordPress, or will these be overridden?** The plugin contains a smart algorithm to check if the current player photo was manually uploaded in WordPress. If so, it won't override it with the photos from Sportlink. ❔ **Can I manually trigger a sync?** Yes! There’s a β€œSync Now” button in the plugin settings that lets you fetch the latest data on demand. ❔ **Is this plugin compatible with other WordPress themes or plugins?** It’s designed to work seamlessly with Football Club Manager. While it should play nicely with most themes, custom styling may be needed depending on your setup. ❔ **Where can I report bugs or request features?** Head over to the [Issues tab](https://github.com/vincentbitter/fcm-for-sportlink/issues) on GitHub to report bugs or suggest new features. --- ## 🀝 Contributing & Support Found a bug or have a feature request? Please open an issue on [GitHub](https://github.com/vincentbitter/fcm-for-sportlink/issues). Want to contribute? Fork the repo and submit a pull request β€” all help is welcome! --- ## πŸ“„ License This plugin is licensed under the [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html). --- ## ⚠️ Disclaimer This plugin is **not developed, endorsed, or affiliated with Sportlink** in any way. All references to Sportlink are solely for compatibility and integration purposes.