Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for the block template parts theme support #44009

Merged
merged 2 commits into from
Sep 9, 2022
Merged

Add documentation for the block template parts theme support #44009

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
573cd22
add documentation for the block template parts theme support
fabiankaegy Sep 9, 2022
ac51cd5
update wording to avoid confusion with the editor role
fabiankaegy Sep 9, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/how-to-guides/themes/theme-support.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -476,3 +476,17 @@ Use this setting to enable the following Global Styles settings:
```php
add_theme_support( 'appearance-tools' );
```

## Block Based Template Parts

Block Based Template parts allow administrators to edit parts of the site using blocks. This is off by default, and requires the theme to opt in by declaring support:

```php
add_theme_support( 'block-template-parts' );
```

This feature is only relevant for non block based themes, as block based themes already support block based template parts as part of the site editor.

The standalone template part editor does not allow editors to create new, or delete existing template parts. This is because the theme manually needs to include the template part in the PHP template.

You can find out more about block based template parts in the [themes handbook block template and template parts section](https://developer.wordpress.org/themes/block-themes/templates-and-template-parts/#block-c5fa39a2-a27d-4bd2-98d0-dc6249a0801a).