WordPress.org

Make WordPress Core

Opened 2 months ago

Closed 2 months ago

#42047 closed defect (bug) (fixed)

Customize Themes: Improve and clarify help text

Reported by: celloexpressions Owned by: westonruter
Milestone: 4.9 Priority: normal
Severity: normal Version: 4.9
Component: Customize Keywords: has-patch commit
Focuses: ui Cc:

Description (last modified by melchoyce)

The help text for the themes panel is currently somewhat misleading, as the filters are no longer in the sidebar. It could probably benefit from a more general reworking to briefly explain what themes are, why they need to be "installed," and maybe that plugins are available that offer themes from other sources (if the user can install themes and it's not multisite).

Current text:

Once themes are installed, you can live-preview them on your site, customize them, and publish your new design. Browse available themes via the filters in this menu.

Attachments (2)

42047.0.diff (1.0 KB) - added by westonruter 2 months ago.
themes-panel-description.png (73.3 KB) - added by westonruter 2 months ago.

Download all attachments as: .zip

Change History (21)

#2 @melchoyce
2 months ago

  • Owner set to melchoyce
  • Status changed from new to assigned

#3 @melchoyce
2 months ago

  • Description modified (diff)

#4 @melchoyce
2 months ago

Copy courtesy of @michelleweber:

Looking for a theme? You can search or browse the WordPress.org theme directory, install and preview themes, then activate them right here.

Once you activate a new theme, use the Customizer to tailor things like widgets and menus and to explore any theme-specific options.

#5 @melchoyce
2 months ago

  • Keywords good-first-bug added

#6 @melchoyce
2 months ago

  • Owner melchoyce deleted

#7 @celloexpressions
2 months ago

Once you activate a new theme, use the Customizer to tailor things like widgets and menus and to explore any theme-specific options.

Since the context stays in the customizer (and we don't frequently use the noun form within core), the "use the customizer" part should probably be eliminated. This text is also misleading, implying that you have to activate a theme before customizing it. That is not the case with this experience anymore.

#8 @dharavihol
2 months ago

  • Resolution set to wontfix
  • Status changed from assigned to closed

#9 @dharavihol
2 months ago

  • Resolution wontfix deleted
  • Status changed from closed to reopened

#10 in reply to: ↑ description @WhirledPress
2 months ago

Replying to celloexpressions:

The help text for the themes panel is currently somewhat misleading,

This is my first attempt to help, so I apologize if I am out of the loop. Do you have a url for this "themes panel" help text so I can get context and not duplicate the help text already present?

#11 follow-up: @melchoyce
2 months ago

@celloexpressions How do you feel about:

Looking for a theme? You can search or browse the WordPress.org theme directory, install and preview themes, then activate them right here.

While previewing a new theme, you can continue to tailor things like widgets and menus, and explore theme-specific options.

@WhirledPress You can find this now by going to the Customizer and clicking the "Change" button next to your active theme :)

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


2 months ago

#13 @celloexpressions
2 months ago

The text in 11 looks good to me.

#14 in reply to: ↑ 11 ; follow-up: @WhirledPress
2 months ago

Replying to melchoyce:

@WhirledPress You can find this now by going to the Customizer and clicking the "Change" button next to your active theme :)

When I click the Change button in the Customizer, I don't see any help text. Clicking the ? help button gives me the following text:

The Customizer allows you to preview changes to your site before publishing them. You can navigate to different pages on your site within the preview. Edit shortcuts are shown for some editable elements.

Maybe something like:

The Customizer allows you to preview changes to your site's appearance before committing. While previewing a theme you can change your site's appearance and tailor things like widgets, menus, and theme-specific options. Edit shortcuts are shown for some of the editable elements. If you want to add additional themes, you can do so from the Appearance Menu > Themes submenu. Once a new theme is installed, you can preview and fine-tune it here before applying changes to your site.

#15 in reply to: ↑ 14 @melchoyce
2 months ago

Replying to WhirledPress:

When I click the Change button in the Customizer, I don't see any help text. Clicking the ? help button gives me the following text:

The Customizer allows you to preview changes to your site before publishing them. You can navigate to different pages on your site within the preview. Edit shortcuts are shown for some editable elements.

Maybe something like:

The Customizer allows you to preview changes to your site's appearance before committing. While previewing a theme you can change your site's appearance and tailor things like widgets, menus, and theme-specific options. Edit shortcuts are shown for some of the editable elements. If you want to add additional themes, you can do so from the Appearance Menu > Themes submenu. Once a new theme is installed, you can preview and fine-tune it here before applying changes to your site.

Thanks for checking it out. We're going to hopefully still add theme installation to this feature, in a point release if not 4.9, so we're going to stick with 11 for the help text.

#16 @petertoi
2 months ago

  • Keywords has-patch added; needs-patch removed

#17 @petertoi
2 months ago

  • Keywords needs-patch added; has-patch removed

@westonruter
2 months ago

#18 @westonruter
2 months ago

  • Keywords has-patch commit added; good-first-bug needs-patch removed
  • Owner set to westonruter
  • Status changed from reopened to accepted

#19 @westonruter
2 months ago

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

In 41815:

Customize: Improve and clarify help text for Themes panel.

Props michelleweber, melchoyce, celloexpressions.
See #37661.
Fixes #42047.

Note: See TracTickets for help on using tickets.