Changeset 48062

Timestamp:

06/16/2020 05:27:05 PM (4 years ago)

Author:

whyisjake

Message:

Help/About: Add help tabs to provide informations about plugin & themes auto-updates.

Adds language around how the feature works and includes links to the WordPress HelpHub pages.

Fixes: #50215.
Props: audrasjb, garrett-eclipse, paaljoachim, marybaum, pbiron, whyisjake.

Location:

trunk/src/wp-admin

Files:

• network/themes.php (modified) (1 diff)
• plugins.php (modified) (1 diff)
• themes.php (modified) (1 diff)
• update-core.php (modified) (1 diff)

trunk/src/wp-admin/network/themes.php

@@ -303 +303 @@
 );
 
+$help_sidebar_autoupdates = '';
+if ( current_user_can( 'update_themes' ) && wp_is_auto_update_enabled_for_type( 'theme' ) ) {
+    get_current_screen()->add_help_tab(
+        array(
+            'id'      => 'plugins-themes-auto-updates',
+            'title'   => __( 'Auto-updates' ),
+            'content' =>
+                '<p>' . __( 'Auto-updates can be enabled or disabled for each individual theme. Themes with auto-updates enabled will display the estimated date of the next auto-update. Auto-updates depends on the WP-Cron task scheduling system.' ) . '</p>' .
+                '<p>' . __( 'Please note: Third-party themes and plugins, or custom code, may override WordPress scheduling.' ) . '</p>',
+        )
+    );
+
+    $help_sidebar_autoupdates = '<p>' . __( '<a href="https://wordpress.org/support/article/plugins-themes-auto-updates/">Learn more: Auto-updates documentation</a>' ) . '</p>';
+}
+
 get_current_screen()->set_help_sidebar(
     '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
     '<p>' . __( '<a href="https://codex.wordpress.org/Network_Admin_Themes_Screen">Documentation on Network Themes</a>' ) . '</p>' .
-    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
+    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>' .
+    $help_sidebar_autoupdates
 );
 

trunk/src/wp-admin/plugins.php

@@ -566 +566 @@
 );
 
+$help_sidebar_autoupdates = '';
+if ( current_user_can( 'update_plugins' ) && wp_is_auto_update_enabled_for_type( 'plugin' ) ) {
+    get_current_screen()->add_help_tab(
+        array(
+            'id'      => 'plugins-themes-auto-updates',
+            'title'   => __( 'Auto-updates' ),
+            'content' =>
+                    '<p>' . __( 'Auto-updates can be enabled or disabled for each individual plugin. Plugins with auto-updates enabled will display the estimated date of the next auto-update. Auto-updates depends on the WP-Cron task scheduling system.' ) . '</p>' .
+                    '<p>' . __( 'Please note: Third-party themes and plugins, or custom code, may override WordPress scheduling.' ) . '</p>',
+        )
+    );
+
+    $help_sidebar_autoupdates = '<p>' . __( '<a href="https://wordpress.org/support/article/plugins-themes-auto-updates/">Learn more: Auto-updates documentation</a>' ) . '</p>';
+}
+
 get_current_screen()->set_help_sidebar(
     '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
     '<p>' . __( '<a href="https://wordpress.org/support/article/managing-plugins/">Documentation on Managing Plugins</a>' ) . '</p>' .
-    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
+    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>' .
+    $help_sidebar_autoupdates
 );
 

trunk/src/wp-admin/themes.php

@@ -183 +183 @@
 } // End if 'edit_theme_options' && 'customize'.
 
+// Help tab: Auto-updates.
+$help_sidebar_autoupdates = '';
+if ( current_user_can( 'update_themes' ) && wp_is_auto_update_enabled_for_type( 'theme' ) ) {
+    $help_tab_autoupdates =
+        '<p>' . __( 'Auto-updates can be enabled or disabled for each individual theme. Themes with auto-updates enabled will display the estimated date of the next auto-update. Auto-updates depends on the WP-Cron task scheduling system.' ) . '</p>' .
+        '<p>' . __( 'Please note: Third-party themes and plugins, or custom code, may override WordPress scheduling.' ) . '</p>';
+
+    get_current_screen()->add_help_tab(
+        array(
+            'id'      => 'plugins-themes-auto-updates',
+            'title'   => __( 'Auto-updates' ),
+            'content' => $help_tab_autoupdates,
+        )
+    );
+
+    $help_sidebar_autoupdates = '<p>' . __( '<a href="https://wordpress.org/support/article/plugins-themes-auto-updates/">Learn more: Auto-updates documentation</a>' ) . '</p>';
+} // End if 'update_themes' && 'wp_is_auto_update_enabled_for_type'.
+
 get_current_screen()->set_help_sidebar(
     '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
     '<p>' . __( '<a href="https://wordpress.org/support/article/using-themes/">Documentation on Using Themes</a>' ) . '</p>' .
-    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
+    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>' .
+    $help_sidebar_autoupdates
 );
 

trunk/src/wp-admin/update-core.php

@@ -746 +746 @@
 );
 
+$help_sidebar_autoupdates = '';
+if ( ( current_user_can( 'update_themes' ) && wp_is_auto_update_enabled_for_type( 'theme' ) ) || ( current_user_can( 'update_plugins' ) && wp_is_auto_update_enabled_for_type( 'plugin' ) ) ) {
+    $help_tab_autoupdates  = '<p>' . __( 'Auto-updates can be enabled or disabled for each individual theme or plugin. Themes or plugins with auto-updates enabled will display the estimated date of the next auto-update. Auto-updates depends on the WP-Cron task scheduling system.' ) . '</p>';
+    $help_tab_autoupdates .= '<p>' . __( 'Please note: Third-party themes and plugins, or custom code, may override WordPress scheduling.' ) . '</p>';
+
+    get_current_screen()->add_help_tab(
+        array(
+            'id'      => 'plugins-themes-auto-updates',
+            'title'   => __( 'Auto-updates' ),
+            'content' => $help_tab_autoupdates,
+        )
+    );
+
+    $help_sidebar_autoupdates = '<p>' . __( '<a href="https://wordpress.org/support/article/plugins-themes-auto-updates/">Learn more: Auto-updates documentation</a>' ) . '</p>';
+}
+
 get_current_screen()->set_help_sidebar(
     '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
     '<p>' . __( '<a href="https://wordpress.org/support/article/dashboard-updates-screen/">Documentation on Updating WordPress</a>' ) . '</p>' .
-    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
+    '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>' .
+    $help_sidebar_autoupdates
 );