Use TONY_SPORTSPRESS_ENHANCEMENTS_DIR constant in requires; localize JS strings

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

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

includes/featured-image-generator.php

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

includes/open-graph-tags.php

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

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

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

includes/sp-event-permalink.php

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

@@ -244,6 +244,73 @@ if ( ! class_exists( 'Tony_Sportspress_Printable_Calendars' ) ) {
 			}
 
 			$current_tab          = $this->current_settings_tab();
+
+			echo '<div class="wrap">';
+			echo '<h1>' . esc_html__( 'Tony\'s Settings', 'tonys-sportspress-enhancements' ) . '</h1>';
+			$this->render_settings_tabs( $current_tab );
+
+			if ( self::TAB_PRINTABLE === $current_tab ) {
+				$this->render_printable_settings_tab( $current_tab );
+			} else {
+				do_action( 'tse_tonys_settings_render_tab_' . $current_tab );
+			}
+
+			echo '</div>';
+		}
+
+		/**
+		 * Render Tony's settings tabs.
+		 *
+		 * @param string $current_tab Current tab key.
+		 */
+		private function render_settings_tabs( $current_tab ) {
+			$tabs = apply_filters(
+				'tse_tonys_settings_tabs',
+				array(
+				self::TAB_PRINTABLE => __( 'Printable Calendars', 'tonys-sportspress-enhancements' ),
+				)
+			);
+
+			echo '<nav class="nav-tab-wrapper" style="margin-bottom:20px;">';
+			foreach ( $tabs as $tab => $label ) {
+				$url = add_query_arg(
+					array(
+						'page' => self::PAGE_SLUG,
+						'tab'  => $tab,
+					),
+					admin_url( 'admin.php' )
+				);
+
+				$class = $tab === $current_tab ? ' nav-tab-active' : '';
+				echo '<a class="nav-tab' . esc_attr( $class ) . '" href="' . esc_url( $url ) . '">' . esc_html( $label ) . '</a>';
+			}
+			echo '</nav>';
+		}
+
+		/**
+		 * Resolve the current settings tab.
+		 *
+		 * @return string
+		 */
+		private function current_settings_tab() {
+			$tab  = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : self::TAB_PRINTABLE;
+			$tabs = apply_filters(
+				'tse_tonys_settings_tabs',
+				array(
+					self::TAB_PRINTABLE => __( 'Printable Calendars', 'tonys-sportspress-enhancements' ),
+				)
+			);
+
+			return isset( $tabs[ $tab ] ) ? $tab : self::TAB_PRINTABLE;
+		}
+
+		/**
+		 * Render printable settings tab content.
+		 *
+		 * @param string $current_tab Current tab key.
+		 * @return void
+		 */
+		private function render_printable_settings_tab( $current_tab ) {
 			$season_id            = $this->selected_season_id();
 			$seasons              = $this->get_seasons();
 			$venues               = $this->get_venues_for_season( $season_id );
@@ -253,9 +320,6 @@ if ( ! class_exists( 'Tony_Sportspress_Printable_Calendars' ) ) {
 			$season_overrides     = isset( $overrides[ $season_key ] ) && is_array( $overrides[ $season_key ] ) ? $overrides[ $season_key ] : array();
 			$season_primary_flags = isset( $primary_flags[ $season_key ] ) && is_array( $primary_flags[ $season_key ] ) ? $primary_flags[ $season_key ] : array();
 
-			echo '<div class="wrap">';
-			echo '<h1>' . esc_html__( 'Tony\'s Settings', 'tonys-sportspress-enhancements' ) . '</h1>';
-			$this->render_settings_tabs( $current_tab );
 			echo '<form method="post" action="options.php">';
 			settings_fields( self::OPTION_GROUP );
 
@@ -325,15 +389,15 @@ if ( ! class_exists( 'Tony_Sportspress_Printable_Calendars' ) ) {
 
 				$palette_count = count( $this->suggested_palette );
 				foreach ( $venues as $index => $venue ) {
-					$venue_id    = (int) $venue['id'];
+					$venue_id     = (int) $venue['id'];
-					$venue_name  = isset( $venue['name'] ) ? (string) $venue['name'] : '';
+					$venue_name   = isset( $venue['name'] ) ? (string) $venue['name'] : '';
-					$saved       = isset( $season_overrides[ (string) $venue_id ] ) && is_string( $season_overrides[ (string) $venue_id ] ) ? $season_overrides[ (string) $venue_id ] : '';
+					$saved        = isset( $season_overrides[ (string) $venue_id ] ) && is_string( $season_overrides[ (string) $venue_id ] ) ? $season_overrides[ (string) $venue_id ] : '';
-					$suggested   = $this->suggested_palette[ $index % max( 1, $palette_count ) ];
+					$suggested    = $this->suggested_palette[ $index % max( 1, $palette_count ) ];
-					$value       = '' !== $saved ? $saved : $suggested;
+					$value        = '' !== $saved ? $saved : $suggested;
-					$adjusted    = $this->adjust_for_white_text( $value, self::MIN_WHITE_CONTRAST );
+					$adjusted     = $this->adjust_for_white_text( $value, self::MIN_WHITE_CONTRAST );
-					$name        = self::OPTION_KEY . '[venue_color_overrides][' . $season_key . '][' . $venue_id . ']';
+					$name         = self::OPTION_KEY . '[venue_color_overrides][' . $season_key . '][' . $venue_id . ']';
 					$primary_name = self::OPTION_KEY . '[venue_use_team_primary][' . $season_key . '][' . $venue_id . ']';
-					$use_primary = isset( $season_primary_flags[ (string) $venue_id ] ) && '1' === $season_primary_flags[ (string) $venue_id ];
+					$use_primary  = isset( $season_primary_flags[ (string) $venue_id ] ) && '1' === $season_primary_flags[ (string) $venue_id ];
 
 					echo '<tr>';
 					echo '<td>' . esc_html( $venue_name ) . '</td>';
@@ -349,46 +413,203 @@ if ( ! class_exists( 'Tony_Sportspress_Printable_Calendars' ) ) {
 
 			submit_button( __( 'Save Settings', 'tonys-sportspress-enhancements' ) );
 			echo '</form>';
-			echo '</div>';
+
+			$this->render_printable_url_builder( $season_id );
 		}
 
 		/**
-		 * Render Tony's settings tabs.
+		 * Render printable calendar URL builder.
 		 *
-		 * @param string $current_tab Current tab key.
+		 * @param int $season_id Current season context.
+		 * @return void
 		 */
-		private function render_settings_tabs( $current_tab ) {
+		private function render_printable_url_builder( $season_id ) {
-			$tabs = array(
+			$leagues = function_exists( 'tse_sp_schedule_exporter_get_leagues' ) ? tse_sp_schedule_exporter_get_leagues() : array();
-				self::TAB_PRINTABLE => __( 'Printable Calendars', 'tonys-sportspress-enhancements' ),
+			$teams   = function_exists( 'tse_sp_schedule_exporter_get_teams' ) ? tse_sp_schedule_exporter_get_teams() : array();
-			);
+			$paper   = '11x17';
 
-			echo '<nav class="nav-tab-wrapper" style="margin-bottom:20px;">';
+			echo '<div class="tse-printable-url-builder" style="max-width:1100px;margin-top:28px;padding:20px 24px;border:1px solid #dcdcde;background:#fff;">';
-			foreach ( $tabs as $tab => $label ) {
+			echo '<h2 style="margin-top:0;">' . esc_html__( 'Printable Calendar URL Builder', 'tonys-sportspress-enhancements' ) . '</h2>';
-				$url = add_query_arg(
+			echo '<p>' . esc_html__( 'Build a shareable printable calendar URL with team, season, league, paper size, and optional auto-print.', 'tonys-sportspress-enhancements' ) . '</p>';
-					array(
-						'page' => self::PAGE_SLUG,
-						'tab'  => $tab,
-					),
-					admin_url( 'admin.php' )
-				);
 
-				$class = self::TAB_PRINTABLE === $tab && self::TAB_PRINTABLE === $current_tab ? ' nav-tab-active' : '';
+			echo '<table class="form-table" role="presentation"><tbody>';
-				echo '<a class="nav-tab' . esc_attr( $class ) . '" href="' . esc_url( $url ) . '">' . esc_html( $label ) . '</a>';
+
+			echo '<tr><th scope="row"><label for="tse-printable-builder-team">' . esc_html__( 'Team', 'tonys-sportspress-enhancements' ) . '</label></th><td>';
+			echo '<select id="tse-printable-builder-team" style="min-width:280px;">';
+			echo '<option value="0">' . esc_html__( 'Choose a team', 'tonys-sportspress-enhancements' ) . '</option>';
+			foreach ( $teams as $team ) {
+				if ( ! $team instanceof WP_Post ) {
+					continue;
+				}
+				echo '<option value="' . esc_attr( (string) $team->ID ) . '">' . esc_html( $team->post_title ) . '</option>';
 			}
-			echo '</nav>';
+			echo '</select>';
+			echo '</td></tr>';
+
+			echo '<tr><th scope="row"><label for="tse-printable-builder-season">' . esc_html__( 'Season', 'tonys-sportspress-enhancements' ) . '</label></th><td>';
+			echo '<select id="tse-printable-builder-season" style="min-width:280px;">';
+			echo '<option value="0">' . esc_html__( 'Current season', 'tonys-sportspress-enhancements' ) . '</option>';
+			foreach ( $this->get_seasons() as $season ) {
+				if ( ! $season instanceof WP_Term ) {
+					continue;
+				}
+				echo '<option value="' . esc_attr( (string) $season->term_id ) . '" ' . selected( $season_id, (int) $season->term_id, false ) . '>' . esc_html( $season->name ) . '</option>';
+			}
+			echo '</select>';
+			echo '</td></tr>';
+
+			echo '<tr><th scope="row"><label for="tse-printable-builder-league">' . esc_html__( 'League', 'tonys-sportspress-enhancements' ) . '</label></th><td>';
+			echo '<select id="tse-printable-builder-league" style="min-width:280px;">';
+			echo '<option value="0">' . esc_html__( 'Any league', 'tonys-sportspress-enhancements' ) . '</option>';
+			foreach ( $leagues as $league ) {
+				if ( ! $league instanceof WP_Term ) {
+					continue;
+				}
+				echo '<option value="' . esc_attr( (string) $league->term_id ) . '">' . esc_html( $league->name ) . '</option>';
+			}
+			echo '</select>';
+			echo '</td></tr>';
+
+			echo '<tr><th scope="row"><label for="tse-printable-builder-paper">' . esc_html__( 'Paper Size', 'tonys-sportspress-enhancements' ) . '</label></th><td>';
+			echo '<select id="tse-printable-builder-paper" style="min-width:280px;">';
+			foreach ( array( 'letter' => __( 'Letter', 'tonys-sportspress-enhancements' ), '11x17' => __( '11x17 / Ledger', 'tonys-sportspress-enhancements' ) ) as $paper_value => $paper_label ) {
+				echo '<option value="' . esc_attr( $paper_value ) . '" ' . selected( $paper, $paper_value, false ) . '>' . esc_html( $paper_label ) . '</option>';
+			}
+			echo '</select>';
+			echo '</td></tr>';
+
+			echo '<tr><th scope="row">' . esc_html__( 'Options', 'tonys-sportspress-enhancements' ) . '</th><td>';
+			echo '<label for="tse-printable-builder-autoprint" style="display:inline-flex;align-items:center;gap:6px;">';
+			echo '<input id="tse-printable-builder-autoprint" type="checkbox" value="1" />';
+			echo esc_html__( 'Auto-open print dialog', 'tonys-sportspress-enhancements' );
+			echo '</label>';
+			echo '</td></tr>';
+
+			echo '</tbody></table>';
+
+			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-printable-builder-output" class="large-text code" readonly="readonly" />';
+			echo '<button type="button" id="tse-printable-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-printable-builder-open" class="button button-primary" href="' . esc_url( home_url( '/' ) ) . '" target="_blank" rel="noopener noreferrer">' . esc_html__( 'Open Printable URL', 'tonys-sportspress-enhancements' ) . '</a></p>';
+			echo '<p class="description">' . esc_html__( 'The printable route requires a single team selection.', 'tonys-sportspress-enhancements' ) . '</p>';
+			echo '</div>';
+
+			$this->render_printable_url_builder_script();
 		}
 
 		/**
-		 * Resolve the current settings tab.
+		 * Render printable URL builder script.
 		 *
-		 * @return string
+		 * @return void
 		 */
-		private function current_settings_tab() {
+		private function render_printable_url_builder_script() {
-			$tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : self::TAB_PRINTABLE;
+			$base_url = home_url( '/' );
+			$query_flag = self::QUERY_FLAG;
+			?>
+			<script>
+			(function(){
+				var root = document.querySelector('.tse-printable-url-builder');
+				if (!root) {
+					return;
+				}
 
-			return self::TAB_PRINTABLE === $tab ? $tab : self::TAB_PRINTABLE;
+				var baseUrl = <?php echo wp_json_encode( $base_url ); ?>;
+				var queryFlag = <?php echo wp_json_encode( $query_flag ); ?>;
+				var team = root.querySelector('#tse-printable-builder-team');
+				var season = root.querySelector('#tse-printable-builder-season');
+				var league = root.querySelector('#tse-printable-builder-league');
+				var paper = root.querySelector('#tse-printable-builder-paper');
+				var autoprint = root.querySelector('#tse-printable-builder-autoprint');
+				var output = root.querySelector('#tse-printable-builder-output');
+				var copyButton = root.querySelector('#tse-printable-builder-copy');
+				var openLink = root.querySelector('#tse-printable-builder-open');
+
+				function buildUrl() {
+					var url = new URL(baseUrl, window.location.origin);
+					url.searchParams.set(queryFlag, '1');
+
+					if (team.value && team.value !== '0') {
+						url.searchParams.set('sp_team', team.value);
+					} else {
+						url.searchParams.delete('sp_team');
+					}
+
+					if (season.value && season.value !== '0') {
+						url.searchParams.set('sp_season', season.value);
+					} else {
+						url.searchParams.delete('sp_season');
+					}
+
+					if (league.value && league.value !== '0') {
+						url.searchParams.set('sp_league', league.value);
+					} else {
+						url.searchParams.delete('sp_league');
+					}
+
+					if (paper.value) {
+						url.searchParams.set('paper', paper.value);
+					}
+
+					if (autoprint.checked) {
+						url.searchParams.set('autoprint', '1');
+					} else {
+						url.searchParams.delete('autoprint');
+					}
+
+					output.value = url.toString();
+					openLink.href = url.toString();
+					openLink.toggleAttribute('disabled', !(team.value && team.value !== '0'));
+				}
+
+				[team, season, league, paper, autoprint].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(markCopied).catch(function(){
+								output.focus();
+								output.select();
+								document.execCommand('copy');
+								markCopied();
+							});
+							return;
+						}
+
+						output.focus();
+						output.select();
+						document.execCommand('copy');
+						markCopied();
+					});
+				}
+
+				buildUrl();
+			})();
+			</script>
+			<?php
 		}
 
+
 		/**
 		 * Render the printable page when the flag is present.
 		 */

includes/sp-schedule-exporter.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * SportsPress schedule exporter admin page.
+ * SportsPress schedule exporter frontend and shared helpers.
  *
  * @package Tonys_Sportspress_Enhancements
  */
@@ -9,22 +9,6 @@ if ( ! defined( 'ABSPATH' ) ) {
 	exit;
 }
 
-/**
- * Register the schedule exporter admin page.
- *
- * @return void
- */
-function tse_sp_schedule_exporter_add_admin_page() {
-	add_submenu_page(
-		'sportspress',
-		__( 'Schedule Exporter', 'tonys-sportspress-enhancements' ),
-		__( 'Schedule Exporter', 'tonys-sportspress-enhancements' ),
-		'manage_sportspress',
-		'tse-schedule-exporter',
-		'tse_sp_schedule_exporter_render_admin_page'
-	);
-}
-add_action( 'admin_menu', 'tse_sp_schedule_exporter_add_admin_page' );
 add_shortcode( 'tse_schedule_exporter', 'tse_sp_schedule_exporter_render_shortcode' );
 add_action( 'init', 'tse_sp_schedule_exporter_register_block' );
 
@@ -40,104 +24,18 @@ function tse_sp_schedule_exporter_handle_download() {
 
 	check_admin_referer( 'tse_schedule_export' );
 
-	$team_id   = isset( $_GET['team_id'] ) ? absint( wp_unslash( $_GET['team_id'] ) ) : 0;
+	$filters = tse_sp_event_export_normalize_request_args();
-	$season_id = isset( $_GET['season_id'] ) ? absint( wp_unslash( $_GET['season_id'] ) ) : 0;
-	$league_id = isset( $_GET['league_id'] ) ? absint( wp_unslash( $_GET['league_id'] ) ) : 0;
-	$format    = isset( $_GET['format'] ) ? sanitize_key( wp_unslash( $_GET['format'] ) ) : '';
 
-	if ( $team_id <= 0 || 'sp_team' !== get_post_type( $team_id ) ) {
+	if ( $filters['team_id'] <= 0 || 'sp_team' !== get_post_type( $filters['team_id'] ) ) {
 		wp_die( esc_html__( 'Choose a valid team before exporting.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 400 ) );
 	}
 
-	if ( ! in_array( $format, array( 'matchup', 'team' ), true ) ) {
+	tse_sp_event_export_stream_csv(
-		wp_die( esc_html__( 'Choose a valid export format.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 400 ) );
+		$filters,
-	}
+		array(
-
+			'disposition' => 'attachment',
-	$events = tse_sp_schedule_exporter_get_events( $team_id, $season_id, $league_id );
+		)
-	$team   = get_post( $team_id );
+	);
-
-	if ( ! $team instanceof WP_Post ) {
-		wp_die( esc_html__( 'The selected team could not be loaded.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 404 ) );
-	}
-
-	$filename = sanitize_title( $team->post_name ? $team->post_name : $team->post_title );
-	if ( '' === $filename ) {
-		$filename = 'schedule';
-	}
-
-	if ( $season_id > 0 ) {
-		$season = get_term( $season_id, 'sp_season' );
-		if ( $season && ! is_wp_error( $season ) && ! empty( $season->slug ) ) {
-			$filename .= '-' . sanitize_title( $season->slug );
-		}
-	}
-
-	$filename .= '-' . $format . '.csv';
-
-	header( 'Content-Type: text/csv; charset=utf-8' );
-	header( 'Content-Disposition: attachment; filename=' . $filename );
-
-	$output = fopen( 'php://output', 'w' );
-	if ( false === $output ) {
-		wp_die( esc_html__( 'Unable to start the CSV export.', 'tonys-sportspress-enhancements' ), '', array( 'response' => 500 ) );
-	}
-
-	fwrite( $output, "\xEF\xBB\xBF" );
-
-	if ( 'matchup' === $format ) {
-		fputcsv(
-			$output,
-			array(
-				'Date',
-				'Time',
-				'Away Team',
-				'Home Team',
-				'Field Name',
-			)
-		);
-
-		foreach ( $events as $event ) {
-			fputcsv(
-				$output,
-				array(
-					$event['date'],
-					$event['time'],
-					$event['away_team'],
-					$event['home_team'],
-					$event['venue_name'],
-				)
-			);
-		}
-	} else {
-		fputcsv(
-			$output,
-			array(
-				'Extra Label',
-				'Date',
-				'Time',
-				'Opponent',
-				'Home/Away',
-				'Venue',
-			)
-		);
-
-		foreach ( $events as $event ) {
-			fputcsv(
-				$output,
-				array(
-					$event['label'],
-					$event['date'],
-					$event['time'],
-					$event['opponent_name'],
-					$event['location_flag'],
-					$event['venue_name'],
-				)
-			);
-		}
-	}
-
-	fclose( $output );
-	exit;
 }
 add_action( 'admin_post_tse_schedule_export', 'tse_sp_schedule_exporter_handle_download' );
 add_action( 'admin_post_nopriv_tse_schedule_export', 'tse_sp_schedule_exporter_handle_download' );
@@ -165,7 +63,7 @@ function tse_sp_schedule_exporter_register_block() {
 		array(
 			'api_version'     => 3,
 			'title'           => __( 'Schedule Exporter', 'tonys-sportspress-enhancements' ),
-			'description'     => __( 'Shows the public schedule exporter with CSV and printable PDF options.', 'tonys-sportspress-enhancements' ),
+			'description'     => __( 'Shows the public schedule exporter with CSV, iCal, and printable page options.', 'tonys-sportspress-enhancements' ),
 			'category'        => 'widgets',
 			'icon'            => 'calendar-alt',
 			'editor_script'   => 'tse-schedule-exporter-block',
@@ -177,149 +75,6 @@ function tse_sp_schedule_exporter_register_block() {
 	);
 }
 
-/**
- * Render the schedule exporter page.
- *
- * @return void
- */
-function tse_sp_schedule_exporter_render_admin_page() {
-	if ( ! current_user_can( 'manage_sportspress' ) ) {
-		return;
-	}
-
-	$leagues   = tse_sp_schedule_exporter_get_leagues();
-	$league_id = tse_sp_schedule_exporter_resolve_league_id( $leagues );
-	$seasons   = tse_sp_schedule_exporter_get_seasons();
-	$season_id = tse_sp_schedule_exporter_resolve_season_id( $seasons );
-	$teams     = tse_sp_schedule_exporter_get_teams( $league_id, $season_id );
-	$team_id   = tse_sp_schedule_exporter_resolve_team_id( $teams );
-	$paper     = tse_sp_schedule_exporter_resolve_paper_size();
-
-	echo '<div class="wrap">';
-	echo '<h1>' . esc_html__( 'Schedule Exporter', 'tonys-sportspress-enhancements' ) . '</h1>';
-	echo '<p>' . esc_html__( 'Choose a team and season, then export the schedule as CSV or open the printable schedule in a PDF-ready print view.', 'tonys-sportspress-enhancements' ) . '</p>';
-
-	echo '<form method="get" action="' . esc_url( admin_url( 'admin.php' ) ) . '" class="tse-schedule-exporter-form" style="max-width:960px;margin:20px 0 28px;">';
-	echo '<input type="hidden" name="page" value="tse-schedule-exporter" />';
-	echo '<table class="form-table" role="presentation"><tbody>';
-
-	echo '<tr>';
-	echo '<th scope="row"><label for="tse-schedule-exporter-league">' . esc_html__( 'League', 'tonys-sportspress-enhancements' ) . '</label></th>';
-	echo '<td><select id="tse-schedule-exporter-league" name="league_id" data-auto-submit="1">';
-	foreach ( $leagues as $league ) {
-		printf(
-			'<option value="%1$s" %2$s>%3$s</option>',
-			esc_attr( (string) $league->term_id ),
-			selected( $league_id, (int) $league->term_id, false ),
-			esc_html( $league->name )
-		);
-	}
-	echo '</select></td>';
-	echo '</tr>';
-
-	echo '<tr>';
-	echo '<th scope="row"><label for="tse-schedule-exporter-season">' . esc_html__( 'Season', 'tonys-sportspress-enhancements' ) . '</label></th>';
-	echo '<td><select id="tse-schedule-exporter-season" name="season_id" data-auto-submit="1">';
-	echo '<option value="0">' . esc_html__( 'Current / All matching events', 'tonys-sportspress-enhancements' ) . '</option>';
-	foreach ( $seasons as $season ) {
-		printf(
-			'<option value="%1$s" %2$s>%3$s</option>',
-			esc_attr( (string) $season->term_id ),
-			selected( $season_id, (int) $season->term_id, false ),
-			esc_html( $season->name )
-		);
-	}
-	echo '</select></td>';
-	echo '</tr>';
-
-	echo '<tr>';
-	echo '<th scope="row"><label for="tse-schedule-exporter-paper">' . esc_html__( 'Paper Size', 'tonys-sportspress-enhancements' ) . '</label></th>';
-	echo '<td><select id="tse-schedule-exporter-paper" name="paper">';
-	foreach ( tse_sp_schedule_exporter_get_paper_sizes() as $paper_value => $paper_label ) {
-		printf(
-			'<option value="%1$s" %2$s>%3$s</option>',
-			esc_attr( $paper_value ),
-			selected( $paper, $paper_value, false ),
-			esc_html( $paper_label )
-		);
-	}
-	echo '</select>';
-	echo '<p class="description">' . esc_html__( 'The PDF option opens the existing printable schedule and triggers the browser print dialog so you can save it as a PDF.', 'tonys-sportspress-enhancements' ) . '</p>';
-	echo '</td>';
-	echo '</tr>';
-
-	echo '<tr>';
-	echo '<th scope="row"><label for="tse-schedule-exporter-team">' . esc_html__( 'Team', 'tonys-sportspress-enhancements' ) . '</label></th>';
-	echo '<td><select id="tse-schedule-exporter-team" name="team_id">';
-	foreach ( $teams as $team ) {
-		printf(
-			'<option value="%1$s" %2$s>%3$s</option>',
-			esc_attr( (string) $team->ID ),
-			selected( $team_id, (int) $team->ID, false ),
-			esc_html( $team->post_title )
-		);
-	}
-	echo '</select>';
-	echo '<p class="description">' . esc_html__( 'Teams are filtered by the selected league and season.', 'tonys-sportspress-enhancements' ) . '</p>';
-	echo '</td>';
-	echo '</tr>';
-
-	echo '</tbody></table>';
-	echo '</form>';
-
-	if ( empty( $teams ) ) {
-		echo '<div class="notice notice-warning inline"><p>' . esc_html__( 'No SportsPress teams match the selected league and season.', 'tonys-sportspress-enhancements' ) . '</p></div>';
-		echo '</div>';
-		return;
-	}
-
-	echo '<div style="max-width:960px;padding:20px 24px;border:1px solid #dcdcde;background:#fff;">';
-	echo '<h2 style="margin-top:0;">' . esc_html__( 'Exports', 'tonys-sportspress-enhancements' ) . '</h2>';
-
-	echo '<table class="widefat striped" style="max-width:100%;margin-top:16px;"><tbody>';
-	foreach ( array(
-		array(
-			'format'      => 'matchup',
-			'label'       => __( 'Download Matchup CSV', 'tonys-sportspress-enhancements' ),
-			'description' => __( 'Date, time, away team, home team, and field name.', 'tonys-sportspress-enhancements' ),
-		),
-		array(
-			'format'      => 'team',
-			'label'       => __( 'Download Team CSV', 'tonys-sportspress-enhancements' ),
-			'description' => __( 'TeamSnap-compatible layout with game label, opponent, home/away flag, and venue.', 'tonys-sportspress-enhancements' ),
-		),
-	) as $export_option ) {
-		$url = wp_nonce_url(
-			add_query_arg(
-				array(
-					'action'    => 'tse_schedule_export',
-					'league_id' => $league_id,
-					'team_id'   => $team_id,
-					'season_id' => $season_id,
-					'format'    => $export_option['format'],
-				),
-				admin_url( 'admin-post.php' )
-			),
-			'tse_schedule_export'
-		);
-
-		echo '<tr>';
-		echo '<td style="width:240px;"><a class="button button-primary tse-export-link" data-format="' . esc_attr( $export_option['format'] ) . '" href="' . esc_url( $url ) . '">' . esc_html( $export_option['label'] ) . '</a></td>';
-		echo '<td>' . esc_html( $export_option['description'] ) . '</td>';
-		echo '</tr>';
-	}
-
-	$pdf_url = tse_sp_schedule_exporter_get_pdf_url( $team_id, $season_id, $paper, $league_id );
-	echo '<tr>';
-	echo '<td style="width:240px;"><a class="button tse-pdf-link" href="' . esc_url( $pdf_url ) . '" target="_blank" rel="noopener noreferrer">' . esc_html__( 'Open Printable PDF View', 'tonys-sportspress-enhancements' ) . '</a></td>';
-	echo '<td>' . esc_html__( 'Opens the printable schedule and launches the browser print dialog so you can save a PDF.', 'tonys-sportspress-enhancements' ) . '</td>';
-	echo '</tr>';
-	echo '</tbody></table>';
-	tse_sp_schedule_exporter_render_link_sync_script( true );
-	echo '</div>';
-	echo '</div>';
-}
-
 /**
  * Render the public shortcode.
  *
@@ -332,7 +87,10 @@ function tse_sp_schedule_exporter_render_shortcode() {
 	$season_id = tse_sp_schedule_exporter_resolve_season_id( $seasons );
 	$teams     = tse_sp_schedule_exporter_get_teams( $league_id, $season_id );
 	$team_id   = tse_sp_schedule_exporter_resolve_team_id( $teams );
-	$paper     = tse_sp_schedule_exporter_resolve_paper_size();
+	$fields    = tse_sp_schedule_exporter_get_fields();
+	$field_id  = tse_sp_schedule_exporter_resolve_field_id( $fields );
+	$export_type = tse_sp_schedule_exporter_resolve_export_type();
+	$subformat   = tse_sp_schedule_exporter_resolve_subformat();
 
 	if ( empty( $teams ) ) {
 		return '<p>' . esc_html__( 'No SportsPress teams match the selected league and season.', 'tonys-sportspress-enhancements' ) . '</p>';
@@ -342,10 +100,34 @@ function tse_sp_schedule_exporter_render_shortcode() {
 	?>
 	<div class="tse-schedule-exporter" style="max-width:960px;margin:0 auto;padding:24px;border:1px solid #d7d7db;background:#fff;">
 		<h2 style="margin-top:0;"><?php esc_html_e( 'Schedule Exporter', 'tonys-sportspress-enhancements' ); ?></h2>
-		<p><?php esc_html_e( 'Export schedules as CSV or open the printable version and save it as a PDF.', 'tonys-sportspress-enhancements' ); ?></p>
+		<p><?php esc_html_e( 'Choose filters once, then generate the CSV feed, iCal link, or printable page URL from the same controls.', 'tonys-sportspress-enhancements' ); ?></p>
 
-		<form method="get" action="<?php echo esc_url( get_permalink() ); ?>" class="tse-schedule-exporter-form" style="display:grid;gap:16px;margin:24px 0;">
+		<form method="get" action="<?php echo esc_url( get_permalink() ); ?>" class="tse-schedule-exporter-form" style="max-width:720px;margin:24px 0;">
-			<div>
+			<div style="margin-bottom:16px;">
+				<label for="tse-public-export-type"><strong><?php esc_html_e( 'Format', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-export-type" name="export_type">
+					<?php foreach ( tse_sp_schedule_exporter_get_export_types() as $type_key => $type_label ) : ?>
+						<option value="<?php echo esc_attr( $type_key ); ?>" <?php selected( $export_type, $type_key ); ?>>
+							<?php echo esc_html( $type_label ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+				<p class="description"><?php esc_html_e( 'CSV builds a feed URL, iCal Link builds a subscription URL, and Printable opens the printable page.', 'tonys-sportspress-enhancements' ); ?></p>
+			</div>
+
+			<div data-subformat-wrap="1" style="margin-bottom:16px;">
+				<label for="tse-public-subformat"><strong><?php esc_html_e( 'CSV Layout', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-subformat" name="subformat">
+					<?php foreach ( tse_sp_event_export_get_formats() as $format_key => $format_definition ) : ?>
+						<option value="<?php echo esc_attr( $format_key ); ?>" <?php selected( $subformat, $format_key ); ?>>
+							<?php echo esc_html( $format_definition['label'] ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+				<p class="description"><?php esc_html_e( 'Matchup is away vs home. Team is opponent-based and requires one specific team.', 'tonys-sportspress-enhancements' ); ?></p>
+			</div>
+
+			<div style="margin-bottom:16px;">
 				<label for="tse-public-league"><strong><?php esc_html_e( 'League', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
 				<select id="tse-public-league" name="league_id" data-auto-submit="1">
 					<?php foreach ( $leagues as $league ) : ?>
@@ -356,7 +138,7 @@ function tse_sp_schedule_exporter_render_shortcode() {
 				</select>
 			</div>
 
-			<div>
+			<div style="margin-bottom:16px;">
 				<label for="tse-public-season"><strong><?php esc_html_e( 'Season', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
 				<select id="tse-public-season" name="season_id" data-auto-submit="1">
 					<option value="0"><?php esc_html_e( 'Current / All matching events', 'tonys-sportspress-enhancements' ); ?></option>
@@ -368,20 +150,10 @@ function tse_sp_schedule_exporter_render_shortcode() {
 				</select>
 			</div>
 
-			<div>
+			<div style="margin-bottom:16px;">
-				<label for="tse-public-paper"><strong><?php esc_html_e( 'Paper Size', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
-				<select id="tse-public-paper" name="paper">
-					<?php foreach ( tse_sp_schedule_exporter_get_paper_sizes() as $paper_value => $paper_label ) : ?>
-						<option value="<?php echo esc_attr( $paper_value ); ?>" <?php selected( $paper, $paper_value ); ?>>
-							<?php echo esc_html( $paper_label ); ?>
-						</option>
-					<?php endforeach; ?>
-				</select>
-			</div>
-
-			<div>
 				<label for="tse-public-team"><strong><?php esc_html_e( 'Team', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
 				<select id="tse-public-team" name="team_id">
+					<option value="0"><?php esc_html_e( 'All teams', 'tonys-sportspress-enhancements' ); ?></option>
 					<?php foreach ( $teams as $team ) : ?>
 						<option value="<?php echo esc_attr( (string) $team->ID ); ?>" <?php selected( $team_id, (int) $team->ID ); ?>>
 							<?php echo esc_html( $team->post_title ); ?>
@@ -390,30 +162,37 @@ function tse_sp_schedule_exporter_render_shortcode() {
 				</select>
 			</div>
 
+			<div style="margin-bottom:16px;">
+				<label for="tse-public-field"><strong><?php esc_html_e( 'Field', 'tonys-sportspress-enhancements' ); ?></strong></label><br />
+				<select id="tse-public-field" name="field_id">
+					<option value="0"><?php esc_html_e( 'All fields', 'tonys-sportspress-enhancements' ); ?></option>
+					<?php foreach ( $fields as $field ) : ?>
+						<option value="<?php echo esc_attr( (string) $field->term_id ); ?>" <?php selected( $field_id, (int) $field->term_id ); ?>>
+							<?php echo esc_html( $field->name ); ?>
+						</option>
+					<?php endforeach; ?>
+				</select>
+			</div>
+
 		</form>
 
-		<table style="width:100%;border-collapse:collapse;margin-top:16px;">
+		<?php tse_sp_schedule_exporter_render_column_picker( 'matchup', 'public', $subformat ); ?>
-			<tbody>
+		<?php tse_sp_schedule_exporter_render_column_picker( 'team', 'public', $subformat ); ?>
-				<tr>
+
-					<td style="width:240px;padding:10px 12px;border:1px solid #d7d7db;">
+		<?php
-						<a class="button button-primary tse-export-link" data-format="matchup" href="<?php echo esc_url( tse_sp_schedule_exporter_get_export_url( $team_id, $season_id, 'matchup', $league_id ) ); ?>"><?php esc_html_e( 'Download Matchup CSV', 'tonys-sportspress-enhancements' ); ?></a>
+		$csv_url = tse_sp_event_export_get_feed_url( array( 'team_id' => $team_id, 'season_id' => $season_id, 'league_id' => $league_id, 'field_id' => $field_id, 'format' => $subformat ), 'csv' );
-					</td>
+		$ics_url = tse_sp_event_export_get_feed_url( array( 'team_id' => $team_id, 'season_id' => $season_id, 'league_id' => $league_id, 'field_id' => $field_id ), 'ics' );
-					<td style="padding:10px 12px;border:1px solid #d7d7db;"><?php esc_html_e( 'Date, time, away team, home team, and field name.', 'tonys-sportspress-enhancements' ); ?></td>
+		$print_url = tse_sp_schedule_exporter_get_printable_url( $team_id, $season_id, 'letter', $league_id );
-				</tr>
+		$current_url = tse_sp_schedule_exporter_get_output_url( $export_type, $csv_url, $ics_url, $print_url );
-				<tr>
+		?>
-					<td style="width:240px;padding:10px 12px;border:1px solid #d7d7db;">
+		<div style="display:flex;align-items:center;gap:8px;max-width:100%;margin-top:16px;">
-						<a class="button button-primary tse-export-link" data-format="team" href="<?php echo esc_url( tse_sp_schedule_exporter_get_export_url( $team_id, $season_id, 'team', $league_id ) ); ?>"><?php esc_html_e( 'Download Team CSV', 'tonys-sportspress-enhancements' ); ?></a>
+			<input type="text" class="large-text code tse-output-url" readonly="readonly" value="<?php echo esc_attr( $current_url ); ?>" />
-					</td>
+			<button type="button" class="button tse-copy-link" title="<?php esc_attr_e( 'Copy URL', 'tonys-sportspress-enhancements' ); ?>"><?php esc_html_e( 'Copy URL', 'tonys-sportspress-enhancements' ); ?></button>
-					<td style="padding:10px 12px;border:1px solid #d7d7db;"><?php esc_html_e( 'TeamSnap-compatible layout with game label, opponent, home/away flag, and venue.', 'tonys-sportspress-enhancements' ); ?></td>
+			<button type="button" class="button button-primary tse-open-link" data-csv-url="<?php echo esc_url( $csv_url ); ?>" data-ics-url="<?php echo esc_url( $ics_url ); ?>" data-print-url="<?php echo esc_url( $print_url ); ?>" title="<?php esc_attr_e( 'Open URL in new tab', 'tonys-sportspress-enhancements' ); ?>"><?php esc_html_e( 'Open URL in New Tab', 'tonys-sportspress-enhancements' ); ?></button>
-				</tr>
+			<button type="button" class="button button-primary tse-ics-ios-link" data-ics-url="<?php echo esc_url( $ics_url ); ?>" title="<?php esc_attr_e( 'Subscribe on iPhone or iPad', 'tonys-sportspress-enhancements' ); ?>" style="display:none;"><?php esc_html_e( 'Subscribe on iPhone/iPad', 'tonys-sportspress-enhancements' ); ?></button>
-				<tr>
+			<button type="button" class="button tse-ics-android-link" data-ics-url="<?php echo esc_url( $ics_url ); ?>" title="<?php esc_attr_e( 'Subscribe on Android', 'tonys-sportspress-enhancements' ); ?>" style="display:none;"><?php esc_html_e( 'Subscribe on Android', 'tonys-sportspress-enhancements' ); ?></button>
-					<td style="width:240px;padding:10px 12px;border:1px solid #d7d7db;">
+		</div>
-						<a class="button tse-pdf-link" href="<?php echo esc_url( tse_sp_schedule_exporter_get_pdf_url( $team_id, $season_id, $paper, $league_id ) ); ?>" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'Open Printable PDF View', 'tonys-sportspress-enhancements' ); ?></a>
+		<p class="description tse-output-note"><?php esc_html_e( 'Use the buttons to copy the generated URL or open the right destination for this export type.', 'tonys-sportspress-enhancements' ); ?></p>
-					</td>
-					<td style="padding:10px 12px;border:1px solid #d7d7db;"><?php esc_html_e( 'Opens the printable schedule and starts the print dialog so visitors can save a PDF.', 'tonys-sportspress-enhancements' ); ?></td>
-				</tr>
-			</tbody>
-		</table>
 	</div>
 	<?php
 	$output = (string) ob_get_clean();
@@ -478,6 +257,28 @@ function tse_sp_schedule_exporter_get_seasons() {
 	return $seasons;
 }
 
+/**
+ * Get fields for the exporter.
+ *
+ * @return WP_Term[]
+ */
+function tse_sp_schedule_exporter_get_fields() {
+	$fields = get_terms(
+		array(
+			'taxonomy'   => 'sp_venue',
+			'hide_empty' => false,
+			'orderby'    => 'name',
+			'order'      => 'ASC',
+		)
+	);
+
+	if ( is_wp_error( $fields ) || ! is_array( $fields ) ) {
+		return array();
+	}
+
+	return $fields;
+}
+
 /**
  * Get teams for the exporter.
  *
@@ -552,6 +353,70 @@ function tse_sp_schedule_exporter_resolve_team_id( $teams ) {
 	return 0;
 }
 
+/**
+ * Resolve selected field ID.
+ *
+ * @param WP_Term[] $fields Field terms.
+ * @return int
+ */
+function tse_sp_schedule_exporter_resolve_field_id( $fields ) {
+	$requested = isset( $_GET['field_id'] ) ? absint( wp_unslash( $_GET['field_id'] ) ) : 0;
+
+	if ( 0 === $requested ) {
+		return 0;
+	}
+
+	foreach ( $fields as $field ) {
+		if ( $field instanceof WP_Term && (int) $field->term_id === $requested ) {
+			return $requested;
+		}
+	}
+
+	return 0;
+}
+
+/**
+ * Render selectable columns for a format.
+ *
+ * @param string $format  Export format.
+ * @param string $context Render context suffix.
+ * @return void
+ */
+function tse_sp_schedule_exporter_render_column_picker( $format, $context, $active_format = '' ) {
+	$format      = tse_sp_event_export_sanitize_format( $format );
+	$definitions = tse_sp_event_export_get_column_definitions();
+	$columns     = isset( $definitions[ $format ] ) ? $definitions[ $format ] : array();
+	$selected    = tse_sp_event_export_get_default_columns( $format );
+	$formats     = tse_sp_event_export_get_formats();
+	$legend      = isset( $formats[ $format ]['label'] ) ? $formats[ $format ]['label'] : ucfirst( $format );
+
+	if ( empty( $columns ) ) {
+		return;
+	}
+
+	$style = 'margin:18px 0;padding:16px;border:1px solid #d7d7db;';
+	if ( $active_format && $active_format !== $format ) {
+		$style .= 'display:none;';
+	}
+
+	echo '<fieldset data-column-group="' . esc_attr( $format ) . '" style="' . esc_attr( $style ) . '">';
+	echo '<legend><strong>' . esc_html( sprintf( __( '%s Columns', 'tonys-sportspress-enhancements' ), $legend ) ) . '</strong></legend>';
+	echo '<div style="display:flex;flex-wrap:wrap;gap:12px 18px;">';
+
+	foreach ( $columns as $column_key => $column_label ) {
+		$input_id = sprintf( 'tse-columns-%1$s-%2$s-%3$s', sanitize_html_class( $context ), sanitize_html_class( $format ), sanitize_html_class( $column_key ) );
+
+		echo '<label for="' . esc_attr( $input_id ) . '" style="display:inline-flex;align-items:center;gap:6px;">';
+		echo '<input id="' . esc_attr( $input_id ) . '" type="checkbox" data-columns-format="' . esc_attr( $format ) . '" value="' . esc_attr( $column_key ) . '" ' . checked( in_array( $column_key, $selected, true ), true, false ) . ' />';
+		echo esc_html( $column_label );
+		echo '</label>';
+	}
+
+	echo '</div>';
+	echo '<p class="description" style="margin:10px 0 0;">' . esc_html__( 'These checkboxes only change the CSV feed link. iCal and printable links use the same shared filters but ignore columns.', 'tonys-sportspress-enhancements' ) . '</p>';
+	echo '</fieldset>';
+}
+
 /**
  * Resolve selected league ID.
  *
@@ -631,6 +496,74 @@ function tse_sp_schedule_exporter_resolve_paper_size() {
 	return array_key_exists( $paper, tse_sp_schedule_exporter_get_paper_sizes() ) ? $paper : 'letter';
 }
 
+/**
+ * Resolve selected export format.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_resolve_format() {
+	$requested = isset( $_GET['format'] ) ? sanitize_key( wp_unslash( $_GET['format'] ) ) : 'matchup';
+
+	return tse_sp_event_export_sanitize_format( $requested );
+}
+
+/**
+ * Get supported exporter output types.
+ *
+ * @return array
+ */
+function tse_sp_schedule_exporter_get_export_types() {
+	return array(
+		'csv'       => __( 'CSV', 'tonys-sportspress-enhancements' ),
+		'ics'       => __( 'iCal Link', 'tonys-sportspress-enhancements' ),
+		'printable' => __( 'Printable', 'tonys-sportspress-enhancements' ),
+	);
+}
+
+/**
+ * Resolve selected exporter output type.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_resolve_export_type() {
+	$requested = isset( $_GET['export_type'] ) ? sanitize_key( wp_unslash( $_GET['export_type'] ) ) : 'csv';
+	$types     = tse_sp_schedule_exporter_get_export_types();
+
+	return isset( $types[ $requested ] ) ? $requested : 'csv';
+}
+
+/**
+ * Resolve selected CSV subformat.
+ *
+ * @return string
+ */
+function tse_sp_schedule_exporter_resolve_subformat() {
+	$requested = isset( $_GET['subformat'] ) ? sanitize_key( wp_unslash( $_GET['subformat'] ) ) : 'matchup';
+
+	return tse_sp_event_export_sanitize_format( $requested );
+}
+
+/**
+ * Get current output URL for the selected export type.
+ *
+ * @param string $export_type Export type.
+ * @param string $csv_url     CSV URL.
+ * @param string $ics_url     ICS URL.
+ * @param string $print_url   Printable URL.
+ * @return string
+ */
+function tse_sp_schedule_exporter_get_output_url( $export_type, $csv_url, $ics_url, $print_url ) {
+	if ( 'ics' === $export_type ) {
+		return $ics_url;
+	}
+
+	if ( 'printable' === $export_type ) {
+		return $print_url;
+	}
+
+	return $csv_url;
+}
+
 /**
  * Collect team schedule events for export.
  *
@@ -761,32 +694,7 @@ function tse_sp_schedule_exporter_get_primary_venue( $event_id ) {
 }
 
 /**
- * Build an export download URL.
+ * Build the printable page URL.
- *
- * @param int    $team_id   Team ID.
- * @param int    $season_id Season ID.
- * @param string $format    Export format.
- * @param int    $league_id League ID.
- * @return string
- */
-function tse_sp_schedule_exporter_get_export_url( $team_id, $season_id, $format, $league_id = 0 ) {
-	return wp_nonce_url(
-		add_query_arg(
-			array(
-				'action'    => 'tse_schedule_export',
-				'league_id' => absint( $league_id ),
-				'team_id'   => absint( $team_id ),
-				'season_id' => absint( $season_id ),
-				'format'    => sanitize_key( $format ),
-			),
-			admin_url( 'admin-post.php' )
-		),
-		'tse_schedule_export'
-	);
-}
-
-/**
- * Build the printable PDF URL.
  *
  * @param int    $team_id   Team ID.
  * @param int    $season_id Season ID.
@@ -794,7 +702,7 @@ function tse_sp_schedule_exporter_get_export_url( $team_id, $season_id, $format,
  * @param int    $league_id League ID.
  * @return string
  */
-function tse_sp_schedule_exporter_get_pdf_url( $team_id, $season_id, $paper, $league_id = 0 ) {
+function tse_sp_schedule_exporter_get_printable_url( $team_id, $season_id, $paper, $league_id = 0, $autoprint = false ) {
 	return add_query_arg(
 		array(
 			Tony_Sportspress_Printable_Calendars::QUERY_FLAG => '1',
@@ -802,7 +710,7 @@ function tse_sp_schedule_exporter_get_pdf_url( $team_id, $season_id, $paper, $le
 			'sp_season'                                      => $season_id > 0 ? (string) absint( $season_id ) : '',
 			'sp_league'                                      => $league_id > 0 ? (string) absint( $league_id ) : '',
 			'paper'                                          => $paper,
-			'autoprint'                                      => '1',
+			'autoprint'                                      => $autoprint ? '1' : '',
 		),
 		home_url( '/' )
 	);
@@ -818,6 +726,30 @@ function tse_sp_schedule_exporter_render_link_sync_script( $echo = false ) {
 	$script = <<<HTML
 <script>
 (function(){
+	function copyText(text, done){
+		if (navigator.clipboard && navigator.clipboard.writeText) {
+			navigator.clipboard.writeText(text).then(done).catch(function(){
+				var input = document.createElement('input');
+				input.value = text;
+				document.body.appendChild(input);
+				input.focus();
+				input.select();
+				document.execCommand('copy');
+				document.body.removeChild(input);
+				done();
+			});
+			return;
+		}
+		var input = document.createElement('input');
+		input.value = text;
+		document.body.appendChild(input);
+		input.focus();
+		input.select();
+		document.execCommand('copy');
+		document.body.removeChild(input);
+		done();
+	}
+
 	function syncLinks(scope){
 		var form = scope.querySelector('.tse-schedule-exporter-form');
 		if (!form) {
@@ -827,25 +759,123 @@ function tse_sp_schedule_exporter_render_link_sync_script( $echo = false ) {
 		var league = form.querySelector('[name="league_id"]');
 		var season = form.querySelector('[name="season_id"]');
 		var team = form.querySelector('[name="team_id"]');
-		var paper = form.querySelector('[name="paper"]');
+		var exportType = form.querySelector('[name="export_type"]');
+		var subformat = form.querySelector('[name="subformat"]');
+		var field = form.querySelector('[name="field_id"]');
+		var outputUrl = scope.querySelector('.tse-output-url');
+		var openButton = scope.querySelector('.tse-open-link');
+		var iosButton = scope.querySelector('.tse-ics-ios-link');
+		var androidButton = scope.querySelector('.tse-ics-android-link');
+		var outputNote = scope.querySelector('.tse-output-note');
+		var copyButton = scope.querySelector('.tse-copy-link');
+		var teamValue = team ? (team.value || '0') : '0';
+		var activeSubformat = subformat ? (subformat.value || 'matchup') : 'matchup';
+		var selectedExportType = exportType ? (exportType.value || 'csv') : 'csv';
 
-		scope.querySelectorAll('.tse-export-link').forEach(function(link){
+		scope.querySelectorAll('[data-column-group]').forEach(function(group){
-			var url = new URL(link.href, window.location.origin);
+			var visible = selectedExportType === 'csv' && group.getAttribute('data-column-group') === activeSubformat;
-			if (league) url.searchParams.set('league_id', league.value || '0');
+			group.style.display = visible ? 'block' : 'none';
-			if (season) url.searchParams.set('season_id', season.value || '0');
-			if (team) url.searchParams.set('team_id', team.value || '0');
-			if (link.dataset.format) url.searchParams.set('format', link.dataset.format);
-			link.href = url.toString();
 		});
 
-		scope.querySelectorAll('.tse-pdf-link').forEach(function(link){
+		if (scope.querySelector('[data-subformat-wrap]')) {
-			var url = new URL(link.href, window.location.origin);
+			scope.querySelectorAll('[data-subformat-wrap]').forEach(function(wrap){
-			if (league) url.searchParams.set('sp_league', league.value || '0');
+				wrap.style.display = selectedExportType === 'csv' ? 'block' : 'none';
-			if (season) url.searchParams.set('sp_season', season.value || '0');
+			});
-			if (team) url.searchParams.set('sp_team', team.value || '0');
+		}
-			if (paper) url.searchParams.set('paper', paper.value || 'letter');
+
-			link.href = url.toString();
+		var csvUrl = openButton ? new URL(openButton.dataset.csvUrl, window.location.origin) : null;
-		});
+		var icsUrl = openButton ? new URL(openButton.dataset.icsUrl, window.location.origin) : null;
+		var printUrl = openButton ? new URL(openButton.dataset.printUrl, window.location.origin) : null;
+
+		if (csvUrl) {
+			if (league) csvUrl.searchParams.set('league_id', league.value || '0');
+			if (season) csvUrl.searchParams.set('season_id', season.value || '0');
+			if (team) csvUrl.searchParams.set('team_id', teamValue);
+			if (field) csvUrl.searchParams.set('field_id', field.value || '0');
+			csvUrl.searchParams.set('format', activeSubformat);
+			var columns = Array.prototype.slice.call(scope.querySelectorAll('[data-columns-format="' + activeSubformat + '"]:checked')).map(function(input){
+				return input.value;
+			}).filter(Boolean);
+			if (columns.length) {
+				csvUrl.searchParams.set('columns', columns.join(','));
+			} else {
+				csvUrl.searchParams.delete('columns');
+			}
+		}
+
+		if (icsUrl) {
+			if (league) icsUrl.searchParams.set('league_id', league.value || '0');
+			if (season) icsUrl.searchParams.set('season_id', season.value || '0');
+			if (team) icsUrl.searchParams.set('team_id', teamValue);
+			if (field) icsUrl.searchParams.set('field_id', field.value || '0');
+			icsUrl.searchParams.delete('format');
+			icsUrl.searchParams.delete('columns');
+		}
+
+		if (printUrl) {
+			if (league) printUrl.searchParams.set('sp_league', league.value || '0');
+			if (season) printUrl.searchParams.set('sp_season', season.value || '0');
+			if (team) printUrl.searchParams.set('sp_team', teamValue);
+			printUrl.searchParams.set('paper', 'letter');
+		}
+
+		var resolvedUrl = csvUrl ? csvUrl.toString() : '';
+		var label = 'Open URL in New Tab';
+		var disabled = false;
+		var note = 'Use the buttons to copy the generated URL or open the right destination for this export type.';
+		var iosUrl = icsUrl ? icsUrl.toString().replace(/^https?:\/\//, 'webcal://') : '';
+		var androidUrl = icsUrl ? 'https://calendar.google.com/calendar/render?cid=' + encodeURIComponent(icsUrl.toString()) : '';
+
+		if (selectedExportType === 'ics' && icsUrl) {
+			resolvedUrl = icsUrl.toString();
+			note = 'Use the iPhone/iPad or Android button to subscribe, or copy the feed URL.';
+		} else if (selectedExportType === 'printable' && printUrl) {
+			resolvedUrl = printUrl.toString();
+			if (teamValue === '0') {
+				disabled = true;
+				note = 'Printable requires a specific team. All teams is not supported.';
+			}
+		} else if (selectedExportType === 'csv' && activeSubformat === 'team' && teamValue === '0') {
+			disabled = true;
+			note = 'CSV team layout requires a specific team. All teams is not supported.';
+		}
+
+		if (outputUrl) {
+			outputUrl.value = resolvedUrl;
+		}
+
+		if (openButton) {
+			openButton.dataset.currentUrl = resolvedUrl;
+			openButton.textContent = label;
+			openButton.style.display = selectedExportType === 'ics' ? 'none' : 'inline-flex';
+			openButton.disabled = disabled;
+			openButton.setAttribute('aria-disabled', disabled ? 'true' : 'false');
+			openButton.style.opacity = disabled ? '0.55' : '1';
+		}
+
+		if (iosButton) {
+			iosButton.dataset.currentUrl = iosUrl;
+			iosButton.style.display = selectedExportType === 'ics' ? 'inline-flex' : 'none';
+			iosButton.disabled = !iosUrl;
+			iosButton.setAttribute('aria-disabled', !iosUrl ? 'true' : 'false');
+			iosButton.style.opacity = !iosUrl ? '0.55' : '1';
+		}
+
+		if (androidButton) {
+			androidButton.dataset.currentUrl = androidUrl;
+			androidButton.style.display = selectedExportType === 'ics' ? 'inline-flex' : 'none';
+			androidButton.disabled = !androidUrl;
+			androidButton.setAttribute('aria-disabled', !androidUrl ? 'true' : 'false');
+			androidButton.style.opacity = !androidUrl ? '0.55' : '1';
+		}
+
+		if (outputNote) {
+			outputNote.textContent = note;
+		}
+
+		if (copyButton) {
+			copyButton.disabled = disabled;
+		}
 	}
 
 	document.querySelectorAll('.tse-schedule-exporter, .wrap').forEach(function(scope){
@@ -865,6 +895,67 @@ function tse_sp_schedule_exporter_render_link_sync_script( $echo = false ) {
 				syncLinks(scope);
 			});
 		});
+
+		scope.querySelectorAll('[data-columns-format]').forEach(function(input){
+			input.addEventListener('change', function(){
+				syncLinks(scope);
+			});
+		});
+
+		var copyButton = scope.querySelector('.tse-copy-link');
+		var openButton = scope.querySelector('.tse-open-link');
+		var iosButton = scope.querySelector('.tse-ics-ios-link');
+		var androidButton = scope.querySelector('.tse-ics-android-link');
+		var outputUrl = scope.querySelector('.tse-output-url');
+		if (copyButton && outputUrl) {
+			copyButton.addEventListener('click', function(){
+				if (copyButton.disabled || !outputUrl.value) {
+					return;
+				}
+
+				var defaultTitle = copyButton.getAttribute('data-default-title') || copyButton.title || 'Copy URL';
+				copyButton.setAttribute('data-default-title', defaultTitle);
+
+				copyText(outputUrl.value, function(){
+					copyButton.title = 'Copied';
+					window.setTimeout(function(){
+						copyButton.title = defaultTitle;
+					}, 1200);
+				});
+			});
+		}
+
+		if (openButton && outputUrl) {
+			openButton.addEventListener('click', function(){
+				if (openButton.disabled || !outputUrl.value) {
+					return;
+				}
+
+				window.open(outputUrl.value, '_blank', 'noopener,noreferrer');
+			});
+		}
+
+		if (iosButton) {
+			iosButton.addEventListener('click', function(){
+				var targetUrl = iosButton.dataset.currentUrl || '';
+				if (iosButton.disabled || !targetUrl) {
+					return;
+				}
+
+				window.location.href = targetUrl;
+			});
+		}
+
+		if (androidButton) {
+			androidButton.addEventListener('click', function(){
+				var targetUrl = androidButton.dataset.currentUrl || '';
+				if (androidButton.disabled || !targetUrl) {
+					return;
+				}
+
+				window.open(targetUrl, '_blank', 'noopener,noreferrer');
+			});
+		}
 	});
 })();
 </script>

includes/sp-url-builder.php

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

tests/test-sp-webhooks.php

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

tonys-sportspress-enhancements.php

@@ -7,13 +7,14 @@
  * Author URI:      https://github.com/anthonyscorrea/
  * Text Domain:     tonys-sportspress-enhancements
  * Domain Path:     /languages
- * Version:         0.1.6
+ * Update URI:      https://github.com/anthonyscorrea/tonys-sportspress-enhancements
+ * Version:         0.1.9
  *
  * @package         Tonys_Sportspress_Enhancements
  */
 
 if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_VERSION' ) ) {
-	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_VERSION', '0.1.6' );
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_VERSION', '0.1.9' );
 }
 
 if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_FILE' ) ) {
@@ -28,14 +29,24 @@ if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_URL' ) ) {
 	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_URL', plugin_dir_url( __FILE__ ) );
 }
 
-// Include other files here
+if ( ! defined( 'TONY_SPORTSPRESS_ENHANCEMENTS_PLUGIN_BASENAME' ) ) {
-require_once plugin_dir_path(__FILE__) . 'includes/open-graph-tags.php';
+	define( 'TONY_SPORTSPRESS_ENHANCEMENTS_PLUGIN_BASENAME', plugin_basename( __FILE__ ) );
-require_once plugin_dir_path(__FILE__) . 'includes/featured-image-generator.php';
+}
-require_once plugin_dir_path(__FILE__) . 'includes/sp-event-permalink.php';
+
-require_once plugin_dir_path(__FILE__) . 'includes/sp-event-csv.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-github-updater.php';
-require_once plugin_dir_path(__FILE__) . 'includes/sp-event-admin-week-filter.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-officials-manager-role.php';
-require_once plugin_dir_path(__FILE__) . 'includes/sp-event-quick-edit-officials.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/open-graph-tags.php';
-require_once plugin_dir_path(__FILE__) . 'includes/sp-event-team-ordering.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/featured-image-generator.php';
-require_once plugin_dir_path(__FILE__) . 'includes/sp-printable-calendars.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-permalink.php';
-require_once plugin_dir_path(__FILE__) . 'includes/sp-schedule-exporter.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-export.php';
-require_once plugin_dir_path(__FILE__) . 'includes/sp-venue-meta.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-csv.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-admin-week-filter.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-quick-edit-officials.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-event-team-ordering.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-printable-calendars.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-url-builder.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-webhooks.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-schedule-exporter.php';
+require_once TONY_SPORTSPRESS_ENHANCEMENTS_DIR . 'includes/sp-venue-meta.php';
+
+register_activation_hook( __FILE__, 'tony_sportspress_sync_officials_manager_roles' );