Use TONY_SPORTSPRESS_ENHANCEMENTS_DIR constant in requires; localize JS strings

- Replace repeated plugin_dir_path(__FILE__) calls with the already-defined
  TONY_SPORTSPRESS_ENHANCEMENTS_DIR constant
- Localize 'Open ICS Feed' and 'Open Feed URL' JS strings in sp-url-builder.php
  via wp_json_encode() so they pass through the translation system

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.gitignore

@@ -7,3 +7,4 @@ node_modules/
 *.sql
 *.tar.gz
 *.zip
+data

assets/print-calendar.css

@@ -0,0 +1,503 @@
+@import url("https://fonts.googleapis.com/css2?family=Nunito+Sans:opsz,wdth,wght@6..12,75..125,600..900&family=Open+Sans:wght@400..800&display=swap");
+
+:root {
+	--pc-font-body: "Open Sans", Arial, sans-serif;
+	--pc-font-display: "Nunito Sans", "Open Sans", Arial, sans-serif;
+	--pc-page-padding: 0.45in;
+	--pc-gap: 8px;
+	--pc-border: #d5dde6;
+	--pc-preview-bg: #d9dce3;
+	--pc-team-logo-size: clamp(40px, 5vw, 56px);
+	--pc-brand-logo-height: clamp(40px, 5vw, 56px);
+	--pc-brand-logo-max-width: 34%;
+	--pc-muted-day-bg: rgba(243, 245, 248, 0.72);
+	--pc-empty-day-bg: rgba(233, 237, 242, 0.72);
+	--pc-event-logo-height: clamp(28px, 100%, 74px);
+	--pc-qr-size: 50px;
+	--pc-qr-offset: calc(var(--pc-qr-size) + var(--pc-gap));
+}
+
+body {
+	margin: 0;
+	padding: 20px;
+	font-family: var(--pc-font-body);
+	color: #111;
+	background: #fff;
+}
+
+.print-shell {
+	margin: 0;
+	width: calc(100% / var(--sheet-scale));
+	background: #fff;
+	transform-origin: top left;
+	transform: scale(var(--sheet-scale));
+}
+
+.print-page {
+	padding: var(--pc-page-padding);
+}
+
+@media screen {
+	body.print-preview {
+		min-height: 100vh;
+		display: flex;
+		justify-content: center;
+		align-items: flex-start;
+		padding: 24px;
+		background: var(--pc-preview-bg);
+	}
+
+	body.print-preview .print-shell {
+		box-shadow: 0 10px 30px rgba(17, 24, 39, 0.2);
+	}
+
+	body.print-preview .print-shell.letter {
+		width: 8.5in;
+		min-height: 11in;
+	}
+
+	body.print-preview .print-shell.ledger {
+		width: 11in;
+		min-height: 17in;
+	}
+}
+
+.header {
+	display: flex;
+	justify-content: space-between;
+	align-items: center;
+	gap: 12px;
+	margin: 0 0 12px;
+	padding-bottom: 8px;
+	border-bottom: 2px solid var(--team-accent, #b61f0f);
+}
+
+.header-brand {
+	display: flex;
+	align-items: center;
+	gap: 10px;
+	min-width: 0;
+}
+
+.team-logo,
+.league-logo {
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+	flex: 0 0 auto;
+}
+
+.team-logo {
+	width: var(--pc-team-logo-size);
+	height: var(--pc-team-logo-size);
+}
+
+.team-logo img,
+.team-logo-img {
+	width: 100%;
+	height: 100%;
+	display: block;
+	object-fit: contain;
+}
+
+.league-logo {
+	height: var(--pc-brand-logo-height);
+	max-width: var(--pc-brand-logo-max-width);
+}
+
+.league-logo a,
+.league-logo .custom-logo-link,
+.league-logo .wp-block-site-logo__link {
+	height: 100%;
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+}
+
+.league-logo img,
+.league-logo-img,
+.league-logo .custom-logo,
+.league-logo .wp-block-site-logo__image {
+	width: auto;
+	height: 100%;
+	max-width: 100%;
+	display: block;
+	object-fit: contain;
+}
+
+.header-copy {
+	min-width: 0;
+}
+
+.title {
+	margin: 0;
+	font-family: var(--pc-font-display);
+	font-size: 28px;
+	font-weight: 800;
+	font-variation-settings: "wdth" 92, "wght" 800;
+	line-height: 1.1;
+	color: var(--team-ink, #111);
+}
+
+.meta {
+	margin: 0;
+	font-size: 13px;
+	color: var(--team-muted-ink, #333);
+}
+
+.legend {
+	display: flex;
+	flex-wrap: wrap;
+	gap: var(--pc-gap);
+	margin: 0;
+}
+
+.legend-item {
+	display: inline-flex;
+	align-items: center;
+	font-family: var(--pc-font-display);
+	font-variation-settings: "wdth" 70, "wght" 700;
+	background: #fff;
+}
+
+.sheet-grid {
+	display: grid;
+	grid-template-columns: repeat(var(--month-columns), minmax(0, 1fr));
+	gap: var(--pc-gap);
+	align-items: start;
+}
+
+.sheet-grid > .month:nth-child(3):last-child {
+	grid-column: 1 / -1;
+	width: calc((100% - var(--pc-gap)) / 2);
+	max-width: calc((100% - var(--pc-gap)) / 2);
+	justify-self: center;
+}
+
+.month {
+	margin: 0;
+	break-inside: avoid;
+	page-break-inside: avoid;
+}
+
+.month-title {
+	margin: 0;
+	padding: 2px;
+	font-family: var(--pc-font-display);
+	font-size: calc(20px * var(--month-font-scale));
+	font-weight: 800;
+	font-variation-settings: "wdth" 80, "wght" 800;
+	line-height: 1.1;
+	letter-spacing: 0.01em;
+	text-align: center;
+	text-transform: uppercase;
+	background: var(--team-primary);
+	color: var(--team-on-primary);
+}
+
+.dow,
+.grid {
+	display: grid;
+	grid-template-columns: repeat(7, minmax(0, 1fr));
+}
+
+.dow span {
+	display: block;
+	padding: 2px 1px;
+	font-size: calc(10px * var(--month-font-scale));
+	font-weight: 700;
+	text-align: center;
+	text-transform: uppercase;
+	border-bottom: 1px solid var(--pc-border);
+	background: var(--team-link-color);
+	color: var(--team-on-link-color);
+}
+
+.day {
+	--corner-badge-size: calc(15px * var(--month-font-scale));
+	--corner-badge-offset: 0px;
+	position: relative;
+	overflow: hidden;
+	aspect-ratio: var(--day-aspect);
+	background: #fff;
+}
+
+.day.muted {
+	background: var(--pc-muted-day-bg);
+	color: #9aa5b1;
+}
+
+.day.no-events {
+	background: var(--pc-empty-day-bg);
+}
+
+.day-num {
+	position: absolute;
+	top: var(--corner-badge-offset);
+	left: var(--corner-badge-offset);
+	z-index: 4;
+	width: var(--corner-badge-size);
+	height: var(--corner-badge-size);
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	font-family: var(--pc-font-display);
+	font-size: calc(12px * var(--month-font-scale));
+	font-weight: 800;
+	font-variation-settings: "wdth" 86, "wght" 800;
+	line-height: 1;
+}
+
+.day.has-events .day-num {
+	color: var(--day-num-color, #fff);
+}
+
+.events-stack {
+	height: 100%;
+	display: grid;
+	grid-template-rows: repeat(var(--event-count), minmax(0, 1fr));
+}
+
+.event {
+	--event-top-band: calc(var(--corner-badge-size, 11px) + var(--corner-badge-offset, 2px));
+	--event-bottom-band: 26px;
+	--event-logo-height: var(--pc-event-logo-height);
+	position: relative;
+	background: var(--event-bg, var(--team-primary, #1b76d1));
+	color: var(--event-fg, #fff);
+}
+
+.event.h {
+	--event-bg: var(--team-primary, #1b76d1);
+}
+
+.event.a {
+	--event-bg: var(--team-link-color, var(--team-secondary, #8b3f1f));
+}
+
+.event-center {
+	position: absolute;
+	top: var(--event-top-band);
+	left: 0;
+	right: 0;
+	bottom: var(--event-bottom-band);
+	z-index: 1;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	overflow: hidden;
+	width: 100%;
+	font-size: calc(10px * var(--month-font-scale));
+	font-weight: 700;
+	line-height: 1;
+	text-align: center;
+}
+
+.event-center img {
+	width: auto;
+	height: var(--event-logo-height);
+	max-width: 100%;
+	max-height: 100%;
+	display: block;
+	object-fit: contain;
+	object-position: center;
+}
+
+.event-name {
+	width: 100%;
+	max-width: 100%;
+	max-height: 100%;
+	overflow: hidden;
+	text-overflow: clip;
+	white-space: normal;
+	word-break: normal;
+	overflow-wrap: normal;
+	hyphens: none;
+	line-height: 1.05;
+	font-weight: 700;
+	opacity: 0.85;
+}
+
+.event.no-logo .event-name {
+	font-family: var(--pc-font-display);
+	font-weight: 700;
+	font-variation-settings: "wdth" 30, "wght" 700;
+	letter-spacing: -0.01em;
+	text-transform: uppercase;
+}
+
+.ha-flag {
+	position: absolute;
+	top: var(--corner-badge-offset, 2px);
+	right: var(--corner-badge-offset, 2px);
+	z-index: 3;
+	width: var(--corner-badge-size, 11px);
+	height: var(--corner-badge-size, 11px);
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	font-family: var(--pc-font-display);
+	font-size: calc(10px * var(--month-font-scale));
+	font-weight: 900;
+	font-variation-settings: "wdth" 84, "wght" 900;
+	line-height: 1;
+	letter-spacing: -0.01em;
+	background: #111;
+	color: #fff;
+}
+
+.event.a .ha-flag {
+	background: #fff;
+	color: #111;
+}
+
+.event-meta {
+	position: absolute;
+	left: 0;
+	right: 0;
+	bottom: 2px;
+	z-index: 3;
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	justify-content: flex-end;
+	gap: 1px;
+	padding: 0 2px;
+	overflow: hidden;
+}
+
+.event-time {
+	order: 1;
+	max-width: 100%;
+	font-size: calc(12px * var(--month-font-scale));
+	font-weight: 800;
+	line-height: 1;
+	text-transform: uppercase;
+	text-align: center;
+	color: currentColor;
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: clip;
+	opacity: 0.95;
+}
+
+.event-venue {
+	order: 2;
+	max-width: 100%;
+	font-size: calc(8px * var(--month-font-scale));
+	font-weight: 700;
+	line-height: 1;
+	text-align: center;
+	text-transform: uppercase;
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: clip;
+	opacity: 0.88;
+}
+
+.empty {
+	padding: 16px;
+	border: 2px dashed #c8d2de;
+	background: #f8fafc;
+}
+
+.footer-meta {
+	display: flex;
+	align-items: flex-start;
+	justify-content: space-between;
+	gap: var(--pc-gap);
+	margin-top: 10px;
+	padding-top: 8px;
+	border-top: 1px solid var(--pc-border);
+}
+
+.legend-bottom {
+	--month-width: calc((100% - ((var(--month-columns) - 1) * var(--pc-gap))) / var(--month-columns));
+	flex: 0 0 var(--month-width);
+	width: var(--month-width);
+	max-width: var(--month-width);
+	align-content: flex-start;
+	justify-content: center;
+	gap: 6px;
+}
+
+.legend-bottom .legend-item {
+	padding: 3px 6px;
+	font-size: 10px;
+	text-align: center;
+}
+
+.footer-qr {
+	position: relative;
+	flex: 0 0 auto;
+	display: flex;
+	align-items: flex-end;
+	justify-content: flex-end;
+	gap: var(--pc-gap);
+	min-height: var(--pc-qr-size);
+	padding-right: var(--pc-qr-offset);
+}
+
+.footer-qr-copy {
+	display: flex;
+	flex-direction: column;
+	align-items: flex-end;
+	gap: 2px;
+	text-align: right;
+}
+
+.footer-qr-label {
+	font-size: 9px;
+	font-weight: 700;
+	letter-spacing: 0.02em;
+	text-transform: uppercase;
+	color: var(--team-muted-ink, #333);
+}
+
+.footer-qr-link {
+	font-size: 10px;
+	font-weight: 700;
+	text-decoration: none;
+	color: var(--team-ink, #111);
+}
+
+.footer-qr-image {
+	position: absolute;
+	right: 0;
+	bottom: 0;
+	width: var(--pc-qr-size);
+	height: var(--pc-qr-size);
+	display: block;
+	border: 1px solid var(--pc-border);
+	background: #fff;
+}
+
+@media print {
+	body,
+	body.print-preview {
+		padding: 0;
+		display: block;
+		background: #fff;
+	}
+
+	.print-shell,
+	body.print-preview .print-shell,
+	body.print-preview .print-shell.letter,
+	body.print-preview .print-shell.ledger {
+		width: auto;
+		min-height: auto;
+		box-shadow: none;
+	}
+
+	.print-page {
+		padding: 0;
+	}
+
+	.header {
+		margin-bottom: 8px;
+	}
+
+	.title {
+		font-size: calc(26px * var(--month-font-scale));
+	}
+}

assets/schedule-exporter-block.js

@@ -0,0 +1,27 @@
+( function ( blocks, blockEditor, element, i18n ) {
+	var el = element.createElement;
+	var useBlockProps = blockEditor.useBlockProps;
+	var __ = i18n.__;
+
+	blocks.registerBlockType( 'tse/schedule-exporter', {
+		edit: function () {
+			var blockProps = useBlockProps( {
+				className: 'tse-schedule-exporter-block-placeholder',
+			} );
+
+			return el(
+				'div',
+				blockProps,
+				el( 'strong', null, __( 'Schedule Exporter', 'tonys-sportspress-enhancements' ) ),
+				el(
+					'p',
+					null,
+					__( 'This block renders the public schedule exporter on the frontend.', 'tonys-sportspress-enhancements' )
+				)
+			);
+		},
+		save: function () {
+			return null;
+		},
+	} );
+} )( window.wp.blocks, window.wp.blockEditor, window.wp.element, window.wp.i18n );

includes/featured-image-generator.php

@@ -1,207 +1,224 @@
 <?php
-/*
+/**
-Plugin Name: SP Event Image Generator
+ * SP Event featured-image generator.
-Description: Auto-generates featured images for SP Events by combining team colors and logos.
+ *
-Version: 1.0
+ * Auto-generates bisected team-color images for SP Events.
-Author: Your Name
+ *
+ * @package Tonys_Sportspress_Enhancements
  */
 
-function generate_bisected_image($color1, $color2, $logo1_path, $logo2_path) {
+if ( ! defined( 'ABSPATH' ) ) {
-    $width = 1200;
-    $height = 628;
-    $x_margin = 0.1 * ($width / 2); // 10% of half the width
-    $y_margin = 0.1 * $height; // 10% of the height
-    $image = imagecreatetruecolor($width, $height);
-
-    // Allocate colors
-    $rgb1 = sscanf($color1, "#%02x%02x%02x");
-    $rgb2 = sscanf($color2, "#%02x%02x%02x");
-    $color1_alloc = imagecolorallocate($image, $rgb1[0], $rgb1[1], $rgb1[2]);
-    $color2_alloc = imagecolorallocate($image, $rgb2[0], $rgb2[1], $rgb2[2]);
-
-    // Fill halves with a 15-degree angled bisection
-    $points1 = [
-        0, 0, 
-        0, $height,
-        $width*.40, $height, 
-        $width*.60, 0,
-    ];
-    $points2 = [
-        $width, 0, 
-        $width, $height, 
-        $width*.40, $height, 
-        $width*.60, 0,
-    ];
-    imagefilledpolygon($image, $points1, $color1_alloc);
-    imagefilledpolygon($image, $points2, $color2_alloc);
-
-    // Add logos with resizing and positioning if paths are not empty
-    if (!empty($logo1_path)) {
-        $logo1 = imagecreatefrompng($logo1_path);
-        $logo1_width = imagesx($logo1);
-        $logo1_height = imagesy($logo1);
-
-        // Calculate max dimensions for logo 1
-        $max_width = ($width / 2) - (2 * $x_margin);
-        $max_height = $height - (2 * $y_margin);
-
-        // Resize logo 1
-        $new_logo1_width = $logo1_width;
-        $new_logo1_height = $logo1_height;
-        if ($logo1_width > $max_width || $logo1_height > $max_height) {
-            $aspect_ratio1 = $logo1_width / $logo1_height;
-            if ($logo1_width / $max_width > $logo1_height / $max_height) {
-                $new_logo1_width = $max_width;
-                $new_logo1_height = $max_width / $aspect_ratio1;
-            } else {
-                $new_logo1_height = $max_height;
-                $new_logo1_width = $max_height * $aspect_ratio1;
-            }
-        }
-
-        // Center logo 1
-        $logo1_x = (int) ($width / 4) - ($new_logo1_width / 2);
-        $logo1_y = (int) ($height / 2) - ($new_logo1_height / 2);
-        imagecopyresampled($image, $logo1, $logo1_x, $logo1_y, 0, 0, $new_logo1_width, $new_logo1_height, $logo1_width, $logo1_height);
-        imagedestroy($logo1);
-    }
-
-    if (!empty($logo2_path)) {
-        $logo2 = imagecreatefrompng($logo2_path);
-        $logo2_width = imagesx($logo2);
-        $logo2_height = imagesy($logo2);
-
-        // Calculate max dimensions for logo 2
-        $max_width = ($width / 2) - (2 * $x_margin);
-        $max_height = $height - (2 * $y_margin);
-
-        // Resize logo 2
-        $new_logo2_width = $logo2_width;
-        $new_logo2_height = $logo2_height;
-        if ($logo2_width > $max_width || $logo2_height > $max_height) {
-            $aspect_ratio2 = $logo2_width / $logo2_height;
-            if ($logo2_width / $max_width > $logo2_height / $max_height) {
-                $new_logo2_width = $max_width;
-                $new_logo2_height = $max_width / $aspect_ratio2;
-            } else {
-                $new_logo2_height = $max_height;
-                $new_logo2_width = $max_height * $aspect_ratio2;
-            }
-        }
-
-        // Center logo 2
-        $logo2_x = (int) (3 * $width / 4) - ($new_logo2_width / 2);
-        $logo2_y = (int) ($height / 2) - ($new_logo2_height / 2);
-        imagecopyresampled($image, $logo2, $logo2_x, $logo2_y, 0, 0, $new_logo2_width, $new_logo2_height, $logo2_width, $logo2_height);
-        imagedestroy($logo2);
-    }
-
-    // Start output buffering to capture the image data
-    ob_start();
-    imagepng($image); // Output the image as PNG
-    $image_data = ob_get_clean(); // Get the image data from the buffer
-
-    // Clean up memory
-    imagedestroy($image);
-
-    return $image_data;
-
-}
-
-function add_image_generator_endpoint() {
-    add_rewrite_endpoint('head-to-head', EP_ROOT, true);
-}
-add_action('init', 'add_image_generator_endpoint');
-
-function handle_image_request() {
-    if (!isset($_GET['post'])) return;
-    
-    $post_id = $_GET['post'];
-    $post = get_post($post_id);
-
-    // Verify post type
-    if (!$post && $post->post_type !== 'sp_event') return;
-
-    // Get associated teams from post meta
-    $team_ids = get_post_meta($post_id, 'sp_team', false); // false to get an array of values
-
-    // Ensure we have exactly two teams
-    if (count($team_ids) < 2) return;
-
-    $team1_id = $team_ids[0];
-    $team2_id = $team_ids[1];
-
-    $team1 = get_post($team1_id);
-    $team2 = get_post($team2_id);
-    $team1_postmodified = strtotime($team1->post_modified);
-    $team2_postmodified = strtotime($team2->post_modified);
-
-    $cache_key = "team_image_{$team1_id}_{$team1_postmodified}-{$team2_id}_{$team2_postmodified}";
-    $cached_image_path = get_transient($cache_key);
-
-    if ($cached_image_path && file_exists($cached_image_path)) {
-        serve_image($cached_image_path);
 	exit;
 }
 
-    // Get team colors and logos
+/**
+ * Register the head-to-head rewrite endpoint.
+ *
+ * @return void
+ */
+function tony_sportspress_add_image_generator_endpoint() {
+	add_rewrite_endpoint( 'head-to-head', EP_ROOT, true );
+}
+add_action( 'init', 'tony_sportspress_add_image_generator_endpoint' );
+
+/**
+ * Serve the generated matchup image on template_redirect.
+ *
+ * @return void
+ */
+function tony_sportspress_handle_image_request() {
+	if ( ! isset( $_GET['post'] ) ) {
+		return;
+	}
+
+	$post_id = absint( $_GET['post'] );
+	if ( $post_id <= 0 ) {
+		return;
+	}
+
+	$post = get_post( $post_id );
+	if ( ! $post || $post->post_type !== 'sp_event' ) {
+		return;
+	}
+
+	$team_ids = get_post_meta( $post_id, 'sp_team', false );
+	if ( count( $team_ids ) < 2 ) {
+		return;
+	}
+
+	$team1_id = (int) $team_ids[0];
+	$team2_id = (int) $team_ids[1];
+
+	$team1 = get_post( $team1_id );
+	$team2 = get_post( $team2_id );
+
+	if ( ! $team1 || ! $team2 ) {
+		return;
+	}
+
+	$team1_modified = strtotime( $team1->post_modified );
+	$team2_modified = strtotime( $team2->post_modified );
+	$cache_key      = "team_image_{$team1_id}_{$team1_modified}-{$team2_id}_{$team2_modified}";
+
+	$cached_path = get_transient( $cache_key );
+	if ( $cached_path && file_exists( $cached_path ) ) {
+		tony_sportspress_serve_image( $cached_path );
+		exit;
+	}
+
+	$default_color = '#FFFFFF';
 	$team1_colors  = get_post_meta( $team1_id, 'sp_colors', true );
 	$team2_colors  = get_post_meta( $team2_id, 'sp_colors', true );
-
-    $default_color = '#FFFFFF'; // Default color (black)
 	$team1_color   = ! empty( $team1_colors['primary'] ) ? $team1_colors['primary'] : $default_color;
 	$team2_color   = ! empty( $team2_colors['primary'] ) ? $team2_colors['primary'] : $default_color;
 
-    // Security check for hex color
+	// Validate hex colors.
-    $team1_color = preg_match('/^#[a-fA-F0-9]{6}$/', $team1_color) ? $team1_color : '#FFFFFF';
+	if ( ! preg_match( '/^#[a-fA-F0-9]{6}$/', $team1_color ) ) {
-    $team2_color = preg_match('/^#[a-fA-F0-9]{6}$/', $team2_color) ? $team2_color : '#FFFFFF';
+		$team1_color = $default_color;
+	}
+	if ( ! preg_match( '/^#[a-fA-F0-9]{6}$/', $team2_color ) ) {
+		$team2_color = $default_color;
+	}
 
 	$team1_logo_url = get_the_post_thumbnail_url( $team1_id, 'full' );
 	$team2_logo_url = get_the_post_thumbnail_url( $team2_id, 'full' );
 
-    // Check if both team colors are default and both logos are empty
+	// Skip if both teams have no distinguishable color or logo.
-    if (($team1_color === $default_color && empty($team1_logo_url)) && ($team2_color === $default_color && empty($team2_logo_url))) {
+	if ( $team1_color === $default_color && empty( $team1_logo_url )
-        return; // Do nothing if both teams have no valid color or logo
+		&& $team2_color === $default_color && empty( $team2_logo_url ) ) {
+		return;
 	}
 
-    $team1_logo_thumbnail_id = get_post_thumbnail_id($team1_id, 'full');
+	$team1_logo = get_attached_file( get_post_thumbnail_id( $team1_id ) );
-    $team2_logo_thumbnail_id = get_post_thumbnail_id($team2_id, 'full');
+	$team2_logo = get_attached_file( get_post_thumbnail_id( $team2_id ) );
-    $team1_logo = get_attached_file($team1_logo_thumbnail_id);
-    $team2_logo = get_attached_file($team2_logo_thumbnail_id);
 
-    // Generate the image if no valid cache exists
+	$image_data = tony_sportspress_generate_bisected_image( $team1_color, $team2_color, $team1_logo, $team2_logo );
-    $image_data = generate_bisected_image($team1_color, $team2_color, $team1_logo, $team2_logo);
+	$image_path = tony_sportspress_save_image_to_cache( $image_data, $cache_key );
-    $image_path = save_image_to_cache($image_data, $cache_key);
+	set_transient( $cache_key, $image_path, DAY_IN_SECONDS * 30 );
-    set_transient($cache_key, $image_path, DAY_IN_SECONDS * 30); // Cache for 30 days
-
-    serve_image($image_path);
 
+	tony_sportspress_serve_image( $image_path );
 	exit;
 }
-add_action('template_redirect', 'handle_image_request');
+add_action( 'template_redirect', 'tony_sportspress_handle_image_request' );
 
-function serve_image($image_path) {
+/**
+ * Send a cached PNG image file to the browser.
+ *
+ * @param string $image_path Absolute path to the image file.
+ * @return void
+ */
+function tony_sportspress_serve_image( $image_path ) {
 	header( 'Content-Type: image/png' );
+
 	if ( file_exists( $image_path ) ) {
 		status_header( 200 );
 	} else {
 		status_header( 404 );
-        die("Image not found.");
+		exit( 'Image not found.' );
 	}
 
-    // Clear all output buffering to prevent any extra output
 	while ( ob_get_level() ) {
 		ob_end_clean();
 	}
-    readfile($image_path);
+
+	readfile( $image_path ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_readfile
 }
 
-function save_image_to_cache($image_data, $cache_key) {
+/**
+ * Write raw image data to the uploads directory and return the file path.
+ *
+ * @param string $image_data Raw PNG data.
+ * @param string $cache_key  Cache key used as the filename stem.
+ * @return string
+ */
+function tony_sportspress_save_image_to_cache( $image_data, $cache_key ) {
 	$upload_dir = wp_get_upload_dir();
 	$file_path  = $upload_dir['path'] . '/' . $cache_key . '.png';
 
-    // Assuming $image_data is raw image data
+	file_put_contents( $file_path, $image_data ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_file_put_contents
-    file_put_contents($file_path, $image_data);
 
 	return $file_path;
 }
+
+/**
+ * Generate a bisected two-color PNG with optional team logos.
+ *
+ * @param string $color1     Hex color for the left half (e.g. #FF0000).
+ * @param string $color2     Hex color for the right half.
+ * @param string $logo1_path Absolute path to team 1 PNG logo (or empty).
+ * @param string $logo2_path Absolute path to team 2 PNG logo (or empty).
+ * @return string Raw PNG image data.
+ */
+function tony_sportspress_generate_bisected_image( $color1, $color2, $logo1_path, $logo2_path ) {
+	$width    = 1200;
+	$height   = 628;
+	$x_margin = 0.1 * ( $width / 2 );
+	$y_margin = 0.1 * $height;
+	$image    = imagecreatetruecolor( $width, $height );
+
+	$rgb1         = sscanf( $color1, '#%02x%02x%02x' );
+	$rgb2         = sscanf( $color2, '#%02x%02x%02x' );
+	$color1_alloc = imagecolorallocate( $image, $rgb1[0], $rgb1[1], $rgb1[2] );
+	$color2_alloc = imagecolorallocate( $image, $rgb2[0], $rgb2[1], $rgb2[2] );
+
+	// Left trapezoid.
+	imagefilledpolygon(
+		$image,
+		array( 0, 0, 0, $height, $width * 0.40, $height, $width * 0.60, 0 ),
+		$color1_alloc
+	);
+
+	// Right trapezoid.
+	imagefilledpolygon(
+		$image,
+		array( $width, 0, $width, $height, $width * 0.40, $height, $width * 0.60, 0 ),
+		$color2_alloc
+	);
+
+	$max_logo_width  = ( $width / 2 ) - ( 2 * $x_margin );
+	$max_logo_height = $height - ( 2 * $y_margin );
+
+	foreach ( array(
+		array( 'path' => $logo1_path, 'center_x' => $width / 4 ),
+		array( 'path' => $logo2_path, 'center_x' => 3 * $width / 4 ),
+	) as $logo ) {
+		if ( empty( $logo['path'] ) ) {
+			continue;
+		}
+
+		$src = imagecreatefrompng( $logo['path'] );
+		if ( ! $src ) {
+			continue;
+		}
+
+		$src_w = imagesx( $src );
+		$src_h = imagesy( $src );
+
+		$dst_w = $src_w;
+		$dst_h = $src_h;
+
+		if ( $src_w > $max_logo_width || $src_h > $max_logo_height ) {
+			$ratio = $src_w / $src_h;
+			if ( $src_w / $max_logo_width > $src_h / $max_logo_height ) {
+				$dst_w = $max_logo_width;
+				$dst_h = $max_logo_width / $ratio;
+			} else {
+				$dst_h = $max_logo_height;
+				$dst_w = $max_logo_height * $ratio;
+			}
+		}
+
+		$dst_x = (int) ( $logo['center_x'] - $dst_w / 2 );
+		$dst_y = (int) ( $height / 2 - $dst_h / 2 );
+
+		imagecopyresampled( $image, $src, $dst_x, $dst_y, 0, 0, (int) $dst_w, (int) $dst_h, $src_w, $src_h );
+		imagedestroy( $src );
+	}
+
+	ob_start();
+	imagepng( $image );
+	$image_data = (string) ob_get_clean();
+	imagedestroy( $image );
+
+	return $image_data;
+}

includes/open-graph-tags.php

@@ -1,109 +1,219 @@
 <?php
-/*
+/**
-Plugin Name: Custom Open Graph Tags with SportsPress Integration
+ * Open Graph tags with SportsPress integration.
-Description: Adds custom Open Graph tags to posts based on their type, specifically handling sp_event post types with methods from the SportsPress SP_Event class.
+ *
-Version: 1.0
+ * Adds custom Open Graph meta tags to sp_event single pages.
-Author: Your Name
+ *
+ * @package Tonys_Sportspress_Enhancements
  */
 
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
 add_action( 'wp_head', 'custom_open_graph_tags_with_sportspress_integration' );
 
-function custom_open_graph_tags_with_sportspress_integration() {
+/**
-    if (is_single()) {
+ * Return the head-to-head matchup image URL for an event.
-        global $post;
+ *
-        if ($post->post_type === 'sp_event') {
+ * @param int|WP_Post $post Post ID or object.
-            // Instantiate SP_Event object
+ * @return string
-            $event = new SP_Event($post->ID);
+ */
+function asc_sp_event_matchup_image_url( $post ) {
+	if ( is_numeric( $post ) ) {
+		$post = get_post( $post );
+	}
 
-            // Fetch details using SP_Event methods
+	if ( ! $post || 'sp_event' !== $post->post_type ) {
-            $publish_date = get_the_date('F j, Y', $post);
+		return '';
+	}
+
+	return get_site_url() . '/head-to-head?post=' . $post->ID;
+}
+
+/**
+ * Generate a display title for an sp_event using team short names.
+ *
+ * @param int|WP_Post $post Post ID or object.
+ * @return string
+ */
+function asc_generate_sp_event_title( $post ) {
+	if ( is_numeric( $post ) ) {
+		$post = get_post( $post );
+	}
+
+	if ( ! $post || $post->post_type !== 'sp_event' ) {
+		return get_the_title();
+	}
+
+	$teams = get_post_meta( $post->ID, 'sp_team', false );
+	$teams = array_filter( $teams );
+
+	$team_names = array();
+	foreach ( $teams as $team ) {
+		while ( is_array( $team ) ) {
+			$team = array_shift( array_filter( $team ) );
+		}
+		if ( $team > 0 ) {
+			$team_names[] = sp_team_short_name( $team );
+		}
+	}
+
+	$team_names = array_unique( $team_names );
+
+	if ( get_option( 'sportspress_event_reverse_teams', 'no' ) === 'yes' ) {
+		$team_names = array_reverse( $team_names );
+	}
+
+	$delimiter = ' ' . get_option( 'sportspress_event_teams_delimiter', 'vs' ) . ' ';
+
+	return implode( $delimiter, $team_names );
+}
+
+/**
+ * Format a short date string for an event.
+ *
+ * @param int|WP_Post $post     Post ID or object.
+ * @param bool        $withTime Whether to include the time.
+ * @return string
+ */
+function asc_generate_short_date( $post, $withTime = true ) {
+	$formatted_date = get_the_date( 'D n/j/y', $post );
+
+	if ( ! $withTime ) {
+		return $formatted_date;
+	}
+
+	if ( get_the_date( 'i', $post ) === '00' ) {
+		$formatted_time = get_the_date( 'gA', $post );
+	} else {
+		$formatted_time = get_the_date( 'g:iA', $post );
+	}
+
+	return $formatted_date . ' ' . $formatted_time;
+}
+
+/**
+ * Output Open Graph meta tags for sp_event single pages.
+ *
+ * @return void
+ */
+function custom_open_graph_tags_with_sportspress_integration() {
+	if ( ! is_single() ) {
+		return;
+	}
+
+	global $post;
+
+	if ( ! $post || $post->post_type !== 'sp_event' ) {
+		return;
+	}
+
+	$event                 = new SP_Event( $post->ID );
 	$venue_terms           = get_the_terms( $post->ID, 'sp_venue' );
-            $venue_name = $venue_terms ? $venue_terms[0]->name : 'No Venue Specified';
+	$venue_name            = ( $venue_terms && ! is_wp_error( $venue_terms ) ) ? $venue_terms[0]->name : 'Venue TBD';
-            $results = $event->results();  // Using SP_Event method
+	$title                 = asc_generate_sp_event_title( $post );
-            $title = get_the_title() . " " . "(" . $publish_date . ")";
 	$sp_status             = get_post_meta( $post->ID, 'sp_status', true );
-            $status = $event->status();  // Using SP_Event method
+	$status                = $event->status();
 	$publish_date_and_time = get_the_date( 'F j, Y g:i A', $post );
 	$description           = "{$publish_date_and_time} at {$venue_name}.";
-            if ( 'postponed' == $sp_status ) {
-              $description = "POSTPONED" . " - " . $description;
-              $title = "POSTPONED" . " - " . $title;
-            }
 
-            if ( 'results' == $status ) { // checks if there is a final score
+	if ( in_array( $sp_status, array( 'postponed', 'cancelled', 'tbd' ), true ) ) {
-              // Get event result data
+		$label       = strtoupper( $sp_status );
+		$description = "{$label} — {$description}";
+		$title       = "{$label} — {$title} — " . asc_generate_short_date( $post ) . " — {$venue_name}";
+	} elseif ( 'future' === $status ) {
+		$title = $title . ' — ' . asc_generate_short_date( $post ) . ' — ' . $venue_name;
+	} elseif ( 'results' === $status ) {
 		$data = $event->results();
 
-              // The first row should be column labels
+		// First row is column labels; remove it.
-              $labels = $data[0];
-
-              // Remove the first row to leave us with the actual data
 		unset( $data[0] );
-
 		$data = array_filter( $data );
 
-              if ( empty( $data ) ) {
+		if ( ! empty( $data ) ) {
-                return false;
+			if ( get_option( 'sportspress_event_reverse_teams', 'no' ) === 'yes' ) {
-              }
-
-              // Initialize
-              $i          = 0;
-              $result_string = '';
-              $title_string = '';
-
-              // Reverse teams order if the option "Events > Teams > Order > Reverse order" is enabled.
-              $reverse_teams = get_option( 'sportspress_event_reverse_teams', 'no' ) === 'yes' ? true : false;
-              if ( $reverse_teams ) {
 				$data = array_reverse( $data, true );
 			}
 
-              $teams_result_array = [];
+			$teams_result_array = array();
 
-              foreach ( $data as $team_id => $result ) :
+			foreach ( $data as $team_id => $result ) {
-                  $outcomes       = array();
 				$result_outcome = sp_array_value( $result, 'outcome' );
-                  if ( ! is_array( $result_outcome ) ) :
+				$the_outcome    = null;
-                    $outcomes = array( '&mdash;' );
+
-                  else :
+				if ( is_array( $result_outcome ) ) {
-                    foreach ( $result_outcome as $outcome ) :
+					foreach ( $result_outcome as $outcome_slug ) {
-                      $the_outcome = get_page_by_path( $outcome, OBJECT, 'sp_outcome' );
+						$found = get_page_by_path( $outcome_slug, OBJECT, 'sp_outcome' );
-                      if ( is_object( $the_outcome ) ) :
+						if ( is_object( $found ) ) {
-                        $outcomes[] = $the_outcome->post_title;
+							$the_outcome = $found;
-                      endif;
+							break;
-                    endforeach;
+						}
-                  endif;
+					}
+				}
 
 				unset( $result['outcome'] );
 
-                $team_name = sp_team_short_name( $team_id );
+				$outcome_title        = $the_outcome ? $the_outcome->post_title : '';
-
+				$outcome_abbreviation = '';
+				if ( $the_outcome ) {
 					$outcome_abbreviation = get_post_meta( $the_outcome->ID, 'sp_abbreviation', true );
 					if ( ! $outcome_abbreviation ) {
 						$outcome_abbreviation = sp_substr( $the_outcome->post_title, 0, 1 );
 					}
+				}
 
-                array_push($teams_result_array, [
+				$teams_result_array[] = array(
-                  "result" => $result,
+					'result'               => $result,
-                  "outcome" => $the_outcome->post_title,
+					'outcome'              => $outcome_title,
-                  "outcome_abbreviation" => $outcome_abbreviation,
+					'outcome_abbreviation' => $outcome_abbreviation,
-                  "team_name" => $team_name,
+					'team_name'            => sp_team_short_name( $team_id ),
-                ]
+					'team_abbreviation'    => sp_team_abbreviation( $team_id ),
 				);
-                $i++;
-              endforeach;
-              $publish_date = get_the_date('F j, Y', $post);
-              $title = "{$teams_result_array[0]['team_name']} {$teams_result_array[0]['result']['r']}-{$teams_result_array[1]['result']['r']} {$teams_result_array[1]['team_name']} ({$publish_date})";
-              $description .= " " . "{$teams_result_array[0]['team_name']} ({$teams_result_array[0]['outcome']}), {$teams_result_array[1]['team_name']} ({$teams_result_array[1]['outcome']}).";;
 			}
 
-            $description .= " " . $post->post_content;
+			if ( count( $teams_result_array ) >= 2 ) {
-            $image = get_site_url() . "/head-to-head?post={$post->ID}";
+				$special_abbreviation = '';
+				$special_label        = '';
+
+				foreach ( $teams_result_array as $team ) {
+					$abbr = strtoupper( $team['outcome_abbreviation'] );
+
+					if ( 'TF-W' === $abbr ) {
+						$special_abbreviation = 'TF-W';
+						$special_label        = 'Technical Forfeit Win';
+						break;
+					} elseif ( 'TF-L' === $abbr ) {
+						$special_abbreviation = 'TF';
+						$special_label        = 'Technical Forfeit';
+						break;
+					} elseif ( 'F-W' === $abbr || 'F-L' === $abbr ) {
+						$special_abbreviation = 'Forfeit';
+						$special_label        = 'Forfeit';
+						break;
+					}
+				}
+
+				$short_date = asc_generate_short_date( $post, false );
+				$t0         = $teams_result_array[0];
+				$t1         = $teams_result_array[1];
+				$score      = isset( $t0['result']['r'] ) && isset( $t1['result']['r'] )
+					? "{$t0['result']['r']}-{$t1['result']['r']}"
+					: '';
+				$suffix     = $special_label ? " ({$special_abbreviation})" : '';
+
+				$title       = "{$t0['team_name']} {$score} {$t1['team_name']} — {$short_date}{$suffix}";
+				$description .= " {$t0['team_name']} ({$t0['outcome']}), {$t1['team_name']} ({$t1['outcome']}).";
+			}
+		}
+	}
+
+	$description .= ' ' . $post->post_content;
+	$image        = asc_sp_event_matchup_image_url( $post );
+
 	echo '<meta property="og:type" content="article" />' . "\n";
-            echo '<meta property="og:image" content="'. $image . '" />' . "\n";
+	echo '<meta property="og:image" content="' . esc_url( $image ) . '" />' . "\n";
-            echo '<meta property="og:title" content="' . $title . '" />' . "\n";
+	echo '<meta property="og:title" content="' . esc_attr( $title ) . '" />' . "\n";
-            echo '<meta property="og:description" content="' . $description . '" />' . "\n";
+	echo '<meta property="og:description" content="' . esc_attr( $description ) . '" />' . "\n";
-            echo '<meta property="og:url" content="' . get_permalink() . '" />' . "\n";
+	echo '<meta property="og:url" content="' . esc_url( get_permalink() ) . '" />' . "\n";
 }
-    }
-}
-?>

includes/sp-event-admin-week-filter.php

@@ -10,6 +10,183 @@ if ( ! defined( 'ABSPATH' ) ) {
 	exit;
 }
 
+/**
+ * Screen-option defaults for event list filters.
+ *
+ * @return array<string, bool>
+ */
+function tony_sportspress_event_filter_defaults() {
+	return array(
+		'month'     => true,
+		'week'      => false,
+		'team'      => true,
+		'venue'     => true,
+		'league'    => true,
+		'season'    => true,
+		'match_day' => true,
+	);
+}
+
+/**
+ * Build user meta key for an event filter screen option.
+ *
+ * @param string $key Filter key.
+ * @return string
+ */
+function tony_sportspress_event_filter_meta_key( $key ) {
+	return 'tony_sp_event_filter_' . $key;
+}
+
+/**
+ * Get the current singular label for event venues.
+ *
+ * @return string
+ */
+function tony_sportspress_get_event_venue_label() {
+	$taxonomy = get_taxonomy( 'sp_venue' );
+
+	if ( $taxonomy && ! empty( $taxonomy->labels->singular_name ) ) {
+		return (string) $taxonomy->labels->singular_name;
+	}
+
+	return __( 'Venue', 'sportspress' );
+}
+
+/**
+ * Get the current plural label for event venues.
+ *
+ * @return string
+ */
+function tony_sportspress_get_event_venue_label_plural() {
+	$taxonomy = get_taxonomy( 'sp_venue' );
+
+	if ( $taxonomy && ! empty( $taxonomy->labels->name ) ) {
+		return (string) $taxonomy->labels->name;
+	}
+
+	return __( 'Venues', 'sportspress' );
+}
+
+/**
+ * Normalize event filter visibility rules.
+ *
+ * Month/Year and Week are mutually exclusive.
+ *
+ * @param array<string, bool> $filters Filter states keyed by filter name.
+ * @return array<string, bool>
+ */
+function tony_sportspress_normalize_event_filter_states( $filters ) {
+	if ( ! empty( $filters['month'] ) && ! empty( $filters['week'] ) ) {
+		$filters['week'] = false;
+	}
+
+	return $filters;
+}
+
+/**
+ * Check whether a filter is enabled for the current user.
+ *
+ * @param string $key Filter key.
+ * @return bool
+ */
+function tony_sportspress_event_filter_enabled( $key ) {
+	$defaults = tony_sportspress_normalize_event_filter_states( tony_sportspress_event_filter_defaults() );
+	if ( ! array_key_exists( $key, $defaults ) ) {
+		return true;
+	}
+
+	$user_id = get_current_user_id();
+	if ( ! $user_id ) {
+		return (bool) $defaults[ $key ];
+	}
+
+	$stored = get_user_meta( $user_id, tony_sportspress_event_filter_meta_key( $key ), true );
+	if ( '' === $stored ) {
+		return (bool) $defaults[ $key ];
+	}
+
+	$states = array();
+	foreach ( $defaults as $filter_key => $enabled ) {
+		$current = get_user_meta( $user_id, tony_sportspress_event_filter_meta_key( $filter_key ), true );
+		$states[ $filter_key ] = '' === $current ? (bool) $enabled : '1' === (string) $current;
+	}
+
+	$states = tony_sportspress_normalize_event_filter_states( $states );
+
+	return ! empty( $states[ $key ] );
+}
+
+/**
+ * Persist event filter Screen Options via AJAX.
+ */
+function tony_sportspress_save_event_filter_screen_options_ajax() {
+	if ( ! current_user_can( 'edit_posts' ) ) {
+		wp_send_json_error();
+	}
+
+	check_ajax_referer( 'tony_sp_event_filters', 'nonce' );
+
+	$defaults = tony_sportspress_normalize_event_filter_states( tony_sportspress_event_filter_defaults() );
+	$filters  = isset( $_POST['filters'] ) && is_array( $_POST['filters'] ) ? $_POST['filters'] : array();
+	$user_id  = get_current_user_id();
+
+	$states = array();
+
+	foreach ( $defaults as $key => $_enabled ) {
+		$value = isset( $filters[ $key ] ) ? sanitize_text_field( wp_unslash( $filters[ $key ] ) ) : '0';
+		$states[ $key ] = '1' === $value;
+	}
+
+	$states = tony_sportspress_normalize_event_filter_states( $states );
+
+	foreach ( $states as $key => $enabled ) {
+		update_user_meta( $user_id, tony_sportspress_event_filter_meta_key( $key ), $enabled ? '1' : '0' );
+	}
+
+	wp_send_json_success();
+}
+add_action( 'wp_ajax_tony_sp_event_filter_prefs_save', 'tony_sportspress_save_event_filter_screen_options_ajax' );
+
+/**
+ * Add filter visibility toggles to Screen Options on event list admin page.
+ *
+ * @param string    $settings Existing settings HTML.
+ * @param WP_Screen $screen   Current screen.
+ * @return string
+ */
+function tony_sportspress_event_filter_screen_options_markup( $settings, $screen ) {
+	if ( ! $screen || 'edit-sp_event' !== $screen->id ) {
+		return $settings;
+	}
+
+	$labels = array(
+		'month'     => __( 'Month/Year', 'tonys-sportspress-enhancements' ),
+		'week'      => __( 'Year/Week', 'tonys-sportspress-enhancements' ),
+		'team'      => __( 'Team', 'tonys-sportspress-enhancements' ),
+		'venue'     => tony_sportspress_get_event_venue_label(),
+		'league'    => __( 'League', 'tonys-sportspress-enhancements' ),
+		'season'    => __( 'Season', 'tonys-sportspress-enhancements' ),
+		'match_day' => __( 'Match Day', 'tonys-sportspress-enhancements' ),
+	);
+
+	$settings .= '<fieldset class="metabox-prefs">';
+	$settings .= '<legend>' . esc_html__( 'Event Filters', 'tonys-sportspress-enhancements' ) . '</legend>';
+
+	foreach ( $labels as $key => $label ) {
+		$meta_key = tony_sportspress_event_filter_meta_key( $key );
+		$checked  = tony_sportspress_event_filter_enabled( $key ) ? ' checked="checked"' : '';
+		$settings .= '<label for="' . esc_attr( $meta_key ) . '">';
+		$settings .= '<input type="checkbox" id="' . esc_attr( $meta_key ) . '" name="' . esc_attr( $meta_key ) . '" value="1"' . $checked . ' />';
+		$settings .= esc_html( $label );
+		$settings .= '</label>';
+	}
+
+	$settings .= '</fieldset>';
+
+	return $settings;
+}
+add_filter( 'screen_settings', 'tony_sportspress_event_filter_screen_options_markup', 10, 2 );
+
 /**
  * Parse an ISO week input (e.g. 2026-W07) from the request.
  *
@@ -21,6 +198,20 @@ function tony_sportspress_parse_admin_week_filter() {
 	}
 
 	$raw      = sanitize_text_field( wp_unslash( $_GET['sp_week_filter'] ) );
+	$timezone = wp_timezone();
+
+	if ( 'this-week' === $raw || 'next-week' === $raw ) {
+		$base = new DateTimeImmutable( 'now', $timezone );
+		if ( 'next-week' === $raw ) {
+			$base = $base->modify( '+1 week' );
+		}
+
+		return array(
+			'year' => (int) $base->format( 'o' ),
+			'week' => (int) $base->format( 'W' ),
+		);
+	}
+
 	if ( ! preg_match( '/^(\d{4})-W(0[1-9]|[1-4][0-9]|5[0-3])$/', $raw, $matches ) ) {
 		return null;
 	}
@@ -34,6 +225,66 @@ function tony_sportspress_parse_admin_week_filter() {
 	);
 }
 
+/**
+ * Get available ISO week options from event post dates.
+ *
+ * @return array<int, array{value:string,label:string}>
+ */
+function tony_sportspress_get_admin_week_filter_options() {
+	global $wpdb;
+
+	$results = $wpdb->get_results(
+		$wpdb->prepare(
+			"SELECT DISTINCT DATE_FORMAT(post_date, '%%x-W%%v') AS iso_week
+			FROM {$wpdb->posts}
+			WHERE post_type = %s
+				AND post_status NOT IN ('auto-draft', 'trash')
+				AND post_date IS NOT NULL
+				AND post_date <> '0000-00-00 00:00:00'
+			ORDER BY iso_week DESC",
+			'sp_event'
+		),
+		ARRAY_A
+	);
+
+	if ( ! is_array( $results ) || empty( $results ) ) {
+		return array();
+	}
+
+	$options  = array();
+	$timezone = wp_timezone();
+
+	foreach ( $results as $result ) {
+		if ( empty( $result['iso_week'] ) || ! preg_match( '/^(\d{4})-W(0[1-9]|[1-4][0-9]|5[0-3])$/', $result['iso_week'], $matches ) ) {
+			continue;
+		}
+
+		$year   = (int) $matches[1];
+		$week   = (int) $matches[2];
+		$monday = ( new DateTimeImmutable( 'now', $timezone ) )->setISODate( $year, $week, 1 )->setTime( 0, 0, 0 );
+		$sunday = $monday->modify( '+6 days' );
+		$start_label = wp_date( 'M j', $monday->getTimestamp(), $timezone );
+		$end_label   = wp_date(
+			$monday->format( 'n' ) === $sunday->format( 'n' ) ? 'j' : 'M j',
+			$sunday->getTimestamp(),
+			$timezone
+		);
+
+		$options[] = array(
+			'value' => $result['iso_week'],
+			/* translators: 1: ISO week code, 2: Monday date, 3: Sunday date. */
+			'label' => sprintf(
+				__( '%1$s (%2$s to %3$s)', 'tonys-sportspress-enhancements' ),
+				$result['iso_week'],
+				$start_label,
+				$end_label
+			),
+		);
+	}
+
+	return $options;
+}
+
 /**
  * Render week filter control in event admin list.
  *
@@ -43,36 +294,32 @@ function tony_sportspress_render_admin_week_filter( $post_type ) {
 	if ( 'sp_event' !== $post_type ) {
 		return;
 	}
+	if ( ! tony_sportspress_event_filter_enabled( 'week' ) ) {
+		return;
+	}
 
 	$value = '';
 	if ( ! empty( $_GET['sp_week_filter'] ) ) {
 		$value = sanitize_text_field( wp_unslash( $_GET['sp_week_filter'] ) );
 	}
-
+	$options = tony_sportspress_get_admin_week_filter_options();
-	$summary_text = __( 'Select a week', 'tonys-sportspress-enhancements' );
-	$parsed       = tony_sportspress_parse_admin_week_filter();
-	if ( is_array( $parsed ) ) {
-		$timezone = wp_timezone();
-		$monday   = ( new DateTimeImmutable( 'now', $timezone ) )->setISODate( $parsed['year'], $parsed['week'], 1 )->setTime( 0, 0, 0 );
-		$sunday   = $monday->modify( '+6 days' )->setTime( 23, 59, 59 );
-		/* translators: 1: Monday label/date, 2: Sunday label/date. */
-		$summary_text = sprintf(
-			__( '%1$s to %2$s', 'tonys-sportspress-enhancements' ),
-			wp_date( 'D M j, Y', $monday->getTimestamp(), $timezone ),
-			wp_date( 'D M j, Y', $sunday->getTimestamp(), $timezone )
-		);
-	}
 	?>
 	<label for="sp_week_filter" class="screen-reader-text"><?php esc_html_e( 'Filter by week', 'tonys-sportspress-enhancements' ); ?></label>
-	<input
+	<select
-		type="week"
 		id="sp_week_filter"
 		name="sp_week_filter"
 		class="sp-week-filter-field"
-		value="<?php echo esc_attr( $value ); ?>"
 		title="<?php esc_attr_e( 'Week (Monday start)', 'tonys-sportspress-enhancements' ); ?>"
-	/>
+	>
-	<span id="sp-week-filter-summary" class="sp-week-filter-summary"><?php echo esc_html( $summary_text ); ?></span>
+		<option value=""><?php esc_html_e( 'Year/Week', 'tonys-sportspress-enhancements' ); ?></option>
+		<option value="this-week" <?php selected( $value, 'this-week' ); ?>><?php esc_html_e( 'This week', 'tonys-sportspress-enhancements' ); ?></option>
+		<option value="next-week" <?php selected( $value, 'next-week' ); ?>><?php esc_html_e( 'Next week', 'tonys-sportspress-enhancements' ); ?></option>
+		<?php foreach ( $options as $option ) : ?>
+			<option value="<?php echo esc_attr( $option['value'] ); ?>" <?php selected( $value, $option['value'] ); ?>>
+				<?php echo esc_html( $option['label'] ); ?>
+			</option>
+		<?php endforeach; ?>
+	</select>
 	<?php
 }
 add_action( 'restrict_manage_posts', 'tony_sportspress_render_admin_week_filter' );
@@ -85,8 +332,46 @@ function tony_sportspress_admin_week_filter_styles() {
 	if ( ! $screen || 'edit-sp_event' !== $screen->id ) {
 		return;
 	}
+	$hide = array(
+		'month'     => ! tony_sportspress_event_filter_enabled( 'month' ),
+		'team'      => ! tony_sportspress_event_filter_enabled( 'team' ),
+		'venue'     => ! tony_sportspress_event_filter_enabled( 'venue' ),
+		'league'    => ! tony_sportspress_event_filter_enabled( 'league' ),
+		'season'    => ! tony_sportspress_event_filter_enabled( 'season' ),
+		'match_day' => ! tony_sportspress_event_filter_enabled( 'match_day' ),
+		'week'      => ! tony_sportspress_event_filter_enabled( 'week' ),
+	);
 	?>
 	<style>
+		<?php if ( $hide['month'] ) : ?>
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="m"] { display: none !important; }
+		<?php endif; ?>
+		<?php if ( $hide['team'] ) : ?>
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="team"],
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="team"] + .chosen-container,
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="team"] + .select2 { display: none !important; }
+		<?php endif; ?>
+		<?php if ( $hide['venue'] ) : ?>
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_venue"],
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_venue"] + .chosen-container,
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_venue"] + .select2 { display: none !important; }
+		<?php endif; ?>
+		<?php if ( $hide['league'] ) : ?>
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_league"],
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_league"] + .chosen-container,
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_league"] + .select2 { display: none !important; }
+		<?php endif; ?>
+		<?php if ( $hide['season'] ) : ?>
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_season"],
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_season"] + .chosen-container,
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) select[name="sp_season"] + .select2 { display: none !important; }
+		<?php endif; ?>
+		<?php if ( $hide['match_day'] ) : ?>
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) input[name="match_day"] { display: none !important; }
+		<?php endif; ?>
+		<?php if ( $hide['week'] ) : ?>
+		.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) #sp_week_filter { display: none !important; }
+		<?php endif; ?>
 		@media (max-width: 1200px) {
 			.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) {
 				display: flex;
@@ -101,14 +386,6 @@ function tony_sportspress_admin_week_filter_styles() {
 			.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) .sp-week-filter-field {
 				min-width: 145px;
 			}
-			.post-type-sp_event .tablenav.top .alignleft.actions:not(.bulkactions) .sp-week-filter-summary {
-				display: block;
-				width: 100%;
-				margin-top: 2px;
-				color: #50575e;
-				font-size: 12px;
-				line-height: 1.4;
-			}
 		}
 	</style>
 	<?php
@@ -116,56 +393,89 @@ function tony_sportspress_admin_week_filter_styles() {
 add_action( 'admin_head-edit.php', 'tony_sportspress_admin_week_filter_styles' );
 
 /**
- * Update week summary text when week input changes.
+ * Update admin filter labels and persist screen options.
  */
 function tony_sportspress_admin_week_filter_script() {
 	$screen = get_current_screen();
 	if ( ! $screen || 'edit-sp_event' !== $screen->id ) {
 		return;
 	}
+
+	$venue_filter_text = sprintf(
+		/* translators: %s: plural venue label. */
+		__( 'Show all %s', 'sportspress' ),
+		strtolower( tony_sportspress_get_event_venue_label_plural() )
+	);
 	?>
 	<script>
 	(function() {
-		const input = document.getElementById('sp_week_filter');
+		const filterCheckboxes = Array.from(
-		const summary = document.getElementById('sp-week-filter-summary');
+			document.querySelectorAll('#screen-options-wrap input[type="checkbox"][id^="tony_sp_event_filter_"]')
-		if (!input || !summary) {
+		);
+		const monthCheckbox = document.getElementById('tony_sp_event_filter_month');
+		const weekCheckbox = document.getElementById('tony_sp_event_filter_week');
+
+		function syncExclusiveFilters(changedCheckbox) {
+			if (!changedCheckbox || !changedCheckbox.checked) {
 				return;
 			}
 
-		function updateSummary() {
+			if (changedCheckbox === monthCheckbox && weekCheckbox) {
-			const raw = (input.value || '').trim();
+				weekCheckbox.checked = false;
-			const match = raw.match(/^(\d{4})-W(\d{2})$/);
+			}
-			if (!match) {
+
-				summary.textContent = 'Select a week';
+			if (changedCheckbox === weekCheckbox && monthCheckbox) {
+				monthCheckbox.checked = false;
+			}
+		}
+
+		function saveFilterPrefs() {
+			if (!filterCheckboxes.length || typeof ajaxurl === 'undefined') {
 				return;
 			}
 
-			const year = parseInt(match[1], 10);
+			const body = new URLSearchParams();
-			const week = parseInt(match[2], 10);
+			body.append('action', 'tony_sp_event_filter_prefs_save');
+			body.append('nonce', <?php echo wp_json_encode( wp_create_nonce( 'tony_sp_event_filters' ) ); ?>);
 
-			const jan4 = new Date(Date.UTC(year, 0, 4));
+			filterCheckboxes.forEach(function(checkbox) {
-			const jan4Day = jan4.getUTCDay() || 7;
+				const key = checkbox.id.replace('tony_sp_event_filter_', '');
-			const mondayWeek1 = new Date(jan4);
+				body.append('filters[' + key + ']', checkbox.checked ? '1' : '0');
-			mondayWeek1.setUTCDate(jan4.getUTCDate() - jan4Day + 1);
-
-			const monday = new Date(mondayWeek1);
-			monday.setUTCDate(mondayWeek1.getUTCDate() + (week - 1) * 7);
-			const sunday = new Date(monday);
-			sunday.setUTCDate(monday.getUTCDate() + 6);
-
-			const fmt = new Intl.DateTimeFormat(undefined, {
-				weekday: 'short',
-				month: 'short',
-				day: 'numeric',
-				year: 'numeric',
-				timeZone: 'UTC'
 			});
 
-			summary.textContent = fmt.format(monday) + ' to ' + fmt.format(sunday);
+			fetch(ajaxurl, {
+				method: 'POST',
+				credentials: 'same-origin',
+				headers: {
+					'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
+				},
+				body: body.toString(),
+				keepalive: true
+			}).catch(function() {});
 		}
 
-		input.addEventListener('change', updateSummary);
+		filterCheckboxes.forEach(function(checkbox) {
-		updateSummary();
+			checkbox.addEventListener('change', function() {
+				syncExclusiveFilters(checkbox);
+				saveFilterPrefs();
+			});
+		});
+
+		const monthSelect = document.querySelector('select[name="m"]');
+		if (monthSelect) {
+			const allDates = monthSelect.querySelector('option[value="0"]');
+			if (allDates) {
+				allDates.textContent = <?php echo wp_json_encode( __( 'Month/Year', 'tonys-sportspress-enhancements' ) ); ?>;
+			}
+		}
+
+		const venueSelect = document.querySelector('select[name="sp_venue"]');
+		if (venueSelect) {
+			const allVenues = venueSelect.querySelector('option[value="0"]');
+			if (allVenues) {
+				allVenues.textContent = <?php echo wp_json_encode( $venue_filter_text ); ?>;
+			}
+		}
 	})();
 	</script>
 	<?php

includes/sp-event-export.php

@@ -0,0 +1,928 @@
+<?php
+/**
+ * Standalone SportsPress schedule feeds.
+ *
+ * @package Tonys_Sportspress_Enhancements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Register the standalone SportsPress CSV feed endpoint.
+ *
+ * @return void
+ */
+function tse_sp_event_export_register_feed() {
+	add_feed( 'sp-csv', 'tse_sp_event_export_render_feed' );
+	add_feed( 'sp-ics', 'tse_sp_event_export_render_ical_feed' );
+}
+add_action( 'init', 'tse_sp_event_export_register_feed', 20 );
+
+/**
+ * Get available export formats.
+ *
+ * @return array
+ */
+function tse_sp_event_export_get_formats() {
+	return array(
+		'matchup' => array(
+			'label'       => __( 'Matchup', 'tonys-sportspress-enhancements' ),
+			'description' => __( 'Date, time, away team, home team, and field columns.', 'tonys-sportspress-enhancements' ),
+		),
+		'team'    => array(
+			'label'       => __( 'Team', 'tonys-sportspress-enhancements' ),
+			'description' => __( 'Team-centric schedule rows with opponent and home/away columns.', 'tonys-sportspress-enhancements' ),
+		),
+	);
+}
+
+/**
+ * Get available export columns grouped by format.
+ *
+ * @return array
+ */
+function tse_sp_event_export_get_column_definitions() {
+	return array(
+		'matchup' => array(
+			'date'                => __( 'Date', 'tonys-sportspress-enhancements' ),
+			'time'                => __( 'Time', 'tonys-sportspress-enhancements' ),
+			'season'              => __( 'Season', 'tonys-sportspress-enhancements' ),
+			'league'              => __( 'League', 'tonys-sportspress-enhancements' ),
+			'away_team'           => __( 'Away Team', 'tonys-sportspress-enhancements' ),
+			'home_team'           => __( 'Home Team', 'tonys-sportspress-enhancements' ),
+			'field_name'          => __( 'Field Name', 'tonys-sportspress-enhancements' ),
+			'field_address'       => __( 'Field Address', 'tonys-sportspress-enhancements' ),
+			'officials'           => __( 'Officials', 'tonys-sportspress-enhancements' ),
+		),
+		'team'    => array(
+			'label'               => __( 'Extra Label', 'tonys-sportspress-enhancements' ),
+			'date'                => __( 'Date', 'tonys-sportspress-enhancements' ),
+			'time'                => __( 'Time', 'tonys-sportspress-enhancements' ),
+			'season'              => __( 'Season', 'tonys-sportspress-enhancements' ),
+			'league'              => __( 'League', 'tonys-sportspress-enhancements' ),
+			'team_name'           => __( 'Team', 'tonys-sportspress-enhancements' ),
+			'opponent_name'       => __( 'Opponent', 'tonys-sportspress-enhancements' ),
+			'location_flag'       => __( 'Home/Away', 'tonys-sportspress-enhancements' ),
+			'field_name'          => __( 'Field Name', 'tonys-sportspress-enhancements' ),
+			'field_address'       => __( 'Field Address', 'tonys-sportspress-enhancements' ),
+			'field_abbreviation'  => __( 'Field Abbreviation', 'tonys-sportspress-enhancements' ),
+			'field_short_name'    => __( 'Field Short Name', 'tonys-sportspress-enhancements' ),
+			'officials'           => __( 'Officials', 'tonys-sportspress-enhancements' ),
+			'home_team'           => __( 'Home Team', 'tonys-sportspress-enhancements' ),
+			'away_team'           => __( 'Away Team', 'tonys-sportspress-enhancements' ),
+		),
+	);
+}
+
+/**
+ * Get default columns for an export format.
+ *
+ * @param string $format Export format.
+ * @return array
+ */
+function tse_sp_event_export_get_default_columns( $format ) {
+	$defaults = array(
+		'matchup' => array( 'date', 'time', 'season', 'league', 'away_team', 'home_team', 'field_name' ),
+		'team'    => array( 'label', 'date', 'time', 'season', 'league', 'opponent_name', 'location_flag', 'field_name' ),
+	);
+
+	return isset( $defaults[ $format ] ) ? $defaults[ $format ] : $defaults['matchup'];
+}
+
+/**
+ * Sanitize an export format.
+ *
+ * @param string $format Raw format.
+ * @return string
+ */
+function tse_sp_event_export_sanitize_format( $format ) {
+	$format  = sanitize_key( (string) $format );
+	$formats = tse_sp_event_export_get_formats();
+
+	return isset( $formats[ $format ] ) ? $format : 'matchup';
+}
+
+/**
+ * Sanitize requested columns for an export format.
+ *
+ * @param string       $format  Export format.
+ * @param string|array $columns Requested columns.
+ * @return array
+ */
+function tse_sp_event_export_sanitize_columns( $format, $columns ) {
+	$definitions = tse_sp_event_export_get_column_definitions();
+	$available   = isset( $definitions[ $format ] ) ? $definitions[ $format ] : array();
+
+	if ( ! is_array( $columns ) ) {
+		$columns = explode( ',', (string) $columns );
+	}
+
+	$sanitized = array();
+
+	foreach ( $columns as $column ) {
+		$key = sanitize_key( (string) $column );
+		if ( '' === $key || ! isset( $available[ $key ] ) || in_array( $key, $sanitized, true ) ) {
+			continue;
+		}
+
+		$sanitized[] = $key;
+	}
+
+	if ( empty( $sanitized ) ) {
+		return tse_sp_event_export_get_default_columns( $format );
+	}
+
+	return $sanitized;
+}
+
+/**
+ * Normalize one or more numeric IDs from a request value.
+ *
+ * Accepts scalars, arrays, and comma-delimited strings.
+ *
+ * @param mixed $value Raw request value.
+ * @return int[]
+ */
+function tse_sp_event_export_parse_id_list( $value ) {
+	if ( is_array( $value ) ) {
+		$raw_values = $value;
+	} else {
+		$raw_values = explode( ',', (string) $value );
+	}
+
+	$ids = array();
+
+	foreach ( $raw_values as $raw_value ) {
+		$id = absint( trim( (string) $raw_value ) );
+		if ( $id > 0 ) {
+			$ids[] = $id;
+		}
+	}
+
+	$ids = array_values( array_unique( $ids ) );
+
+	return $ids;
+}
+
+/**
+ * Normalize export request arguments.
+ *
+ * @param array|null $source Optional input source.
+ * @return array
+ */
+function tse_sp_event_export_normalize_request_args( $source = null ) {
+	$source = is_array( $source ) ? $source : $_GET;
+	$format = isset( $source['format'] ) ? tse_sp_event_export_sanitize_format( wp_unslash( $source['format'] ) ) : 'matchup';
+	$team_ids = isset( $source['team_id'] ) ? tse_sp_event_export_parse_id_list( wp_unslash( $source['team_id'] ) ) : array();
+	$season_ids = isset( $source['season_id'] ) ? tse_sp_event_export_parse_id_list( wp_unslash( $source['season_id'] ) ) : array();
+	$league_ids = isset( $source['league_id'] ) ? tse_sp_event_export_parse_id_list( wp_unslash( $source['league_id'] ) ) : array();
+	$field_ids = isset( $source['field_id'] ) ? tse_sp_event_export_parse_id_list( wp_unslash( $source['field_id'] ) ) : array();
+
+	return array(
+		'team_id'    => isset( $team_ids[0] ) ? $team_ids[0] : 0,
+		'team_ids'   => $team_ids,
+		'season_id'  => isset( $season_ids[0] ) ? $season_ids[0] : 0,
+		'season_ids' => $season_ids,
+		'league_id'  => isset( $league_ids[0] ) ? $league_ids[0] : 0,
+		'league_ids' => $league_ids,
+		'field_id'   => isset( $field_ids[0] ) ? $field_ids[0] : 0,
+		'field_ids'  => $field_ids,
+		'format'     => $format,
+		'columns'    => isset( $source['columns'] ) ? tse_sp_event_export_sanitize_columns( $format, wp_unslash( $source['columns'] ) ) : tse_sp_event_export_get_default_columns( $format ),
+	);
+}
+
+/**
+ * Validate export filters for the requested format.
+ *
+ * @param array $filters Export filters.
+ * @return void
+ */
+function tse_sp_event_export_validate_filters( $filters ) {
+	$format   = tse_sp_event_export_sanitize_format( isset( $filters['format'] ) ? $filters['format'] : 'matchup' );
+	$team_ids = isset( $filters['team_ids'] ) && is_array( $filters['team_ids'] ) ? $filters['team_ids'] : array();
+
+	if ( 'team' !== $format ) {
+		return;
+	}
+
+	if ( empty( $team_ids ) ) {
+		wp_die( esc_html__( 'Team format requires a team filter.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 400 ) );
+	}
+
+	if ( count( $team_ids ) > 1 ) {
+		wp_die( esc_html__( 'Team format does not support multiple teams.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 400 ) );
+	}
+}
+
+/**
+ * Query matching event posts for export.
+ *
+ * @param array $filters Export filters.
+ * @return WP_Post[]
+ */
+function tse_sp_event_export_query_posts( $filters ) {
+	$team_ids   = isset( $filters['team_ids'] ) && is_array( $filters['team_ids'] ) ? array_values( array_filter( array_map( 'absint', $filters['team_ids'] ) ) ) : array();
+	$season_ids = isset( $filters['season_ids'] ) && is_array( $filters['season_ids'] ) ? array_values( array_filter( array_map( 'absint', $filters['season_ids'] ) ) ) : array();
+	$league_ids = isset( $filters['league_ids'] ) && is_array( $filters['league_ids'] ) ? array_values( array_filter( array_map( 'absint', $filters['league_ids'] ) ) ) : array();
+	$field_ids  = isset( $filters['field_ids'] ) && is_array( $filters['field_ids'] ) ? array_values( array_filter( array_map( 'absint', $filters['field_ids'] ) ) ) : array();
+
+	$args = array(
+		'post_type'      => 'sp_event',
+		'post_status'    => array( 'publish', 'future' ),
+		'posts_per_page' => -1,
+		'orderby'        => 'date',
+		'order'          => 'ASC',
+		'no_found_rows'  => true,
+	);
+
+	if ( ! empty( $team_ids ) ) {
+		$args['meta_query'] = array(
+			array(
+				'key'     => 'sp_team',
+				'value'   => array_map( 'strval', $team_ids ),
+				'compare' => 'IN',
+			),
+		);
+	}
+
+	$tax_query = array();
+
+	if ( ! empty( $season_ids ) ) {
+		$tax_query[] = array(
+			'taxonomy' => 'sp_season',
+			'field'    => 'term_id',
+			'terms'    => $season_ids,
+		);
+	}
+
+	if ( ! empty( $league_ids ) ) {
+		$tax_query[] = array(
+			'taxonomy' => 'sp_league',
+			'field'    => 'term_id',
+			'terms'    => $league_ids,
+		);
+	}
+
+	if ( ! empty( $field_ids ) ) {
+		$tax_query[] = array(
+			'taxonomy' => 'sp_venue',
+			'field'    => 'term_id',
+			'terms'    => $field_ids,
+		);
+	}
+
+	if ( ! empty( $tax_query ) ) {
+		if ( count( $tax_query ) > 1 ) {
+			$tax_query['relation'] = 'AND';
+		}
+
+		$args['tax_query'] = $tax_query;
+	}
+
+	$query = new WP_Query( $args );
+
+	return is_array( $query->posts ) ? $query->posts : array();
+}
+
+/**
+ * Query matching schedule events for export.
+ *
+ * @param array $filters Export filters.
+ * @return array
+ */
+function tse_sp_event_export_get_events( $filters ) {
+	$team_id     = isset( $filters['team_id'] ) ? absint( $filters['team_id'] ) : 0;
+	$selected_ids = isset( $filters['team_ids'] ) && is_array( $filters['team_ids'] ) ? array_values( array_filter( array_map( 'absint', $filters['team_ids'] ) ) ) : array();
+	$query_posts = tse_sp_event_export_query_posts( $filters );
+	$events     = array();
+	$team_name = $team_id > 0 ? get_the_title( $team_id ) : '';
+
+	foreach ( $query_posts as $event ) {
+		$event_id = $event instanceof WP_Post ? (int) $event->ID : 0;
+		if ( $event_id <= 0 ) {
+			continue;
+		}
+
+		$teams = array_values( array_unique( array_map( 'intval', get_post_meta( $event_id, 'sp_team', false ) ) ) );
+		if ( ! empty( $selected_ids ) && empty( array_intersect( $selected_ids, $teams ) ) ) {
+			continue;
+		}
+
+		$home_id = isset( $teams[0] ) ? (int) $teams[0] : 0;
+		$away_id = isset( $teams[1] ) ? (int) $teams[1] : 0;
+		$venue   = tse_sp_event_export_get_primary_field( $event_id );
+
+		if ( $team_id > 0 ) {
+			$location_flag = $home_id === $team_id ? 'Home' : 'Away';
+			$opponent_id   = $home_id === $team_id ? $away_id : $home_id;
+		} else {
+			$location_flag = '';
+			$opponent_id   = 0;
+		}
+
+		$events[] = array(
+			'event_id'            => $event_id,
+			'label'               => '',
+			'date'                => get_post_time( 'm/d/Y', false, $event_id, true ),
+			'time'                => strtoupper( (string) ( function_exists( 'sp_get_time' ) ? sp_get_time( $event_id ) : get_post_time( get_option( 'time_format' ), false, $event_id, true ) ) ),
+			'team_name'           => is_string( $team_name ) ? $team_name : '',
+			'opponent_name'       => $opponent_id > 0 ? get_the_title( $opponent_id ) : '',
+			'location_flag'       => $location_flag,
+			'home_team'           => $home_id > 0 ? get_the_title( $home_id ) : '',
+			'away_team'           => $away_id > 0 ? get_the_title( $away_id ) : '',
+			'field_name'          => isset( $venue['name'] ) ? $venue['name'] : '',
+			'field_address'       => isset( $venue['address'] ) ? $venue['address'] : '',
+			'field_abbreviation'  => isset( $venue['abbreviation'] ) ? $venue['abbreviation'] : '',
+			'field_short_name'    => isset( $venue['short_name'] ) ? $venue['short_name'] : '',
+			'season'              => tse_sp_event_export_get_event_term_names( $event_id, 'sp_season' ),
+			'league'              => tse_sp_event_export_get_event_term_names( $event_id, 'sp_league' ),
+			'officials'           => tse_sp_event_export_get_officials_value( $event_id ),
+		);
+	}
+
+	foreach ( $events as $index => $event ) {
+		$events[ $index ]['label'] = sprintf( 'G#%02d', $index + 1 );
+	}
+
+	wp_reset_postdata();
+
+	return $events;
+}
+
+/**
+ * Get event term names as a semicolon-delimited string.
+ *
+ * @param int    $event_id  Event ID.
+ * @param string $taxonomy  Taxonomy name.
+ * @return string
+ */
+function tse_sp_event_export_get_event_term_names( $event_id, $taxonomy ) {
+	$terms = get_the_terms( $event_id, $taxonomy );
+
+	if ( ! is_array( $terms ) || empty( $terms ) ) {
+		return '';
+	}
+
+	$names = array_values( array_filter( array_map( 'strval', wp_list_pluck( $terms, 'name' ) ) ) );
+
+	return implode( '; ', array_unique( $names ) );
+}
+
+/**
+ * Get primary field metadata for an event.
+ *
+ * @param int $event_id Event ID.
+ * @return array
+ */
+function tse_sp_event_export_get_primary_field( $event_id ) {
+	$venues = get_the_terms( $event_id, 'sp_venue' );
+
+	if ( ! is_array( $venues ) || ! isset( $venues[0] ) || ! $venues[0] instanceof WP_Term ) {
+		return array(
+			'name'         => '',
+			'address'      => '',
+			'abbreviation' => '',
+			'short_name'   => '',
+		);
+	}
+
+	$venue = $venues[0];
+	$meta  = get_option( 'taxonomy_' . $venue->term_id );
+
+	return array(
+		'name'         => isset( $venue->name ) ? (string) $venue->name : '',
+		'address'      => is_array( $meta ) && isset( $meta['sp_address'] ) ? trim( (string) $meta['sp_address'] ) : '',
+		'abbreviation' => trim( (string) get_term_meta( $venue->term_id, 'tse_abbreviation', true ) ),
+		'short_name'   => trim( (string) get_term_meta( $venue->term_id, 'tse_short_name', true ) ),
+	);
+}
+
+/**
+ * Get event officials as a semicolon-delimited string.
+ *
+ * @param int $event_id Event ID.
+ * @return string
+ */
+function tse_sp_event_export_get_officials_value( $event_id ) {
+	$official_groups = get_post_meta( $event_id, 'sp_officials', true );
+
+	if ( ! is_array( $official_groups ) || empty( $official_groups ) ) {
+		return '';
+	}
+
+	$official_names = array();
+
+	foreach ( $official_groups as $official_ids ) {
+		if ( ! is_array( $official_ids ) ) {
+			continue;
+		}
+
+		foreach ( $official_ids as $official_id ) {
+			$official_id = absint( $official_id );
+			if ( $official_id <= 0 || 'sp_official' !== get_post_type( $official_id ) ) {
+				continue;
+			}
+
+			$name = get_the_title( $official_id );
+			if ( '' === $name ) {
+				continue;
+			}
+
+			$official_names[ $official_id ] = $name;
+		}
+	}
+
+	if ( empty( $official_names ) ) {
+		return '';
+	}
+
+	return implode( '; ', array_values( $official_names ) );
+}
+
+/**
+ * Escape iCalendar text content.
+ *
+ * @param string $value Raw value.
+ * @return string
+ */
+function tse_sp_event_export_escape_ical_text( $value ) {
+	$value = html_entity_decode( wp_strip_all_tags( (string) $value ), ENT_QUOTES, get_bloginfo( 'charset' ) );
+	$value = str_replace( array( '\\', "\r\n", "\r", "\n", ',', ';' ), array( '\\\\', '\n', '\n', '\n', '\,', '\;' ), $value );
+
+	return $value;
+}
+
+/**
+ * Fold an iCalendar content line.
+ *
+ * @param string $line Raw line.
+ * @return string
+ */
+function tse_sp_event_export_fold_ical_line( $line ) {
+	return wordwrap( (string) $line, 60, "\r\n\t", true );
+}
+
+/**
+ * Get the ICS summary for an event.
+ *
+ * For matchup format, this mirrors the SportsPress result/title behavior.
+ * For team format, this becomes a team-centric opponent summary.
+ *
+ * @param WP_Post $event   Event post.
+ * @param array   $filters Export filters.
+ * @return string
+ */
+function tse_sp_event_export_get_ical_summary( $event, $filters ) {
+	$format   = tse_sp_event_export_sanitize_format( isset( $filters['format'] ) ? $filters['format'] : 'matchup' );
+	$team_ids = isset( $filters['team_ids'] ) && is_array( $filters['team_ids'] ) ? array_values( array_filter( array_map( 'absint', $filters['team_ids'] ) ) ) : array();
+	$team_id  = isset( $team_ids[0] ) ? $team_ids[0] : 0;
+
+	if ( 'team' === $format && $team_id > 0 ) {
+		$teams   = array_values( array_unique( array_map( 'intval', get_post_meta( $event->ID, 'sp_team', false ) ) ) );
+		$home_id = isset( $teams[0] ) ? (int) $teams[0] : 0;
+		$away_id = isset( $teams[1] ) ? (int) $teams[1] : 0;
+
+		if ( in_array( $team_id, $teams, true ) ) {
+			$is_home     = $home_id === $team_id;
+			$opponent_id = $is_home ? $away_id : $home_id;
+			$opponent    = $opponent_id > 0 ? get_the_title( $opponent_id ) : __( 'TBD', 'tonys-sportspress-enhancements' );
+			$summary     = sprintf(
+				/* translators: 1: preposition, 2: opponent name. */
+				__( '%1$s %2$s', 'tonys-sportspress-enhancements' ),
+				$is_home ? 'vs' : 'at',
+				$opponent
+			);
+
+			return apply_filters( 'sportspress_ical_feed_summary', $summary, $event );
+		}
+	}
+
+	$main_result = get_option( 'sportspress_primary_result', null );
+	$results     = array();
+	$teams       = (array) get_post_meta( $event->ID, 'sp_team', false );
+	$teams       = array_filter( array_unique( $teams ) );
+
+	if ( ! empty( $teams ) ) {
+		$event_results = get_post_meta( $event->ID, 'sp_results', true );
+
+		foreach ( $teams as $team_id ) {
+			$team_id = absint( $team_id );
+			if ( $team_id <= 0 ) {
+				continue;
+			}
+
+			$team = get_post( $team_id );
+			if ( ! $team instanceof WP_Post ) {
+				continue;
+			}
+
+			$team_results = is_array( $event_results ) && isset( $event_results[ $team_id ] ) ? $event_results[ $team_id ] : null;
+
+			if ( $main_result ) {
+				$team_result = is_array( $team_results ) && isset( $team_results[ $main_result ] ) ? $team_results[ $main_result ] : null;
+			} else {
+				if ( is_array( $team_results ) ) {
+					end( $team_results );
+					$team_result = prev( $team_results );
+				} else {
+					$team_result = null;
+				}
+			}
+
+			if ( null !== $team_result && '' !== (string) $team_result ) {
+				$results[] = get_the_title( $team_id ) . ' ' . $team_result;
+			}
+		}
+	}
+
+	$summary = ! empty( $results ) ? implode( ' ', $results ) : $event->post_title;
+
+	$summary = preg_replace_callback(
+		'/(&#[0-9]+;)/',
+		static function( $matches ) {
+			return mb_convert_encoding( $matches[1], 'UTF-8', 'HTML-ENTITIES' );
+		},
+		$summary
+	);
+
+	return apply_filters( 'sportspress_ical_feed_summary', $summary, $event );
+}
+
+/**
+ * Get the ICS location payload for an event.
+ *
+ * @param WP_Post $event Event post.
+ * @return array
+ */
+function tse_sp_event_export_get_ical_location_data( $event ) {
+	$location = '';
+	$geo      = false;
+	$venues   = get_the_terms( $event->ID, 'sp_venue' );
+
+	if ( ! is_array( $venues ) || empty( $venues ) ) {
+		return array(
+			'location' => $location,
+			'geo'      => $geo,
+		);
+	}
+
+	$venue    = reset( $venues );
+	$location = $venue->name;
+	$meta     = get_option( 'taxonomy_' . $venue->term_id );
+	$address  = is_array( $meta ) && isset( $meta['sp_address'] ) ? $meta['sp_address'] : false;
+
+	if ( false !== $address && '' !== (string) $address ) {
+		$location = $venue->name . ', ' . $address;
+	}
+
+	$latitude  = is_array( $meta ) && isset( $meta['sp_latitude'] ) ? $meta['sp_latitude'] : false;
+	$longitude = is_array( $meta ) && isset( $meta['sp_longitude'] ) ? $meta['sp_longitude'] : false;
+
+	if ( false !== $latitude && false !== $longitude && '' !== (string) $latitude && '' !== (string) $longitude ) {
+		$geo = $latitude . ';' . $longitude;
+	}
+
+	return array(
+		'location' => (string) $location,
+		'geo'      => $geo,
+	);
+}
+
+/**
+ * Build iCalendar output for the requested filters.
+ *
+ * @param array $filters Export filters.
+ * @return string
+ */
+function tse_sp_event_export_build_ical_output( $filters ) {
+	$query_posts = tse_sp_event_export_query_posts( $filters );
+	$locale      = substr( get_locale(), 0, 2 );
+	$timezone    = sanitize_option( 'timezone_string', get_option( 'timezone_string' ) );
+	$url         = tse_sp_event_export_get_feed_url( $filters, 'ics' );
+	$calendar    = tse_sp_event_export_get_feed_title( $filters );
+	$output      =
+"BEGIN:VCALENDAR\r\n" .
+"VERSION:2.0\r\n" .
+'PRODID:-//ThemeBoy//SportsPress//' . strtoupper( $locale ) . "\r\n" .
+"CALSCALE:GREGORIAN\r\n" .
+"METHOD:PUBLISH\r\n" .
+'URL:' . tse_sp_event_export_fold_ical_line( $url ) . "\r\n" .
+'X-FROM-URL:' . tse_sp_event_export_fold_ical_line( $url ) . "\r\n" .
+'NAME:' . tse_sp_event_export_escape_ical_text( $calendar ) . "\r\n" .
+'X-WR-CALNAME:' . tse_sp_event_export_escape_ical_text( $calendar ) . "\r\n" .
+'DESCRIPTION:' . tse_sp_event_export_escape_ical_text( $calendar ) . "\r\n" .
+'X-WR-CALDESC:' . tse_sp_event_export_escape_ical_text( $calendar ) . "\r\n" .
+"REFRESH-INTERVAL;VALUE=DURATION:PT2M\r\n" .
+"X-PUBLISHED-TTL:PT2M\r\n" .
+'TZID:' . $timezone . "\r\n" .
+'X-WR-TIMEZONE:' . $timezone . "\r\n";
+
+	foreach ( $query_posts as $event ) {
+		if ( ! $event instanceof WP_Post ) {
+			continue;
+		}
+
+		$date_format = 'Ymd\THis';
+		$description = tse_sp_event_export_escape_ical_text( $event->post_content );
+		$summary     = tse_sp_event_export_get_ical_summary( $event, $filters );
+		$minutes     = get_post_meta( $event->ID, 'sp_minutes', true );
+		$minutes     = '' === $minutes ? get_option( 'sportspress_event_minutes', 90 ) : $minutes;
+		$end         = new DateTime( $event->post_date );
+		$end->add( new DateInterval( 'PT' . absint( $minutes ) . 'M' ) );
+		$location    = tse_sp_event_export_get_ical_location_data( $event );
+		$event_url   = get_permalink( $event );
+
+		$output .= "BEGIN:VEVENT\r\n";
+		$output .= tse_sp_event_export_fold_ical_line( 'SUMMARY:' . tse_sp_event_export_escape_ical_text( $summary ) ) . "\r\n";
+		$output .= 'UID:' . $event->ID . "\r\n";
+		$output .= "STATUS:CONFIRMED\r\n";
+		$output .= "DTSTAMP:19700101T000000\r\n";
+		$output .= 'DTSTART:' . mysql2date( $date_format, $event->post_date ) . "\r\n";
+		$output .= 'DTEND:' . $end->format( $date_format ) . "\r\n";
+		$output .= 'LAST-MODIFIED:' . mysql2date( $date_format, $event->post_modified_gmt ) . "\r\n";
+
+		if ( '' !== $description ) {
+			$output .= tse_sp_event_export_fold_ical_line( 'DESCRIPTION:' . $description ) . "\r\n";
+		}
+
+		if ( '' !== $location['location'] ) {
+			$output .= tse_sp_event_export_fold_ical_line( 'LOCATION:' . tse_sp_event_export_escape_ical_text( $location['location'] ) ) . "\r\n";
+		}
+
+		if ( ! empty( $location['geo'] ) ) {
+			$output .= 'GEO:' . $location['geo'] . "\r\n";
+		}
+
+		if ( is_string( $event_url ) && '' !== $event_url ) {
+			$output .= tse_sp_event_export_fold_ical_line( 'URL:' . esc_url_raw( $event_url ) ) . "\r\n";
+		}
+
+		$output .= "END:VEVENT\r\n";
+	}
+
+	$output .= 'END:VCALENDAR';
+
+	return $output;
+}
+
+/**
+ * Stream ICS output.
+ *
+ * @param array $filters Export filters.
+ * @param array $args    Optional render args.
+ * @return void
+ */
+function tse_sp_event_export_stream_ical( $filters, $args = array() ) {
+	tse_sp_event_export_validate_filters( $filters );
+
+	$disposition = isset( $args['disposition'] ) ? sanitize_key( $args['disposition'] ) : 'inline';
+	$disposition = in_array( $disposition, array( 'inline', 'attachment' ), true ) ? $disposition : 'inline';
+	$output      = tse_sp_event_export_build_ical_output( $filters );
+	$filename    = tse_sp_event_export_build_filename( $filters ) . '.ics';
+	$etag        = md5( $output );
+
+	header( 'Content-type: text/calendar; charset=utf-8' );
+	header( 'Etag:' . '"' . $etag . '"' );
+	header( 'Content-Disposition: ' . $disposition . '; filename=' . $filename );
+
+	echo $output; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+	exit;
+}
+
+/**
+ * Build a CSV row value for a logical column.
+ *
+ * @param array  $event  Normalized event row.
+ * @param string $column Column key.
+ * @return string
+ */
+function tse_sp_event_export_get_row_value( $event, $column ) {
+	return isset( $event[ $column ] ) ? (string) $event[ $column ] : '';
+}
+
+/**
+ * Build a CSV filename for the export.
+ *
+ * @param array $filters Export filters.
+ * @return string
+ */
+function tse_sp_event_export_build_filename( $filters ) {
+	$parts = array( 'schedule' );
+
+	$parts = array_merge( $parts, tse_sp_event_export_get_post_slugs( isset( $filters['team_ids'] ) ? $filters['team_ids'] : array() ) );
+	$parts = array_merge( $parts, tse_sp_event_export_get_term_slugs_by_ids( isset( $filters['season_ids'] ) ? $filters['season_ids'] : array(), 'sp_season' ) );
+	$parts = array_merge( $parts, tse_sp_event_export_get_term_slugs_by_ids( isset( $filters['league_ids'] ) ? $filters['league_ids'] : array(), 'sp_league' ) );
+	$parts = array_merge( $parts, tse_sp_event_export_get_term_slugs_by_ids( isset( $filters['field_ids'] ) ? $filters['field_ids'] : array(), 'sp_venue' ) );
+
+	$parts[] = tse_sp_event_export_sanitize_format( isset( $filters['format'] ) ? $filters['format'] : 'matchup' );
+	$parts   = array_values( array_filter( $parts ) );
+
+	return implode( '-', $parts );
+}
+
+/**
+ * Build a human-readable feed title from filters.
+ *
+ * @param array $filters Export filters.
+ * @return string
+ */
+function tse_sp_event_export_get_feed_title( $filters ) {
+	$site_title  = trim( (string) get_bloginfo( 'name' ) );
+	$team_name   = tse_sp_event_export_get_post_titles( isset( $filters['team_ids'] ) ? $filters['team_ids'] : array() );
+	$season_name = tse_sp_event_export_get_term_names_by_ids( isset( $filters['season_ids'] ) ? $filters['season_ids'] : array(), 'sp_season' );
+	$league_name = tse_sp_event_export_get_term_names_by_ids( isset( $filters['league_ids'] ) ? $filters['league_ids'] : array(), 'sp_league' );
+	$field_name  = tse_sp_event_export_get_term_names_by_ids( isset( $filters['field_ids'] ) ? $filters['field_ids'] : array(), 'sp_venue' );
+
+	$title   = '' !== $site_title ? $site_title . ' ' . __( 'Event Feed', 'tonys-sportspress-enhancements' ) : __( 'Event Feed', 'tonys-sportspress-enhancements' );
+	$details = array_filter( array( $team_name, $season_name, $league_name, $field_name ) );
+
+	if ( ! empty( $details ) ) {
+		$title .= ' (' . implode( ' • ', $details ) . ')';
+	}
+
+	return $title;
+}
+
+/**
+ * Get term names for a list of term IDs.
+ *
+ * @param array  $ids      Term IDs.
+ * @param string $taxonomy Taxonomy name.
+ * @return string
+ */
+function tse_sp_event_export_get_term_names_by_ids( $ids, $taxonomy ) {
+	$names = array();
+
+	foreach ( (array) $ids as $id ) {
+		$term = get_term( absint( $id ), $taxonomy );
+		if ( $term instanceof WP_Term ) {
+			$names[] = $term->name;
+		}
+	}
+
+	$names = array_values( array_unique( array_filter( $names ) ) );
+
+	return implode( '; ', $names );
+}
+
+/**
+ * Get post titles for a list of post IDs.
+ *
+ * @param array $ids Post IDs.
+ * @return string
+ */
+function tse_sp_event_export_get_post_titles( $ids ) {
+	$titles = array();
+
+	foreach ( (array) $ids as $id ) {
+		$post = get_post( absint( $id ) );
+		if ( $post instanceof WP_Post ) {
+			$titles[] = $post->post_title;
+		}
+	}
+
+	$titles = array_values( array_unique( array_filter( $titles ) ) );
+
+	return implode( '; ', $titles );
+}
+
+/**
+ * Get term slugs for a list of term IDs.
+ *
+ * @param array  $ids      Term IDs.
+ * @param string $taxonomy Taxonomy name.
+ * @return string[]
+ */
+function tse_sp_event_export_get_term_slugs_by_ids( $ids, $taxonomy ) {
+	$slugs = array();
+
+	foreach ( (array) $ids as $id ) {
+		$term = get_term( absint( $id ), $taxonomy );
+		if ( $term instanceof WP_Term && ! empty( $term->slug ) ) {
+			$slugs[] = sanitize_title( $term->slug );
+		}
+	}
+
+	return array_values( array_unique( array_filter( $slugs ) ) );
+}
+
+/**
+ * Get post slugs for a list of post IDs.
+ *
+ * @param array $ids Post IDs.
+ * @return string[]
+ */
+function tse_sp_event_export_get_post_slugs( $ids ) {
+	$slugs = array();
+
+	foreach ( (array) $ids as $id ) {
+		$post = get_post( absint( $id ) );
+		if ( $post instanceof WP_Post ) {
+			$slugs[] = sanitize_title( $post->post_name ? $post->post_name : $post->post_title );
+		}
+	}
+
+	return array_values( array_unique( array_filter( $slugs ) ) );
+}
+
+/**
+ * Stream CSV output for the requested export.
+ *
+ * @param array $filters Export filters.
+ * @param array $args    Optional render args.
+ * @return void
+ */
+function tse_sp_event_export_stream_csv( $filters, $args = array() ) {
+	$filters['format']  = tse_sp_event_export_sanitize_format( isset( $filters['format'] ) ? $filters['format'] : 'matchup' );
+	$filters['columns'] = tse_sp_event_export_sanitize_columns( $filters['format'], isset( $filters['columns'] ) ? $filters['columns'] : array() );
+	tse_sp_event_export_validate_filters( $filters );
+
+	$definitions = tse_sp_event_export_get_column_definitions();
+	$headers     = array();
+
+	foreach ( $filters['columns'] as $column ) {
+		$headers[] = $definitions[ $filters['format'] ][ $column ];
+	}
+
+	$events       = tse_sp_event_export_get_events( $filters );
+	$disposition  = isset( $args['disposition'] ) ? sanitize_key( $args['disposition'] ) : 'inline';
+	$disposition  = in_array( $disposition, array( 'inline', 'attachment' ), true ) ? $disposition : 'inline';
+	$filename     = tse_sp_event_export_build_filename( $filters ) . '.csv';
+
+	header( 'Content-Type: text/csv; charset=utf-8' );
+	header( 'Content-Disposition: ' . $disposition . '; filename=' . $filename );
+
+	$output = fopen( 'php://output', 'w' );
+
+	if ( false === $output ) {
+		wp_die( esc_html__( 'Unable to generate the CSV export.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 500 ) );
+	}
+
+	fwrite( $output, "\xEF\xBB\xBF" );
+	fputcsv( $output, $headers );
+
+	foreach ( $events as $event ) {
+		$row = array();
+
+		foreach ( $filters['columns'] as $column ) {
+			$row[] = tse_sp_event_export_get_row_value( $event, $column );
+		}
+
+		fputcsv( $output, $row );
+	}
+
+	fclose( $output );
+	exit;
+}
+
+/**
+ * Render the standalone CSV feed.
+ *
+ * @return void
+ */
+function tse_sp_event_export_render_feed() {
+	if ( ! class_exists( 'SP_Calendar' ) && ! post_type_exists( 'sp_event' ) ) {
+		wp_die( esc_html__( 'SportsPress is required for this feed.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 500 ) );
+	}
+
+	tse_sp_event_export_stream_csv( tse_sp_event_export_normalize_request_args() );
+}
+
+/**
+ * Render the standalone ICS feed.
+ *
+ * @return void
+ */
+function tse_sp_event_export_render_ical_feed() {
+	if ( ! class_exists( 'SP_Calendar' ) && ! post_type_exists( 'sp_event' ) ) {
+		wp_die( esc_html__( 'SportsPress is required for this feed.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 500 ) );
+	}
+
+	tse_sp_event_export_stream_ical( tse_sp_event_export_normalize_request_args() );
+}
+
+/**
+ * Build a shareable feed URL.
+ *
+ * @param array  $args      Export args.
+ * @param string $feed_type Feed type.
+ * @return string
+ */
+function tse_sp_event_export_get_feed_url( $args = array(), $feed_type = 'csv' ) {
+	$filters = tse_sp_event_export_normalize_request_args( $args );
+	$feed    = 'ics' === sanitize_key( $feed_type ) ? 'sp-ics' : 'sp-csv';
+	$query   = array(
+		'feed'      => $feed,
+		'format'    => $filters['format'],
+		'team_id'   => ! empty( $filters['team_ids'] ) ? implode( ',', $filters['team_ids'] ) : '',
+		'season_id' => ! empty( $filters['season_ids'] ) ? implode( ',', $filters['season_ids'] ) : '',
+		'league_id' => ! empty( $filters['league_ids'] ) ? implode( ',', $filters['league_ids'] ) : '',
+		'field_id'  => ! empty( $filters['field_ids'] ) ? implode( ',', $filters['field_ids'] ) : '',
+		'columns'   => implode( ',', $filters['columns'] ),
+	);
+
+	return add_query_arg( array_filter( $query, 'strlen' ), home_url( '/' ) );
+}

includes/sp-event-permalink.php

@@ -1,16 +1,19 @@
 <?php
-/*
+/**
-Plugin Name: Custom Event Permalinks
+ * Custom permalink structure for sp_event post type.
-Description: Adds a custom permalink structure for the sp_event post type.
+ *
-Version: 1.0
+ * @package Tonys_Sportspress_Enhancements
-Author: Your Name
  */
 
 if ( ! defined( 'ABSPATH' ) ) {
-    exit; // Exit if accessed directly
+	exit;
 }
 
-// Register custom rewrite rules
+/**
+ * Register custom rewrite rules for sp_event.
+ *
+ * @return void
+ */
 function custom_event_rewrite_rules() {
 	add_rewrite_rule(
 		'(?:event|game)/.*?[/]?([0-9]+)[/]?$',
@@ -20,54 +23,58 @@ function custom_event_rewrite_rules() {
 }
 add_action( 'init', 'custom_event_rewrite_rules' );
 
-// Customize the permalink structure
+/**
+ * Customize the permalink structure for sp_event posts.
+ *
+ * @param string  $permalink Existing permalink.
+ * @param WP_Post $post      Post object.
+ * @return string
+ */
 function custom_event_permalink( $permalink, $post ) {
 	if ( $post->post_type !== 'sp_event' ) {
 		return $permalink;
 	}
 
-    $event = new SP_Event($post->ID);
 	$teams = get_post_meta( $post->ID, 'sp_team', false );
 	$format = get_post_meta( $post->ID, 'sp_format', true );
 	sort( $teams );
 	$seasons = get_the_terms( $post->ID, 'sp_season', true );
+
 	if ( $seasons ) {
 		$seasons_slug = implode(
-        "-",
+			'-',
-        array_map(function($season){return $season->slug;},$seasons),
+			array_map( function( $season ) { return $season->slug; }, $seasons )
 		);
 	} else {
-      $seasons_slug = "no-season";
+		$seasons_slug = 'no-season';
-    };
+	}
 
-    // Get the teams associated with the event
+	$team_1 = isset( $teams[0] ) ? get_post( $teams[0] ) : null;
-    $team_1 = get_post($teams[0]);
+	$team_2 = isset( $teams[1] ) ? get_post( $teams[1] ) : null;
-    $team_2 = get_post($teams[1]);
 
 	switch ( $format ) {
 		case 'league':
-          $format_string = 'game';
-          break;
 		case 'tournament':
 			$format_string = 'game';
 			break;
-      case 'friendly':
-          $format_string = 'event';
-          break;
 		default:
 			$format_string = 'event';
 			break;
 	}
 
 	if ( $team_1 && $team_2 ) {
-        $permalink = home_url($format_string ."/". $seasons_slug . '/' . $team_1->post_name . '-' . $team_2->post_name . '/' . $post->ID);
+		$permalink = home_url( $format_string . '/' . $seasons_slug . '/' . $team_1->post_name . '-' . $team_2->post_name . '/' . $post->ID );
 	}
 
 	return $permalink;
 }
 add_filter( 'post_type_link', 'custom_event_permalink', 10, 2 );
 
-// Flush rewrite rules on activation and deactivation
+/**
+ * Flush rewrite rules on activation.
+ *
+ * @return void
+ */
 function custom_event_rewrite_flush() {
 	custom_event_rewrite_rules();
 	flush_rewrite_rules();
@@ -75,15 +82,32 @@ function custom_event_rewrite_flush() {
 register_activation_hook( __FILE__, 'custom_event_rewrite_flush' );
 register_deactivation_hook( __FILE__, 'flush_rewrite_rules' );
 
-// Modify the query to handle custom permalinks and include future posts
+/**
+ * Allow scheduled events to resolve on the frontend.
+ *
+ * @param WP_Query $query Current query.
+ * @return void
+ */
 function custom_event_parse_request( $query ) {
-  $post_type = sp_array_value( $query->query, 'post_type', null );
+	if ( ! $query instanceof WP_Query ) {
-  if (isset($query->query_vars['post_type']) && $query->query_vars['post_type'] === 'sp_event') {
+		return;
-      if (isset($query->query_vars['p'])) {
+	}
+
+	if ( is_admin() || ! $query->is_main_query() ) {
+		return;
+	}
+
+	if ( 'sp_event' !== $query->get( 'post_type' ) ) {
+		return;
+	}
+
+	$post_id = absint( $query->get( 'p' ) );
+	if ( $post_id <= 0 ) {
+		return;
+	}
+
 	$query->set( 'post_type', 'sp_event' );
-          $query->set('p', $query->query_vars['p']);
+	$query->set( 'p', $post_id );
 	$query->set( 'post_status', array( 'publish', 'future' ) );
 }
-  }
-}
 add_action( 'pre_get_posts', 'custom_event_parse_request' );

includes/sp-event-quick-edit-officials.php

@@ -0,0 +1,329 @@
+<?php
+/**
+ * Quick Edit officials support for SportsPress events.
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Add an Officials column to the event admin list.
+ *
+ * @param array $columns Existing columns.
+ * @return array
+ */
+function tony_sportspress_event_add_officials_column( $columns ) {
+	$updated = array();
+
+	foreach ( $columns as $key => $label ) {
+		$updated[ $key ] = $label;
+
+		if ( 'sp_team' === $key ) {
+			$updated['tony_sp_officials'] = esc_html__( 'Officials', 'tonys-sportspress-enhancements' );
+		}
+	}
+
+	if ( ! isset( $updated['tony_sp_officials'] ) ) {
+		$updated['tony_sp_officials'] = esc_html__( 'Officials', 'tonys-sportspress-enhancements' );
+	}
+
+	return $updated;
+}
+add_filter( 'manage_edit-sp_event_columns', 'tony_sportspress_event_add_officials_column', 20 );
+
+/**
+ * Build a display-ready officials map for an event.
+ *
+ * @param int $post_id Post ID.
+ * @return array<int, array{name: string, officials: string[]}>
+ */
+function tony_sportspress_event_get_officials_display( $post_id ) {
+	$officials_by_duty = get_post_meta( $post_id, 'sp_officials', true );
+	if ( ! is_array( $officials_by_duty ) || empty( $officials_by_duty ) ) {
+		return array();
+	}
+
+	$duties = get_terms(
+		array(
+			'taxonomy'   => 'sp_duty',
+			'hide_empty' => false,
+		)
+	);
+
+	$duty_names = array();
+	if ( is_array( $duties ) ) {
+		foreach ( $duties as $duty ) {
+			if ( isset( $duty->term_id, $duty->name ) ) {
+				$duty_names[ (int) $duty->term_id ] = $duty->name;
+			}
+		}
+	}
+
+	$rows = array();
+	foreach ( $officials_by_duty as $duty_id => $official_ids ) {
+		$duty_id      = absint( $duty_id );
+		$official_ids = array_filter( array_map( 'absint', (array) $official_ids ) );
+
+		if ( $duty_id <= 0 || empty( $official_ids ) ) {
+			continue;
+		}
+
+		$names = array();
+		foreach ( $official_ids as $official_id ) {
+			$title = get_the_title( $official_id );
+			if ( is_string( $title ) && '' !== $title ) {
+				$names[] = $title;
+			}
+		}
+
+		if ( empty( $names ) ) {
+			continue;
+		}
+
+		$rows[] = array(
+			'name'      => isset( $duty_names[ $duty_id ] ) ? $duty_names[ $duty_id ] : (string) $duty_id,
+			'officials' => $names,
+		);
+	}
+
+	return $rows;
+}
+
+/**
+ * Print hidden officials data on each event row for quick edit prefill.
+ *
+ * @param string $column  Column key.
+ * @param int    $post_id Post ID.
+ */
+function tony_sportspress_event_quick_edit_officials_row_data( $column, $post_id ) {
+	if ( 'tony_sp_officials' !== $column ) {
+		return;
+	}
+
+	$officials = get_post_meta( $post_id, 'sp_officials', true );
+	if ( ! is_array( $officials ) ) {
+		$officials = array();
+	}
+
+	$serialized = wp_json_encode( $officials );
+	if ( ! is_string( $serialized ) ) {
+		$serialized = '{}';
+	}
+
+	$rows = tony_sportspress_event_get_officials_display( $post_id );
+	if ( empty( $rows ) ) {
+		echo '&mdash;';
+	} else {
+		foreach ( $rows as $row ) {
+			echo '<div class="tony-sp-event-official-row">';
+			echo '<strong>' . esc_html( $row['name'] ) . ':</strong> ';
+			echo esc_html( implode( ', ', $row['officials'] ) );
+			echo '</div>';
+		}
+	}
+
+	echo '<span class="hidden tony-event-officials-data" data-officials="' . esc_attr( $serialized ) . '"></span>';
+}
+add_action( 'manage_sp_event_posts_custom_column', 'tony_sportspress_event_quick_edit_officials_row_data', 20, 2 );
+
+/**
+ * Render quick edit UI for officials.
+ *
+ * @param string $column_name Column key.
+ * @param string $post_type   Post type key.
+ */
+function tony_sportspress_event_quick_edit_officials_field( $column_name, $post_type ) {
+	if ( 'sp_event' !== $post_type || 'tony_sp_officials' !== $column_name ) {
+		return;
+	}
+
+	static $printed = false;
+	if ( $printed ) {
+		return;
+	}
+	$printed = true;
+
+	wp_nonce_field( 'tony_sp_event_officials_quick_edit', 'tony_sp_event_officials_quick_edit_nonce' );
+
+	$duties = get_terms(
+		array(
+			'taxonomy'   => 'sp_duty',
+			'hide_empty' => false,
+			'orderby'    => 'meta_value_num',
+			'meta_query' => array(
+				'relation' => 'OR',
+				array(
+					'key'     => 'sp_order',
+					'compare' => 'NOT EXISTS',
+				),
+				array(
+					'key'     => 'sp_order',
+					'compare' => 'EXISTS',
+				),
+			),
+		)
+	);
+
+	if ( ! is_array( $duties ) || empty( $duties ) ) {
+		return;
+	}
+
+	$officials = get_posts(
+		array(
+			'post_type'      => 'sp_official',
+			'post_status'    => 'publish',
+			'posts_per_page' => -1,
+			'orderby'        => 'title',
+			'order'          => 'ASC',
+		)
+	);
+
+	if ( ! is_array( $officials ) || empty( $officials ) ) {
+		return;
+	}
+	?>
+	<fieldset class="inline-edit-col-right tony-sp-event-officials-wrap">
+		<div class="inline-edit-col">
+			<span class="title inline-edit-categories-label"><?php esc_html_e( 'Officials', 'tonys-sportspress-enhancements' ); ?></span>
+			<?php foreach ( $duties as $duty ) : ?>
+				<div class="tony-sp-duty-group">
+					<span class="title inline-edit-categories-label"><?php echo esc_html( $duty->name ); ?></span>
+					<input type="hidden" name="tony_sp_officials[<?php echo esc_attr( $duty->term_id ); ?>][]" value="0">
+					<ul class="cat-checklist">
+						<?php foreach ( $officials as $official ) : ?>
+							<li>
+								<label class="selectit">
+									<input
+										value="<?php echo esc_attr( $official->ID ); ?>"
+										type="checkbox"
+										name="tony_sp_officials[<?php echo esc_attr( $duty->term_id ); ?>][]"
+										class="tony-sp-official-checkbox"
+										data-duty-id="<?php echo esc_attr( $duty->term_id ); ?>"
+									>
+									<?php echo esc_html( $official->post_title ); ?>
+								</label>
+							</li>
+						<?php endforeach; ?>
+					</ul>
+				</div>
+			<?php endforeach; ?>
+		</div>
+	</fieldset>
+	<?php
+}
+add_action( 'quick_edit_custom_box', 'tony_sportspress_event_quick_edit_officials_field', 10, 2 );
+
+/**
+ * Save quick edit officials data.
+ *
+ * @param int $post_id Post ID.
+ */
+function tony_sportspress_event_quick_edit_officials_save( $post_id ) {
+	if ( empty( $_POST ) ) {
+		return;
+	}
+
+	if ( wp_is_post_revision( $post_id ) || ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) ) {
+		return;
+	}
+
+	if ( 'sp_event' !== get_post_type( $post_id ) ) {
+		return;
+	}
+
+	if ( ! current_user_can( 'edit_post', $post_id ) ) {
+		return;
+	}
+
+	$nonce = isset( $_POST['tony_sp_event_officials_quick_edit_nonce'] )
+		? sanitize_text_field( wp_unslash( $_POST['tony_sp_event_officials_quick_edit_nonce'] ) )
+		: '';
+
+	if ( '' === $nonce || ! wp_verify_nonce( $nonce, 'tony_sp_event_officials_quick_edit' ) ) {
+		return;
+	}
+
+	$raw_officials = isset( $_POST['tony_sp_officials'] ) ? wp_unslash( $_POST['tony_sp_officials'] ) : array();
+	if ( ! is_array( $raw_officials ) ) {
+		$raw_officials = array();
+	}
+
+	$clean_officials = array();
+	foreach ( $raw_officials as $duty_id => $official_ids ) {
+		$duty_id = absint( $duty_id );
+		if ( $duty_id <= 0 || ! is_array( $official_ids ) ) {
+			continue;
+		}
+
+		$official_ids = array_map( 'absint', $official_ids );
+		$official_ids = array_filter( $official_ids );
+		$official_ids = array_values( array_unique( $official_ids ) );
+
+		if ( ! empty( $official_ids ) ) {
+			$clean_officials[ $duty_id ] = $official_ids;
+		}
+	}
+
+	update_post_meta( $post_id, 'sp_officials', $clean_officials );
+}
+add_action( 'save_post', 'tony_sportspress_event_quick_edit_officials_save' );
+
+/**
+ * Prefill quick edit checkboxes with existing officials.
+ */
+function tony_sportspress_event_quick_edit_officials_script() {
+	$screen = get_current_screen();
+	if ( ! $screen || 'edit-sp_event' !== $screen->id ) {
+		return;
+	}
+	?>
+	<script>
+	(function($) {
+		if (typeof inlineEditPost === 'undefined' || !inlineEditPost.edit) {
+			return;
+		}
+
+		var wpInlineEdit = inlineEditPost.edit;
+
+		inlineEditPost.edit = function(id) {
+			wpInlineEdit.apply(this, arguments);
+
+			var postId = 0;
+			if (typeof id === 'object') {
+				postId = parseInt(this.getId(id), 10);
+			}
+			if (!postId) {
+				return;
+			}
+
+			var editRow = $('#edit-' + postId);
+			var postRow = $('#post-' + postId);
+			var payload = postRow.find('.tony-event-officials-data').attr('data-officials');
+			var selected = {};
+
+			try {
+				selected = payload ? JSON.parse(payload) : {};
+			} catch (e) {
+				selected = {};
+			}
+
+			editRow.find('.tony-sp-official-checkbox').prop('checked', false);
+
+			Object.keys(selected).forEach(function(dutyId) {
+				var ids = selected[dutyId];
+				if (!Array.isArray(ids)) {
+					return;
+				}
+				ids.forEach(function(officialId) {
+					editRow
+						.find('.tony-sp-official-checkbox[data-duty-id="' + dutyId + '"][value="' + String(officialId) + '"]')
+						.prop('checked', true);
+				});
+			});
+		};
+	})(jQuery);
+	</script>
+	<?php
+}
+add_action( 'admin_footer-edit.php', 'tony_sportspress_event_quick_edit_officials_script' );

includes/sp-event-team-ordering.php

@@ -0,0 +1,275 @@
+<?php
+/**
+ * Unified team-ordering behavior for SportsPress event admin and frontend lists.
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Check whether SportsPress reverse teams option is enabled.
+ *
+ * @return bool
+ */
+function tony_sportspress_reverse_teams_enabled() {
+	return get_option( 'sportspress_event_reverse_teams', 'no' ) === 'yes';
+}
+
+/**
+ * Add Away | Home option to Event List title format setting.
+ *
+ * @param array $options Event list settings options.
+ * @return array
+ */
+function tony_sportspress_event_list_add_away_home_option( $options ) {
+	if ( ! is_array( $options ) ) {
+		return $options;
+	}
+
+	foreach ( $options as &$option ) {
+		if ( ! is_array( $option ) || ! isset( $option['id'] ) || 'sportspress_event_list_title_format' !== $option['id'] ) {
+			continue;
+		}
+
+		if ( ! isset( $option['options'] ) || ! is_array( $option['options'] ) ) {
+			continue;
+		}
+
+		if ( ! array_key_exists( 'awayhome', $option['options'] ) ) {
+			$option['options']['awayhome'] = sprintf( '%s | %s', esc_attr__( 'Away', 'sportspress' ), esc_attr__( 'Home', 'sportspress' ) );
+		}
+	}
+	unset( $option );
+
+	return $options;
+}
+add_filter( 'sportspress_event_list_options', 'tony_sportspress_event_list_add_away_home_option' );
+
+/**
+ * Clarify wording of SportsPress Teams reverse-order option.
+ *
+ * @param array $options Team options.
+ * @return array
+ */
+function tony_sportspress_relabel_reverse_teams_option( $options ) {
+	if ( ! is_array( $options ) ) {
+		return $options;
+	}
+
+	foreach ( $options as &$option ) {
+		if ( ! is_array( $option ) || ! isset( $option['id'] ) || 'sportspress_event_reverse_teams' !== $option['id'] ) {
+			continue;
+		}
+
+		$option['desc'] = esc_attr__( 'Show away team first', 'tonys-sportspress-enhancements' );
+	}
+	unset( $option );
+
+	return $options;
+}
+add_filter( 'sportspress_event_logo_options', 'tony_sportspress_relabel_reverse_teams_option' );
+
+/**
+ * Add Event Results team order option.
+ *
+ * @param array $options Event Results options.
+ * @return array
+ */
+function tony_sportspress_add_event_results_order_option( $options ) {
+	if ( ! is_array( $options ) ) {
+		return $options;
+	}
+
+	$options[] = array(
+		'title'   => esc_attr__( 'Row order', 'tonys-sportspress-enhancements' ),
+		'id'      => 'tony_sportspress_event_results_row_order',
+		'default' => 'home_away',
+		'type'    => 'radio',
+		'options' => array(
+			'home_away' => sprintf( '%s | %s', esc_attr__( 'Home', 'sportspress' ), esc_attr__( 'Away', 'sportspress' ) ),
+			'away_home' => sprintf( '%s | %s', esc_attr__( 'Away', 'sportspress' ), esc_attr__( 'Home', 'sportspress' ) ),
+		),
+	);
+
+	return $options;
+}
+add_filter( 'sportspress_result_options', 'tony_sportspress_add_event_results_order_option' );
+
+/**
+ * Override SportsPress event templates with plugin versions.
+ *
+ * @param string $template      Located template path.
+ * @param string $template_name Template filename.
+ * @param string $template_path Template base path.
+ * @return string
+ */
+function tony_sportspress_locate_event_list_template( $template, $template_name, $template_path ) {
+	$supported = array(
+		'event-list.php',
+		'event-results.php',
+	);
+
+	if ( ! in_array( $template_name, $supported, true ) ) {
+		return $template;
+	}
+
+	$override = dirname( __DIR__ ) . '/templates/' . $template_name;
+	if ( file_exists( $override ) ) {
+		return $override;
+	}
+
+	return $template;
+}
+add_filter( 'sportspress_locate_template', 'tony_sportspress_locate_event_list_template', 10, 3 );
+
+/**
+ * Add admin styles for explicit Home/Away labels on event edit screens.
+ */
+function tony_sportspress_event_team_order_admin_styles() {
+	$screen = get_current_screen();
+	if ( ! $screen || 'sp_event' !== $screen->post_type ) {
+		return;
+	}
+	?>
+	<style>
+		#sp_teamdiv .sp-instance {
+			padding-top: 8px;
+			border-top: 1px solid #dcdcde;
+		}
+		#sp_teamdiv .sp-instance:first-child {
+			padding-top: 0;
+			border-top: 0;
+		}
+		#sp_teamdiv .tony-sp-home-away-label {
+			margin: 0 0 8px;
+			font-size: 12px;
+			letter-spacing: 0.02em;
+			text-transform: uppercase;
+			color: #50575e;
+		}
+	</style>
+	<?php
+}
+add_action( 'admin_head-post.php', 'tony_sportspress_event_team_order_admin_styles' );
+add_action( 'admin_head-post-new.php', 'tony_sportspress_event_team_order_admin_styles' );
+
+/**
+ * Add explicit Home/Away labels and reverse visual order in event edit teams metabox.
+ */
+function tony_sportspress_event_team_order_admin_script() {
+	$screen = get_current_screen();
+	if ( ! $screen || 'sp_event' !== $screen->post_type ) {
+		return;
+	}
+
+	$slot_labels     = array(
+		__( 'Home Team', 'tonys-sportspress-enhancements' ),
+		__( 'Away Team', 'tonys-sportspress-enhancements' ),
+	);
+	$show_away_first = tony_sportspress_reverse_teams_enabled();
+	?>
+	<script>
+	(function($) {
+		function applyHomeAwayLabels() {
+			var labels = <?php echo wp_json_encode( $slot_labels ); ?>;
+			var showAwayFirst = <?php echo $show_away_first ? 'true' : 'false'; ?>;
+			var $instances = $('#sp_teamdiv .sp-instance');
+
+			if (!$instances.length) {
+				return;
+			}
+
+			var $container = $instances.first().parent();
+			$instances.css('order', '');
+
+			if (showAwayFirst && $instances.length > 1) {
+				$container.css({
+					display: 'flex',
+					flexDirection: 'column'
+				});
+				$instances.each(function(index) {
+					$(this).css('order', index + 1);
+				});
+				$instances.eq(0).css('order', 2);
+				$instances.eq(1).css('order', 1);
+			}
+
+			$instances.each(function(index) {
+				var label = labels[index] || ('Team ' + (index + 1));
+				var $instance = $(this);
+
+				if (!$instance.children('.tony-sp-home-away-label').length) {
+					$instance.prepend('<p class="tony-sp-home-away-label"><strong>' + label + '</strong></p>');
+				} else {
+					$instance.children('.tony-sp-home-away-label').find('strong').text(label);
+				}
+
+				$instance.find('select[name="sp_team[]"]').first().attr('aria-label', label);
+			});
+		}
+
+		$(applyHomeAwayLabels);
+		$(document).on('sp-init-chosen sp-init', applyHomeAwayLabels);
+	})(jQuery);
+	</script>
+	<?php
+}
+add_action( 'admin_footer-post.php', 'tony_sportspress_event_team_order_admin_script' );
+add_action( 'admin_footer-post-new.php', 'tony_sportspress_event_team_order_admin_script' );
+
+/**
+ * Normalize event-list results array to match event team order.
+ *
+ * @param array $main_results Team results array.
+ * @param int   $event_id     Event ID.
+ * @return array
+ */
+function tony_sportspress_event_list_score_order( $main_results, $event_id ) {
+	if ( ! is_array( $main_results ) || empty( $main_results ) ) {
+		return $main_results;
+	}
+
+	$teams = (array) get_post_meta( $event_id, 'sp_team', false );
+	$teams = array_values( array_filter( array_map( 'absint', $teams ) ) );
+	if ( empty( $teams ) ) {
+		return $main_results;
+	}
+
+	$ordered = array();
+
+	foreach ( $teams as $index => $team_id ) {
+		if ( array_key_exists( $team_id, $main_results ) ) {
+			$ordered[ $team_id ] = $main_results[ $team_id ];
+			continue;
+		}
+
+		// SportsPress main_results() can be positional (0,1,...) in team order.
+		if ( array_key_exists( $index, $main_results ) ) {
+			$ordered[ $team_id ] = $main_results[ $index ];
+		}
+	}
+
+	if ( empty( $ordered ) ) {
+		return $main_results;
+	}
+
+	foreach ( $main_results as $team_id => $result ) {
+		if ( array_key_exists( $team_id, $ordered ) ) {
+			continue;
+		}
+
+		// Skip positional keys that have already been remapped to team IDs.
+		if ( is_int( $team_id ) || ctype_digit( (string) $team_id ) ) {
+			$position = (int) $team_id;
+			if ( array_key_exists( $position, $teams ) ) {
+				continue;
+			}
+		}
+
+		$ordered[ $team_id ] = $result;
+	}
+
+	return $ordered;
+}
+add_filter( 'sportspress_event_list_main_results', 'tony_sportspress_event_list_score_order', 999, 2 );

includes/sp-github-updater.php

@@ -0,0 +1,306 @@
+<?php
+/**
+ * GitHub release updater for the plugin.
+ *
+ * @package Tonys_Sportspress_Enhancements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_GITHUB_REPO' ) ) {
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_GITHUB_REPO', 'anthonyscorrea/tonys-sportspress-enhancements' );
+}
+
+if ( ! class_exists( 'Tony_Sportspress_GitHub_Updater' ) ) {
+	/**
+	 * Integrates WordPress plugin updates with GitHub Releases.
+	 */
+	class Tony_Sportspress_GitHub_Updater {
+		/**
+		 * GitHub API URL for the latest release.
+		 *
+		 * @var string
+		 */
+		private $release_api_url;
+
+		/**
+		 * Plugin basename.
+		 *
+		 * @var string
+		 */
+		private $plugin_basename;
+
+		/**
+		 * Plugin slug.
+		 *
+		 * @var string
+		 */
+		private $plugin_slug;
+
+		/**
+		 * Cache key for release metadata.
+		 *
+		 * @var string
+		 */
+		private $cache_key = 'tony_sportspress_github_release';
+
+		/**
+		 * Constructor.
+		 */
+		public function __construct() {
+			$this->release_api_url = sprintf(
+				'https://api.github.com/repos/%s/releases/latest',
+				TONY_SPORTSPRESS_ENHANCEMENTS_GITHUB_REPO
+			);
+			$this->plugin_basename = TONY_SPORTSPRESS_ENHANCEMENTS_PLUGIN_BASENAME;
+			$this->plugin_slug     = dirname( $this->plugin_basename );
+
+			add_filter( 'pre_set_site_transient_update_plugins', array( $this, 'inject_update' ) );
+			add_filter( 'plugins_api', array( $this, 'plugin_information' ), 20, 3 );
+			add_filter( 'upgrader_source_selection', array( $this, 'normalize_source_directory' ), 10, 4 );
+			add_action( 'upgrader_process_complete', array( $this, 'purge_release_cache' ), 10, 2 );
+		}
+
+		/**
+		 * Adds plugin update data to WordPress' update transient.
+		 *
+		 * @param stdClass $transient Existing update transient.
+		 * @return stdClass
+		 */
+		public function inject_update( $transient ) {
+			if ( ! is_object( $transient ) || empty( $transient->checked ) ) {
+				return $transient;
+			}
+
+			$release = $this->get_latest_release();
+
+			if ( ! $release ) {
+				return $transient;
+			}
+
+			$remote_version = $this->normalize_version( $release['version'] );
+			$current_version = $this->normalize_version( TONY_SPORTSPRESS_ENHANCEMENTS_VERSION );
+
+			if ( version_compare( $remote_version, $current_version, '<=' ) ) {
+				return $transient;
+			}
+
+			$transient->response[ $this->plugin_basename ] = (object) array(
+				'id'            => $release['url'],
+				'slug'          => $this->plugin_slug,
+				'plugin'        => $this->plugin_basename,
+				'new_version'   => $remote_version,
+				'url'           => $release['url'],
+				'package'       => $release['package'],
+				'tested'        => '',
+				'requires_php'  => '',
+				'icons'         => array(),
+				'banners'       => array(),
+				'banners_rtl'   => array(),
+				'translations'  => array(),
+			);
+
+			return $transient;
+		}
+
+		/**
+		 * Provides plugin information for the update details modal.
+		 *
+		 * @param false|object|array $result Existing result.
+		 * @param string             $action API action.
+		 * @param object             $args   API args.
+		 * @return false|object|array
+		 */
+		public function plugin_information( $result, $action, $args ) {
+			if ( 'plugin_information' !== $action || empty( $args->slug ) || $this->plugin_slug !== $args->slug ) {
+				return $result;
+			}
+
+			$release = $this->get_latest_release();
+
+			if ( ! $release ) {
+				return $result;
+			}
+
+			return (object) array(
+				'name'          => 'Tonys SportsPress Enhancements',
+				'slug'          => $this->plugin_slug,
+				'version'       => $this->normalize_version( $release['version'] ),
+				'author'        => '<a href="https://github.com/anthonyscorrea/">Tony Correa</a>',
+				'author_profile'=> 'https://github.com/anthonyscorrea/',
+				'homepage'      => $release['url'],
+				'download_link' => $release['package'],
+				'sections'      => array(
+					'description' => wp_kses_post( wpautop( 'Suite of SportsPress Enhancements.' ) ),
+					'changelog'   => wp_kses_post( wpautop( $release['body'] ) ),
+				),
+			);
+		}
+
+		/**
+		 * Ensures GitHub's extracted directory name matches the installed plugin slug.
+		 *
+		 * @param string       $source        Source file location.
+		 * @param string       $remote_source Remote file source location.
+		 * @param WP_Upgrader  $upgrader      Upgrader instance.
+		 * @param array        $hook_extra    Extra hook arguments.
+		 * @return string|WP_Error
+		 */
+		public function normalize_source_directory( $source, $remote_source, $upgrader, $hook_extra ) {
+			global $wp_filesystem;
+
+			if ( empty( $hook_extra['plugin'] ) || $this->plugin_basename !== $hook_extra['plugin'] ) {
+				return $source;
+			}
+
+			$expected_dir = trailingslashit( $remote_source ) . $this->plugin_slug;
+
+			if ( untrailingslashit( $source ) === untrailingslashit( $expected_dir ) ) {
+				return $source;
+			}
+
+			if ( ! $wp_filesystem ) {
+				return $source;
+			}
+
+			if ( $wp_filesystem->exists( $expected_dir ) ) {
+				$wp_filesystem->delete( $expected_dir, true );
+			}
+
+			if ( ! $wp_filesystem->move( $source, $expected_dir ) ) {
+				return new WP_Error(
+					'tony_sportspress_updater_rename_failed',
+					__( 'The plugin update package could not be prepared for installation.', 'tonys-sportspress-enhancements' )
+				);
+			}
+
+			return $expected_dir;
+		}
+
+		/**
+		 * Clears cached release metadata after plugin updates complete.
+		 *
+		 * @param WP_Upgrader $upgrader   Upgrader instance.
+		 * @param array       $hook_extra Extra hook arguments.
+		 * @return void
+		 */
+		public function purge_release_cache( $upgrader, $hook_extra ) {
+			if ( empty( $hook_extra['type'] ) || 'plugin' !== $hook_extra['type'] ) {
+				return;
+			}
+
+			if ( empty( $hook_extra['plugins'] ) || ! in_array( $this->plugin_basename, (array) $hook_extra['plugins'], true ) ) {
+				return;
+			}
+
+			delete_site_transient( $this->cache_key );
+		}
+
+		/**
+		 * Reads and caches the latest GitHub release metadata.
+		 *
+		 * @return array|null
+		 */
+		private function get_latest_release() {
+			$cached = get_site_transient( $this->cache_key );
+
+			if ( is_array( $cached ) ) {
+				return $cached;
+			}
+
+			$response = wp_remote_get(
+				$this->release_api_url,
+				array(
+					'timeout' => 15,
+					'headers' => array(
+						'Accept'     => 'application/vnd.github+json',
+						'User-Agent' => 'WordPress/' . get_bloginfo( 'version' ) . '; ' . home_url( '/' ),
+					),
+				)
+			);
+
+			if ( is_wp_error( $response ) ) {
+				return null;
+			}
+
+			if ( 200 !== (int) wp_remote_retrieve_response_code( $response ) ) {
+				return null;
+			}
+
+			$data = json_decode( wp_remote_retrieve_body( $response ), true );
+
+			if ( ! is_array( $data ) || empty( $data['tag_name'] ) || empty( $data['html_url'] ) ) {
+				return null;
+			}
+
+			$release = array(
+				'version' => $data['tag_name'],
+				'url'     => $data['html_url'],
+				'body'    => isset( $data['body'] ) ? (string) $data['body'] : '',
+				'package' => $this->determine_package_url( $data ),
+			);
+
+			if ( empty( $release['package'] ) ) {
+				return null;
+			}
+
+			set_site_transient( $this->cache_key, $release, 6 * HOUR_IN_SECONDS );
+
+			return $release;
+		}
+
+		/**
+		 * Selects the best package URL from a release payload.
+		 *
+		 * @param array $release GitHub release payload.
+		 * @return string
+		 */
+		private function determine_package_url( $release ) {
+			if ( ! empty( $release['assets'] ) && is_array( $release['assets'] ) ) {
+				$fallback_asset = '';
+
+				foreach ( $release['assets'] as $asset ) {
+					if ( empty( $asset['browser_download_url'] ) || empty( $asset['name'] ) ) {
+						continue;
+					}
+
+					if ( '.zip' !== strtolower( substr( $asset['name'], -4 ) ) ) {
+						continue;
+					}
+
+					if ( false !== strpos( $asset['name'], $this->plugin_slug ) ) {
+						return $asset['browser_download_url'];
+					}
+
+					if ( empty( $fallback_asset ) ) {
+						$fallback_asset = $asset['browser_download_url'];
+					}
+				}
+
+				if ( ! empty( $fallback_asset ) ) {
+					return $fallback_asset;
+				}
+			}
+
+			if ( ! empty( $release['zipball_url'] ) ) {
+				return $release['zipball_url'];
+			}
+
+			return '';
+		}
+
+		/**
+		 * Normalizes release versions so Git tags like v1.2.3 compare correctly.
+		 *
+		 * @param string $version Version string.
+		 * @return string
+		 */
+		private function normalize_version( $version ) {
+			return ltrim( (string) $version, "vV \t\n\r\0\x0B" );
+		}
+	}
+
+	new Tony_Sportspress_GitHub_Updater();
+}

includes/sp-officials-manager-role.php

@@ -0,0 +1,420 @@
+<?php
+/**
+ * Officials Manager role and capability restrictions.
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( ! defined( 'TONY_SPORTSPRESS_OFFICIALS_MANAGER_ROLE' ) ) {
+	define( 'TONY_SPORTSPRESS_OFFICIALS_MANAGER_ROLE', 'sp_officials_manager' );
+}
+
+/**
+ * Build the primitive capabilities for a custom post type.
+ *
+ * @param string $singular Singular capability base.
+ * @param string $plural   Plural capability base.
+ * @return string[]
+ */
+function tony_sportspress_build_post_type_caps( $singular, $plural ) {
+	return array(
+		"edit_{$singular}",
+		"read_{$singular}",
+		"delete_{$singular}",
+		"edit_{$plural}",
+		"edit_others_{$plural}",
+		"publish_{$plural}",
+		"read_private_{$plural}",
+		"delete_{$plural}",
+		"delete_private_{$plural}",
+		"delete_published_{$plural}",
+		"delete_others_{$plural}",
+		"edit_private_{$plural}",
+		"edit_published_{$plural}",
+	);
+}
+
+/**
+ * Get officials manager role capabilities.
+ *
+ * @return array<string, bool>
+ */
+function tony_sportspress_get_officials_manager_caps() {
+	$caps = array(
+		'read'                 => true,
+		'edit_posts'           => true,
+		'delete_posts'         => true,
+		'edit_published_posts' => true,
+	);
+
+	foreach ( tony_sportspress_build_post_type_caps( 'sp_official', 'sp_officials' ) as $cap ) {
+		$caps[ $cap ] = true;
+	}
+
+	// Allow access to the event list and quick edit for assignments, without full event management.
+	$caps['read_sp_event']             = true;
+	$caps['edit_sp_event']             = true;
+	$caps['edit_sp_events']            = true;
+	$caps['edit_others_sp_events']     = true;
+	$caps['edit_published_sp_events']  = true;
+	$caps['read_private_sp_events']    = true;
+
+	return $caps;
+}
+
+/**
+ * Get the capabilities managed for the officials manager role.
+ *
+ * @return string[]
+ */
+function tony_sportspress_get_officials_manager_managed_caps() {
+	return array_keys( tony_sportspress_get_officials_manager_caps() );
+}
+
+/**
+ * Grant custom official caps to existing roles that already have matching event caps.
+ *
+ * This preserves existing access after moving officials off the `sp_event` capability type.
+ *
+ * @return void
+ */
+function tony_sportspress_sync_official_caps_to_existing_roles() {
+	global $wp_roles;
+
+	if ( ! class_exists( 'WP_Roles' ) ) {
+		return;
+	}
+
+	if ( ! isset( $wp_roles ) ) {
+		$wp_roles = wp_roles();
+	}
+
+	if ( ! $wp_roles instanceof WP_Roles ) {
+		return;
+	}
+
+	$cap_map = array(
+		'edit_sp_event'              => 'edit_sp_official',
+		'read_sp_event'              => 'read_sp_official',
+		'delete_sp_event'            => 'delete_sp_official',
+		'edit_sp_events'             => 'edit_sp_officials',
+		'edit_others_sp_events'      => 'edit_others_sp_officials',
+		'publish_sp_events'          => 'publish_sp_officials',
+		'read_private_sp_events'     => 'read_private_sp_officials',
+		'delete_sp_events'           => 'delete_sp_officials',
+		'delete_private_sp_events'   => 'delete_private_sp_officials',
+		'delete_published_sp_events' => 'delete_published_sp_officials',
+		'delete_others_sp_events'    => 'delete_others_sp_officials',
+		'edit_private_sp_events'     => 'edit_private_sp_officials',
+		'edit_published_sp_events'   => 'edit_published_sp_officials',
+	);
+
+	foreach ( $wp_roles->role_objects as $role ) {
+		if ( ! $role instanceof WP_Role ) {
+			continue;
+		}
+
+		foreach ( $cap_map as $event_cap => $official_cap ) {
+			if ( $role->has_cap( $event_cap ) ) {
+				$role->add_cap( $official_cap );
+			}
+		}
+	}
+}
+
+/**
+ * Create or update the officials manager role.
+ *
+ * @return void
+ */
+function tony_sportspress_sync_officials_manager_roles() {
+	$role = get_role( TONY_SPORTSPRESS_OFFICIALS_MANAGER_ROLE );
+
+	if ( ! $role ) {
+		$role = add_role(
+			TONY_SPORTSPRESS_OFFICIALS_MANAGER_ROLE,
+			__( 'Officials Manager', 'tonys-sportspress-enhancements' ),
+			array()
+		);
+	}
+
+	if ( ! $role instanceof WP_Role ) {
+		return;
+	}
+
+	$desired_caps = tony_sportspress_get_officials_manager_caps();
+
+	foreach ( tony_sportspress_get_officials_manager_managed_caps() as $cap ) {
+		if ( ! empty( $desired_caps[ $cap ] ) ) {
+			$role->add_cap( $cap );
+		} else {
+			$role->remove_cap( $cap );
+		}
+	}
+
+	tony_sportspress_sync_official_caps_to_existing_roles();
+}
+add_action( 'init', 'tony_sportspress_sync_officials_manager_roles' );
+
+/**
+ * Assign custom capabilities to the officials post type.
+ *
+ * @param array $args Post type registration args.
+ * @return array
+ */
+function tony_sportspress_officials_post_type_caps( $args ) {
+	$args['capability_type'] = array( 'sp_official', 'sp_officials' );
+	$args['map_meta_cap']    = true;
+	$args['capabilities']    = array(
+		'create_posts' => 'edit_sp_officials',
+	);
+
+	return $args;
+}
+add_filter( 'sportspress_register_post_type_official', 'tony_sportspress_officials_post_type_caps' );
+
+/**
+ * Determine whether the current user should be restricted to assignment-only event access.
+ *
+ * @return bool
+ */
+function tony_sportspress_is_officials_manager_user() {
+	$user = wp_get_current_user();
+
+	if ( ! $user instanceof WP_User || empty( $user->roles ) ) {
+		return false;
+	}
+
+	if ( ! in_array( TONY_SPORTSPRESS_OFFICIALS_MANAGER_ROLE, $user->roles, true ) ) {
+		return false;
+	}
+
+	if ( current_user_can( 'manage_options' ) || current_user_can( 'manage_sportspress' ) ) {
+		return false;
+	}
+
+	return true;
+}
+
+/**
+ * Prevent assignment-only users from opening full event edit screens.
+ *
+ * @return void
+ */
+function tony_sportspress_lock_event_editor_for_officials_manager() {
+	global $pagenow;
+
+	if ( ! is_admin() || ! tony_sportspress_is_officials_manager_user() ) {
+		return;
+	}
+
+	if ( 'post-new.php' === $pagenow ) {
+		$post_type = isset( $_GET['post_type'] ) ? sanitize_key( wp_unslash( $_GET['post_type'] ) ) : 'post';
+
+		if ( 'sp_event' === $post_type ) {
+			wp_safe_redirect( admin_url( 'edit.php?post_type=sp_event&tse_event_editor_locked=1' ) );
+			exit;
+		}
+	}
+
+	if ( 'post.php' !== $pagenow ) {
+		return;
+	}
+
+	$post_id = isset( $_GET['post'] ) ? absint( wp_unslash( $_GET['post'] ) ) : 0;
+	if ( $post_id > 0 && 'sp_event' === get_post_type( $post_id ) ) {
+		wp_safe_redirect( admin_url( 'edit.php?post_type=sp_event&tse_event_editor_locked=1' ) );
+		exit;
+	}
+}
+add_action( 'admin_init', 'tony_sportspress_lock_event_editor_for_officials_manager' );
+
+/**
+ * Show an admin notice when event editor access is blocked.
+ *
+ * @return void
+ */
+function tony_sportspress_officials_manager_admin_notice() {
+	if ( ! tony_sportspress_is_officials_manager_user() ) {
+		return;
+	}
+
+	if ( empty( $_GET['tse_event_editor_locked'] ) ) {
+		return;
+	}
+
+	echo '<div class="notice notice-info is-dismissible"><p>' . esc_html__( 'Officials Managers can assign officials from the events list via Quick Edit, but cannot open the full event editor.', 'tonys-sportspress-enhancements' ) . '</p></div>';
+}
+add_action( 'admin_notices', 'tony_sportspress_officials_manager_admin_notice' );
+
+/**
+ * Remove event row actions that would expose broader editing.
+ *
+ * @param array   $actions Row actions.
+ * @param WP_Post $post    Post object.
+ * @return array
+ */
+function tony_sportspress_limit_event_row_actions_for_officials_manager( $actions, $post ) {
+	if ( ! tony_sportspress_is_officials_manager_user() || ! $post instanceof WP_Post || 'sp_event' !== $post->post_type ) {
+		return $actions;
+	}
+
+	$allowed = array();
+
+	if ( isset( $actions['inline hide-if-no-js'] ) ) {
+		$allowed['inline hide-if-no-js'] = $actions['inline hide-if-no-js'];
+	}
+
+	if ( isset( $actions['view'] ) ) {
+		$allowed['view'] = $actions['view'];
+	}
+
+	return $allowed;
+}
+add_filter( 'post_row_actions', 'tony_sportspress_limit_event_row_actions_for_officials_manager', 10, 2 );
+
+/**
+ * Remove bulk actions from the events list for assignment-only users.
+ *
+ * @param array $actions Bulk actions.
+ * @return array
+ */
+function tony_sportspress_limit_event_bulk_actions_for_officials_manager( $actions ) {
+	if ( ! tony_sportspress_is_officials_manager_user() ) {
+		return $actions;
+	}
+
+	return array();
+}
+add_filter( 'bulk_actions-edit-sp_event', 'tony_sportspress_limit_event_bulk_actions_for_officials_manager' );
+
+/**
+ * Remove the Add New events submenu for assignment-only users.
+ *
+ * @return void
+ */
+function tony_sportspress_limit_event_admin_menu_for_officials_manager() {
+	if ( ! tony_sportspress_is_officials_manager_user() ) {
+		return;
+	}
+
+	remove_submenu_page( 'edit.php?post_type=sp_event', 'post-new.php?post_type=sp_event' );
+}
+add_action( 'admin_menu', 'tony_sportspress_limit_event_admin_menu_for_officials_manager', 99 );
+
+/**
+ * Hide event Add New buttons on the list screen for assignment-only users.
+ *
+ * @return void
+ */
+function tony_sportspress_limit_event_admin_ui_for_officials_manager() {
+	$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
+	if ( ! $screen || 'edit-sp_event' !== $screen->id || ! tony_sportspress_is_officials_manager_user() ) {
+		return;
+	}
+	?>
+	<style>
+		.post-type-sp_event .page-title-action,
+		.post-type-sp_event .wrap .bulkactions {
+			display: none;
+		}
+
+		.post-type-sp_event .wp-list-table .column-title .row-title {
+			color: inherit;
+			cursor: default;
+			text-decoration: none;
+		}
+	</style>
+	<script>
+	(function() {
+		const replaceTitleLinks = function() {
+			document.querySelectorAll('.post-type-sp_event .wp-list-table .column-title a.row-title').forEach(function(link) {
+				const text = document.createTextNode(link.textContent || '');
+				const span = document.createElement('span');
+
+				span.className = link.className;
+				span.appendChild(text);
+				link.replaceWith(span);
+			});
+		};
+
+		if (document.readyState === 'loading') {
+			document.addEventListener('DOMContentLoaded', replaceTitleLinks);
+		} else {
+			replaceTitleLinks();
+		}
+	})();
+	</script>
+	<?php
+}
+add_action( 'admin_head', 'tony_sportspress_limit_event_admin_ui_for_officials_manager' );
+
+/**
+ * Prevent clickable edit links to events for assignment-only users.
+ *
+ * This keeps the list-table title as plain text while preserving Quick Edit.
+ *
+ * @param string|false $link    Edit link.
+ * @param int          $post_id Post ID.
+ * @param string       $context Link context.
+ * @return string|false
+ */
+function tony_sportspress_disable_event_edit_links_for_officials_manager( $link, $post_id, $context ) {
+	if ( ! is_admin() || ! tony_sportspress_is_officials_manager_user() ) {
+		return $link;
+	}
+
+	if ( 'sp_event' !== get_post_type( $post_id ) ) {
+		return $link;
+	}
+
+	return false;
+}
+add_filter( 'get_edit_post_link', 'tony_sportspress_disable_event_edit_links_for_officials_manager', 10, 3 );
+
+/**
+ * Preserve core event fields so assignment-only users cannot alter them via Quick Edit.
+ *
+ * @param array $data    Sanitized post data.
+ * @param array $postarr Raw post array.
+ * @return array
+ */
+function tony_sportspress_protect_event_fields_for_officials_manager( $data, $postarr ) {
+	if ( ! is_admin() || ! tony_sportspress_is_officials_manager_user() ) {
+		return $data;
+	}
+
+	if ( empty( $postarr['ID'] ) || 'sp_event' !== $data['post_type'] ) {
+		return $data;
+	}
+
+	$existing_post = get_post( (int) $postarr['ID'], ARRAY_A );
+	if ( ! is_array( $existing_post ) ) {
+		return $data;
+	}
+
+	$protected_fields = array(
+		'post_author',
+		'post_content',
+		'post_content_filtered',
+		'post_date',
+		'post_date_gmt',
+		'post_excerpt',
+		'post_name',
+		'post_parent',
+		'post_password',
+		'post_status',
+		'post_title',
+	);
+
+	foreach ( $protected_fields as $field ) {
+		if ( isset( $existing_post[ $field ] ) ) {
+			$data[ $field ] = $existing_post[ $field ];
+		}
+	}
+
+	return $data;
+}
+add_filter( 'wp_insert_post_data', 'tony_sportspress_protect_event_fields_for_officials_manager', 20, 2 );

includes/sp-schedule-exporter.php

@@ -0,0 +1,970 @@
+<?php
+/**
+ * SportsPress schedule exporter frontend and shared helpers.
+ *
+ * @package Tonys_Sportspress_Enhancements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+add_shortcode( 'tse_schedule_exporter', 'tse_sp_schedule_exporter_render_shortcode' );
+add_action( 'init', 'tse_sp_schedule_exporter_register_block' );
+
+/**
+ * Handle schedule export downloads.
+ *
+ * @return void
+ */
+function tse_sp_schedule_exporter_handle_download() {
+	if ( is_user_logged_in() && ! current_user_can( 'manage_sportspress' ) ) {
+		wp_die( esc_html__( 'You do not have permission to export schedules.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 403 ) );
+	}
+
+	check_admin_referer( 'tse_schedule_export' );
+
+	$filters = tse_sp_event_export_normalize_request_args();
+
+	if ( $filters['team_id'] <= 0 || 'sp_team' !== get_post_type( $filters['team_id'] ) ) {
+		wp_die( esc_html__( 'Choose a valid team before exporting.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 400 ) );
+	}
+
+	tse_sp_event_export_stream_csv(
+		$filters,
+		array(
+			'disposition' => 'attachment',
+		)
+	);
+}
+add_action( 'admin_post_tse_schedule_export', 'tse_sp_schedule_exporter_handle_download' );
+add_action( 'admin_post_nopriv_tse_schedule_export', 'tse_sp_schedule_exporter_handle_download' );
+
+/**
+ * Register the schedule exporter block.
+ *
+ * @return void
+ */
+function tse_sp_schedule_exporter_register_block() {
+	if ( ! function_exists( 'register_block_type' ) ) {
+		return;
+	}
+
+	wp_register_script(
+		'tse-schedule-exporter-block',
+		TONY_SPORTSPRESS_ENHANCEMENTS_URL . 'assets/schedule-exporter-block.js',
+		array( 'wp-blocks', 'wp-block-editor', 'wp-element', 'wp-i18n' ),
+		TONY_SPORTSPRESS_ENHANCEMENTS_VERSION,
+		true
+	);
+
+	register_block_type(
+		'tse/schedule-exporter',
+		array(
+			'api_version'     => 3,
+			'title'           => __( 'Schedule Exporter', 'tonys-sportspress-enhancements' ),
+			'description'     => __( 'Shows the public schedule exporter with CSV, iCal, and printable page options.', 'tonys-sportspress-enhancements' ),
+			'category'        => 'widgets',
+			'icon'            => 'calendar-alt',
+			'editor_script'   => 'tse-schedule-exporter-block',
+			'render_callback' => 'tse_sp_schedule_exporter_render_block',
+			'supports'        => array(
+				'html' => false,
+			),
+		)
+	);
+}
+
+/**
+ * Render the public shortcode.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_render_shortcode() {
+	$leagues   = tse_sp_schedule_exporter_get_leagues();
+	$league_id = tse_sp_schedule_exporter_resolve_league_id( $leagues );
+	$seasons   = tse_sp_schedule_exporter_get_seasons();
+	$season_id = tse_sp_schedule_exporter_resolve_season_id( $seasons );
+	$teams     = tse_sp_schedule_exporter_get_teams( $league_id, $season_id );
+	$team_id   = tse_sp_schedule_exporter_resolve_team_id( $teams );
+	$fields    = tse_sp_schedule_exporter_get_fields();
+	$field_id  = tse_sp_schedule_exporter_resolve_field_id( $fields );
+	$export_type = tse_sp_schedule_exporter_resolve_export_type();
+	$subformat   = tse_sp_schedule_exporter_resolve_subformat();
+
+	if ( empty( $teams ) ) {
+		return '<p>' . esc_html__( 'No SportsPress teams match the selected league and season.', 'tonys-sportspress-enhancements' ) . '</p>';
+	}
+
+	ob_start();
+	?>
+	<div class="tse-schedule-exporter" style="max-width:960px;margin:0 auto;padding:24px;border:1px solid #d7d7db;background:#fff;">
+		<h2 style="margin-top:0;"><?php esc_html_e( 'Schedule Exporter', 'tonys-sportspress-enhancements' ); ?></h2>
+		<p><?php esc_html_e( 'Choose filters once, then generate the CSV feed, iCal link, or printable page URL from the same controls.', 'tonys-sportspress-enhancements' ); ?></p>
+
+		<form method="get" action="<?php echo esc_url( get_permalink() ); ?>" class="tse-schedule-exporter-form" style="max-width:720px;margin:24px 0;">
+			<div style="margin-bottom:16px;">
+				<label for="tse-public-export-type"><strong><?php esc_html_e( 'Format', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-export-type" name="export_type">
+					<?php foreach ( tse_sp_schedule_exporter_get_export_types() as $type_key => $type_label ) : ?>
+						<option value="<?php echo esc_attr( $type_key ); ?>" <?php selected( $export_type, $type_key ); ?>>
+							<?php echo esc_html( $type_label ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+				<p class="description"><?php esc_html_e( 'CSV builds a feed URL, iCal Link builds a subscription URL, and Printable opens the printable page.', 'tonys-sportspress-enhancements' ); ?></p>
+			</div>
+
+			<div data-subformat-wrap="1" style="margin-bottom:16px;">
+				<label for="tse-public-subformat"><strong><?php esc_html_e( 'CSV Layout', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-subformat" name="subformat">
+					<?php foreach ( tse_sp_event_export_get_formats() as $format_key => $format_definition ) : ?>
+						<option value="<?php echo esc_attr( $format_key ); ?>" <?php selected( $subformat, $format_key ); ?>>
+							<?php echo esc_html( $format_definition['label'] ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+				<p class="description"><?php esc_html_e( 'Matchup is away vs home. Team is opponent-based and requires one specific team.', 'tonys-sportspress-enhancements' ); ?></p>
+			</div>
+
+			<div style="margin-bottom:16px;">
+				<label for="tse-public-league"><strong><?php esc_html_e( 'League', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-league" name="league_id" data-auto-submit="1">
+					<?php foreach ( $leagues as $league ) : ?>
+						<option value="<?php echo esc_attr( (string) $league->term_id ); ?>" <?php selected( $league_id, (int) $league->term_id ); ?>>
+							<?php echo esc_html( $league->name ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+			</div>
+
+			<div style="margin-bottom:16px;">
+				<label for="tse-public-season"><strong><?php esc_html_e( 'Season', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-season" name="season_id" data-auto-submit="1">
+					<option value="0"><?php esc_html_e( 'Current / All matching events', 'tonys-sportspress-enhancements' ); ?></option>
+					<?php foreach ( $seasons as $season ) : ?>
+						<option value="<?php echo esc_attr( (string) $season->term_id ); ?>" <?php selected( $season_id, (int) $season->term_id ); ?>>
+							<?php echo esc_html( $season->name ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+			</div>
+
+			<div style="margin-bottom:16px;">
+				<label for="tse-public-team"><strong><?php esc_html_e( 'Team', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-team" name="team_id">
+					<option value="0"><?php esc_html_e( 'All teams', 'tonys-sportspress-enhancements' ); ?></option>
+					<?php foreach ( $teams as $team ) : ?>
+						<option value="<?php echo esc_attr( (string) $team->ID ); ?>" <?php selected( $team_id, (int) $team->ID ); ?>>
+							<?php echo esc_html( $team->post_title ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+			</div>
+
+			<div style="margin-bottom:16px;">
+				<label for="tse-public-field"><strong><?php esc_html_e( 'Field', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-field" name="field_id">
+					<option value="0"><?php esc_html_e( 'All fields', 'tonys-sportspress-enhancements' ); ?></option>
+					<?php foreach ( $fields as $field ) : ?>
+						<option value="<?php echo esc_attr( (string) $field->term_id ); ?>" <?php selected( $field_id, (int) $field->term_id ); ?>>
+							<?php echo esc_html( $field->name ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+			</div>
+
+		</form>
+
+		<?php tse_sp_schedule_exporter_render_column_picker( 'matchup', 'public', $subformat ); ?>
+		<?php tse_sp_schedule_exporter_render_column_picker( 'team', 'public', $subformat ); ?>
+
+		<?php
+		$csv_url = tse_sp_event_export_get_feed_url( array( 'team_id' => $team_id, 'season_id' => $season_id, 'league_id' => $league_id, 'field_id' => $field_id, 'format' => $subformat ), 'csv' );
+		$ics_url = tse_sp_event_export_get_feed_url( array( 'team_id' => $team_id, 'season_id' => $season_id, 'league_id' => $league_id, 'field_id' => $field_id ), 'ics' );
+		$print_url = tse_sp_schedule_exporter_get_printable_url( $team_id, $season_id, 'letter', $league_id );
+		$current_url = tse_sp_schedule_exporter_get_output_url( $export_type, $csv_url, $ics_url, $print_url );
+		?>
+		<div style="display:flex;align-items:center;gap:8px;max-width:100%;margin-top:16px;">
+			<input type="text" class="large-text code tse-output-url" readonly="readonly" value="<?php echo esc_attr( $current_url ); ?>" />
+			<button type="button" class="button tse-copy-link" title="<?php esc_attr_e( 'Copy URL', 'tonys-sportspress-enhancements' ); ?>"><?php esc_html_e( 'Copy URL', 'tonys-sportspress-enhancements' ); ?></button>
+			<button type="button" class="button button-primary tse-open-link" data-csv-url="<?php echo esc_url( $csv_url ); ?>" data-ics-url="<?php echo esc_url( $ics_url ); ?>" data-print-url="<?php echo esc_url( $print_url ); ?>" title="<?php esc_attr_e( 'Open URL in new tab', 'tonys-sportspress-enhancements' ); ?>"><?php esc_html_e( 'Open URL in New Tab', 'tonys-sportspress-enhancements' ); ?></button>
+			<button type="button" class="button button-primary tse-ics-ios-link" data-ics-url="<?php echo esc_url( $ics_url ); ?>" title="<?php esc_attr_e( 'Subscribe on iPhone or iPad', 'tonys-sportspress-enhancements' ); ?>" style="display:none;"><?php esc_html_e( 'Subscribe on iPhone/iPad', 'tonys-sportspress-enhancements' ); ?></button>
+			<button type="button" class="button tse-ics-android-link" data-ics-url="<?php echo esc_url( $ics_url ); ?>" title="<?php esc_attr_e( 'Subscribe on Android', 'tonys-sportspress-enhancements' ); ?>" style="display:none;"><?php esc_html_e( 'Subscribe on Android', 'tonys-sportspress-enhancements' ); ?></button>
+		</div>
+		<p class="description tse-output-note"><?php esc_html_e( 'Use the buttons to copy the generated URL or open the right destination for this export type.', 'tonys-sportspress-enhancements' ); ?></p>
+	</div>
+	<?php
+	$output = (string) ob_get_clean();
+
+	return $output . tse_sp_schedule_exporter_render_link_sync_script();
+}
+
+/**
+ * Render the schedule exporter block.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_render_block() {
+	if ( is_admin() || ( function_exists( 'wp_is_json_request' ) && wp_is_json_request() ) ) {
+		return '<div class="tse-schedule-exporter-block-placeholder"><strong>' . esc_html__( 'Schedule Exporter', 'tonys-sportspress-enhancements' ) . '</strong><p>' . esc_html__( 'The schedule exporter renders on the frontend.', 'tonys-sportspress-enhancements' ) . '</p></div>';
+	}
+
+	return tse_sp_schedule_exporter_render_shortcode();
+}
+
+/**
+ * Get teams for the exporter.
+ *
+ * @return WP_Post[]
+ */
+function tse_sp_schedule_exporter_get_leagues() {
+	$leagues = get_terms(
+		array(
+			'taxonomy'   => 'sp_league',
+			'hide_empty' => false,
+			'orderby'    => 'name',
+			'order'      => 'ASC',
+		)
+	);
+
+	if ( is_wp_error( $leagues ) || ! is_array( $leagues ) ) {
+		return array();
+	}
+
+	return $leagues;
+}
+
+/**
+ * Get seasons for the exporter.
+ *
+ * @return WP_Term[]
+ */
+function tse_sp_schedule_exporter_get_seasons() {
+	$seasons = get_terms(
+		array(
+			'taxonomy'   => 'sp_season',
+			'hide_empty' => false,
+			'orderby'    => 'name',
+			'order'      => 'ASC',
+		)
+	);
+
+	if ( is_wp_error( $seasons ) || ! is_array( $seasons ) ) {
+		return array();
+	}
+
+	return $seasons;
+}
+
+/**
+ * Get fields for the exporter.
+ *
+ * @return WP_Term[]
+ */
+function tse_sp_schedule_exporter_get_fields() {
+	$fields = get_terms(
+		array(
+			'taxonomy'   => 'sp_venue',
+			'hide_empty' => false,
+			'orderby'    => 'name',
+			'order'      => 'ASC',
+		)
+	);
+
+	if ( is_wp_error( $fields ) || ! is_array( $fields ) ) {
+		return array();
+	}
+
+	return $fields;
+}
+
+/**
+ * Get teams for the exporter.
+ *
+ * @param int $league_id League ID.
+ * @param int $season_id Season ID.
+ * @return WP_Post[]
+ */
+function tse_sp_schedule_exporter_get_teams( $league_id = 0, $season_id = 0 ) {
+	$tax_query = array();
+
+	if ( $league_id > 0 ) {
+		$tax_query[] = array(
+			'taxonomy' => 'sp_league',
+			'field'    => 'term_id',
+			'terms'    => array( $league_id ),
+		);
+	}
+
+	if ( $season_id > 0 ) {
+		$tax_query[] = array(
+			'taxonomy' => 'sp_season',
+			'field'    => 'term_id',
+			'terms'    => array( $season_id ),
+		);
+	}
+
+	$args = array(
+		'post_type'      => 'sp_team',
+		'post_status'    => 'publish',
+		'posts_per_page' => -1,
+		'orderby'        => 'title',
+		'order'          => 'ASC',
+		'no_found_rows'  => true,
+		'update_post_meta_cache' => false,
+		'update_post_term_cache' => false,
+		'cache_results'          => false,
+	);
+
+	if ( ! empty( $tax_query ) ) {
+		if ( count( $tax_query ) > 1 ) {
+			$tax_query['relation'] = 'AND';
+		}
+
+		$args['tax_query'] = $tax_query;
+	}
+
+	$teams = get_posts( $args );
+
+	return is_array( $teams ) ? $teams : array();
+}
+
+/**
+ * Resolve selected team ID.
+ *
+ * @param WP_Post[] $teams Team posts.
+ * @return int
+ */
+function tse_sp_schedule_exporter_resolve_team_id( $teams ) {
+	$requested = isset( $_GET['team_id'] ) ? absint( wp_unslash( $_GET['team_id'] ) ) : 0;
+	if ( $requested > 0 && 'sp_team' === get_post_type( $requested ) ) {
+		foreach ( $teams as $team ) {
+			if ( $team instanceof WP_Post && (int) $team->ID === $requested ) {
+				return $requested;
+			}
+		}
+	}
+
+	if ( isset( $teams[0] ) && $teams[0] instanceof WP_Post ) {
+		return (int) $teams[0]->ID;
+	}
+
+	return 0;
+}
+
+/**
+ * Resolve selected field ID.
+ *
+ * @param WP_Term[] $fields Field terms.
+ * @return int
+ */
+function tse_sp_schedule_exporter_resolve_field_id( $fields ) {
+	$requested = isset( $_GET['field_id'] ) ? absint( wp_unslash( $_GET['field_id'] ) ) : 0;
+
+	if ( 0 === $requested ) {
+		return 0;
+	}
+
+	foreach ( $fields as $field ) {
+		if ( $field instanceof WP_Term && (int) $field->term_id === $requested ) {
+			return $requested;
+		}
+	}
+
+	return 0;
+}
+
+/**
+ * Render selectable columns for a format.
+ *
+ * @param string $format  Export format.
+ * @param string $context Render context suffix.
+ * @return void
+ */
+function tse_sp_schedule_exporter_render_column_picker( $format, $context, $active_format = '' ) {
+	$format      = tse_sp_event_export_sanitize_format( $format );
+	$definitions = tse_sp_event_export_get_column_definitions();
+	$columns     = isset( $definitions[ $format ] ) ? $definitions[ $format ] : array();
+	$selected    = tse_sp_event_export_get_default_columns( $format );
+	$formats     = tse_sp_event_export_get_formats();
+	$legend      = isset( $formats[ $format ]['label'] ) ? $formats[ $format ]['label'] : ucfirst( $format );
+
+	if ( empty( $columns ) ) {
+		return;
+	}
+
+	$style = 'margin:18px 0;padding:16px;border:1px solid #d7d7db;';
+	if ( $active_format && $active_format !== $format ) {
+		$style .= 'display:none;';
+	}
+
+	echo '<fieldset data-column-group="' . esc_attr( $format ) . '" style="' . esc_attr( $style ) . '">';
+	echo '<legend><strong>' . esc_html( sprintf( __( '%s Columns', 'tonys-sportspress-enhancements' ), $legend ) ) . '</strong></legend>';
+	echo '<div style="display:flex;flex-wrap:wrap;gap:12px 18px;">';
+
+	foreach ( $columns as $column_key => $column_label ) {
+		$input_id = sprintf( 'tse-columns-%1$s-%2$s-%3$s', sanitize_html_class( $context ), sanitize_html_class( $format ), sanitize_html_class( $column_key ) );
+
+		echo '<label for="' . esc_attr( $input_id ) . '" style="display:inline-flex;align-items:center;gap:6px;">';
+		echo '<input id="' . esc_attr( $input_id ) . '" type="checkbox" data-columns-format="' . esc_attr( $format ) . '" value="' . esc_attr( $column_key ) . '" ' . checked( in_array( $column_key, $selected, true ), true, false ) . ' />';
+		echo esc_html( $column_label );
+		echo '</label>';
+	}
+
+	echo '</div>';
+	echo '<p class="description" style="margin:10px 0 0;">' . esc_html__( 'These checkboxes only change the CSV feed link. iCal and printable links use the same shared filters but ignore columns.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '</fieldset>';
+}
+
+/**
+ * Resolve selected league ID.
+ *
+ * @param WP_Term[] $leagues League terms.
+ * @return int
+ */
+function tse_sp_schedule_exporter_resolve_league_id( $leagues ) {
+	$requested = isset( $_GET['league_id'] ) ? absint( wp_unslash( $_GET['league_id'] ) ) : 0;
+	if ( $requested > 0 ) {
+		return $requested;
+	}
+
+	foreach ( $leagues as $league ) {
+		if ( ! $league instanceof WP_Term ) {
+			continue;
+		}
+
+		$slug = isset( $league->slug ) ? strtolower( (string) $league->slug ) : '';
+		$name = isset( $league->name ) ? strtolower( trim( (string) $league->name ) ) : '';
+
+		if ( 'cmba' === $slug || 'cmba' === $name ) {
+			return (int) $league->term_id;
+		}
+	}
+
+	if ( isset( $leagues[0] ) && $leagues[0] instanceof WP_Term ) {
+		return (int) $leagues[0]->term_id;
+	}
+
+	return 0;
+}
+
+/**
+ * Resolve selected season ID.
+ *
+ * @param WP_Term[] $seasons Season terms.
+ * @return int
+ */
+function tse_sp_schedule_exporter_resolve_season_id( $seasons ) {
+	$requested = isset( $_GET['season_id'] ) ? absint( wp_unslash( $_GET['season_id'] ) ) : 0;
+	if ( $requested > 0 ) {
+		return $requested;
+	}
+
+	$current = absint( (string) get_option( 'sportspress_season', '0' ) );
+	if ( $current > 0 ) {
+		return $current;
+	}
+
+	if ( isset( $seasons[0] ) && is_object( $seasons[0] ) && isset( $seasons[0]->term_id ) ) {
+		return (int) $seasons[0]->term_id;
+	}
+
+	return 0;
+}
+
+/**
+ * Get supported paper sizes.
+ *
+ * @return array
+ */
+function tse_sp_schedule_exporter_get_paper_sizes() {
+	return array(
+		'letter' => __( 'Letter', 'tonys-sportspress-enhancements' ),
+		'ledger' => __( '11x17 / Ledger', 'tonys-sportspress-enhancements' ),
+	);
+}
+
+/**
+ * Resolve selected paper size.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_resolve_paper_size() {
+	$paper = isset( $_GET['paper'] ) ? sanitize_key( wp_unslash( $_GET['paper'] ) ) : 'letter';
+
+	return array_key_exists( $paper, tse_sp_schedule_exporter_get_paper_sizes() ) ? $paper : 'letter';
+}
+
+/**
+ * Resolve selected export format.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_resolve_format() {
+	$requested = isset( $_GET['format'] ) ? sanitize_key( wp_unslash( $_GET['format'] ) ) : 'matchup';
+
+	return tse_sp_event_export_sanitize_format( $requested );
+}
+
+/**
+ * Get supported exporter output types.
+ *
+ * @return array
+ */
+function tse_sp_schedule_exporter_get_export_types() {
+	return array(
+		'csv'       => __( 'CSV', 'tonys-sportspress-enhancements' ),
+		'ics'       => __( 'iCal Link', 'tonys-sportspress-enhancements' ),
+		'printable' => __( 'Printable', 'tonys-sportspress-enhancements' ),
+	);
+}
+
+/**
+ * Resolve selected exporter output type.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_resolve_export_type() {
+	$requested = isset( $_GET['export_type'] ) ? sanitize_key( wp_unslash( $_GET['export_type'] ) ) : 'csv';
+	$types     = tse_sp_schedule_exporter_get_export_types();
+
+	return isset( $types[ $requested ] ) ? $requested : 'csv';
+}
+
+/**
+ * Resolve selected CSV subformat.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_resolve_subformat() {
+	$requested = isset( $_GET['subformat'] ) ? sanitize_key( wp_unslash( $_GET['subformat'] ) ) : 'matchup';
+
+	return tse_sp_event_export_sanitize_format( $requested );
+}
+
+/**
+ * Get current output URL for the selected export type.
+ *
+ * @param string $export_type Export type.
+ * @param string $csv_url     CSV URL.
+ * @param string $ics_url     ICS URL.
+ * @param string $print_url   Printable URL.
+ * @return string
+ */
+function tse_sp_schedule_exporter_get_output_url( $export_type, $csv_url, $ics_url, $print_url ) {
+	if ( 'ics' === $export_type ) {
+		return $ics_url;
+	}
+
+	if ( 'printable' === $export_type ) {
+		return $print_url;
+	}
+
+	return $csv_url;
+}
+
+/**
+ * Collect team schedule events for export.
+ *
+ * @param int $team_id   Team ID.
+ * @param int $season_id Optional season ID.
+ * @param int $league_id Optional league ID.
+ * @return array
+ */
+function tse_sp_schedule_exporter_get_events( $team_id, $season_id = 0, $league_id = 0 ) {
+	$team_id = absint( $team_id );
+	if ( $team_id <= 0 || 'sp_team' !== get_post_type( $team_id ) ) {
+		return array();
+	}
+
+	$args = array(
+		'post_type'      => 'sp_event',
+		'post_status'    => array( 'publish', 'future' ),
+		'posts_per_page' => -1,
+		'orderby'        => 'date',
+		'order'          => 'ASC',
+		'no_found_rows'  => true,
+		'meta_query'     => array(
+			array(
+				'key'     => 'sp_team',
+				'value'   => array( (string) $team_id ),
+				'compare' => 'IN',
+			),
+		),
+	);
+
+	$tax_query = array();
+
+	if ( $season_id > 0 ) {
+		$tax_query[] = array(
+			'taxonomy' => 'sp_season',
+			'field'    => 'term_id',
+			'terms'    => array( $season_id ),
+		);
+	}
+
+	if ( $league_id > 0 ) {
+		$tax_query[] = array(
+			'taxonomy' => 'sp_league',
+			'field'    => 'term_id',
+			'terms'    => array( $league_id ),
+		);
+	}
+
+	if ( ! empty( $tax_query ) ) {
+		if ( count( $tax_query ) > 1 ) {
+			$tax_query['relation'] = 'AND';
+		}
+
+		$args['tax_query'] = $tax_query;
+	}
+
+	$query   = new WP_Query( $args );
+	$events   = array();
+	$team_name = get_the_title( $team_id );
+
+	foreach ( $query->posts as $event ) {
+		$event_id = $event instanceof WP_Post ? (int) $event->ID : 0;
+		if ( $event_id <= 0 ) {
+			continue;
+		}
+
+		$teams = array_values( array_unique( array_map( 'intval', get_post_meta( $event_id, 'sp_team', false ) ) ) );
+		if ( ! in_array( $team_id, $teams, true ) ) {
+			continue;
+		}
+
+		$home_id = isset( $teams[0] ) ? (int) $teams[0] : 0;
+		$away_id = isset( $teams[1] ) ? (int) $teams[1] : 0;
+
+		$location_flag = $home_id === $team_id ? 'Home' : 'Away';
+		$opponent_id   = $home_id === $team_id ? $away_id : $home_id;
+		$venue         = tse_sp_schedule_exporter_get_primary_venue( $event_id );
+
+		$events[] = array(
+			'label'               => '',
+			'event_id'            => $event_id,
+			'date'                => get_post_time( 'm/d/Y', false, $event_id, true ),
+			'time'                => strtoupper( (string) ( function_exists( 'sp_get_time' ) ? sp_get_time( $event_id ) : get_post_time( get_option( 'time_format' ), false, $event_id, true ) ) ),
+			'team_name'           => is_string( $team_name ) ? $team_name : '',
+			'opponent_name'       => $opponent_id > 0 ? get_the_title( $opponent_id ) : __( 'TBD', 'tonys-sportspress-enhancements' ),
+			'location_flag'       => $location_flag,
+			'home_team'           => $home_id > 0 ? get_the_title( $home_id ) : '',
+			'away_team'           => $away_id > 0 ? get_the_title( $away_id ) : '',
+			'venue_name'          => isset( $venue['name'] ) ? $venue['name'] : '',
+			'venue_abbreviation'  => isset( $venue['abbreviation'] ) ? $venue['abbreviation'] : '',
+			'venue_short_name'    => isset( $venue['short_name'] ) ? $venue['short_name'] : '',
+		);
+	}
+
+	foreach ( $events as $index => $event ) {
+		$events[ $index ]['label'] = sprintf( 'G#%02d', $index + 1 );
+	}
+
+	wp_reset_postdata();
+
+	return $events;
+}
+
+/**
+ * Get the primary venue details for an event.
+ *
+ * @param int $event_id Event ID.
+ * @return array
+ */
+function tse_sp_schedule_exporter_get_primary_venue( $event_id ) {
+	$venues = get_the_terms( $event_id, 'sp_venue' );
+
+	if ( ! is_array( $venues ) || ! isset( $venues[0] ) || ! $venues[0] instanceof WP_Term ) {
+		return array(
+			'name'         => '',
+			'abbreviation' => '',
+			'short_name'   => '',
+		);
+	}
+
+	$venue = $venues[0];
+
+	return array(
+		'name'         => isset( $venue->name ) ? (string) $venue->name : '',
+		'abbreviation' => trim( (string) get_term_meta( $venue->term_id, 'tse_abbreviation', true ) ),
+		'short_name'   => trim( (string) get_term_meta( $venue->term_id, 'tse_short_name', true ) ),
+	);
+}
+
+/**
+ * Build the printable page URL.
+ *
+ * @param int    $team_id   Team ID.
+ * @param int    $season_id Season ID.
+ * @param string $paper     Paper size.
+ * @param int    $league_id League ID.
+ * @return string
+ */
+function tse_sp_schedule_exporter_get_printable_url( $team_id, $season_id, $paper, $league_id = 0, $autoprint = false ) {
+	return add_query_arg(
+		array(
+			Tony_Sportspress_Printable_Calendars::QUERY_FLAG => '1',
+			'sp_team'                                        => (string) absint( $team_id ),
+			'sp_season'                                      => $season_id > 0 ? (string) absint( $season_id ) : '',
+			'sp_league'                                      => $league_id > 0 ? (string) absint( $league_id ) : '',
+			'paper'                                          => $paper,
+			'autoprint'                                      => $autoprint ? '1' : '',
+		),
+		home_url( '/' )
+	);
+}
+
+/**
+ * Render a small script that keeps export links in sync with current selections.
+ *
+ * @param bool $echo Whether to echo immediately.
+ * @return string
+ */
+function tse_sp_schedule_exporter_render_link_sync_script( $echo = false ) {
+	$script = <<<HTML
+<script>
+(function(){
+	function copyText(text, done){
+		if (navigator.clipboard && navigator.clipboard.writeText) {
+			navigator.clipboard.writeText(text).then(done).catch(function(){
+				var input = document.createElement('input');
+				input.value = text;
+				document.body.appendChild(input);
+				input.focus();
+				input.select();
+				document.execCommand('copy');
+				document.body.removeChild(input);
+				done();
+			});
+			return;
+		}
+		var input = document.createElement('input');
+		input.value = text;
+		document.body.appendChild(input);
+		input.focus();
+		input.select();
+		document.execCommand('copy');
+		document.body.removeChild(input);
+		done();
+	}
+
+	function syncLinks(scope){
+		var form = scope.querySelector('.tse-schedule-exporter-form');
+		if (!form) {
+			return;
+		}
+
+		var league = form.querySelector('[name="league_id"]');
+		var season = form.querySelector('[name="season_id"]');
+		var team = form.querySelector('[name="team_id"]');
+		var exportType = form.querySelector('[name="export_type"]');
+		var subformat = form.querySelector('[name="subformat"]');
+		var field = form.querySelector('[name="field_id"]');
+		var outputUrl = scope.querySelector('.tse-output-url');
+		var openButton = scope.querySelector('.tse-open-link');
+		var iosButton = scope.querySelector('.tse-ics-ios-link');
+		var androidButton = scope.querySelector('.tse-ics-android-link');
+		var outputNote = scope.querySelector('.tse-output-note');
+		var copyButton = scope.querySelector('.tse-copy-link');
+		var teamValue = team ? (team.value || '0') : '0';
+		var activeSubformat = subformat ? (subformat.value || 'matchup') : 'matchup';
+		var selectedExportType = exportType ? (exportType.value || 'csv') : 'csv';
+
+		scope.querySelectorAll('[data-column-group]').forEach(function(group){
+			var visible = selectedExportType === 'csv' && group.getAttribute('data-column-group') === activeSubformat;
+			group.style.display = visible ? 'block' : 'none';
+		});
+
+		if (scope.querySelector('[data-subformat-wrap]')) {
+			scope.querySelectorAll('[data-subformat-wrap]').forEach(function(wrap){
+				wrap.style.display = selectedExportType === 'csv' ? 'block' : 'none';
+			});
+		}
+
+		var csvUrl = openButton ? new URL(openButton.dataset.csvUrl, window.location.origin) : null;
+		var icsUrl = openButton ? new URL(openButton.dataset.icsUrl, window.location.origin) : null;
+		var printUrl = openButton ? new URL(openButton.dataset.printUrl, window.location.origin) : null;
+
+		if (csvUrl) {
+			if (league) csvUrl.searchParams.set('league_id', league.value || '0');
+			if (season) csvUrl.searchParams.set('season_id', season.value || '0');
+			if (team) csvUrl.searchParams.set('team_id', teamValue);
+			if (field) csvUrl.searchParams.set('field_id', field.value || '0');
+			csvUrl.searchParams.set('format', activeSubformat);
+			var columns = Array.prototype.slice.call(scope.querySelectorAll('[data-columns-format="' + activeSubformat + '"]:checked')).map(function(input){
+				return input.value;
+			}).filter(Boolean);
+			if (columns.length) {
+				csvUrl.searchParams.set('columns', columns.join(','));
+			} else {
+				csvUrl.searchParams.delete('columns');
+			}
+		}
+
+		if (icsUrl) {
+			if (league) icsUrl.searchParams.set('league_id', league.value || '0');
+			if (season) icsUrl.searchParams.set('season_id', season.value || '0');
+			if (team) icsUrl.searchParams.set('team_id', teamValue);
+			if (field) icsUrl.searchParams.set('field_id', field.value || '0');
+			icsUrl.searchParams.delete('format');
+			icsUrl.searchParams.delete('columns');
+		}
+
+		if (printUrl) {
+			if (league) printUrl.searchParams.set('sp_league', league.value || '0');
+			if (season) printUrl.searchParams.set('sp_season', season.value || '0');
+			if (team) printUrl.searchParams.set('sp_team', teamValue);
+			printUrl.searchParams.set('paper', 'letter');
+		}
+
+		var resolvedUrl = csvUrl ? csvUrl.toString() : '';
+		var label = 'Open URL in New Tab';
+		var disabled = false;
+		var note = 'Use the buttons to copy the generated URL or open the right destination for this export type.';
+		var iosUrl = icsUrl ? icsUrl.toString().replace(/^https?:\/\//, 'webcal://') : '';
+		var androidUrl = icsUrl ? 'https://calendar.google.com/calendar/render?cid=' + encodeURIComponent(icsUrl.toString()) : '';
+
+		if (selectedExportType === 'ics' && icsUrl) {
+			resolvedUrl = icsUrl.toString();
+			note = 'Use the iPhone/iPad or Android button to subscribe, or copy the feed URL.';
+		} else if (selectedExportType === 'printable' && printUrl) {
+			resolvedUrl = printUrl.toString();
+			if (teamValue === '0') {
+				disabled = true;
+				note = 'Printable requires a specific team. All teams is not supported.';
+			}
+		} else if (selectedExportType === 'csv' && activeSubformat === 'team' && teamValue === '0') {
+			disabled = true;
+			note = 'CSV team layout requires a specific team. All teams is not supported.';
+		}
+
+		if (outputUrl) {
+			outputUrl.value = resolvedUrl;
+		}
+
+		if (openButton) {
+			openButton.dataset.currentUrl = resolvedUrl;
+			openButton.textContent = label;
+			openButton.style.display = selectedExportType === 'ics' ? 'none' : 'inline-flex';
+			openButton.disabled = disabled;
+			openButton.setAttribute('aria-disabled', disabled ? 'true' : 'false');
+			openButton.style.opacity = disabled ? '0.55' : '1';
+		}
+
+		if (iosButton) {
+			iosButton.dataset.currentUrl = iosUrl;
+			iosButton.style.display = selectedExportType === 'ics' ? 'inline-flex' : 'none';
+			iosButton.disabled = !iosUrl;
+			iosButton.setAttribute('aria-disabled', !iosUrl ? 'true' : 'false');
+			iosButton.style.opacity = !iosUrl ? '0.55' : '1';
+		}
+
+		if (androidButton) {
+			androidButton.dataset.currentUrl = androidUrl;
+			androidButton.style.display = selectedExportType === 'ics' ? 'inline-flex' : 'none';
+			androidButton.disabled = !androidUrl;
+			androidButton.setAttribute('aria-disabled', !androidUrl ? 'true' : 'false');
+			androidButton.style.opacity = !androidUrl ? '0.55' : '1';
+		}
+
+		if (outputNote) {
+			outputNote.textContent = note;
+		}
+
+		if (copyButton) {
+			copyButton.disabled = disabled;
+		}
+	}
+
+	document.querySelectorAll('.tse-schedule-exporter, .wrap').forEach(function(scope){
+		if (!scope.querySelector('.tse-schedule-exporter-form')) {
+			return;
+		}
+
+		syncLinks(scope);
+
+		scope.querySelectorAll('.tse-schedule-exporter-form select').forEach(function(select){
+			select.addEventListener('change', function(){
+				if (select.dataset.autoSubmit === '1') {
+					select.form.submit();
+					return;
+				}
+
+				syncLinks(scope);
+			});
+		});
+
+		scope.querySelectorAll('[data-columns-format]').forEach(function(input){
+			input.addEventListener('change', function(){
+				syncLinks(scope);
+			});
+		});
+
+		var copyButton = scope.querySelector('.tse-copy-link');
+		var openButton = scope.querySelector('.tse-open-link');
+		var iosButton = scope.querySelector('.tse-ics-ios-link');
+		var androidButton = scope.querySelector('.tse-ics-android-link');
+		var outputUrl = scope.querySelector('.tse-output-url');
+		if (copyButton && outputUrl) {
+			copyButton.addEventListener('click', function(){
+				if (copyButton.disabled || !outputUrl.value) {
+					return;
+				}
+
+				var defaultTitle = copyButton.getAttribute('data-default-title') || copyButton.title || 'Copy URL';
+				copyButton.setAttribute('data-default-title', defaultTitle);
+
+				copyText(outputUrl.value, function(){
+					copyButton.title = 'Copied';
+					window.setTimeout(function(){
+						copyButton.title = defaultTitle;
+					}, 1200);
+				});
+			});
+		}
+
+		if (openButton && outputUrl) {
+			openButton.addEventListener('click', function(){
+				if (openButton.disabled || !outputUrl.value) {
+					return;
+				}
+
+				window.open(outputUrl.value, '_blank', 'noopener,noreferrer');
+			});
+		}
+
+		if (iosButton) {
+			iosButton.addEventListener('click', function(){
+				var targetUrl = iosButton.dataset.currentUrl || '';
+				if (iosButton.disabled || !targetUrl) {
+					return;
+				}
+
+				window.location.href = targetUrl;
+			});
+		}
+
+		if (androidButton) {
+			androidButton.addEventListener('click', function(){
+				var targetUrl = androidButton.dataset.currentUrl || '';
+				if (androidButton.disabled || !targetUrl) {
+					return;
+				}
+
+				window.open(targetUrl, '_blank', 'noopener,noreferrer');
+			});
+		}
+	});
+})();
+</script>
+HTML;
+
+	if ( $echo ) {
+		echo $script; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+		return '';
+	}
+
+	return $script;
+}

includes/sp-url-builder.php

@@ -0,0 +1,287 @@
+<?php
+/**
+ * Tony's Settings CSV URL builder tab.
+ *
+ * @package Tonys_Sportspress_Enhancements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Register the URL builder tab label.
+ *
+ * @param array $tabs Existing tab map.
+ * @return array
+ */
+function tse_sp_url_builder_register_tab( $tabs ) {
+	$tabs['url-builder'] = __( 'Feed Builder', 'tonys-sportspress-enhancements' );
+
+	return $tabs;
+}
+add_filter( 'tse_tonys_settings_tabs', 'tse_sp_url_builder_register_tab' );
+
+/**
+ * Render the URL builder tab.
+ *
+ * @return void
+ */
+function tse_sp_url_builder_render_tab() {
+	$leagues = function_exists( 'tse_sp_schedule_exporter_get_leagues' ) ? tse_sp_schedule_exporter_get_leagues() : array();
+	$seasons = function_exists( 'tse_sp_schedule_exporter_get_seasons' ) ? tse_sp_schedule_exporter_get_seasons() : array();
+	$teams   = function_exists( 'tse_sp_schedule_exporter_get_teams' ) ? tse_sp_schedule_exporter_get_teams() : array();
+	$fields  = function_exists( 'tse_sp_schedule_exporter_get_fields' ) ? tse_sp_schedule_exporter_get_fields() : array();
+	$formats = function_exists( 'tse_sp_event_export_get_formats' ) ? tse_sp_event_export_get_formats() : array();
+	$columns = function_exists( 'tse_sp_event_export_get_column_definitions' ) ? tse_sp_event_export_get_column_definitions() : array();
+
+	echo '<h2>' . esc_html__( 'Feed Builder', 'tonys-sportspress-enhancements' ) . '</h2>';
+	echo '<p>' . esc_html__( 'Build a shareable CSV feed URL with format, filters, and custom columns. This does not save settings.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '<div class="tse-url-builder" style="max-width:1100px;padding:20px 24px;border:1px solid #dcdcde;background:#fff;">';
+	echo '<table class="form-table" role="presentation"><tbody>';
+
+	echo '<tr><th scope="row"><label for="tse-url-builder-feed-type">' . esc_html__( 'Feed Type', 'tonys-sportspress-enhancements' ) . '</label></th><td>';
+	echo '<select id="tse-url-builder-feed-type">';
+	echo '<option value="csv">' . esc_html__( 'CSV', 'tonys-sportspress-enhancements' ) . '</option>';
+	echo '<option value="ics">' . esc_html__( 'iCal / ICS', 'tonys-sportspress-enhancements' ) . '</option>';
+	echo '</select>';
+	echo '</td></tr>';
+
+	echo '<tr><th scope="row"><label for="tse-url-builder-format">' . esc_html__( 'Format', 'tonys-sportspress-enhancements' ) . '</label></th><td>';
+	echo '<select id="tse-url-builder-format">';
+	foreach ( $formats as $format_key => $format ) {
+		echo '<option value="' . esc_attr( $format_key ) . '">' . esc_html( $format['label'] ) . '</option>';
+	}
+	echo '</select>';
+	echo '</td></tr>';
+
+	echo '<tr><th scope="row">' . esc_html__( 'League', 'tonys-sportspress-enhancements' ) . '</th><td>';
+	echo '<div id="tse-url-builder-league" style="display:flex;flex-wrap:wrap;gap:10px 14px;max-width:720px;">';
+	foreach ( $leagues as $league ) {
+		$input_id = 'tse-url-builder-league-' . absint( $league->term_id );
+		echo '<label for="' . esc_attr( $input_id ) . '" style="display:inline-flex;align-items:center;gap:6px;">';
+		echo '<input id="' . esc_attr( $input_id ) . '" type="checkbox" data-tse-builder-filter="league_id" value="' . esc_attr( (string) $league->term_id ) . '" />';
+		echo esc_html( $league->name );
+		echo '</label>';
+	}
+	echo '</div>';
+	echo '<p class="description">' . esc_html__( 'Select one or more leagues. Leave empty to include all leagues.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '</td></tr>';
+
+	echo '<tr><th scope="row">' . esc_html__( 'Season', 'tonys-sportspress-enhancements' ) . '</th><td>';
+	echo '<div id="tse-url-builder-season" style="display:flex;flex-wrap:wrap;gap:10px 14px;max-width:720px;">';
+	foreach ( $seasons as $season ) {
+		$input_id = 'tse-url-builder-season-' . absint( $season->term_id );
+		echo '<label for="' . esc_attr( $input_id ) . '" style="display:inline-flex;align-items:center;gap:6px;">';
+		echo '<input id="' . esc_attr( $input_id ) . '" type="checkbox" data-tse-builder-filter="season_id" value="' . esc_attr( (string) $season->term_id ) . '" />';
+		echo esc_html( $season->name );
+		echo '</label>';
+	}
+	echo '</div>';
+	echo '<p class="description">' . esc_html__( 'Select one or more seasons. Leave empty to include all seasons.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '</td></tr>';
+
+	echo '<tr><th scope="row">' . esc_html__( 'Team', 'tonys-sportspress-enhancements' ) . '</th><td>';
+	echo '<div id="tse-url-builder-team" style="display:flex;flex-wrap:wrap;gap:10px 14px;max-width:720px;">';
+	foreach ( $teams as $team ) {
+		$input_id = 'tse-url-builder-team-' . absint( $team->ID );
+		echo '<label for="' . esc_attr( $input_id ) . '" style="display:inline-flex;align-items:center;gap:6px;">';
+		echo '<input id="' . esc_attr( $input_id ) . '" type="checkbox" data-tse-builder-filter="team_id" value="' . esc_attr( (string) $team->ID ) . '" />';
+		echo esc_html( $team->post_title );
+		echo '</label>';
+	}
+	echo '</div>';
+	echo '<p class="description">' . esc_html__( 'Select one or more teams. Team format requires exactly one team.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '</td></tr>';
+
+	echo '<tr><th scope="row">' . esc_html__( 'Field', 'tonys-sportspress-enhancements' ) . '</th><td>';
+	echo '<div id="tse-url-builder-field" style="display:flex;flex-wrap:wrap;gap:10px 14px;max-width:720px;">';
+	foreach ( $fields as $field ) {
+		$input_id = 'tse-url-builder-field-' . absint( $field->term_id );
+		echo '<label for="' . esc_attr( $input_id ) . '" style="display:inline-flex;align-items:center;gap:6px;">';
+		echo '<input id="' . esc_attr( $input_id ) . '" type="checkbox" data-tse-builder-filter="field_id" value="' . esc_attr( (string) $field->term_id ) . '" />';
+		echo esc_html( $field->name );
+		echo '</label>';
+	}
+	echo '</div>';
+	echo '<p class="description">' . esc_html__( 'Select one or more fields. Leave empty to include all fields.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '</td></tr>';
+
+	echo '</tbody></table>';
+
+	echo '<div style="display:grid;gap:16px;margin-top:20px;">';
+	foreach ( $columns as $format_key => $format_columns ) {
+		$default_columns = function_exists( 'tse_sp_event_export_get_default_columns' ) ? tse_sp_event_export_get_default_columns( $format_key ) : array();
+		$label           = isset( $formats[ $format_key ]['label'] ) ? $formats[ $format_key ]['label'] : ucfirst( $format_key );
+
+		echo '<fieldset data-tse-builder-columns="' . esc_attr( $format_key ) . '" style="margin:0;padding:16px;border:1px solid #d7d7db;">';
+		echo '<legend><strong>' . esc_html( sprintf( __( '%s Columns', 'tonys-sportspress-enhancements' ), $label ) ) . '</strong></legend>';
+		echo '<div style="display:flex;flex-wrap:wrap;gap:12px 18px;">';
+		foreach ( $format_columns as $column_key => $column_label ) {
+			$input_id = 'tse-url-builder-' . sanitize_html_class( $format_key . '-' . $column_key );
+			echo '<label for="' . esc_attr( $input_id ) . '" style="display:inline-flex;align-items:center;gap:6px;">';
+			echo '<input id="' . esc_attr( $input_id ) . '" type="checkbox" data-tse-builder-column="' . esc_attr( $format_key ) . '" value="' . esc_attr( $column_key ) . '" ' . checked( in_array( $column_key, $default_columns, true ), true, false ) . ' />';
+			echo esc_html( $column_label );
+			echo '</label>';
+		}
+		echo '</div>';
+		echo '</fieldset>';
+	}
+	echo '</div>';
+
+	echo '<h3 style="margin-top:24px;">' . esc_html__( 'Generated URL', 'tonys-sportspress-enhancements' ) . '</h3>';
+	echo '<div style="display:flex;align-items:center;gap:8px;max-width:100%;">';
+	echo '<input type="text" id="tse-url-builder-output" class="large-text code" readonly="readonly" />';
+	echo '<button type="button" id="tse-url-builder-copy" class="button" aria-label="' . esc_attr__( 'Copy URL', 'tonys-sportspress-enhancements' ) . '" title="' . esc_attr__( 'Copy URL', 'tonys-sportspress-enhancements' ) . '" style="display:inline-flex;align-items:center;justify-content:center;min-width:40px;padding:0 10px;">';
+	echo '<span aria-hidden="true" style="font-size:16px;line-height:1;">⧉</span>';
+	echo '</button>';
+	echo '</div>';
+	echo '<p><a id="tse-url-builder-open" class="button button-primary" href="' . esc_url( home_url( '/' ) ) . '" target="_blank" rel="noopener noreferrer">' . esc_html__( 'Open Feed URL', 'tonys-sportspress-enhancements' ) . '</a></p>';
+	echo '<p class="description">' . esc_html__( 'The builder always generates the standalone CSV feed endpoint using the selected filters and columns.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '</div>';
+
+	tse_sp_url_builder_render_script();
+}
+add_action( 'tse_tonys_settings_render_tab_url-builder', 'tse_sp_url_builder_render_tab' );
+
+/**
+ * Render builder script.
+ *
+ * @return void
+ */
+function tse_sp_url_builder_render_script() {
+	$base_url = home_url( '/' );
+	?>
+	<script>
+	(function(){
+		var root = document.querySelector('.tse-url-builder');
+		if (!root) {
+			return;
+		}
+
+		var baseUrl = <?php echo wp_json_encode( $base_url ); ?>;
+		var labelOpenIcs = <?php echo wp_json_encode( __( 'Open ICS Feed', 'tonys-sportspress-enhancements' ) ); ?>;
+		var labelOpenCsv = <?php echo wp_json_encode( __( 'Open Feed URL', 'tonys-sportspress-enhancements' ) ); ?>;
+		var feedType = root.querySelector('#tse-url-builder-feed-type');
+		var format = root.querySelector('#tse-url-builder-format');
+		var output = root.querySelector('#tse-url-builder-output');
+		var copyButton = root.querySelector('#tse-url-builder-copy');
+		var openLink = root.querySelector('#tse-url-builder-open');
+
+		function getSelectedValues(filterName) {
+			return Array.prototype.slice.call(root.querySelectorAll('[data-tse-builder-filter="' + filterName + '"]:checked')).map(function(input){
+				return input.value;
+			});
+		}
+
+		function syncColumnGroups() {
+			var selectedFormat = format.value || 'matchup';
+			var isCsv = (feedType.value || 'csv') === 'csv';
+			root.querySelectorAll('[data-tse-builder-columns]').forEach(function(group){
+				group.style.display = (isCsv && group.getAttribute('data-tse-builder-columns') === selectedFormat) ? 'block' : 'none';
+			});
+		}
+
+		function buildUrl() {
+			var selectedFeedType = feedType.value || 'csv';
+			var selectedFormat = format.value || 'matchup';
+			var url = new URL(baseUrl, window.location.origin);
+			var leagues = getSelectedValues('league_id');
+			var seasons = getSelectedValues('season_id');
+			var teams = getSelectedValues('team_id');
+			var fields = getSelectedValues('field_id');
+			var selectedColumns = Array.prototype.slice.call(root.querySelectorAll('[data-tse-builder-column="' + selectedFormat + '"]:checked')).map(function(input){
+				return input.value;
+			}).filter(Boolean);
+
+			url.searchParams.set('feed', selectedFeedType === 'ics' ? 'sp-ics' : 'sp-csv');
+			url.searchParams.set('format', selectedFormat);
+
+			if (leagues.length) {
+				url.searchParams.set('league_id', leagues.join(','));
+			} else {
+				url.searchParams.delete('league_id');
+			}
+			if (seasons.length) {
+				url.searchParams.set('season_id', seasons.join(','));
+			} else {
+				url.searchParams.delete('season_id');
+			}
+			if (teams.length) {
+				url.searchParams.set('team_id', teams.join(','));
+			} else {
+				url.searchParams.delete('team_id');
+			}
+			if (fields.length) {
+				url.searchParams.set('field_id', fields.join(','));
+			} else {
+				url.searchParams.delete('field_id');
+			}
+			if (selectedFeedType === 'csv' && selectedColumns.length) {
+				url.searchParams.set('columns', selectedColumns.join(','));
+			} else {
+				url.searchParams.delete('columns');
+			}
+
+			output.value = url.toString();
+			openLink.href = url.toString();
+			openLink.textContent = selectedFeedType === 'ics' ? labelOpenIcs : labelOpenCsv;
+		}
+
+		syncColumnGroups();
+		buildUrl();
+
+		[feedType, format].forEach(function(input){
+			input.addEventListener('change', function(){
+				syncColumnGroups();
+				buildUrl();
+			});
+		});
+
+		root.querySelectorAll('[data-tse-builder-filter]').forEach(function(input){
+			input.addEventListener('change', buildUrl);
+		});
+
+		root.querySelectorAll('[data-tse-builder-column]').forEach(function(input){
+			input.addEventListener('change', buildUrl);
+		});
+
+		if (copyButton) {
+			copyButton.addEventListener('click', function(){
+				var value = output.value || '';
+				if (!value) {
+					return;
+				}
+
+				var defaultTitle = copyButton.getAttribute('data-default-title') || copyButton.title || 'Copy URL';
+				copyButton.setAttribute('data-default-title', defaultTitle);
+
+				function markCopied() {
+					copyButton.title = 'Copied';
+					window.setTimeout(function(){
+						copyButton.title = defaultTitle;
+					}, 1200);
+				}
+
+				if (navigator.clipboard && navigator.clipboard.writeText) {
+					navigator.clipboard.writeText(value).then(function(){
+						markCopied();
+					}).catch(function(){
+						output.focus();
+						output.select();
+						document.execCommand('copy');
+						markCopied();
+					});
+					return;
+				}
+
+				output.focus();
+				output.select();
+				document.execCommand('copy');
+				markCopied();
+			});
+		}
+	})();
+	</script>
+	<?php
+}

includes/sp-venue-meta.php

@@ -0,0 +1,116 @@
+<?php
+/**
+ * Venue term metadata support.
+ *
+ * Adds short name and abbreviation fields to SportsPress venues.
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Register venue term meta.
+ */
+function tony_sportspress_register_venue_term_meta() {
+	register_term_meta(
+		'sp_venue',
+		'tse_short_name',
+		array(
+			'type'              => 'string',
+			'single'            => true,
+			'sanitize_callback' => 'sanitize_text_field',
+			'show_in_rest'      => true,
+			'auth_callback'     => static function() {
+				return current_user_can( 'manage_categories' );
+			},
+		)
+	);
+
+	register_term_meta(
+		'sp_venue',
+		'tse_abbreviation',
+		array(
+			'type'              => 'string',
+			'single'            => true,
+			'sanitize_callback' => 'sanitize_text_field',
+			'show_in_rest'      => true,
+			'auth_callback'     => static function() {
+				return current_user_can( 'manage_categories' );
+			},
+		)
+	);
+}
+add_action( 'init', 'tony_sportspress_register_venue_term_meta' );
+
+/**
+ * Render add-form fields for venue metadata.
+ */
+function tony_sportspress_add_venue_meta_fields() {
+	?>
+	<div class="form-field term-short-name-wrap">
+		<label for="tse_short_name"><?php esc_html_e( 'Short Name', 'tonys-sportspress-enhancements' ); ?></label>
+		<input name="tse_short_name" id="tse_short_name" type="text" value="" maxlength="100" />
+		<p><?php esc_html_e( 'Optional shorter label for this field or venue.', 'tonys-sportspress-enhancements' ); ?></p>
+	</div>
+	<div class="form-field term-abbreviation-wrap">
+		<label for="tse_abbreviation"><?php esc_html_e( 'Abbreviation', 'tonys-sportspress-enhancements' ); ?></label>
+		<input name="tse_abbreviation" id="tse_abbreviation" type="text" value="" maxlength="20" />
+		<p><?php esc_html_e( 'Optional abbreviation such as CC East or Field 1.', 'tonys-sportspress-enhancements' ); ?></p>
+	</div>
+	<?php
+}
+add_action( 'sp_venue_add_form_fields', 'tony_sportspress_add_venue_meta_fields' );
+
+/**
+ * Render edit-form fields for venue metadata.
+ *
+ * @param WP_Term $term Venue term.
+ */
+function tony_sportspress_edit_venue_meta_fields( $term ) {
+	$short_name   = get_term_meta( $term->term_id, 'tse_short_name', true );
+	$abbreviation = get_term_meta( $term->term_id, 'tse_abbreviation', true );
+	?>
+	<tr class="form-field term-short-name-wrap">
+		<th scope="row">
+			<label for="tse_short_name"><?php esc_html_e( 'Short Name', 'tonys-sportspress-enhancements' ); ?></label>
+		</th>
+		<td>
+			<input name="tse_short_name" id="tse_short_name" type="text" value="<?php echo esc_attr( $short_name ); ?>" maxlength="100" />
+			<p class="description"><?php esc_html_e( 'Optional shorter label for this field or venue.', 'tonys-sportspress-enhancements' ); ?></p>
+		</td>
+	</tr>
+	<tr class="form-field term-abbreviation-wrap">
+		<th scope="row">
+			<label for="tse_abbreviation"><?php esc_html_e( 'Abbreviation', 'tonys-sportspress-enhancements' ); ?></label>
+		</th>
+		<td>
+			<input name="tse_abbreviation" id="tse_abbreviation" type="text" value="<?php echo esc_attr( $abbreviation ); ?>" maxlength="20" />
+			<p class="description"><?php esc_html_e( 'Optional abbreviation such as CC East or Field 1.', 'tonys-sportspress-enhancements' ); ?></p>
+		</td>
+	</tr>
+	<?php
+}
+add_action( 'sp_venue_edit_form_fields', 'tony_sportspress_edit_venue_meta_fields' );
+
+/**
+ * Save venue metadata fields.
+ *
+ * @param int $term_id Venue term ID.
+ */
+function tony_sportspress_save_venue_meta_fields( $term_id ) {
+	if ( ! current_user_can( 'manage_categories' ) ) {
+		return;
+	}
+
+	$short_name = isset( $_POST['tse_short_name'] ) ? sanitize_text_field( wp_unslash( $_POST['tse_short_name'] ) ) : '';
+	$short_name = is_string( $short_name ) ? trim( $short_name ) : '';
+
+	$abbreviation = isset( $_POST['tse_abbreviation'] ) ? sanitize_text_field( wp_unslash( $_POST['tse_abbreviation'] ) ) : '';
+	$abbreviation = is_string( $abbreviation ) ? trim( $abbreviation ) : '';
+
+	update_term_meta( $term_id, 'tse_short_name', $short_name );
+	update_term_meta( $term_id, 'tse_abbreviation', $abbreviation );
+}
+add_action( 'created_sp_venue', 'tony_sportspress_save_venue_meta_fields' );
+add_action( 'edited_sp_venue', 'tony_sportspress_save_venue_meta_fields' );

package.json

@@ -1,7 +1,7 @@
 
 {
   "name": "tonys-sportspress-enhancements",
-  "version": "0.1.0",
+  "version": "0.1.5",
   "main": "Gruntfile.js",
   "author": "YOUR NAME HERE",
   "scripts" : {

readme.md

@@ -0,0 +1,39 @@
+# Tony's SportsPress Enhancements
+
+Suite of enhancements for the SportsPress plugin, including custom event permalinks, Open Graph tags, and automatic featured image generation for events.
+
+## Description
+
+Tony's SportsPress Enhancements is a collection of add-ons for the [SportsPress](https://wordpress.org/plugins/sportspress/) plugin. It provides:
+
+- **Custom event permalinks** for `sp_event` post types, including season and team slugs.
+- **Open Graph meta tags** for events, with dynamic titles, descriptions, and images.
+- **Automatic featured image generation** for events, combining team colors and logos into a shareable image.
+- **Printable team schedules** with season-aware venue colors and a print-friendly calendar layout.
+
+## Features
+
+- Custom rewrite rules and permalinks for SportsPress events.
+- Open Graph integration for better social sharing.
+- Dynamic, cached event images based on team data.
+- Printable schedule pages linked from team profiles.
+- Compatible with WordPress 4.5+ and PHP 5.6+.
+
+## Installation
+
+1. Upload the plugin files to the `/wp-content/plugins/tonys-sportspress-enhancements/` directory, or install via the WordPress plugin repository.
+2. Activate the plugin through the 'Plugins' menu in WordPress.
+3. Make sure the [SportsPress](https://wordpress.org/plugins/sportspress/) plugin is installed and activated.
+
+## Frequently Asked Questions
+
+**Q: Does this plugin require SportsPress?**  
+A: Yes, it extends the functionality of the SportsPress plugin.
+
+**Q: How are event images generated?**  
+A: When an event is viewed or shared, a featured image is generated using the primary colors and logos of the participating teams.
+
+
+---
+
+*This plugin is not affiliated with or endorsed by ThemeBoy or the official SportsPress plugin.*

readme.txt

@@ -1,115 +0,0 @@
-=== Tonys Sportspress Enhancements ===
-Contributors: (this should be a list of wordpress.org userid's)
-Donate link: https://example.com/
-Tags: comments, spam
-Requires at least: 4.5
-Tested up to: 6.5.3
-Requires PHP: 5.6
-Stable tag: 0.1.0
-License: GPLv2 or later
-License URI: https://www.gnu.org/licenses/gpl-2.0.html
-
-Here is a short description of the plugin.  This should be no more than 150 characters.  No markup here.
-
-== Description ==
-
-This is the long description.  No limit, and you can use Markdown (as well as in the following sections).
-
-For backwards compatibility, if this section is missing, the full length of the short description will be used, and
-Markdown parsed.
-
-A few notes about the sections above:
-
-*   "Contributors" is a comma separated list of wp.org/wp-plugins.org usernames
-*   "Tags" is a comma separated list of tags that apply to the plugin
-*   "Requires at least" is the lowest version that the plugin will work on
-*   "Tested up to" is the highest version that you've *successfully used to test the plugin*. Note that it might work on
-higher versions... this is just the highest one you've verified.
-*   Stable tag should indicate the Subversion "tag" of the latest stable version, or "trunk," if you use `/trunk/` for
-stable.
-
-    Note that the `readme.txt` of the stable tag is the one that is considered the defining one for the plugin, so
-if the `/trunk/readme.txt` file says that the stable tag is `4.3`, then it is `/tags/4.3/readme.txt` that'll be used
-for displaying information about the plugin.  In this situation, the only thing considered from the trunk `readme.txt`
-is the stable tag pointer.  Thus, if you develop in trunk, you can update the trunk `readme.txt` to reflect changes in
-your in-development version, without having that information incorrectly disclosed about the current stable version
-that lacks those changes -- as long as the trunk's `readme.txt` points to the correct stable tag.
-
-    If no stable tag is provided, it is assumed that trunk is stable, but you should specify "trunk" if that's where
-you put the stable version, in order to eliminate any doubt.
-
-== Installation ==
-
-This section describes how to install the plugin and get it working.
-
-e.g.
-
-1. Upload `plugin-name.php` to the `/wp-content/plugins/` directory
-1. Activate the plugin through the 'Plugins' menu in WordPress
-1. Place `<?php do_action('plugin_name_hook'); ?>` in your templates
-
-== Frequently Asked Questions ==
-
-= A question that someone might have =
-
-An answer to that question.
-
-= What about foo bar? =
-
-Answer to foo bar dilemma.
-
-== Screenshots ==
-
-1. This screen shot description corresponds to screenshot-1.(png|jpg|jpeg|gif). Note that the screenshot is taken from
-the /assets directory or the directory that contains the stable readme.txt (tags or trunk). Screenshots in the /assets
-directory take precedence. For example, `/assets/screenshot-1.png` would win over `/tags/4.3/screenshot-1.png`
-(or jpg, jpeg, gif).
-2. This is the second screen shot
-
-== Changelog ==
-
-= 1.0 =
-* A change since the previous version.
-* Another change.
-
-= 0.5 =
-* List versions from most recent at top to oldest at bottom.
-
-== Upgrade Notice ==
-
-= 1.0 =
-Upgrade notices describe the reason a user should upgrade.  No more than 300 characters.
-
-= 0.5 =
-This version fixes a security related bug.  Upgrade immediately.
-
-== Arbitrary section ==
-
-You may provide arbitrary sections, in the same format as the ones above.  This may be of use for extremely complicated
-plugins where more information needs to be conveyed that doesn't fit into the categories of "description" or
-"installation."  Arbitrary sections will be shown below the built-in sections outlined above.
-
-== A brief Markdown Example ==
-
-Ordered list:
-
-1. Some feature
-1. Another feature
-1. Something else about the plugin
-
-Unordered list:
-
-* something
-* something else
-* third thing
-
-Here's a link to [WordPress](https://wordpress.org/ "Your favorite software") and one to [Markdown's Syntax Documentation][markdown syntax].
-Titles are optional, naturally.
-
-[markdown syntax]: https://daringfireball.net/projects/markdown/syntax
-            "Markdown is what the parser uses to process much of the readme file"
-
-Markdown uses email style notation for blockquotes and I've been told:
-> Asterisks for *emphasis*. Double it up  for **strong**.
-
-`<?php code(); // goes in backticks ?>`

templates/event-list.php

@@ -0,0 +1,576 @@
+<?php
+/**
+ * Event List
+ *
+ * @author      ThemeBoy
+ * @package     SportsPress/Templates
+ * @version     2.7.23
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly
+}
+
+$defaults = array(
+	'id'                   => null,
+	'title'                => false,
+	'status'               => 'default',
+	'format'               => 'default',
+	'date'                 => 'default',
+	'date_from'            => 'default',
+	'date_to'              => 'default',
+	'date_past'            => 'default',
+	'date_future'          => 'default',
+	'date_relative'        => 'default',
+	'day'                  => 'default',
+	'league'               => null,
+	'season'               => null,
+	'venue'                => null,
+	'team'                 => null,
+	'teams_past'           => null,
+	'date_before'          => null,
+	'player'               => null,
+	'number'               => -1,
+	'show_team_logo'       => get_option( 'sportspress_event_list_show_logos', 'no' ) == 'yes' ? true : false,
+	'link_events'          => get_option( 'sportspress_link_events', 'yes' ) == 'yes' ? true : false,
+	'link_teams'           => get_option( 'sportspress_link_teams', 'no' ) == 'yes' ? true : false,
+	'link_venues'          => get_option( 'sportspress_link_venues', 'yes' ) == 'yes' ? true : false,
+	'responsive'           => get_option( 'sportspress_enable_responsive_tables', 'no' ) == 'yes' ? true : false,
+	'sortable'             => get_option( 'sportspress_enable_sortable_tables', 'yes' ) == 'yes' ? true : false,
+	'scrollable'           => get_option( 'sportspress_enable_scrollable_tables', 'yes' ) == 'yes' ? true : false,
+	'paginated'            => get_option( 'sportspress_event_list_paginated', 'yes' ) == 'yes' ? true : false,
+	'rows'                 => get_option( 'sportspress_event_list_rows', 10 ),
+	'order'                => 'default',
+	'columns'              => null,
+	'show_all_events_link' => false,
+	'show_title'           => get_option( 'sportspress_event_list_show_title', 'yes' ) == 'yes' ? true : false,
+	'title_format'         => get_option( 'sportspress_event_list_title_format', 'title' ),
+	'time_format'          => get_option( 'sportspress_event_list_time_format', 'combined' ),
+);
+
+extract( $defaults, EXTR_SKIP );
+
+$calendar = new SP_Calendar( $id );
+if ( $status != 'default' ) {
+	$calendar->status = $status;
+}
+if ( $format != 'default' ) {
+	$calendar->event_format = $format;
+}
+if ( $date != 'default' ) {
+	$calendar->date = $date;
+}
+if ( $date_from != 'default' ) {
+	$calendar->from = $date_from;
+}
+if ( $date_to != 'default' ) {
+	$calendar->to = $date_to;
+}
+if ( $date_past != 'default' ) {
+	$calendar->past = $date_past;
+}
+if ( $date_future != 'default' ) {
+	$calendar->future = $date_future;
+}
+if ( $date_relative != 'default' ) {
+	$calendar->relative = $date_relative;
+}
+if ( $league ) {
+	$calendar->league = $league;
+}
+if ( $season ) {
+	$calendar->season = $season;
+}
+if ( $venue ) {
+	$calendar->venue = $venue;
+}
+if ( $team ) {
+	$calendar->team = $team;
+}
+if ( $teams_past ) {
+	$calendar->teams_past = $teams_past;
+}
+if ( $date_before ) {
+	$calendar->date_before = $date_before;
+}
+if ( $player ) {
+	$calendar->player = $player;
+}
+if ( $order != 'default' ) {
+	$calendar->order = $order;
+}
+if ( $day != 'default' ) {
+	$calendar->day = $day;
+}
+$data       = $calendar->data();
+$usecolumns = $calendar->columns;
+
+if ( isset( $columns ) ) :
+	if ( is_array( $columns ) ) {
+		$usecolumns = $columns;
+	} else {
+		$usecolumns = explode( ',', $columns );
+	}
+endif;
+
+$title_format_raw    = $title_format;
+$is_awayhome_format  = 'awayhome' === $title_format_raw;
+if ( $is_awayhome_format ) {
+	$title_format = 'homeaway';
+}
+$home_label = $is_awayhome_format ? esc_attr__( 'Away', 'sportspress' ) : esc_attr__( 'Home', 'sportspress' );
+$away_label = $is_awayhome_format ? esc_attr__( 'Home', 'sportspress' ) : esc_attr__( 'Away', 'sportspress' );
+
+if ( $show_title && false === $title && $id ) :
+	$caption = $calendar->caption;
+	if ( $caption ) {
+		$title = $caption;
+	} else {
+		$title = get_the_title( $id );
+	}
+endif;
+$labels = array();
+// Create a unique identifier based on the current time in microseconds
+$identifier = uniqid( 'eventlist_' );
+?>
+<div class="sp-template sp-template-event-list">
+	<?php if ( $title ) { ?>
+		<h4 class="sp-table-caption"><?php echo wp_kses_post( $title ); ?></h4>
+	<?php } ?>
+	<div class="sp-table-wrapper">
+		<table class="sp-event-list sp-event-list-format-<?php echo esc_attr( $title_format ); ?> sp-data-table
+																	<?php
+																	if ( $paginated ) {
+																		?>
+			 sp-paginated-table
+																		 <?php
+																	} if ( $sortable ) {
+																		?>
+			 sp-sortable-table
+																		 <?php
+																	} if ( $responsive ) {
+																												echo ' sp-responsive-table ' . esc_attr( $identifier ); } if ( $scrollable ) {
+																		?>
+													 sp-scrollable-table <?php } ?>" data-sp-rows="<?php echo esc_attr( $rows ); ?>">
+			<thead>
+				<tr>
+					<?php
+					echo '<th class="data-date">' . esc_attr__( 'Date', 'sportspress' ) . '</th>';
+
+					switch ( $title_format ) {
+						case 'homeaway':
+							if ( sp_column_active( $usecolumns, 'event' ) ) {
+								echo '<th class="data-home">' . esc_html( $home_label ) . '</th>';
+							}
+
+							if ( 'combined' == $time_format && sp_column_active( $usecolumns, 'time' ) ) {
+								echo '<th class="data-time">' . esc_attr__( 'Time/Results', 'sportspress' ) . '</th>';
+								$labels[] = esc_attr__( 'Time/Results', 'sportspress' );
+							} elseif ( in_array( $time_format, array( 'separate', 'results' ) ) && sp_column_active( $usecolumns, 'results' ) ) {
+								echo '<th class="data-results">' . esc_attr__( 'Results', 'sportspress' ) . '</th>';
+							}
+
+							if ( sp_column_active( $usecolumns, 'event' ) ) {
+								echo '<th class="data-away">' . esc_html( $away_label ) . '</th>';
+							}
+
+							if ( in_array( $time_format, array( 'separate', 'time' ) ) && sp_column_active( $usecolumns, 'time' ) ) {
+								echo '<th class="data-time">' . esc_attr__( 'Time', 'sportspress' ) . '</th>';
+							}
+							break;
+						default:
+							if ( sp_column_active( $usecolumns, 'event' ) ) {
+								if ( $title_format == 'teams' ) {
+									echo '<th class="data-teams">' . esc_attr__( 'Teams', 'sportspress' ) . '</th>';
+								} else {
+									echo '<th class="data-event">' . esc_attr__( 'Event', 'sportspress' ) . '</th>';
+								}
+							}
+
+							switch ( $time_format ) {
+								case 'separate':
+									if ( sp_column_active( $usecolumns, 'time' ) ) {
+										echo '<th class="data-time">' . esc_attr__( 'Time', 'sportspress' ) . '</th>';
+									}
+									if ( sp_column_active( $usecolumns, 'results' ) ) {
+										echo '<th class="data-results">' . esc_attr__( 'Results', 'sportspress' ) . '</th>';
+									}
+									break;
+								case 'time':
+									if ( sp_column_active( $usecolumns, 'time' ) ) {
+										echo '<th class="data-time">' . esc_attr__( 'Time', 'sportspress' ) . '</th>';
+									}
+									break;
+								case 'results':
+									if ( sp_column_active( $usecolumns, 'results' ) ) {
+										echo '<th class="data-results">' . esc_attr__( 'Results', 'sportspress' ) . '</th>';
+									}
+									break;
+								default:
+									if ( sp_column_active( $usecolumns, 'time' ) ) {
+										echo '<th class="data-time">' . esc_attr__( 'Time/Results', 'sportspress' ) . '</th>';
+									}
+							}
+					}
+
+					if ( sp_column_active( $usecolumns, 'league' ) ) {
+						echo '<th class="data-league">' . esc_attr__( 'League', 'sportspress' ) . '</th>';
+					}
+
+					if ( sp_column_active( $usecolumns, 'season' ) ) {
+						echo '<th class="data-season">' . esc_attr__( 'Season', 'sportspress' ) . '</th>';
+					}
+
+					if ( sp_column_active( $usecolumns, 'venue' ) ) {
+						echo '<th class="data-venue">' . esc_attr__( 'Venue', 'sportspress' ) . '</th>';
+					} else {
+						echo '<th style="display:none;" class="data-venue">' . esc_attr__( 'Venue', 'sportspress' ) . '</th>';
+					}
+
+					if ( sp_column_active( $usecolumns, 'article' ) ) {
+						echo '<th class="data-article">' . esc_attr__( 'Article', 'sportspress' ) . '</th>';
+					}
+
+					if ( sp_column_active( $usecolumns, 'day' ) ) {
+						echo '<th class="data-day">' . esc_attr__( 'Match Day', 'sportspress' ) . '</th>';
+					}
+
+					do_action( 'sportspress_event_list_head_row', $usecolumns );
+					?>
+				</tr>
+			</thead>
+			<tbody>
+				<?php
+				$i = 0;
+
+				if ( is_numeric( $number ) && $number > 0 ) {
+					$limit = $number;
+				}
+
+				foreach ( $data as $event ) :
+					if ( isset( $limit ) && $i >= $limit ) {
+						continue;
+					}
+
+					$teams  = get_post_meta( $event->ID, 'sp_team' );
+					$video  = get_post_meta( $event->ID, 'sp_video', true );
+					$status = get_post_meta( $event->ID, 'sp_status', true );
+
+					$main_results = apply_filters( 'sportspress_event_list_main_results', sp_get_main_results( $event ), $event->ID );
+
+					$reverse_results = $is_awayhome_format;
+					$reverse_teams   = false;
+					if ( 'homeaway' === $title_format ) {
+						$reverse_teams = $is_awayhome_format;
+					} elseif ( 'teams' === $title_format ) {
+						$reverse_teams = get_option( 'sportspress_event_reverse_teams', 'no' ) === 'yes' ? true : false;
+					}
+
+					if ( $reverse_results ) {
+						$main_results = array_reverse( $main_results, true );
+					}
+
+					$teams_output = '';
+					$team_class   = '';
+					$teams_array  = array();
+					$team_logos   = array();
+
+					if ( $teams ) :
+						foreach ( $teams as $t => $team ) :
+							$name = sp_team_short_name( $team );
+							if ( $name ) :
+
+								$name = '<meta itemprop="name" content="' . $name . '">' . $name;
+
+								if ( $show_team_logo ) :
+									if ( has_post_thumbnail( $team ) ) :
+										$logo         = '<span class="team-logo">' . sp_get_logo( $team, 'mini', array( 'itemprop' => 'url' ) ) . '</span>';
+										$team_logos[] = $logo;
+										$team_class  .= ' has-logo';
+
+										if ( $t ) :
+											$name = $logo . ' ' . $name;
+										else :
+											$name .= ' ' . $logo;
+										endif;
+									endif;
+								endif;
+
+								if ( $link_teams ) :
+									$team_output = '<a href="' . get_post_permalink( $team ) . '" itemprop="url">' . $name . '</a>';
+								else :
+									$team_output = $name;
+								endif;
+
+								$team_result = sp_array_value( $main_results, $team, null );
+
+								if ( $team_result != null ) :
+									if ( $usecolumns != null && ! in_array( 'time', $usecolumns ) ) :
+										$team_output .= ' (' . $team_result . ')';
+									endif;
+								endif;
+
+								$teams_array[] = $team_output;
+
+								$teams_output .= $team_output . '<br>';
+							endif;
+						endforeach;
+					else :
+						$teams_output .= '&mdash;';
+					endif;
+
+					echo '<tr class="sp-row sp-post' . ( $i % 2 == 0 ? ' alternate' : '' ) . ' sp-row-no-' . esc_attr( $i ) . '" itemscope itemtype="http://schema.org/SportsEvent">';
+
+						$date_html = '<date>' . get_post_time( 'Y-m-d H:i:s', false, $event ) . '</date>' . apply_filters( 'sportspress_event_date', get_post_time( get_option( 'date_format' ), false, $event, true ), $event->ID );
+
+					if ( $link_events ) {
+						$date_html = '<a href="' . get_post_permalink( $event->ID, false, true ) . '" itemprop="url">' . $date_html . '</a>';
+					}
+
+						echo '<td class="data-date" itemprop="startDate" content="' . esc_attr( mysql2date( 'Y-m-d\TH:i:sP', $event->post_date ) ) . '" data-label="' . esc_attr__( 'Date', 'sportspress' ) . '">' . wp_kses( $date_html, array( 'a' => array( 'href' => array(), 'itemprop' => array() ), 'date' => array() ) ) . '</td>';
+
+						// Check if the reverse_teams option is selected and alter the teams order
+					if ( $reverse_teams ) {
+						$teams_array = array_reverse( $teams_array, true );
+					}
+
+					switch ( $title_format ) {
+						case 'homeaway':
+							if ( sp_column_active( $usecolumns, 'event' ) ) {
+								$team = array_shift( $teams_array );
+								echo '<td class="data-home' . esc_attr( $team_class ) . '" itemprop="competitor" itemscope itemtype="http://schema.org/SportsTeam" data-label="' . esc_attr( $home_label ) . '">' . wp_kses_post( $team ) . '</td>';
+							}
+
+							if ( 'combined' == $time_format && sp_column_active( $usecolumns, 'time' ) ) {
+								echo '<td class="data-time ' . esc_attr( $status ) . '" data-label="' . esc_attr__( 'Time/Results', 'sportspress' ) . '">';
+								if ( $link_events ) {
+									echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+								}
+								if ( ! empty( $main_results ) ) :
+									echo wp_kses_post( implode( ' - ', $main_results ) );
+									else :
+										echo '<date>&nbsp;' . wp_kses_post( get_post_time( 'H:i:s', false, $event ) ) . '</date>' . wp_kses_post( apply_filters( 'sportspress_event_time', sp_get_time( $event ), $event->ID ) );
+									endif;
+									if ( $link_events ) {
+										echo '</a>';
+									}
+									echo '</td>';
+							} elseif ( in_array( $time_format, array( 'separate', 'results' ) ) && sp_column_active( $usecolumns, 'results' ) ) {
+								echo '<td class="data-results" data-label="' . esc_attr__( 'Results', 'sportspress' ) . '">';
+								if ( $link_events ) {
+									echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+								}
+								if ( ! empty( $main_results ) ) :
+									echo wp_kses_post( implode( ' - ', $main_results ) );
+									else :
+										echo '-';
+									endif;
+									if ( $link_events ) {
+										echo '</a>';
+									}
+									echo '</td>';
+							}
+
+							if ( sp_column_active( $usecolumns, 'event' ) ) {
+								$team = array_shift( $teams_array );
+								echo '<td class="data-away' . esc_attr( $team_class ) . '" itemprop="competitor" itemscope itemtype="http://schema.org/SportsTeam" data-label="' . esc_attr( $away_label ) . '">' . wp_kses_post( $team ) . '</td>';
+							}
+
+							if ( in_array( $time_format, array( 'separate', 'time' ) ) && sp_column_active( $usecolumns, 'time' ) ) {
+								echo '<td class="data-time ' . esc_attr( $status ) . '" data-label="' . esc_attr__( 'Time', 'sportspress' ) . '">';
+								if ( $link_events ) {
+									echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+								}
+								echo '<date>&nbsp;' . wp_kses_post( get_post_time( 'H:i:s', false, $event ) ) . '</date>' . wp_kses_post( apply_filters( 'sportspress_event_time', sp_get_time( $event ), $event->ID ) );
+								if ( $link_events ) {
+									echo '</a>';
+								}
+								echo '</td>';
+							}
+							break;
+						default:
+							if ( sp_column_active( $usecolumns, 'event' ) ) {
+								if ( $title_format == 'teams' ) {
+									echo '<td class="data-event data-teams" data-label="' . esc_attr__( 'Teams', 'sportspress' ) . '">' . wp_kses_post( $teams_output ) . '</td>';
+								} else {
+									$title_html = implode( ' ', $team_logos ) . ' ' . $event->post_title;
+									if ( $link_events ) {
+										$title_html = '<a href="' . get_post_permalink( $event->ID, false, true ) . '" itemprop="url name">' . $title_html . '</a>';
+									}
+									echo '<td class="data-event" data-label="' . esc_attr__( 'Event', 'sportspress' ) . '">' . wp_kses_post( $title_html ) . '</td>';
+								}
+							}
+
+							switch ( $time_format ) {
+								case 'separate':
+									if ( sp_column_active( $usecolumns, 'time' ) ) {
+										echo '<td class="data-time ' . esc_attr( $status ) . '" data-label="' . esc_attr__( 'Time', 'sportspress' ) . '">';
+										if ( $link_events ) {
+											echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+										}
+										echo '<date>&nbsp;' . wp_kses_post( get_post_time( 'H:i:s', false, $event ) ) . '</date>' . wp_kses_post( apply_filters( 'sportspress_event_time', sp_get_time( $event ), $event->ID ) );
+										if ( $link_events ) {
+											echo '</a>';
+										}
+										echo '</td>';
+									}
+									if ( sp_column_active( $usecolumns, 'results' ) ) {
+										echo '<td class="data-results" data-label="' . esc_attr__( 'Results', 'sportspress' ) . '">';
+										if ( $link_events ) {
+											echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+										}
+										if ( ! empty( $main_results ) ) :
+											echo wp_kses_post( implode( ' - ', $main_results ) );
+											else :
+												echo '-';
+											endif;
+											if ( $link_events ) {
+												echo '</a>';
+											}
+											echo '</td>';
+									}
+									break;
+								case 'time':
+									if ( sp_column_active( $usecolumns, 'time' ) ) {
+										echo '<td class="data-time ' . esc_attr( $status ) . '" data-label="' . esc_attr__( 'Time', 'sportspress' ) . '">';
+										if ( $link_events ) {
+											echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+										}
+										echo '<date>&nbsp;' . wp_kses_post( get_post_time( 'H:i:s', false, $event ) ) . '</date>' . wp_kses_post( apply_filters( 'sportspress_event_time', sp_get_time( $event ), $event->ID ) );
+										if ( $link_events ) {
+											echo '</a>';
+										}
+										echo '</td>';
+									}
+									break;
+								case 'results':
+									if ( sp_column_active( $usecolumns, 'results' ) ) {
+										echo '<td class="data-results" data-label="' . esc_attr__( 'Results', 'sportspress' ) . '">';
+										if ( $link_events ) {
+											echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+										}
+										if ( ! empty( $main_results ) ) :
+											echo wp_kses_post( implode( ' - ', $main_results ) );
+											else :
+												echo '-';
+											endif;
+											if ( $link_events ) {
+												echo '</a>';
+											}
+											echo '</td>';
+									}
+									break;
+								default:
+									if ( sp_column_active( $usecolumns, 'time' ) ) {
+										echo '<td class="data-time ' . esc_attr( $status ) . '" data-label="' . esc_attr__( 'Time/Results', 'sportspress' ) . '">';
+										if ( $link_events ) {
+											echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+										}
+										if ( ! empty( $main_results ) ) :
+											echo wp_kses_post( implode( ' - ', $main_results ) );
+											else :
+												echo '<date>&nbsp;' . wp_kses_post( get_post_time( 'H:i:s', false, $event ) ) . '</date>' . wp_kses_post( apply_filters( 'sportspress_event_time', sp_get_time( $event ), $event->ID ) );
+											endif;
+											if ( $link_events ) {
+												echo '</a>';
+											}
+											echo '</td>';
+									}
+							}
+					}
+
+					if ( sp_column_active( $usecolumns, 'league' ) ) :
+						echo '<td class="data-league" data-label="' . esc_attr__( 'League', 'sportspress' ) . '">';
+						$leagues = get_the_terms( $event->ID, 'sp_league' );
+						if ( $leagues ) :
+							echo wp_kses_post( implode( ', ', wp_list_pluck( $leagues, 'name' ) ) );
+							endif;
+						echo '</td>';
+						endif;
+
+					if ( sp_column_active( $usecolumns, 'season' ) ) :
+						echo '<td class="data-season" data-label="' . esc_attr__( 'Season', 'sportspress' ) . '">';
+						$seasons = get_the_terms( $event->ID, 'sp_season' );
+						if ( $seasons ) :
+							echo wp_kses_post( implode( ', ', wp_list_pluck( $seasons, 'name' ) ) );
+							endif;
+						echo '</td>';
+						endif;
+
+					if ( sp_column_active( $usecolumns, 'venue' ) ) :
+						echo '<td class="data-venue" data-label="' . esc_attr__( 'Venue', 'sportspress' ) . '" itemprop="location" itemscope itemtype="http://schema.org/Place">';
+						echo '<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">';
+						if ( $link_venues ) :
+							the_terms( $event->ID, 'sp_venue' );
+							else :
+								$venues = get_the_terms( $event->ID, 'sp_venue' );
+								if ( $venues ) :
+									echo wp_kses_post( implode( ', ', wp_list_pluck( $venues, 'name' ) ) );
+								endif;
+							endif;
+							echo '</div>';
+							echo '</td>';
+						else :
+							echo '<td style="display:none;" class="data-venue" data-label="' . esc_attr__( 'Venue', 'sportspress' ) . '" itemprop="location" itemscope itemtype="http://schema.org/Place">';
+							echo '<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">';
+							esc_attr_e( 'N/A', 'sportspress' );
+							echo '</div>';
+							echo '</td>';
+						endif;
+
+						if ( sp_column_active( $usecolumns, 'article' ) ) :
+							echo '<td class="data-article" data-label="' . esc_attr__( 'Article', 'sportspress' ) . '">';
+							if ( $link_events ) {
+								echo '<a href="' . esc_url( get_post_permalink( $event->ID, false, true ) ) . '" itemprop="url">';
+							}
+
+							if ( $video ) :
+								echo '<div class="dashicons dashicons-video-alt"></div>';
+								elseif ( has_post_thumbnail( $event->ID ) ) :
+									echo '<div class="dashicons dashicons-camera"></div>';
+								endif;
+								if ( $event->post_content !== null ) :
+									if ( $event->post_status == 'publish' ) :
+										esc_attr_e( 'Recap', 'sportspress' );
+									else :
+										esc_attr_e( 'Preview', 'sportspress' );
+									endif;
+								endif;
+
+								if ( $link_events ) {
+									echo '</a>';
+								}
+								echo '</td>';
+						endif;
+
+						if ( sp_column_active( $usecolumns, 'day' ) ) :
+							echo '<td class="data-day" data-label="' . esc_attr__( 'Match Day', 'sportspress' ) . '">';
+							$day = get_post_meta( $event->ID, 'sp_day', true );
+							if ( '' == $day ) {
+								echo '-';
+							} else {
+								echo wp_kses_post( $day );
+							}
+							echo '</td>';
+						endif;
+
+						do_action( 'sportspress_event_list_row', $event, $usecolumns );
+
+						echo '</tr>';
+
+						$i++;
+				endforeach;
+				?>
+			</tbody>
+		</table>
+	</div>
+	<?php
+	// If responsive tables are enabled then load the inline css code
+	if ( $responsive ) {
+		// sportspress_responsive_tables_css( $identifier );
+	}
+	if ( $id && $show_all_events_link ) {
+		echo '<div class="sp-calendar-link sp-view-all-link"><a href="' . esc_url( get_permalink( $id ) ) . '">' . esc_attr__( 'View all events', 'sportspress' ) . '</a></div>';
+	}
+	?>
+</div>

templates/event-results.php

@@ -0,0 +1,166 @@
+<?php
+/**
+ * Event Results
+ *
+ * @author      ThemeBoy
+ * @package     SportsPress/Templates
+ * @version   2.7.1
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly
+}
+if ( get_option( 'sportspress_event_show_results', 'yes' ) === 'no' ) {
+	return;
+}
+
+if ( ! isset( $id ) ) {
+	$id = get_the_ID();
+}
+
+$event  = new SP_Event( $id );
+$status = $event->status();
+
+if ( 'results' != $status ) {
+	return;
+}
+
+if ( ! isset( $caption ) ) {
+	$caption = esc_attr__( 'Results', 'sportspress' );
+}
+
+// Get event result data
+$data = $event->results();
+
+// The first row should be column labels
+$labels = $data[0];
+
+// Remove the first row to leave us with the actual data
+unset( $data[0] );
+
+$data = array_filter( $data );
+
+if ( empty( $data ) ) {
+	return false;
+}
+
+$scrollable    = get_option( 'sportspress_enable_scrollable_tables', 'yes' ) == 'yes' ? true : false;
+$link_teams    = get_option( 'sportspress_link_teams', 'no' ) == 'yes' ? true : false;
+$show_outcomes = array_key_exists( 'outcome', $labels );
+
+// Initialize
+$output     = '';
+$table_rows = '';
+$i          = 0;
+
+// Event Results row order is controlled in SportsPress > Settings > Events > Event Results.
+$row_order = get_option( 'tony_sportspress_event_results_row_order', '' );
+if ( '' === $row_order ) {
+	// Backward compatibility with the legacy checkbox option.
+	$legacy_away_first = get_option( 'tony_sportspress_event_results_away_first', 'no' ) === 'yes';
+	$row_order         = $legacy_away_first ? 'away_home' : 'home_away';
+}
+
+$teams = array_values( array_filter( array_map( 'absint', (array) get_post_meta( $id, 'sp_team', false ) ) ) );
+if ( 'away_home' === $row_order ) {
+	$teams = array_reverse( $teams );
+}
+
+if ( ! empty( $teams ) ) {
+	$ordered = array();
+
+	foreach ( $teams as $index => $team_id ) {
+		if ( array_key_exists( $team_id, $data ) ) {
+			$ordered[ $team_id ] = $data[ $team_id ];
+			continue;
+		}
+
+		// SportsPress can store positional rows in team order (0,1,...) depending on context.
+		if ( array_key_exists( $index, $data ) ) {
+			$ordered[ $team_id ] = $data[ $index ];
+		}
+	}
+
+	foreach ( $data as $team_id => $result ) {
+		if ( ! array_key_exists( $team_id, $ordered ) ) {
+			$ordered[ $team_id ] = $result;
+		}
+	}
+
+	if ( ! empty( $ordered ) ) {
+		$data = $ordered;
+	}
+}
+
+foreach ( $data as $team_id => $result ) :
+	if ( $show_outcomes ) :
+		$outcomes       = array();
+		$result_outcome = sp_array_value( $result, 'outcome' );
+		if ( ! is_array( $result_outcome ) ) :
+			$outcomes = array( '&mdash;' );
+		else :
+			foreach ( $result_outcome as $outcome ) :
+				$the_outcome = get_page_by_path( $outcome, OBJECT, 'sp_outcome' );
+				if ( is_object( $the_outcome ) ) :
+					$outcomes[] = $the_outcome->post_title;
+				endif;
+			endforeach;
+		endif;
+	endif;
+
+	unset( $result['outcome'] );
+
+	$table_rows .= '<tr class="' . ( $i % 2 == 0 ? 'odd' : 'even' ) . '">';
+
+	$team_name = sp_team_short_name( $team_id );
+
+	if ( $link_teams && sp_post_exists( $team_id ) ) :
+		$team_name = '<a href="' . get_post_permalink( $team_id ) . '">' . $team_name . '</a>';
+	endif;
+
+	$table_rows .= '<td class="data-name">' . $team_name . '</td>';
+
+	foreach ( $labels as $key => $label ) :
+		if ( in_array( $key, array( 'name', 'outcome' ) ) ) {
+			continue;
+		}
+		if ( array_key_exists( $key, $result ) && $result[ $key ] != '' ) :
+			$value = $result[ $key ];
+		else :
+			$value = apply_filters( 'sportspress_event_empty_result_string', '&mdash;' );
+		endif;
+		$table_rows .= '<td class="data-' . $key . '">' . $value . '</td>';
+	endforeach;
+
+	if ( $show_outcomes ) :
+		$table_rows .= '<td class="data-outcome">' . implode( ', ', $outcomes ) . '</td>';
+	endif;
+
+	$table_rows .= '</tr>';
+
+	$i++;
+endforeach;
+
+if ( empty( $table_rows ) ) :
+
+	return false;
+
+else :
+
+	$output .= '<h4 class="sp-table-caption">' . $caption . '</h4>';
+
+	$output .= '<div class="sp-table-wrapper">' .
+		'<table class="sp-event-results sp-data-table' . ( $scrollable ? ' sp-scrollable-table' : '' ) . '"><thead>' .
+		'<th class="data-name">' . esc_attr__( 'Team', 'sportspress' ) . '</th>';
+	foreach ( $labels as $key => $label ) :
+		$output .= '<th class="data-' . $key . '">' . $label . '</th>';
+	endforeach;
+	$output .= '</tr>' . '</thead>' . '<tbody>';
+	$output .= $table_rows;
+	$output .= '</tbody>' . '</table>' . '</div>';
+
+endif;
+?>
+<div class="sp-template sp-template-event-results">
+	<?php echo wp_kses_post( $output ); ?>
+</div>

tests/test-sp-event-permalink.php

@@ -0,0 +1,81 @@
+<?php
+/**
+ * Tests for custom event permalink query behavior.
+ *
+ * @package Tonys_Sportspress_Enhancements
+ */
+
+/**
+ * Event permalink query tests.
+ */
+class Test_SP_Event_Permalink extends WP_UnitTestCase {
+
+	/**
+	 * Preserve global main query references for each test.
+	 *
+	 * @var WP_Query
+	 */
+	private $original_wp_query;
+
+	/**
+	 * Preserve global main query references for each test.
+	 *
+	 * @var WP_Query
+	 */
+	private $original_wp_the_query;
+
+	/**
+	 * Set up test case state.
+	 */
+	public function set_up(): void {
+		parent::set_up();
+		$this->original_wp_query     = $GLOBALS['wp_query'];
+		$this->original_wp_the_query = $GLOBALS['wp_the_query'];
+		set_current_screen( 'front' );
+	}
+
+	/**
+	 * Restore global query references.
+	 */
+	public function tear_down(): void {
+		$GLOBALS['wp_query']     = $this->original_wp_query;
+		$GLOBALS['wp_the_query'] = $this->original_wp_the_query;
+		set_current_screen( 'front' );
+		parent::tear_down();
+	}
+
+	/**
+	 * The admin event list query should not be altered by permalink handling.
+	 */
+	public function test_admin_event_queries_are_not_modified() {
+		set_current_screen( 'edit-sp_event' );
+
+		$query = new WP_Query();
+		$query->set( 'post_type', 'sp_event' );
+		$query->set( 'p', 123 );
+		$query->set( 'post_status', 'future' );
+
+		custom_event_parse_request( $query );
+
+		$this->assertSame( 'future', $query->get( 'post_status' ) );
+		$this->assertSame( 123, $query->get( 'p' ) );
+	}
+
+	/**
+	 * Front-end single event requests should include future posts.
+	 */
+	public function test_frontend_single_event_queries_include_future_posts() {
+		$query = new WP_Query();
+		$query->set( 'post_type', 'sp_event' );
+		$query->set( 'p', 456 );
+
+		$GLOBALS['wp_query']     = $query;
+		$GLOBALS['wp_the_query'] = $query;
+
+		custom_event_parse_request( $query );
+
+		$this->assertSame( 'sp_event', $query->get( 'post_type' ) );
+		$this->assertSame( 456, $query->get( 'p' ) );
+		$this->assertSame( array( 'publish', 'future' ), $query->get( 'post_status' ) );
+	}
+}

tests/test-sp-webhooks.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * Tests for configurable SportsPress webhooks.
+ *
+ * @package Tonys_Sportspress_Enhancements
+ */
+
+/**
+ * Webhook feature tests.
+ */
+class Test_SP_Webhooks extends WP_UnitTestCase {
+
+	/**
+	 * Template placeholders should resolve nested values and JSON serialization.
+	 */
+	public function test_render_template_supports_dot_paths_and_tojson() {
+		$webhooks = Tony_Sportspress_Webhooks::instance();
+		$template = 'Trigger={{ trigger.key }} Team={{ event.teams.0.name }} Image={{ event.image }} Payload={{ event|tojson }}';
+		$context  = array(
+			'trigger' => array(
+				'key' => 'event_results_updated',
+			),
+			'event'   => array(
+				'id'    => 55,
+				'image' => 'https://example.com/head-to-head?post=55',
+				'teams' => array(
+					array(
+						'name' => 'Blue Team',
+					),
+				),
+			),
+		);
+
+		$rendered = $webhooks->render_template( $template, $context );
+
+		$this->assertStringContainsString( 'Trigger=event_results_updated', $rendered );
+		$this->assertStringContainsString( 'Team=Blue Team', $rendered );
+		$this->assertStringContainsString( 'Image=https://example.com/head-to-head?post=55', $rendered );
+		$this->assertStringContainsString( '"id":55', $rendered );
+	}
+
+	/**
+	 * Sanitization should keep only complete provider-specific webhook rows.
+	 */
+	public function test_sanitize_settings_keeps_only_valid_webhooks() {
+		$webhooks  = Tony_Sportspress_Webhooks::instance();
+		$sanitized = $webhooks->sanitize_settings(
+			array(
+				'webhooks' => array(
+					array(
+						'name'     => 'Results',
+						'enabled'  => '1',
+						'provider' => 'google_chat',
+						'url'      => 'https://chat.googleapis.com/v1/spaces/AAA/messages?key=test&token=test',
+						'triggers' => array( 'event_results_updated' ),
+						'template' => '{"summary":"{{ results.summary }}"}',
+					),
+					array(
+						'name'     => 'Invalid',
+						'enabled'  => '1',
+						'provider' => 'groupme_bot',
+						'url'      => 'invalid bot id',
+						'triggers' => array( 'event_datetime_changed' ),
+						'template' => 'ignored',
+					),
+					array(
+						'name'     => 'Missing trigger',
+						'enabled'  => '1',
+						'provider' => 'generic_json',
+						'url'      => 'https://example.com/missing-trigger',
+						'template' => 'ignored',
+					),
+				),
+			)
+		);
+
+		$this->assertCount( 1, $sanitized['webhooks'] );
+		$this->assertSame( 'Results', $sanitized['webhooks'][0]['name'] );
+		$this->assertSame( 'google_chat', $sanitized['webhooks'][0]['provider'] );
+		$this->assertSame( 'https://chat.googleapis.com/v1/spaces/AAA/messages?key=test&token=test', $sanitized['webhooks'][0]['url'] );
+		$this->assertSame( array( 'event_results_updated' ), $sanitized['webhooks'][0]['triggers'] );
+	}
+}

tonys-sportspress-enhancements.php

@@ -1,19 +1,52 @@
 <?php
 /**
  * Plugin Name:     Tonys SportsPress Enhancements
- * Plugin URI:      PLUGIN SITE HERE
+ * Plugin URI:      https://github.com/anthonyscorrea/tonys-sportspress-enhancements
  * Description:     Suite of SportsPress Enhancements
- * Author:          YOUR NAME HERE
+ * Author:          Tony Correa
- * Author URI:      YOUR SITE HERE
+ * Author URI:      https://github.com/anthonyscorrea/
  * Text Domain:     tonys-sportspress-enhancements
  * Domain Path:     /languages
- * Version:         0.1.0
+ * Update URI:      https://github.com/anthonyscorrea/tonys-sportspress-enhancements
+ * Version:         0.1.9
  *
  * @package         Tonys_Sportspress_Enhancements
  */
 
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_VERSION' ) ) {
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_VERSION', '0.1.9' );
+}
 
-// Include other files here
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_FILE' ) ) {
-require_once plugin_dir_path(__FILE__) . 'includes/open-graph-tags.php';
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_FILE', __FILE__ );
-require_once plugin_dir_path(__FILE__) . 'includes/featured-image-generator.php';
+}
-require_once plugin_dir_path(__FILE__) . 'includes/sp-event-permalink.php';require_once plugin_dir_path(__FILE__) . 'includes/sp-event-admin-week-filter.php';
+
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_DIR' ) ) {
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_DIR', plugin_dir_path( __FILE__ ) );
+}
+
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_URL' ) ) {
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_URL', plugin_dir_url( __FILE__ ) );
+}
+
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_PLUGIN_BASENAME' ) ) {
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_PLUGIN_BASENAME', plugin_basename( __FILE__ ) );
+}
+
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-github-updater.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-officials-manager-role.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/open-graph-tags.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/featured-image-generator.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-permalink.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-export.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-csv.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-admin-week-filter.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-quick-edit-officials.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-team-ordering.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-printable-calendars.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-url-builder.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-webhooks.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-schedule-exporter.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-venue-meta.php';
+
+register_activation_hook( __FILE__, 'tony_sportspress_sync_officials_manager_roles' );