WordPress.org

Making WordPress.org

Opened 9 months ago

Last modified 9 months ago

#4115 new defect

Proposal to change the headings hierarchy in the Plugins section

Reported by: afercia Owned by:
Milestone: Priority: normal
Component: Plugin Directory Keywords: headings-hierarchy
Cc:

Description

Splitting this out from #4110.

The headings hierarchy in the Plugins section has room for improvements for better SEO and accessibility:

http://cldup.com/PFoxkhPY4r.jpeg

As mentioned in #4112 the logo shouldn't be a h1. "Plugins" should be the only h1 in this page.

Most of the other headings are h2 and that may make sense at first sight.

However, this page is split in sections:

  • "Block-Enabled Plugins" is a h2 thus all the plugins under it should be h3
  • same for "Featured Plugins", "Beta Plugins", "My Favorites", "Popular Plugins": they're h2 thus all the plugins under them should be h3

Also, at the bottom of the page, the h3 headings:

  • Add Your Plugin
  • Create a Plugin
  • Stay Up-to-Date

shouldn't be h3: this way, they're hierarchically under the last plugin in the page (Jetpack in this case) which is clearly incorrect, as they're logically related to the whole page.

"See all" pages:
In the related "See all" pages, for example https://wordpress.org/plugins/browse/featured/:

  • "Browse: Featured" should be the only h1 in the page

Search results page:

  • "Showing results for: {term}" should be the only h1 in the page

Plugin detail page:

  • the plugin name should be the only h1 in the page
  • some of the headings are parsed from the plugin's readme.txt, let's hope developers are using markdown correctly
  • however, in the sidebar the following headings:
    • "Meta" (it's visually hidden with screen-reader-text)
    • "Ratings"
    • "Support"
    • "Donate" (if present)

shouldn't be h3: this way, they're hierarchically under the last heading in the description, which is incorrect because they're logically related to the plugin page as a whole. They should be h2. Example screenshot:

http://cldup.com/tgBf6sJsrX.png

Please consider going through all the pages in this section is out of the scope of this ticket. However, these are general guidelines that should be applied everywhere.

Change History (1)

#1 @dd32
9 months ago

  • Component changed from General to Plugin Directory
Note: See TracTickets for help on using tickets.