{"id":239930,"date":"2025-07-07T10:57:29","date_gmt":"2025-07-07T10:57:29","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/playhq-fixtures-viewer\/"},"modified":"2026-03-03T12:29:28","modified_gmt":"2026-03-03T12:29:28","slug":"fixture-viewer-for-playhq","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/fixture-viewer-for-playhq\/","author":23319231,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.5","stable_tag":"1.5","tested":"6.8.5","requires":"5.0","requires_php":"7.2","requires_plugins":null,"header_name":"Fixture Viewer for PlayHQ","header_author":"Mark Blackburn","header_description":"Displays fixtures for a team from PlayHQ API.","assets_banners_color":"","last_updated":"2026-03-03 12:29:28","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":10,"downloads":392,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.4":{"tag":"1.4","author":"markrblackburn","date":"2025-07-07 11:01:45"},"1.5":{"tag":"1.5","author":"markrblackburn","date":"2026-03-03 12:29:28"}},"upgrade_notice":{"1.5":"<p>Improves team loading to support paginated PlayHQ season team results, ensuring all teams are fetched when an organisation has multiple pages.<\/p>","1.4":"<p>Major Table Styling update: Borders can be styled independently, all color settings support hex input, and mobile font size is fixed. Review your settings after upgrading.<\/p>","1.3":"<p>Mobile table layout improved: Only Date\/Time, Opponent, and Venue columns are shown in the correct order. All columns visible on desktop.<br \/>\n<strong>All core CSS is now loaded from a dedicated file for better performance and maintainability.<\/strong><br \/>\nPlease review your settings after upgrading.<\/p>","1.2":"<p>Major update: Adds team selection by name, color picker for selected team, tenant selector, and improved shortcode options. Please review your settings after upgrading.<\/p>","1.0":"<ul>\n<li>Initial release.<\/li>\n<\/ul>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4","1.5"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"<strong>Settings Page:<\/strong> Configure your API key, organisation, sport, and display options.","2":"<strong>Team Selector:<\/strong> Let visitors choose a team above the fixtures table.","3":"<strong>Fixtures Table:<\/strong> Responsive, styled table of upcoming or past fixtures."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[20781,244621,80,4776,77],"plugin_category":[37,43],"plugin_contributors":[244622],"plugin_business_model":[],"class_list":["post-239930","plugin","type-plugin","status-publish","hentry","plugin_tags-fixtures","plugin_tags-playhq","plugin_tags-shortcode","plugin_tags-sports","plugin_tags-teams","plugin_category-arts-and-entertainment","plugin_category-customization","plugin_contributors-markrblackburn","plugin_committers-markrblackburn"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/fixture-viewer-for-playhq.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Fixture Viewer for PlayHQ allows you to display fixtures for a selected team from the PlayHQ API.<br \/>\nAdmins 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.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>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.<\/p>\n\n<p><strong>What the service is and what it is used for:<\/strong>\n- 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.<\/p>\n\n<p><strong>What data is sent and when:<\/strong>\n- When you configure the plugin, your PlayHQ API key, organisation ID, and selected team ID are used to make requests to the PlayHQ API.\n- The plugin sends these identifiers as part of the API request headers or URL to retrieve fixture and team data.\n- No personal user data from your WordPress site is sent to PlayHQ.<\/p>\n\n<p><strong>Links to the service's terms of service and privacy policy:<\/strong>\n- PlayHQ Terms of Service: https:\/\/www.playhq.com\/terms-of-use\n- PlayHQ Privacy Policy: https:\/\/www.playhq.com\/privacy-policy<\/p>\n\n<p>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.<\/p>\n\n<h3>Configuration Options<\/h3>\n\n<p>On the <strong>Settings &gt; Fixture Viewer for PlayHQ<\/strong> page, you can configure:<\/p>\n\n<ul>\n<li><strong>API Key (x-api-key):<\/strong> Your PlayHQ API key (required).<\/li>\n<li><strong>Organisation ID:<\/strong> Your PlayHQ organisation ID (required).<\/li>\n<li><strong>Sport (x-phq-tenant):<\/strong> Enter the PlayHQ tenant ID for your sport (required, default: afl).<\/li>\n<li><strong>Fetch Teams:<\/strong> Click to fetch and save teams for your organisation.<\/li>\n<li><strong>Team:<\/strong> Select the default team to display fixtures for.<\/li>\n<li><strong>Date Format:<\/strong> Choose how dates are displayed.<\/li>\n<li><strong>Time Format:<\/strong> Choose how times are displayed.<\/li>\n<li><strong>Enable Team Selector on Display Page:<\/strong> If checked, visitors can select a team from a dropdown above the fixtures table.<\/li>\n<li><strong>Selected Team Color:<\/strong> Pick a color or enter a hex code to highlight the selected team in the fixtures table.<\/li>\n<li><strong>Filter Fixtures:<\/strong> Show all, only upcoming, or only past fixtures.<\/li>\n<li><strong>Clean Team Names:<\/strong> Remove common suffixes (e.g., \"Over 35s\") from team names.<\/li>\n<li><strong>Table Styling:<\/strong><br \/>\n\n<ul>\n<li><strong>Table Colors:<\/strong> Set header, row, alternate row, text, and hover colors (with color picker and hex input).<\/li>\n<li><strong>Table Borders:<\/strong> Independently style the outer border and the row\/column dividers (style, weight, color).<\/li>\n<li><strong>Table Typography:<\/strong> Set font size and header alignment.<\/li>\n<\/ul><\/li>\n<li><strong>Custom CSS:<\/strong> Add your own CSS for further customization.<\/li>\n<\/ul>\n\n<h3>Shortcode Usage<\/h3>\n\n<p>Basic usage:\n    <code>[playhq_fixtures]<\/code>\nThis will display fixtures for the default team selected in the settings.<\/p>\n\n<p><strong>Shortcode Attributes:<\/strong><\/p>\n\n<ul>\n<li><code>team<\/code> (optional): Specify a team by ID or name to override the default team and hide the selector.\n\n<ul>\n<li>Example by ID: <code>[playhq_fixtures team=\"123456\"]<\/code><\/li>\n<li>Example by name: <code>[playhq_fixtures team=\"My Team Name\"]<\/code><\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p>If the <code>team<\/code> attribute is used, a heading with the team name will appear above the table.<\/p>\n\n<h3>Front-End Team Selector<\/h3>\n\n<p>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.<br \/>\nThe selected team will update the fixtures table automatically.<\/p>\n\n<h3>Table Styling Features<\/h3>\n\n<ul>\n<li><strong>Table Colors:<\/strong> Header, row, alternate row, text, and hover colors (color picker + hex input).<\/li>\n<li><strong>Table Borders:<\/strong> Outer border and row\/column dividers can be styled independently (style, weight, color).<\/li>\n<li><strong>Table Typography:<\/strong> Font size and header alignment.<\/li>\n<li><strong>Responsive:<\/strong> Mobile-friendly table layout with simplified columns and font size on small screens.<\/li>\n<\/ul>\n\n<h3>License<\/h3>\n\n<p>This plugin is licensed under the GPLv2 or later.\nSee https:\/\/www.gnu.org\/licenses\/gpl-2.0.html<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/fixture-viewer-for-playhq\/<\/code> or install via the WordPress Plugins screen.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Go to <strong>Settings &gt; Fixture Viewer for PlayHQ<\/strong> to configure the plugin.<\/li>\n<li>Enter your PlayHQ API Key and Organisation ID.<\/li>\n<li>Enter your Sport (x-phq-tenant) value (e.g. <code>afl<\/code>, <code>netball<\/code>, etc.).<\/li>\n<li>Click \"Fetch Teams\" to load the teams for your organisation.<\/li>\n<li>Select your default team and adjust other settings as needed.<\/li>\n<li>Use the <code>[playhq_fixtures]<\/code> shortcode on any page or post to display fixtures.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20i%20use%20the%20shortcode%20multiple%20times%20on%20a%20page%3F\"><h3>Can I use the shortcode multiple times on a page?<\/h3><\/dt>\n<dd><p>Yes, but each instance will use its own team selection based on the shortcode attribute or the default setting.<\/p><\/dd>\n<dt id=\"how%20do%20i%20get%20my%20playhq%20api%20key%3F\"><h3>How do I get my PlayHQ API key?<\/h3><\/dt>\n<dd><p>You must request an API key from PlayHQ. This plugin does not provide one.<\/p><\/dd>\n<dt id=\"why%20are%20no%20teams%20showing%20in%20the%20dropdown%3F\"><h3>Why are no teams showing in the dropdown?<\/h3><\/dt>\n<dd><p>Ensure you have entered a valid Organisation ID, API Key, and Sport (x-phq-tenant), then click \"Fetch Teams\" on the settings page.<\/p><\/dd>\n<dt id=\"can%20i%20style%20the%20table%3F\"><h3>Can I style the table?<\/h3><\/dt>\n<dd><p>Yes, use the Table Styling settings.<br \/>\n<strong>All core table and responsive CSS is loaded from a dedicated CSS file for better performance and maintainability.<\/strong><\/p><\/dd>\n<dt id=\"how%20do%20i%20change%20the%20sport%2Ftenant%3F\"><h3>How do I change the sport\/tenant?<\/h3><\/dt>\n<dd><p>Enter the required tenant ID (e.g., <code>afl<\/code>, <code>netball<\/code>, etc.) in the Sport (x-phq-tenant) field in settings.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.5<\/h4>\n\n<ul>\n<li>Improved team fetching from PlayHQ seasons API to support pagination via <code>metadata.hasMore<\/code> and <code>metadata.nextCursor<\/code>.<\/li>\n<li>Ensures all teams are loaded and saved when more than one page of team results exists.<\/li>\n<\/ul>\n\n<h4>1.4<\/h4>\n\n<ul>\n<li>Major Table Styling improvements:\n\n<ul>\n<li>Outer border and row\/column borders can be styled independently (style, weight, color).<\/li>\n<li>All color settings now support both color picker and hex code input.<\/li>\n<li>Table styling settings are grouped for clarity.<\/li>\n<li>Mobile font size is always 15px for readability.<\/li>\n<\/ul><\/li>\n<li>Addressed review comments:\n\n<ul>\n<li>Use wp_enqueue commands<\/li>\n<li>Data Must be Sanitized, Escaped, and Validated<\/li>\n<li>Processing the whole input<\/li>\n<li>Attempting to process custom CSS\/JS\/PHP \/ Allowing arbitrary script insertion<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li>Renamed plugin to \"Fixture Viewer for PlayHQ\"<\/li>\n<li>Updated documentation and versioning<\/li>\n<li>Minor improvements and bug fixes<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Optimised mobile display: Only Date\/Time, Opponent, and Venue columns are shown in the correct order on mobile.<\/li>\n<li>All columns visible on desktop.<\/li>\n<li>All core CSS moved to a dedicated file and enqueued for better performance.<\/li>\n<li>Version bump.<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Added support for team selection by name or ID via shortcode.<\/li>\n<li>Added optional team selector dropdown on the display page.<\/li>\n<li>Added color picker for selected team highlight.<\/li>\n<li>Added configurable sport\/tenant (x-phq-tenant).<\/li>\n<li>Improved styling and mobile responsiveness.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Display PlayHQ team fixtures on your WordPress site with a shortcode. Includes team selection and advanced table styling options.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/239930","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=239930"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/markrblackburn"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=239930"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=239930"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=239930"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=239930"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=239930"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=239930"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}