WordPress/gutenberg

The description of the More block is not clear

Open

#41854 opened on Jun 22, 2022

View on GitHub
 (6 comments) (0 reactions) (0 assignees)JavaScript (9,607 stars) (3,893 forks)batch import
Good First Issue[Block] More[Status] In Progress[Type] Copy

Description

Description

The description of the more block reads "Content before this block will be shown in the excerpt on your archives page." From this description, it is not obvious that this only works when the theme template shows the full content.

If the theme archive page (or a home page with a list of blog posts) displays excerpts, the content will not be split into two, and the read more link will not show. This can be unexpected for users, see Trac ticket 52361.

Related documentation for the <!- -more tag Code reference Codex

Step-by-step reproduction instructions

  1. Activate the theme Twenty Twenty-One -Make sure that the default customizer settings are used, and that the front page is set to display the latest posts.
  2. Create a new post and add a short paragraph.
  3. Add a More block
  4. Add two more paragraphs after the more block.
  5. Save the post and view the front page with the list of blog posts.
  6. Confirm that an excerpt is showing texts both from before and after the more block.

Screenshots, screen recording, code snippet

No response

Environment info

No response

Please confirm that you have searched existing issues in the repo.

Yes

Please confirm that you have tested with all plugins deactivated except Gutenberg.

Yes

Contributor guide

Tech stack
javascriptreact
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Understanding of WordPress block editorFamiliarity with template excerpts
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80
Research direction
Investigate the More block's description string in the block registration file (likely in packages/block library/src/more/). Update the description to clarify that the 'more' tag only works when the theme displays full content, not excerpts. Refer to the linked Trac ticket and Codex documentation for guidance.