WordPress.org

Make WordPress Core

Opened 3 months ago

Closed 7 weeks ago

Last modified 7 weeks ago

#50215 closed defect (bug) (fixed)

Add help tabs to provide informations about plugin & themes auto-updates

Reported by: audrasjb Owned by: audrasjb
Milestone: 5.5 Priority: normal
Severity: normal Version: trunk
Component: Help/About Keywords: has-patch has-screenshots has-copy-review
Focuses: ui, docs, ui-copy Cc:

Description

Now #50052 (plugin and theme auto-updates) is merged into core, let's add some help tabs that explain what auto-updates are and how the UI works.

The text in the tab should be pretty short, probably with a link to a (yet to be written) article on HelpHub.

Among other things, it should mention that what is displayed in the UI is not 100% guaranteed to be what happens when WP_Automatic_Updater actually runs.

For reference, this the original issue on GitHub: ​https://github.com/WordPress/wp-autoupdates/issues/105

…and the related pull request, which is already merged into WP Auto-updates plugin: ​https://github.com/WordPress/wp-autoupdates/pull/121

Attachments (8)

help-tabs-screen-update-core.png​ (102.4 KB) - added by audrasjb 3 months ago.
update-core.php screen
help-tabs-screen-plugins.png​ (131.1 KB) - added by audrasjb 3 months ago.
plugins.php screen
help-tabs-screen-themes.png​ (311.1 KB) - added by audrasjb 3 months ago.
themes.php screen
50215.diff​ (6.4 KB) - added by audrasjb 3 months ago.
Upgrade/Install: Add help tabs related to auto-updates UI
50215.1.diff​ (6.5 KB) - added by audrasjb 2 months ago.
Address copy review fixes
50215.2.diff​ (6.4 KB) - added by whyisjake 7 weeks ago.
50215.3.diff​ (6.4 KB) - added by whyisjake 7 weeks ago.
50215.4.diff​ (6.5 KB) - added by whyisjake 7 weeks ago.

Download all attachments as: .zip

Change History (21)

@audrasjb
3 months ago

update-core.php screen

@audrasjb
3 months ago

plugins.php screen

@audrasjb
3 months ago

themes.php screen

#1 @audrasjb
3 months ago

  • Keywords needs-patch removed
  • Owner set to audrasjb
  • Status changed from new to assigned

Important: we already have a patch for this ticket. Most importantly, it needs copy review

Here are the current strings:

update-core.php

Plugins and Themes with auto-updates enabled will display the estimated date of the next auto-update. Auto-updates schedule depends on WordPress planned tasks.
Please note: WordPress auto-updates may be overridden by third-parties plugins or custom code.
For more information: {LINK}Documentation about auto-updates{LINK}

themes.php

Auto-updates can be enabled and disabled on a theme by theme basis. Themes with auto-updates enabled will display the estimated date of the next auto-update. Auto-updates schedule depends on WordPress planned tasks.
Please note: WordPress auto-updates may be overridden by third-parties plugins or custom code.
For more information: {LINK}Documentation about auto-updates{LINK}

plugins.php

Auto-updates can be enabled and disabled on a plugin by plugin basis. Plugins with auto-updates enabled will display the estimated date of the next auto-update. Auto-updates schedule depends on WordPress planned tasks.
Please note: WordPress auto-updates may be overridden by third-parties plugins or custom code.
For more information: {LINK}Documentation about auto-updates{LINK}

Last edited 3 months ago by audrasjb (previous) (diff)

@audrasjb
3 months ago

Upgrade/Install: Add help tabs related to auto-updates UI

#3 @audrasjb
3 months ago

  • Keywords has-patch dev-feedback added

#4 @audrasjb
3 months ago

  • Keywords has-screenshots added

This ticket was mentioned in ​Slack in #core by audrasjb. ​View the logs.


2 months ago

#6 @garrett-eclipse
2 months ago

Instead of "Auto-updates schedule depends on WordPress planned tasks."
How about "Auto-updates depends on the WP-Cron task scheduling system."
Just to be clear it's using Cron and it's easier to find information on scheduled task than planned task so don't feel that phrasing is very common.

#7 follow-up: @paaljoachim
2 months ago

My suggested adjustments.

"....third-parties plugins or custom code." adjust to third-party plugins or custom code.

Auto-updates can be enabled and disabled on a theme by theme basis.
Auto-updates can be enabled and disabled on a plugin by plugin basis.

=

Auto-updates can be enabled and disabled for each individual theme.
Auto-updates can be enabled and disabled for each individual plugin.

#8 in reply to: ↑ 7 @marybaum
2 months ago

And mine:

"You can choose to enable or disable auto-updates on each theme. Each theme with with auto-updates enabled will show the next scheduled auto-update, based on published timelines.

Please note: Third-party themes and plugins, or custom code, may override WordPress scheduling.

Learn more: Auto-updates documentation"

"You can choose to enable or disable auto-updates on each plugin. Each theme with with auto-updates enabled will show the next scheduled auto-update, based on published timelines.

Please note: Third-party themes and plugins, or custom code, may override WordPress scheduling.

Learn more: Auto-updates documentation"

Replying to paaljoachim:

My suggested adjustments.

"....third-parties plugins or custom code." adjust to third-party plugins or custom code.

Auto-updates can be enabled and disabled on a theme by theme basis.
Auto-updates can be enabled and disabled on a plugin by plugin basis.

=

Auto-updates can be enabled and disabled for each individual theme.
Auto-updates can be enabled and disabled for each individual plugin.

#9 @audrasjb
2 months ago

Thanks you all for your suggestions!

@garrett-eclipse:

Instead of "Auto-updates schedule depends on WordPress planned tasks."
How about "Auto-updates depends on the WP-Cron task scheduling system."
Just to be clear it's using Cron and it's easier to find information on scheduled task than planned task so don't feel that phrasing is very common.

Makes sense. Fixed in 50215.1.diff.

@paaljoachim:

"third-parties plugins or custom code." adjust to third-party plugins or custom code.

Fixed in 50215.1.diff.

Auto-updates can be enabled and disabled for each individual theme.
Auto-updates can be enabled and disabled for each individual plugin.

Sounds better! Fixed in 50215.1.diff.

@marybaum:

Please note: Third-party themes and plugins, or custom code, may override WordPress scheduling.

Fixed in 50215.1.diff.

Learn more: Auto-updates documentation

Fixed in 50215.1.diff.

@audrasjb
2 months ago

Address copy review fixes

#10 @audrasjb
2 months ago

  • Keywords has-copy-review added; needs-copy-review dev-feedback removed
  • Status changed from assigned to accepted

#11 @paaljoachim
7 weeks ago

A last minute adjustment.
Auto-updates can be enabled and disabled for each individual theme.
Auto-updates can be enabled and disabled for each individual plugin.
--->
Auto-updates can be enabled or disabled for each individual theme.
Auto-updates can be enabled or disabled for each individual plugin.

Replace and with or.

@whyisjake
7 weeks ago

@whyisjake
7 weeks ago

@whyisjake
7 weeks ago

#12 @whyisjake
7 weeks ago

  • Resolution set to fixed
  • Status changed from accepted to closed

In 48062:

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.

#13 @SergeyBiryukov
7 weeks ago

In 48095:

Help/About: Move "Learn more: Auto-updates documentation" link about "Support", for consistency with other screens.

Follow-up to [48062].

See #50215.

Note: See TracTickets for help on using tickets.