WordPress.org

Make WordPress Core

Opened 19 months ago

Closed 18 months ago

Last modified 18 months 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: 5.5
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 19 months ago.
update-core.php screen
help-tabs-screen-plugins.png​ (131.1 KB) - added by audrasjb 19 months ago.
plugins.php screen
help-tabs-screen-themes.png​ (311.1 KB) - added by audrasjb 19 months ago.
themes.php screen
50215.diff​ (6.4 KB) - added by audrasjb 19 months ago.
Upgrade/Install: Add help tabs related to auto-updates UI
50215.1.diff​ (6.5 KB) - added by audrasjb 18 months ago.
Address copy review fixes
50215.2.diff​ (6.4 KB) - added by whyisjake 18 months ago.
50215.3.diff​ (6.4 KB) - added by whyisjake 18 months ago.
50215.4.diff​ (6.5 KB) - added by whyisjake 18 months ago.

Download all attachments as: .zip

Change History (21)

@audrasjb
19 months ago

update-core.php screen

@audrasjb
19 months ago

plugins.php screen

@audrasjb
19 months ago

themes.php screen

#1 @audrasjb
19 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 19 months ago by audrasjb (previous) (diff)

@audrasjb
19 months ago

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

#3 @audrasjb
19 months ago

  • Keywords has-patch dev-feedback added

#4 @audrasjb
19 months ago

  • Keywords has-screenshots added

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


18 months ago

#6 @garrett-eclipse
18 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
18 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
18 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
18 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
18 months ago

Address copy review fixes

#10 @audrasjb
18 months ago

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

#11 @paaljoachim
18 months 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.

#12 @whyisjake
18 months 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
18 months 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.