Update theme.json docs for WordPress 5.8
#33131
Conversation
oandregal
added
[Type] Developer Documentation
| The settings section has the following structure: | ||
|
|
||
| {% codetabs %} | ||
| {% WordPress %} |
There was a problem hiding this comment.
I thought about naming this "WordPress 5.8" instead.
The reason I didn't was that I believe this text has to be a single string without spaces. When I introduced the "Input"/"Output" for sections like this one https://developer.wordpress.org/block-editor/how-to-guides/themes/theme-json/#css-custom-properties-presets-custom I have a vague memory of having used "theme.json"/"CSS styles" and that it was problematic. Will look it up to confirm.
There was a problem hiding this comment.
#28655 illustrates what happened when using spaces in the codetabs texts.
|
|
||
| ### Settings | ||
|
|
||
| <div class="callout callout-alert"> |
There was a problem hiding this comment.
This would be styled as a callout.
|
|
||
| ### Styles | ||
|
|
||
| <div class="callout callout-alert"> |
There was a problem hiding this comment.
This would be styled as a callout.
|
|
||
| ### customTemplates | ||
|
|
||
| <div class="callout callout-alert"> |
There was a problem hiding this comment.
This would be styled as a callout.
|
|
||
| ### templateParts | ||
|
|
||
| <div class="callout callout-alert"> |
There was a problem hiding this comment.
This would be styled as a callout.
oandregal
changed the title
theme.json docs for 5 8theme.json docs for WordPress 5.8
jorgefilipecosta
left a comment
jorgefilipecosta
left a comment
There was a problem hiding this comment.
Thank you for these updates. They look good to me 👍
| "duotone": [], | ||
| "gradients": [], | ||
| "link": false, | ||
| "palette": [] |
There was a problem hiding this comment.
It may be helpful to define a preset like a color so people know how to do it.
There was a problem hiding this comment.
There's a section fully focused on presets.
Part of #20331
WordPress 5.8 comes with support for
theme.json, so we need to update the docs accordingly: remove references to "experimental", highlight which parts only work on Gutenberg vs WordPress 5.8, etc.See the document.
Note that there're a few call-outs that will be displayed differently in the block editor handbook. For reference, this is how the current call-out looks: