Changeset 48077 for trunk/src/wp-admin/themes.php

Timestamp:

06/17/2020 11:58:15 PM (6 years ago)

Author:

azaozz

Message:

Plugins and Themes Auto-Updates: allow overriding of the HTML for the auto-update setting link. This will let plugins show better/specific information when they are overriding the auto-update settings, for example "Updates are managed by ... plugin".

Introduces: theme_auto_update_setting_html, plugin_auto_update_setting_html, and theme_auto_update_setting_template filters.

Props audrasjb, pbiron, azaozz.
Fixes #50280.

File:

• trunk/src/wp-admin/themes.php (modified) (2 diffs)

trunk/src/wp-admin/themes.php

@@ -550 +550 @@
 
 <?php
+
+/**
+ * Returns the template for displaying the auto-update setting for a theme.
+ *
+ * @since 5.5.0
+ *
+ * @return string Template
+ */
+function wp_theme_auto_update_setting_template() {
+    $template = '
+        <p class="theme-autoupdate">
+            <# if ( data.autoupdate ) { #>
+                <a href="{{{ data.actions.autoupdate }}}" class="toggle-auto-update" data-slug="{{ data.id }}" data-wp-action="disable">
+                    <span class="dashicons dashicons-update spin hidden" aria-hidden="true"></span>
+                    <span class="label">' . __( 'Disable auto-updates' ) . '</span>
+                </a>
+            <# } else { #>
+                <a href="{{{ data.actions.autoupdate }}}" class="toggle-auto-update" data-slug="{{ data.id }}" data-wp-action="enable">
+                    <span class="dashicons dashicons-update spin hidden" aria-hidden="true"></span>
+                    <span class="label">' . __( 'Enable auto-updates' ) . '</span>
+                </a>
+            <# } #>
+            <# if ( data.hasUpdate ) { #>
+                <# if ( data.autoupdate ) { #>
+                    <span class="auto-update-time">
+                <# } else { #>
+                    <span class="auto-update-time hidden">
+                <# } #>
+                <br />' . wp_get_auto_update_message() . '</span>
+            <# } #>
+            <span class="auto-updates-error hidden"><p></p></span>
+        </p>
+    ';
+
+    /**
+     * Filters the JavaScript template used in Backbone to display the auto-update setting for a theme (in the overlay).
+     *
+     * See {@see wp_prepare_themes_for_js()} for the properties of the `data` object.
+     *
+     * @since 5.5.0
+     *
+     * @param string $template The template for displaying the auto-update setting link.
+     */
+    return apply_filters( 'theme_auto_update_setting_template', $template );
+}
+
 /*
  * The tmpl-theme template is synchronized with PHP above!
@@ -649 +695 @@
 
                 <# if ( data.actions.autoupdate ) { #>
-                <p class="theme-autoupdate">
-                <# if ( data.autoupdate ) { #>
-                    <a href="{{{ data.actions.autoupdate }}}" class="toggle-auto-update" data-slug="{{ data.id }}" data-wp-action="disable">
-                        <span class="dashicons dashicons-update spin hidden" aria-hidden="true"></span>
-                        <span class="label"><?php _e( 'Disable auto-updates' ); ?></span>
-                    </a>
-                <# } else { #>
-                    <a href="{{{ data.actions.autoupdate }}}" class="toggle-auto-update" data-slug="{{ data.id }}" data-wp-action="enable">
-                        <span class="dashicons dashicons-update spin hidden" aria-hidden="true"></span>
-                        <span class="label"><?php _e( 'Enable auto-updates' ); ?></span>
-                    </a>
-                <# } #>
-                <# if ( data.hasUpdate ) { #>
-                    <# if ( data.autoupdate) { #>
-                    <span class="auto-update-time"><br /><?php echo wp_get_auto_update_message(); ?></span>
-                    <# } else { #>
-                    <span class="auto-update-time hidden"><br /><?php echo wp_get_auto_update_message(); ?></span>
-                    <# } #>
-                <# } #>
-                    <span class="auto-updates-error hidden"><p></p></span>
-                </p>
+                    <?php echo wp_theme_auto_update_setting_template(); ?>
                 <# } #>