Changeset 59449

Timestamp:

11/22/2024 10:55:12 AM (4 months ago)

Author:

mikachan

Message:

Editor: Warn about empty templates on the frontend for logged in users.

Adds a new function, wp_render_empty_block_template_warning, that renders a warning for logged-in users when a block template is empty.

Reviewed by get_dave, richtabor.
Props vcanales, mikachan, peterwilsoncc, richtabor, get_dave, mrfoxtalbot, matveb, arielmaidana, seifradwane, annezazu.
Fixes #62053.

Location:

trunk/src/wp-includes

Files:

• block-template.php (modified) (2 diffs)
• css/wp-empty-template-alert.css (added)
• script-loader.php (modified) (2 diffs)

trunk/src/wp-includes/block-template.php

@@ -16 +16 @@
         add_action( 'pre_get_posts', '_resolve_template_for_new_post' );
     }
+}
+
+/**
+ * Renders a warning screen for empty block templates.
+ *
+ * @since 6.8.0
+ *
+ * @param WP_Block_Template $block_template The block template object.
+ * @return string The warning screen HTML.
+ */
+function wp_render_empty_block_template_warning( $block_template ) {
+    wp_enqueue_style( 'wp-empty-template-alert' );
+    return sprintf(
+        /* translators: %1$s: Block template title. %2$s: Empty template warning message. %3$s: Edit template link. %4$s: Edit template button label. */
+        '<div id="wp-empty-template-alert">
+            <h2>%1$s</h2>
+            <p>%2$s</p>
+            <a href="%3$s" class="wp-element-button">
+                %4$s
+            </a>
+        </div>',
+        esc_html( $block_template->title ),
+        __( 'This page is blank because the template is empty. You can reset or customize it in the Site Editor.' ),
+        get_edit_post_link( $block_template->wp_id, 'site-editor' ),
+        __( 'Edit template' )
+    );
 }
 
@@ -69 +95 @@
         $_wp_current_template_id = $block_template->id;
 
-        if ( empty( $block_template->content ) && is_user_logged_in() ) {
-            $_wp_current_template_content =
-            sprintf(
-                /* translators: %s: Template title */
-                __( 'Empty template: %s' ),
-                $block_template->title
-            );
+        if ( empty( $block_template->content ) ) {
+            if ( is_user_logged_in() ) {
+                $_wp_current_template_content = wp_render_empty_block_template_warning( $block_template );
+            } else {
+                if ( $block_template->has_theme_file ) {
+                    // Show contents from theme template if user is not logged in.
+                    $theme_template = _get_block_template_file( 'wp_template', $block_template->slug );
+                    $_wp_current_template_content = file_get_contents( $theme_template['path'] );
+                } else {
+                    $_wp_current_template_content = $block_template->content;
+                }
+            }
         } elseif ( ! empty( $block_template->content ) ) {
             $_wp_current_template_content = $block_template->content;

trunk/src/wp-includes/script-loader.php

@@ -1628 +1628 @@
     $styles->add( 'customize-preview', "/wp-includes/css/customize-preview$suffix.css", array( 'dashicons' ) );
     $styles->add( 'wp-embed-template-ie', "/wp-includes/css/wp-embed-template-ie$suffix.css" );
+    $styles->add( 'wp-empty-template-alert', "/wp-includes/css/wp-empty-template-alert$suffix.css" );
     $styles->add_data( 'wp-embed-template-ie', 'conditional', 'lte IE 8' );
 
@@ -1810 +1811 @@
         'login',
         'site-health',
+        'wp-empty-template-alert',
         // Includes CSS.
         'buttons',