內容簡介
### 總結：
Fixture Viewer for PlayHQ 外掛讓您能從 PlayHQ API 中選擇球隊，並顯示比賽資訊。管理員可透過 WordPress 設定頁面進行外掛設定，取得組織中的球隊資料，並可選擇是否讓訪客在前端選擇球隊。
### 問題與答案：
1. 什麼是 PlayHQ API？
- 答：PlayHQ API 是由 PlayHQ Pty Ltd 提供的第三方服務，用於擷取運動比賽的賽程、球隊和賽季資料。
2. 使用 Fixture Viewer for PlayHQ 外掛時，哪些資料會被傳送以及什麼時候會傳送？
- 答：當您設定外掛時，會使用您的 PlayHQ API 金鑰、組織 ID 和選擇的球隊 ID 進行請求到 PlayHQ API。
3. 如何自訂外掛的配置？
- 答：您可以在「Settings > Fixture Viewer for PlayHQ」頁面進行以下設定：
- API Key (x-api-key): 您的 PlayHQ API 金鑰（必填）。
- Organisation ID: 您的 PlayHQ 組織 ID（必填）。
- Sport (x-phq-tenant): 為您的運動輸入 PlayHQ 租戶 ID（必填，默認為 afl）。
- Fetch Teams: 點擊以取得並保存您的組織的球隊。
- Team: 選擇要顯示比賽資訊的預設球隊。
- Date Format: 選擇日期的顯示方式。
- Time Format: 選擇時間的顯示方式。
- Enable Team Selector on Display Page: 勾選後，訪客可在比賽資訊表格上方的下拉式選單中選擇球隊。
- Selected Team Color: 選擇一種顏色或輸入十六進位碼以突出顯示比賽資訊表格中的所選球隊。
- Filter Fixtures: 顯示全部、僅未來或僅過去的比賽資訊。
- Clean Team Names: 從球隊名稱中移除常見的後綴詞（例如「Over 35s」）。
- 與其他視覺設定選項。
外掛標籤
開發者團隊
原文外掛簡介
Fixture Viewer for PlayHQ allows you to display fixtures for a selected team from the PlayHQ API.
Admins can configure the plugin via the WordPress settings page, fetch teams for an organisation, and optionally allow visitors to select a team on the front end.
External Services
This plugin connects to the PlayHQ API (https://api.playhq.com) to retrieve sports fixture data for your selected team or organisation. This is required to display up-to-date fixtures and results on your website.
What the service is and what it is used for:
– The PlayHQ API is a third-party service provided by PlayHQ Pty Ltd. It is used to fetch fixture, team, and season data for sports competitions.
What data is sent and when:
– When you configure the plugin, your PlayHQ API key, organisation ID, and selected team ID are used to make requests to the PlayHQ API.
– The plugin sends these identifiers as part of the API request headers or URL to retrieve fixture and team data.
– No personal user data from your WordPress site is sent to PlayHQ.
Links to the service’s terms of service and privacy policy:
– PlayHQ Terms of Service: https://www.playhq.com/terms-of-use
– PlayHQ Privacy Policy: https://www.playhq.com/privacy-policy
By using this plugin, you agree that your site will communicate with the PlayHQ API to display sports fixtures. Please review PlayHQ’s terms and privacy policy for more information.
Configuration Options
On the Settings > Fixture Viewer for PlayHQ page, you can configure:
API Key (x-api-key): Your PlayHQ API key (required).
Organisation ID: Your PlayHQ organisation ID (required).
Sport (x-phq-tenant): Enter the PlayHQ tenant ID for your sport (required, default: afl).
Fetch Teams: Click to fetch and save teams for your organisation.
Team: Select the default team to display fixtures for.
Date Format: Choose how dates are displayed.
Time Format: Choose how times are displayed.
Enable Team Selector on Display Page: If checked, visitors can select a team from a dropdown above the fixtures table.
Selected Team Color: Pick a color or enter a hex code to highlight the selected team in the fixtures table.
Filter Fixtures: Show all, only upcoming, or only past fixtures.
Clean Team Names: Remove common suffixes (e.g., “Over 35s”) from team names.
Table Styling:
Table Colors: Set header, row, alternate row, text, and hover colors (with color picker and hex input).
Table Borders: Independently style the outer border and the row/column dividers (style, weight, color).
Table Typography: Set font size and header alignment.
Custom CSS: Add your own CSS for further customization.
Shortcode Usage
Basic usage:
[playhq_fixtures]
This will display fixtures for the default team selected in the settings.
Shortcode Attributes:
team (optional): Specify a team by ID or name to override the default team and hide the selector.
Example by ID: [playhq_fixtures team="123456"]
Example by name: [playhq_fixtures team="My Team Name"]
If the team attribute is used, a heading with the team name will appear above the table.
Front-End Team Selector
If “Enable Team Selector on Display Page” is checked in settings, a dropdown will appear above the fixtures table, allowing visitors to select a team.
The selected team will update the fixtures table automatically.
Table Styling Features
Table Colors: Header, row, alternate row, text, and hover colors (color picker + hex input).
Table Borders: Outer border and row/column dividers can be styled independently (style, weight, color).
Table Typography: Font size and header alignment.
Responsive: Mobile-friendly table layout with simplified columns and font size on small screens.
License
This plugin is licensed under the GPLv2 or later.
See https://www.gnu.org/licenses/gpl-2.0.html