Making WordPress.org

Opened 7 months ago

Last modified 2 months ago

#7524 new enhancement

Update Full Site Editing Tag for block themes

Reported by: annezazu's profile annezazu Owned by:
Milestone: Priority: normal
Component: Theme Directory Keywords: needs-copy-review
Cc:

Description

Following on original efforts to add a block themes tab to the Theme Directory https://meta.trac.wordpress.org/ticket/6330 I'd like to propose we rename the "full site editing" tag to something more focused on site editor or site editing. Some ideas to start the convo:

  • Site Editor
  • Site Editor Enabled
  • Site Editor Support

This is also in line with the broader community push to not use the "Full site editing" term: https://make.wordpress.org/updates/2022/11/04/site-editor-a-more-user-friendly-name/ and I worry folks will have a hard time making the connection to the Site Editor.


Change History (27)

This ticket was mentioned in Slack in #core-themes by annezazu. View the logs.


7 months ago

#2 @greenshady
7 months ago

Should we be thinking about more feature-specific tags? It's my understanding that some support for "block theme features" will also be available for classic themes too at some point (like the Styles panel). For example, here's a list of some features that aren't fully represented by the current tags:

  • Site Editing
  • Style Editing
  • Font Collections
  • Starter Patterns
  • etc.

We have some of these like:

  • Template Editing
  • Style Variations
  • Block Editor Styles
  • Block Editor Patterns

It might be worth considering changing the user-facing labels for some of those too. For example, maybe "Block Editor Patterns" should just be "Patterns."

Maybe the Themes Team should gather again to overhaul the tags system for a modern WP. I realize I'm thinking a little bigger than this ticket's proposal, but it doesn't hurt to explore if we can take it the next step.

#3 @annezazu
7 months ago

I dig the longer term thinking (and had that thought when looking at the tags myself) so thanks for bringing it up. That might be better in a broader discussion and issue as I'd love to iterate on the current "full site editing" label for now rather than a broader overhaul.

#4 @nickhamze
7 months ago

I agree with Anne. Let's do it in steps. If we aren't using that term anymore let's change it. Who do we talk to make it happen?

#5 @dufresnesteven
6 months ago

That might be better in a broader discussion and issue as I'd love to iterate on the current "full site editing" label for now rather than a broader overhaul.

We'll need to rename the theme tag, probably add a mapping on .org to support existing ones, and update some references and documentation.

What label do we want to go with?

Code:
https://github.com/WordPress/wordpress.org/blob/237d35f236c8bfed5b01fa2747226ecc693ff070/wordpress.org/public_html/wp-content/plugins/theme-directory/theme-directory.php#L539

References:
https://meta.trac.wordpress.org/ticket/5212

Docs:
https://make.wordpress.org/themes/handbook/review/required/theme-tags/

This ticket was mentioned in Slack in #core-themes by annezazu. View the logs.


6 months ago

#7 @annezazu
6 months ago

Flagged once more in #core-themes and in #outreach to get more thoughts. For me, I'd want to go with "Site Editing". It's simple, matches documentation, and is in line with other tags there (particularly "Template Editing" which overlaps some).

#8 @greenshady
6 months ago

Agreed on keeping this ticket in scope. I tend to "think big," and wanted to get some initial thoughts out.

Let's definitely move forward with getting the Full Site Editing tag updated. For back-compatibility with current themes, we might consider keeping the underlying full-site-editing tag while updating the user-facing label, though it is still listed as "experimental" on Make Themes: https://make.wordpress.org/themes/handbook/review/required/theme-tags/#features-tags

That page probably needs an update to more accurately reflect the tag.

#9 @bacoords
6 months ago

I agree with Justin's idea that more feature-specific tags that blur classic/hybrid/block themes would be nice (font libary, block template editing) but would be a separate issue than just renaming the Full Site Editing tag.

Site Editing seems like the clearest option and follows the convention of other tags.

Another option would simply be Block Theme, which is much closer to what users are searching for and saying, and is the term used on the filter button, but not really as feature-specific as the current tag structure.

#10 @markhowellsmead
6 months ago

I agree that Site Editing or Site Editor make the most sense.

#11 @karmatosed
6 months ago

I really like the ease and understanding of Site Editing or Site Editor. I say ship that and go with things from there, it says what it has as functionality.

Last edited 6 months ago by karmatosed (previous) (diff)

#12 @mikachan
6 months ago

+1 for changing it to "Site Editing" or "Site Editor".

#13 @courane01
6 months ago

Site Editor I believe makes the most sense. I think about not only what we call it here, but in Appearance as well, and then what podcasters and the like will say. It makes sense to stay unified.

#14 in reply to: ↑ description @flexseth
6 months ago

Editor

Referring to anything you can do to change the look of content generated from the WordPress Block Editor.

At WordCamp Portugal, Matt said something about wanting to move the nomenclature from Site Editing and Full Site Editing to simply calling it the Editor

If Gutenberg were to be ported to another CMS, the term Editor would still apply.


Advanced example: Headless WordPress

There may be some headless features that would pertain to the Editor, but that wouldn't actually reflect the way this website is displayed. Only modeling the content.

Just my $.02


Replying to annezazu:

Following on original efforts to add a block themes tab to the Theme Directory https://meta.trac.wordpress.org/ticket/6330 I'd like to propose we rename the "full site editing" tag to something more focused on site editor or site editing. Some ideas to start the convo:

  • Site Editor
  • Site Editor Enabled
  • Site Editor Support

This is also in line with the broader community push to not use the "Full site editing" term: https://make.wordpress.org/updates/2022/11/04/site-editor-a-more-user-friendly-name/ and I worry folks will have a hard time making the connection to the Site Editor.


Last edited 6 months ago by flexseth (previous) (diff)

#15 @richtabor
6 months ago

I think “Site Editor” is the clearest.“Site Editing” isn’t a clear feature set, as you’d expect any theme to allow you to edit a site.

Just thinking out loud, but is there a reason not to tag them as “Block Theme”; that’d be the most comprehensible.

#16 @annezazu
6 months ago

@dufresnesteven let's roll with Site Editor since it matches current documentation and I think a holistic alignment always helps: https://wordpress.org/documentation/article/site-editor/

Can you (or someone) kick that off?

I do agree about in the future the "editor" will likely rule all but we're not quite there yet and I, at least, want to iterate us in the direction of where we are today and in the foreseeable future.

I think it would be neat to use "block themes" but, if I remember correctly, there were concerns this would be confused with other features, like Block Editor Styles or Block Editor Patterns. When an effort is done to overhaul the other tags, I could see a switch.

Thank you everyone for chiming in!

#17 @dufresnesteven
4 months ago

I think these are all the relevant changes.

Update Core:

Update Theme:

Update Theme Directory Plugin:

Map old tags to new:

Update Trac:

Update Docs

Noting that I'll make these changes after the theme design refresh is complete. https://wordpress.slack.com/archives/C04U953K77A/p1718633412098839

#18 @ryelle
4 months ago

The label for the full-site-editing tag is now "Block Themes" everywhere user-facing on the Theme Directory.

The exception is in the URL: https://wordpress.org/themes/tags/full-site-editing/

But you'll see the page title, headings, option in the "Feature" dropdown, all use "Block Themes".

I did not opt to change the tag itself since themes are currently using it, and this seemed an easier step. Changing the tag slug will probably require migrating the current themes to use the new tag.

#19 @annezazu
4 months ago

I'm a bit confused by these changes considering the "feature" isn't "Block theme" but the "Site Editor". I was hoping the feature could be "Site Editor" but I understand this might have been done as part of the theme directory refresh.

#20 @ryelle
4 months ago

Sorry, that must have been lost in translation into the github project. Should it be "Site Editor" (capitalized like that) everywhere that currently says "Block themes"? Including the nav bar, archive page title, etc?

Last edited 4 months ago by ryelle (previous) (diff)

#21 @dufresnesteven
4 months ago

From my understanding, we agreed to rename the tag full-site-editing to site-editor which would impact how it shows up in the feature dropdown but wouldn't change the "Block Themes" item in the directory navigation. That is how it was working originally.

The existing solution to use the feature tag url to filter block themes was a bit of a hack in the old directory. I think the path forward is to:

  • Create a new url at /browse/block-themes for the navigation.
  • Rename the feature tag to site-editor.

#22 @annezazu
4 months ago

Just looping back to confirm that what @dufresnesteven said is what I had in mind too :)

#23 @markhowellsmead
3 months ago

I'd thought we'd agreed to re-name it “Site Editor” too.

#24 @ryelle
3 months ago

Create a new url at /browse/block-themes for the navigation.

What would show here? would it still just be things tagged full-site-editing except now that would be site-editor, or should this view include other tags as well?

#25 @markhowellsmead
3 months ago

I may be wrong, but “block themes” and “site editor” are different from one another. A block theme doesn’t necessarily have site editing capability.

#26 @ryelle
3 months ago

Hi folks, just trying to get clarity on this again. What should be shown at the /browse/block-themes/ URL? It needs to filter the theme list by some criteria, like "Popular" shows themes updated in the last two years by download count; and "Commercial" shows things with the "commercial" business model (taxonomy term).

So what should the "Block Themes" filter show?

#27 @stevepluginthing
2 months ago

It should return all themes that have the site-editor or full-site-editing tag.

Note: See TracTickets for help on using tickets.