Bump version to 0.1.8

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/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.
  *
@@ -20,7 +197,21 @@ function tony_sportspress_parse_admin_week_filter() {
 		return null;
 	}
 
-	$raw = sanitize_text_field( wp_unslash( $_GET['sp_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) {
+		);
-			return;
+		const monthCheckbox = document.getElementById('tony_sp_event_filter_month');
-		}
+		const weekCheckbox = document.getElementById('tony_sp_event_filter_week');
 
-		function updateSummary() {
+		function syncExclusiveFilters(changedCheckbox) {
-			const raw = (input.value || '').trim();
+			if (!changedCheckbox || !changedCheckbox.checked) {
-			const match = raw.match(/^(\d{4})-W(\d{2})$/);
-			if (!match) {
-				summary.textContent = 'Select a week';
 				return;
 			}
 
-			const year = parseInt(match[1], 10);
+			if (changedCheckbox === monthCheckbox && weekCheckbox) {
-			const week = parseInt(match[2], 10);
+				weekCheckbox.checked = false;
+			}
 
-			const jan4 = new Date(Date.UTC(year, 0, 4));
+			if (changedCheckbox === weekCheckbox && monthCheckbox) {
-			const jan4Day = jan4.getUTCDay() || 7;
+				monthCheckbox.checked = false;
-			const mondayWeek1 = new Date(jan4);
+			}
-			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);
 		}
 
-		input.addEventListener('change', updateSummary);
+		function saveFilterPrefs() {
-		updateSummary();
+			if (!filterCheckboxes.length || typeof ajaxurl === 'undefined') {
+				return;
+			}
+
+			const body = new URLSearchParams();
+			body.append('action', 'tony_sp_event_filter_prefs_save');
+			body.append('nonce', <?php echo wp_json_encode( wp_create_nonce( 'tony_sp_event_filters' ) ); ?>);
+
+			filterCheckboxes.forEach(function(checkbox) {
+				const key = checkbox.id.replace('tony_sp_event_filter_', '');
+				body.append('filters[' + key + ']', checkbox.checked ? '1' : '0');
+			});
+
+			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() {});
+		}
+
+		filterCheckboxes.forEach(function(checkbox) {
+			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-csv.php

@@ -10,256 +10,8 @@ if ( ! defined( 'ABSPATH' ) ) {
 }
 
 /**
- * Register the SportsPress calendar CSV feed endpoint.
+ * SportsPress event CSV importer tools.
- *
- * @return void
  */
-function tse_sp_register_calendar_csv_feed() {
-	add_feed( 'sp-csv', 'tse_sp_render_calendar_csv_feed' );
-}
-add_action( 'init', 'tse_sp_register_calendar_csv_feed', 20 );
-
-/**
- * Replace the stock SportsPress calendar feeds metabox with one that includes CSV.
- *
- * @return void
- */
-function tse_sp_replace_calendar_feeds_metabox() {
-	remove_meta_box( 'sp_feedsdiv', 'sp_calendar', 'side' );
-	add_meta_box(
-		'sp_feedsdiv',
-		esc_attr__( 'Feeds', 'sportspress' ),
-		'tse_sp_render_calendar_feeds_metabox',
-		'sp_calendar',
-		'side',
-		'default'
-	);
-}
-add_action( 'add_meta_boxes_sp_calendar', 'tse_sp_replace_calendar_feeds_metabox', 40 );
-
-/**
- * Return the CSV feed format definition used in the metabox.
- *
- * @return array
- */
-function tse_sp_get_calendar_csv_feed_formats() {
-	return array(
-		'download' => array(
-			'name' => __( 'CSV Download', 'tonys-sportspress-enhancements' ),
-		),
-	);
-}
-
-/**
- * Render the calendar feeds metabox with CSV support.
- *
- * @param WP_Post $post Current calendar post.
- * @return void
- */
-function tse_sp_render_calendar_feeds_metabox( $post ) {
-	$feeds                = new SP_Feeds();
-	$calendar_feeds       = is_array( $feeds->calendar ) ? $feeds->calendar : array();
-	$calendar_feeds['csv'] = tse_sp_get_calendar_csv_feed_formats();
-	?>
-	<div>
-		<?php foreach ( $calendar_feeds as $slug => $formats ) : ?>
-			<?php
-			if ( 'csv' === $slug ) {
-				$link = tse_sp_get_calendar_csv_url( $post->ID );
-			} else {
-				$link = add_query_arg( 'feed', 'sp-' . $slug, untrailingslashit( get_post_permalink( $post ) ) );
-			}
-			?>
-			<?php foreach ( $formats as $format ) : ?>
-				<?php
-				if ( 'csv' === $slug ) {
-					$feed = $link;
-				} else {
-					$protocol = sp_array_value( $format, 'protocol' );
-					if ( $protocol ) {
-						$feed = str_replace( array( 'http:', 'https:' ), 'webcal:', $link );
-					} else {
-						$feed = $link;
-					}
-					$prefix = sp_array_value( $format, 'prefix' );
-					if ( $prefix ) {
-						$feed = $prefix . urlencode( $feed );
-					}
-				}
-				?>
-				<p>
-					<strong><?php echo esc_html( sp_array_value( $format, 'name' ) ); ?></strong>
-					<a class="sp-link" href="<?php echo esc_url( $feed ); ?>" target="_blank" title="<?php esc_attr_e( 'Link', 'sportspress' ); ?>"></a>
-				</p>
-				<p>
-					<input type="text" value="<?php echo esc_attr( $feed ); ?>" readonly="readonly" class="code widefat">
-				</p>
-				<?php if ( 'csv' === $slug ) : ?>
-					<p class="description">
-						<?php esc_html_e( 'Optional team filter: add &team_id=123 to only include games for that team.', 'tonys-sportspress-enhancements' ); ?>
-					</p>
-				<?php endif; ?>
-			<?php endforeach; ?>
-		<?php endforeach; ?>
-	</div>
-	<?php
-}
-
-/**
- * Build the CSV feed URL for a SportsPress calendar.
- *
- * @param int $calendar_id SportsPress calendar post ID.
- * @param int $team_id     Optional team ID filter.
- * @return string
- */
-function tse_sp_get_calendar_csv_url( $calendar_id, $team_id = 0 ) {
-	$calendar_id = absint( $calendar_id );
-	$team_id     = absint( $team_id );
-
-	if ( ! $calendar_id || 'sp_calendar' !== get_post_type( $calendar_id ) ) {
-		return '';
-	}
-
-	$url = add_query_arg( 'feed', 'sp-csv', get_post_permalink( $calendar_id ) );
-
-	if ( $team_id ) {
-		$url = add_query_arg( 'team_id', $team_id, $url );
-	}
-
-	return $url;
-}
-
-/**
- * Get the queried SportsPress calendar post for the CSV feed.
- *
- * @return WP_Post|null
- */
-function tse_sp_get_calendar_csv_post() {
-	$post = get_post();
-
-	if ( $post instanceof WP_Post && 'sp_calendar' === $post->post_type ) {
-		return $post;
-	}
-
-	$queried_object = get_queried_object();
-
-	if ( $queried_object instanceof WP_Post && 'sp_calendar' === $queried_object->post_type ) {
-		return $queried_object;
-	}
-
-	$calendar_id = get_queried_object_id();
-	if ( $calendar_id && 'sp_calendar' === get_post_type( $calendar_id ) ) {
-		return get_post( $calendar_id );
-	}
-
-	return null;
-}
-
-/**
- * Return the home and away teams for an event in stored order.
- *
- * @param int $event_id SportsPress event ID.
- * @return array
- */
-function tse_sp_get_event_home_away_teams( $event_id ) {
-	$teams = array_values( array_filter( array_map( 'absint', get_post_meta( $event_id, 'sp_team', false ) ) ) );
-
-	return array(
-		'home' => isset( $teams[0] ) ? get_the_title( $teams[0] ) : '',
-		'away' => isset( $teams[1] ) ? get_the_title( $teams[1] ) : '',
-	);
-}
-
-/**
- * Return the field name(s) for an event.
- *
- * @param int $event_id SportsPress event ID.
- * @return string
- */
-function tse_sp_get_event_field_name( $event_id ) {
-	$venues = get_the_terms( $event_id, 'sp_venue' );
-
-	if ( empty( $venues ) || is_wp_error( $venues ) ) {
-		return '';
-	}
-
-	return implode( ', ', wp_list_pluck( $venues, 'name' ) );
-}
-
-/**
- * Render the SportsPress calendar CSV feed.
- *
- * @return void
- */
-function tse_sp_render_calendar_csv_feed() {
-	if ( ! class_exists( 'SP_Calendar' ) ) {
-		wp_die( esc_html__( 'ERROR: SportsPress is required for this feed.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 500 ) );
-	}
-
-	$calendar = tse_sp_get_calendar_csv_post();
-
-	if ( ! $calendar ) {
-		wp_die( esc_html__( 'ERROR: This is not a valid calendar feed.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 404 ) );
-	}
-
-	$team_id = isset( $_GET['team_id'] ) ? absint( wp_unslash( $_GET['team_id'] ) ) : 0;
-
-	$calendar_data = new SP_Calendar( $calendar );
-	if ( $team_id ) {
-		$calendar_data->team = $team_id;
-	}
-
-	$events = (array) $calendar_data->data();
-
-	$filename = sanitize_title( $calendar->post_name ? $calendar->post_name : $calendar->post_title );
-	if ( '' === $filename ) {
-		$filename = 'schedule';
-	}
-	if ( $team_id ) {
-		$filename .= '-team-' . $team_id;
-	}
-
-	header( 'Content-Type: text/csv; charset=utf-8' );
-	header( 'Content-Disposition: inline; filename=' . $filename . '.csv' );
-
-	$output = fopen( 'php://output', 'w' );
-
-	if ( false === $output ) {
-		wp_die( esc_html__( 'ERROR: Unable to generate the CSV feed.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 500 ) );
-	}
-
-	// Excel expects a BOM for UTF-8 CSV files.
-	fwrite( $output, "\xEF\xBB\xBF" );
-
-	fputcsv(
-		$output,
-		array(
-			'Date',
-			'Time',
-			'Away Team',
-			'Home Team',
-			'Field Name',
-		)
-	);
-
-	foreach ( $events as $event ) {
-		$teams = tse_sp_get_event_home_away_teams( $event->ID );
-
-		fputcsv(
-			$output,
-			array(
-				sp_get_date( $event ),
-				sp_get_time( $event ),
-				$teams['away'],
-				$teams['home'],
-				tse_sp_get_event_field_name( $event->ID ),
-			)
-		);
-	}
-
-	fclose( $output );
-	exit;
-}
 
 /**
  * CSV headers recognized by this importer.

includes/sp-event-export.php

@@ -0,0 +1,922 @@
+<?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' ),
+			'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_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_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'         => '',
+			'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 ) ),
+	);
+}
+
+/**
+ * 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

@@ -75,15 +75,27 @@ 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
+// Modify the front-end single event query to allow scheduled events to resolve.
-function custom_event_parse_request($query) {
+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'])) {
+	}
-          $query->set('post_type', 'sp_event');
+
-          $query->set('p', $query->query_vars['p']);
+	if ( is_admin() || ! $query->is_main_query() ) {
-          $query->set('post_status', array('publish', 'future'));
+		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', $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

@@ -7,6 +7,89 @@ 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.
  *
@@ -14,7 +97,7 @@ if ( ! defined( 'ABSPATH' ) ) {
  * @param int    $post_id Post ID.
  */
 function tony_sportspress_event_quick_edit_officials_row_data( $column, $post_id ) {
-	if ( 'sp_team' !== $column ) {
+	if ( 'tony_sp_officials' !== $column ) {
 		return;
 	}
 
@@ -28,6 +111,18 @@ function tony_sportspress_event_quick_edit_officials_row_data( $column, $post_id
 		$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 );
@@ -39,7 +134,7 @@ add_action( 'manage_sp_event_posts_custom_column', 'tony_sportspress_event_quick
  * @param string $post_type   Post type key.
  */
 function tony_sportspress_event_quick_edit_officials_field( $column_name, $post_type ) {
-	if ( 'sp_event' !== $post_type || 'sp_team' !== $column_name ) {
+	if ( 'sp_event' !== $post_type || 'tony_sp_officials' !== $column_name ) {
 		return;
 	}
 

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-url-builder.php

@@ -0,0 +1,285 @@
+<?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 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' ? 'Open ICS Feed' : 'Open Feed URL';
+		}
+
+		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

@@ -9,12 +9,14 @@ Tony's SportsPress Enhancements is a collection of add-ons for the [SportsPress]
 - **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
@@ -34,4 +36,4 @@ A: When an event is viewed or shared, a featured image is generated using the pr
 
 ---
 
-*This plugin is not affiliated with or endorsed by ThemeBoy or the official SportsPress plugin.*
+*This plugin is not affiliated with or endorsed by ThemeBoy or the official SportsPress plugin.*

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' ) );
+	}
+}

tonys-sportspress-enhancements.php

@@ -7,16 +7,46 @@
  * Author URI:      https://github.com/anthonyscorrea/
  * Text Domain:     tonys-sportspress-enhancements
  * Domain Path:     /languages
- * Version:         0.1.4
+ * Update URI:      https://github.com/anthonyscorrea/tonys-sportspress-enhancements
+ * Version:         0.1.8
  *
  * @package         Tonys_Sportspress_Enhancements
  */
 
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_VERSION' ) ) {
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_VERSION', '0.1.8' );
+}
+
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_FILE' ) ) {
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_FILE', __FILE__ );
+}
+
+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__ ) );
+}
 
 // Include other files here
+require_once plugin_dir_path(__FILE__) . 'includes/sp-github-updater.php';
+require_once plugin_dir_path(__FILE__) . 'includes/sp-officials-manager-role.php';
 require_once plugin_dir_path(__FILE__) . 'includes/open-graph-tags.php';
 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-export.php';
 require_once plugin_dir_path(__FILE__) . 'includes/sp-event-csv.php';
 require_once plugin_dir_path(__FILE__) . 'includes/sp-event-admin-week-filter.php';
 require_once plugin_dir_path(__FILE__) . 'includes/sp-event-quick-edit-officials.php';
+require_once plugin_dir_path(__FILE__) . 'includes/sp-event-team-ordering.php';
+require_once plugin_dir_path(__FILE__) . 'includes/sp-printable-calendars.php';
+require_once plugin_dir_path(__FILE__) . 'includes/sp-url-builder.php';
+require_once plugin_dir_path(__FILE__) . 'includes/sp-schedule-exporter.php';
+require_once plugin_dir_path(__FILE__) . 'includes/sp-venue-meta.php';
+
+register_activation_hook( __FILE__, 'tony_sportspress_sync_officials_manager_roles' );