Skip to content

Blocks: Contextual tips tied to specific search queries #20196

@davemart-in

Description

@davemart-in

Problem

Folks who are new to WordPress and Gutenberg start off with a very rudimentary mental model of how WordPress works. Once they are in Gutenberg, it's easy to see how they might assume that all customization of their site can be done within the editor. When people search for terms like:

  • CSS
  • theme
  • plugin
  • header
  • colors

Not only do we show zero results, but we currently do nothing to point them in the right direction.

Proposed Solution

Let's use the tips system (which already exists in the inserter and can be made searchable) to contextually suggest alternative sections of WordPress when specific keywords are entered into the block inserter.

Preview

Here's a preview of what that might look like:

tip

Proposed keyword/copy

  • CSS - You can visit the <a href="/customize.php?autofocus[section]=custom_css" target="_blank">the Customizer</a> to edit the CSS on your site.
  • theme - You can visit the <a href="/themes.php" target="_blank">theme directory</a> to select a different design for your site.
  • plugin - You can visit the <a href="/plugin-install.php" target="_blank">plugin directory</a> to install additional plugins.
  • header - You can visit the <a href="/customize.php?autofocus[section]=title_tagline" target="_blank">the Customizer</a> to edit your logo and site title.
  • colors - You can visit the <a href="/customize.php?autofocus[section]=colors" target="_blank">the Customizer</a> to edit the colors on your site.

Alternatives Considered

1) Using tips in their current location

tip-link-3

I started off by attempting to use tips within their current location, but it felt off. The white space feels a tad excessive.

  1. Replace "no results" with tip

tip-link-2

The next thing I tried was simply replacing the "No blocks found." text with the tip. I believe this text provides valuable context though, so I moved the tip to the bottom (as seen in the proposed solution above)

Metadata

Metadata

Assignees

Labels

Needs DecisionNeeds a decision to be actionable or relevant[Feature] InserterThe main way to insert blocks using the + button in the editing interface[Type] EnhancementA suggestion for improvement.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions