From 00f3ebdfa171bea4836c887ab191f832c4e868bc Mon Sep 17 00:00:00 2001
From: Shreyas Ikhar <shreyasikhar26@gmail.com>
Date: Fri, 8 May 2026 15:36:57 +0530
Subject: [PATCH 1/3] Enhance attachment handling: Use attachment file URL when
 pages are disabled and update media templates accordingly.

Co-authored-by: Copilot <copilot@github.com>
---
 src/wp-admin/includes/post.php             |  6 ++++-
 src/wp-includes/media-template.php         |  9 +++++++
 tests/phpunit/tests/admin/includesPost.php | 17 +++++++++++++
 tests/phpunit/tests/media.php              | 28 ++++++++++++++++++++++
 4 files changed, 59 insertions(+), 1 deletion(-)

diff --git a/src/wp-admin/includes/post.php b/src/wp-admin/includes/post.php
index 8d52c1487a7a5..54d64f9a3a04f 100644
--- a/src/wp-admin/includes/post.php
+++ b/src/wp-admin/includes/post.php
@@ -1570,7 +1570,11 @@ function get_sample_permalink_html( $post, $new_title = null, $new_slug = null )
 			$preview_target = " target='wp-preview-{$post->ID}'";
 		} else {
 			if ( 'publish' === $post->post_status || 'attachment' === $post->post_type ) {
-				$view_link = get_permalink( $post );
+				if ( 'attachment' === $post->post_type && ! get_option( 'wp_attachment_pages_enabled' ) ) {
+					$view_link = wp_get_attachment_url( $post->ID );
+				} else {
+					$view_link = get_permalink( $post );
+				}
 			} else {
 				// Allow non-published (private, future) to be viewed at a pretty permalink, in case $post->post_name is set.
 				$view_link = str_replace( array( '%pagename%', '%postname%' ), $post->post_name, $permalink );
diff --git a/src/wp-includes/media-template.php b/src/wp-includes/media-template.php
index 5fb6b5d894d9b..1b40e76e880ee 100644
--- a/src/wp-includes/media-template.php
+++ b/src/wp-includes/media-template.php
@@ -822,6 +822,7 @@ function wp_print_media_templates() {
 	</script>
 
 	<?php // Template for the Attachment display settings, used for example in the sidebar. ?>
+	<?php $wp_attachment_pages_enabled = (bool) get_option( 'wp_attachment_pages_enabled' ); ?>
 	<script type="text/html" id="tmpl-attachment-display-settings">
 		<h2><?php _e( 'Attachment Display Settings' ); ?></h2>
 
@@ -881,6 +882,7 @@ function wp_print_media_templates() {
 					<?php esc_html_e( 'Media File' ); ?>
 				<# } #>
 				</option>
+				<?php if ( $wp_attachment_pages_enabled ) : ?>
 				<option value="post">
 				<# if ( data.model.canEmbed ) { #>
 					<?php esc_html_e( 'Link to Attachment Page' ); ?>
@@ -888,6 +890,7 @@ function wp_print_media_templates() {
 					<?php esc_html_e( 'Attachment Page' ); ?>
 				<# } #>
 				</option>
+				<?php endif; ?>
 			<# if ( 'image' === data.type ) { #>
 				<option value="custom">
 					<?php esc_html_e( 'Custom URL' ); ?>
@@ -947,12 +950,16 @@ function wp_print_media_templates() {
 					data-user-setting="urlbutton"
 				<# } #>>
 
+				<?php if ( $wp_attachment_pages_enabled ) : ?>
 				<option value="post" <# if ( ! wp.media.galleryDefaults.link || 'post' === wp.media.galleryDefaults.link ) {
 					#>selected="selected"<# }
 				#>>
 					<?php esc_html_e( 'Attachment Page' ); ?>
 				</option>
 				<option value="file" <# if ( 'file' === wp.media.galleryDefaults.link ) { #>selected="selected"<# } #>>
+				<?php else : ?>
+				<option value="file" <# if ( ! wp.media.galleryDefaults.link || 'file' === wp.media.galleryDefaults.link || 'post' === wp.media.galleryDefaults.link ) { #>selected="selected"<# } #>>
+				<?php endif; ?>
 					<?php esc_html_e( 'Media File' ); ?>
 				</option>
 				<option value="none" <# if ( 'none' === wp.media.galleryDefaults.link ) { #>selected="selected"<# } #>>
@@ -1228,9 +1235,11 @@ function wp_print_media_templates() {
 							<option value="file">
 								<?php esc_html_e( 'Media File' ); ?>
 							</option>
+							<?php if ( $wp_attachment_pages_enabled ) : ?>
 							<option value="post">
 								<?php esc_html_e( 'Attachment Page' ); ?>
 							</option>
+							<?php endif; ?>
 						<# } else { #>
 							<option value="file">
 								<?php esc_html_e( 'Image URL' ); ?>
diff --git a/tests/phpunit/tests/admin/includesPost.php b/tests/phpunit/tests/admin/includesPost.php
index d9d39d8da727d..9e0680ba46c7a 100644
--- a/tests/phpunit/tests/admin/includesPost.php
+++ b/tests/phpunit/tests/admin/includesPost.php
@@ -706,6 +706,23 @@ public function test_get_sample_permalink_html_should_use_pretty_permalink_for_v
 		$this->assertStringContainsString( '>' . urldecode( get_permalink( $post ) ) . '<', $found );
 	}
 
+	/**
+	 * @ticket 65169
+	 */
+	public function test_get_sample_permalink_html_should_use_attachment_file_url_when_attachment_pages_are_disabled() {
+		$this->set_permalink_structure( '/%postname%/' );
+
+		wp_set_current_user( self::$admin_id );
+		update_option( 'wp_attachment_pages_enabled', 0 );
+
+		$attachment_id = self::factory()->attachment->create_upload_object( DIR_TESTDATA . '/images/canola.jpg' );
+
+		$found = get_sample_permalink_html( $attachment_id );
+
+		$this->assertStringContainsString( 'href="' . wp_get_attachment_url( $attachment_id ) . '"', $found );
+		$this->assertStringNotContainsString( 'href="' . get_permalink( $attachment_id ) . '"', $found );
+	}
+
 	/**
 	 * @ticket 32954
 	 * @ticket 18306
diff --git a/tests/phpunit/tests/media.php b/tests/phpunit/tests/media.php
index 060a7295f6bb4..1778f3d6f5031 100644
--- a/tests/phpunit/tests/media.php
+++ b/tests/phpunit/tests/media.php
@@ -494,6 +494,34 @@ public function test_wp_prepare_attachment_for_js_without_image_sizes() {
 		$this->assertArrayHasKey( 'sizes', $prepped );
 	}
 
+	/**
+	 * @ticket 65169
+	 */
+	public function test_wp_print_media_templates_hides_attachment_page_link_options_when_disabled() {
+		update_option( 'wp_attachment_pages_enabled', 0 );
+
+		ob_start();
+		wp_print_media_templates();
+		$output = ob_get_clean();
+
+		$this->assertStringNotContainsString( '<option value="post">', $output );
+		$this->assertStringContainsString( 'Media File', $output );
+	}
+
+	/**
+	 * @ticket 57913
+	 */
+	public function test_wp_print_media_templates_shows_attachment_page_link_options_when_enabled() {
+		update_option( 'wp_attachment_pages_enabled', 1 );
+
+		ob_start();
+		wp_print_media_templates();
+		$output = ob_get_clean();
+
+		$this->assertStringContainsString( '<option value="post">', $output );
+		$this->assertStringContainsString( 'Attachment Page', $output );
+	}
+
 	/**
 	 * @ticket 19067
 	 * @expectedDeprecated wp_convert_bytes_to_hr

From 2eeea95243a8bd751d9b2ab0310f471e65befaaa Mon Sep 17 00:00:00 2001
From: Shreyas Ikhar <shreyasikhar26@gmail.com>
Date: Fri, 8 May 2026 15:44:24 +0530
Subject: [PATCH 2/3] Update ticket reference in media template test case

---
 tests/phpunit/tests/media.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/phpunit/tests/media.php b/tests/phpunit/tests/media.php
index 1778f3d6f5031..6e1d065d4a023 100644
--- a/tests/phpunit/tests/media.php
+++ b/tests/phpunit/tests/media.php
@@ -509,7 +509,7 @@ public function test_wp_print_media_templates_hides_attachment_page_link_options
 	}
 
 	/**
-	 * @ticket 57913
+	 * @ticket 65169
 	 */
 	public function test_wp_print_media_templates_shows_attachment_page_link_options_when_enabled() {
 		update_option( 'wp_attachment_pages_enabled', 1 );

From 6edbe1d5fda6e84ebdb4c344a94e6e79a6556c58 Mon Sep 17 00:00:00 2001
From: Shreyas Ikhar <shreyasikhar26@gmail.com>
Date: Fri, 8 May 2026 16:08:21 +0530
Subject: [PATCH 3/3] Add attachment pages setting to media options

---
 src/wp-admin/options-media.php | 17 +++++++++++++++++
 src/wp-admin/options.php       |  1 +
 2 files changed, 18 insertions(+)

diff --git a/src/wp-admin/options-media.php b/src/wp-admin/options-media.php
index 81ebc9223f543..b0953d4e2acf7 100644
--- a/src/wp-admin/options-media.php
+++ b/src/wp-admin/options-media.php
@@ -98,6 +98,23 @@
 <?php do_settings_fields( 'media', 'default' ); ?>
 </table>
 
+<h2 class="title"><?php _e( 'Attachment pages' ); ?></h2>
+<table class="form-table" role="presentation">
+<tr>
+<th scope="row"><?php _e( 'Attachment pages' ); ?></th>
+<td>
+	<fieldset>
+		<legend class="screen-reader-text"><span><?php _e( 'Attachment pages' ); ?></span></legend>
+		<label for="wp_attachment_pages_enabled">
+			<input name="wp_attachment_pages_enabled" type="checkbox" id="wp_attachment_pages_enabled" value="1" <?php checked( '1', (string) get_option( 'wp_attachment_pages_enabled' ) ); ?> />
+			<?php _e( 'Enable attachment pages for uploaded media files' ); ?>
+		</label>
+		<p class="description"><?php _e( 'When disabled, attachment page URLs redirect to the media file URL.' ); ?></p>
+	</fieldset>
+</td>
+</tr>
+</table>
+
 <?php
 /**
  * @global array $wp_settings
diff --git a/src/wp-admin/options.php b/src/wp-admin/options.php
index bb98824f9a56a..a9cff89df2ef5 100644
--- a/src/wp-admin/options.php
+++ b/src/wp-admin/options.php
@@ -138,6 +138,7 @@
 		'image_default_size',
 		'image_default_align',
 		'image_default_link_type',
+		'wp_attachment_pages_enabled',
 	),
 	'reading'    => array(
 		'posts_per_page',