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.

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

[HelpHub]: Template Part block #291

Closed
38 tasks done
femkreations opened this issue Apr 14, 2022 · 13 comments
Closed
38 tasks done

[HelpHub]: Template Part block #291

femkreations opened this issue Apr 14, 2022 · 13 comments
Assignees
Labels
6.0 Changes in 6.0 release 6.1 Changes in 6.1 release 6.2 Changes in 6.2 release 6.3 Changes in 6.3 release block editor Gutenberg related issues high priority [Status] Done Issue is completed tracking issue Use to track a series of related issues. user documentation (HelpHub) Improvements or additions to end-user documentation

Comments

@femkreations
Copy link
Collaborator

femkreations commented Apr 14, 2022

Article: https://wordpress.org/documentation/article/template-part-block/

Update for 6.3

  • Sort template parts by type in navigation screen. 50841
  • Add corresponding area icon to template part menu items. 52102
  • Library: Rename template parts to library. 50769
  • Add chevrons to the templates and template parts in site editor 50076
  • Bring back revisions button for template parts 49163
  • Add "Added by" description to template part navigation sidebar 48732
  • Change "Browse all templates" to "Manage all templates" in template details popover 48496
  • Remove TemplateAreas from template details 48490
  • Append template type and name to the site editor page title 47855
  • Add a nested level when selecting templates or template parts 47777
  • Add corresponding area icon to template part menu items 50791
  • Update Template Parts icon to use the symbol 50410
  • Template revisions: require 2 revisions before showing the revisions UI 50762
  • Make sticky block action on template part block 49219
  • Add a "Make sticky" action to the Template Part block 49085
  • Add Library for Template Parts & Patterns Management 51078
  • add footer to template part and ensure nested template areas display 51669

Updating for 6.2

  • Colorize template parts and Reusable blocks 45473
  • Add an option to import widgets from the sidebars 45509
  • Avoid duplicate titles on creation 46996
  • Allow adding new templates and template parts directly from the sidebar 46458

Updating for 6.1

  • Make template part and reusable block creation language consistent 43032
  • Add search to replacement modal 42459
  • Add block variations for individual template parts 42454
  • Swap block action places 42221
  • Only allow template part to be replaced if its a header or footer 40787
  • Bundle new collection of Header and Footer block patterns 43157
  • Allow changing properties in focus mode 43151

Updating for 6.0

  • Show existing template parts and a list of block patterns at creation flow. 38814
  • Remove support for conversion to Reusable block. 36918
  • Remove color, spacing, and layout options. 36571
  • Remove the spotlight mode from template parts 40652

General

  • Make sure all screenshots are relevant to the latest version
  • Make sure videos, if any, are up to date
  • Add ALT tags for the images
  • Make sure the headings are in sentence case
  • Convert all reusable blocks to a ‘regular block’.
  • Update the changelog at the end of the article

Notes

  1. We are not adding detailed updates for the Block settings - Typography, Color, Layout, Dimension and Border and for the More Options setting in the block toolbar. Pls mention the settings included for the block and link to the detailed settings pages instead.
  2. Pls make 6.2 updates first and then move to 6.1.
  3. Some of the PRs have great videos that can be added to the article
  4. For 6.1, you can pick the screenshots added in the comments previously, if they are relevant.
@femkreations femkreations added tracking issue Use to track a series of related issues. user documentation (HelpHub) Improvements or additions to end-user documentation block editor Gutenberg related issues 6.0 Changes in 6.0 release labels Apr 14, 2022
@femkreations femkreations added the 6.1 Changes in 6.1 release label Sep 26, 2022
@femkreations
Copy link
Collaborator Author

Added tasks for 6.1

@tanazmasaba
Copy link

@femkreations Hi, I'd like to be assigned to this one if that's alright?

@jennimckinnon
Copy link
Collaborator

@tanazmasaba You're assigned! Thank you and have fun :)

@femkreations femkreations moved this from Todo to In Progress in WP 6.2 Documentation Mar 14, 2023
@zzap zzap moved this from In Progress to Todo in WP 6.2 Documentation May 9, 2023
@femkreations femkreations self-assigned this May 9, 2023
@zzap zzap mentioned this issue May 9, 2023
13 tasks
@femkreations femkreations moved this from Todo to In Progress in WP 6.2 Documentation May 11, 2023
@zzap zzap mentioned this issue May 30, 2023
13 tasks
@femkreations femkreations removed their assignment Jul 10, 2023
@femkreations femkreations changed the title [HelpHub] Template Part block [HelpHub]: Template Part block Jul 10, 2023
@shabnam611 shabnam611 self-assigned this Jul 11, 2023
@shabnam611
Copy link
Collaborator

I would like to work on this one.

@femkreations femkreations moved this from Todo to In Progress in WP 6.3 Documentation Jul 11, 2023
@femkreations
Copy link
Collaborator Author

Refer to this PR for details WordPress/gutenberg#50392

@shabnam611
Copy link
Collaborator

shabnam611 commented Aug 4, 2023

Hi @femkreations

For this ticket, I was unable to add all the changes while using 6.3-RC3. Here is the list of the updates I made for 6.3. I would love your feedback/suggestions for the issues I couldn't work on.

I added update for:

I have added screenshot that depicts the sorting under a new section that I created i.e Creating new template parts from the template part list

I noticed the library has been replaced by Pattern so the screenshot from the section Creating new template parts from the template part list covers this as well.

I noticed this PR is dated as May 19th and the one 52102 was on June 29th so I am assuming the one dated with June 29th is the latest one. Is that correct? In the screenshots, Template parts are showing.

In the section Creating new template parts from the template part list, the screenshot shows chevron icons on the left of Patterns and on the right of Manage all template parts and manage all patterns. Since there is no description of template, I didn't add screenshot for template's chevron icon.

In the same screenshot, the manage all template parts is shown.

I created this section Managing template parts and patterns, and there I added a screenshot that shows the Added by for template parts.

I understand the change, but I was not sure how to incorporate it or if it is required to do so.

I updated the screenshots to show the latest Template parts icon

I was able to locate this but I am not sure how to incorporate this, Shall I create a new topic for this? Will it go after advanced?

Couldn't find/couldn't work on:

I couldn't find this revisions for template part

Make sticky block action on template part block was reverted in Add a "Make sticky" action to the Template Part block . So I didn't add any changes for this.

@femkreations femkreations moved this from In Progress to Needs 1st Review in WP 6.3 Documentation Aug 4, 2023
@zzap zzap added the [Status] Review Issue in review label Oct 17, 2023
@github-actions
Copy link

Heads up @docs-reviewers - the "[Status] Review" label was applied to this issue.

@atachibana
Copy link
Collaborator

@shabnam611

Hi Mushrit, Thank you for the contribution and sorry for the late review.
All your suggestions and comments regarding 6.3 are appropriate.
Could you check 6.0, 6.1, and 6.2 as well? If the current version has changed in behavior or UI, you can ignore all of them. If you do not have the time, I will be happy to take over for you.

Here are a few comments in response to your question. Again, no action required of you.

Library: Rename template parts to library.
I noticed this PR is dated as May 19th and the one 52102 was on June 29th so I am assuming the one dated with June 29th is the latest one. Is that correct?

Yes, you can ignore this PR.

Append template type and name to the site editor page title
I understand the change, but I was not sure how to incorporate it or if it is required to do so.

You don't need do anything. As you said, this is not related to this content.

Add footer to template part and ensure nested template areas display
I was able to locate this but I am not sure how to incorporate this, Shall I create a new topic for this? Will it go after advanced?

Again, you don't do anything. This is user experience improvement.

Bring back revisions button for template parts and Template revisions: require 2 revisions before showing the revisions UI
I couldn't find this revisions for template part

As later PR says, you have to have 2 revisions at least.
But again, this is not essential to Template Parts. You can ignore these PRs.

Followings are uncommented PRs.

Remove TemplateAreas from template details 48490
Add a nested level when selecting templates or template parts 47777

This is user experience improvement. Let's ignore it.

Add corresponding area icon to template part menu items 50791

This is covered by your first screenshot

Add Library for Template Parts & Patterns Management 51078

Still we don't have Library. So we can ignore.

@atachibana
Copy link
Collaborator

OK, I would like to take over.

Updating for 6.2

N/A

UX improvement and not needed:

  • Colorize template parts and Reusable blocks 45473
  • Avoid duplicate titles on creation 46996

Already included:

  • Allow adding new templates and template parts directly from the sidebar 46458

Task

Add an option to import widgets from the sidebars 45509

Imporing widget area

If you've switched from a classic theme to a block theme and widgets created in the classic theme, you can import them from Import Widget Area dropdown in the Advanced Settings. Select the widget from dropdown and click Import.

importing-widget-area_6 4

@atachibana
Copy link
Collaborator

Updating for 6.1

N/A

UX improvement:

  • Make template part and reusable block creation language consistent 43032
  • Add search to replacement modal 42459
  • Add block variations for individual template parts 42454
  • Only allow template part to be replaced if its a header or footer 40787
  • Allow changing properties in focus mode 43151

Already enhanced:

  • Bundle new collection of Header and Footer block patterns 43157

Task

Swap block action places 42221

Template part focus mode

... an individual template part. To access this mode, Select the template part and click Edit from the toolbar.

template-parts-mordal-6.4.mp4

Replacing one template part with another

If the theme has more than one template part for the same area, you can use the Replace option after clicking on the three dot menu in the block toolbar to replace the current template part with another. If you don’t see this option, this is because the theme hasn’t provided multiple template parts for the same area.
template-parts-replace-option-6 4

@atachibana
Copy link
Collaborator

Updating for 6.0

N/A

UX improvement:

  • Remove support for conversion to Reusable block. 36918
  • Remove color, spacing, and layout options. 36571
    Remove the spotlight mode from template parts 40652

Already enhanced:

  • Show existing template parts and a list of block patterns at creation flow. 38814

@atachibana
Copy link
Collaborator

I've enhanced all and close this PR.

@github-project-automation github-project-automation bot moved this from Needs 1st Review to Done in WP 6.3 Documentation Feb 17, 2024
@github-actions github-actions bot added [Status] Done Issue is completed and removed [Status] Review Issue in review labels Feb 17, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
6.0 Changes in 6.0 release 6.1 Changes in 6.1 release 6.2 Changes in 6.2 release 6.3 Changes in 6.3 release block editor Gutenberg related issues high priority [Status] Done Issue is completed tracking issue Use to track a series of related issues. user documentation (HelpHub) Improvements or additions to end-user documentation
Projects
Status: Done
Status: Done
Development

No branches or pull requests

7 participants