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(); ?>
                                 <# } #>