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

Use the default post comments template for the post comments listing #21012

Merged
merged 1 commit into from
Mar 27, 2020

Conversation

youknowriad
Copy link
Contributor

@youknowriad youknowriad commented Mar 19, 2020

Related #20791

The Post comments block was using an adhoc template for the comments list. This PR updates the block to rely on the default one that ships with WordPress.

Apparently, this template is deprecated though but it's handy for the FSE block so we might consider removing the deprecation.

Capture d’écran 2020-03-19 à 10 56 37 AM

Notes

While working on this, I actually wondered whether we'd need to build comments blocks suite (comment author block, comment content, comment avatar...) and use them in a comment query block (similar to what we're doing with the post blocks.

My thinking is that it's too soon for these, and the use-cases are smaller than the post ones. cc @mtias

@github-actions
Copy link

github-actions bot commented Mar 19, 2020

Size Change: 0 B

Total Size: 856 kB

ℹ️ View Unchanged
Filename Size Change
build/a11y/index.js 998 B 0 B
build/annotations/index.js 3.44 kB 0 B
build/api-fetch/index.js 3.39 kB 0 B
build/autop/index.js 2.58 kB 0 B
build/blob/index.js 620 B 0 B
build/block-directory/index.js 6.02 kB 0 B
build/block-directory/style-rtl.css 760 B 0 B
build/block-directory/style.css 760 B 0 B
build/block-editor/index.js 101 kB 0 B
build/block-editor/style-rtl.css 10.9 kB 0 B
build/block-editor/style.css 10.9 kB 0 B
build/block-library/editor-rtl.css 7.22 kB 0 B
build/block-library/editor.css 7.23 kB 0 B
build/block-library/index.js 110 kB 0 B
build/block-library/style-rtl.css 7.43 kB 0 B
build/block-library/style.css 7.44 kB 0 B
build/block-library/theme-rtl.css 669 B 0 B
build/block-library/theme.css 671 B 0 B
build/block-serialization-default-parser/index.js 1.65 kB 0 B
build/block-serialization-spec-parser/index.js 3.1 kB 0 B
build/blocks/index.js 57.5 kB 0 B
build/components/index.js 190 kB 0 B
build/components/style-rtl.css 15.8 kB 0 B
build/components/style.css 15.7 kB 0 B
build/compose/index.js 6.21 kB 0 B
build/core-data/index.js 10.6 kB 0 B
build/data-controls/index.js 1.04 kB 0 B
build/data/index.js 8.25 kB 0 B
build/date/index.js 5.37 kB 0 B
build/deprecated/index.js 771 B 0 B
build/dom-ready/index.js 568 B 0 B
build/dom/index.js 3.06 kB 0 B
build/edit-post/index.js 91.2 kB 0 B
build/edit-post/style-rtl.css 8.43 kB 0 B
build/edit-post/style.css 8.43 kB 0 B
build/edit-site/index.js 6.73 kB 0 B
build/edit-site/style-rtl.css 2.91 kB 0 B
build/edit-site/style.css 2.9 kB 0 B
build/edit-widgets/index.js 4.43 kB 0 B
build/edit-widgets/style-rtl.css 2.57 kB 0 B
build/edit-widgets/style.css 2.57 kB 0 B
build/editor/editor-styles-rtl.css 428 B 0 B
build/editor/editor-styles.css 431 B 0 B
build/editor/index.js 42.8 kB 0 B
build/editor/style-rtl.css 3.38 kB 0 B
build/editor/style.css 3.38 kB 0 B
build/element/index.js 4.44 kB 0 B
build/escape-html/index.js 733 B 0 B
build/format-library/index.js 6.95 kB 0 B
build/format-library/style-rtl.css 502 B 0 B
build/format-library/style.css 502 B 0 B
build/hooks/index.js 1.93 kB 0 B
build/html-entities/index.js 622 B 0 B
build/i18n/index.js 3.49 kB 0 B
build/is-shallow-equal/index.js 710 B 0 B
build/keyboard-shortcuts/index.js 2.3 kB 0 B
build/keycodes/index.js 1.69 kB 0 B
build/list-reusable-blocks/index.js 2.99 kB 0 B
build/list-reusable-blocks/style-rtl.css 226 B 0 B
build/list-reusable-blocks/style.css 226 B 0 B
build/media-utils/index.js 4.84 kB 0 B
build/notices/index.js 1.57 kB 0 B
build/nux/index.js 3.01 kB 0 B
build/nux/style-rtl.css 616 B 0 B
build/nux/style.css 613 B 0 B
build/plugins/index.js 2.54 kB 0 B
build/primitives/index.js 1.5 kB 0 B
build/priority-queue/index.js 781 B 0 B
build/redux-routine/index.js 2.84 kB 0 B
build/rich-text/index.js 14.5 kB 0 B
build/server-side-render/index.js 2.55 kB 0 B
build/shortcode/index.js 1.7 kB 0 B
build/token-list/index.js 1.27 kB 0 B
build/url/index.js 4.01 kB 0 B
build/viewport/index.js 1.61 kB 0 B
build/warning/index.js 1.14 kB 0 B
build/wordcount/index.js 1.18 kB 0 B

compressed-size-action

@youknowriad
Copy link
Contributor Author

Can I get some reviews here @noahtallen @vindl @johnstonphilip

@mtias
Copy link
Member

mtias commented Mar 24, 2020

Eventually it'd follow the same path as the post templates, yes, but agreed it's a bit too soon and I'd like to see the post ones in a place we are fully comfortable with before expanding.

packages/block-library/src/post-comments/index.php Outdated Show resolved Hide resolved
ob_get_clean();

ob_start();
wp_list_comments(array(
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we need to call wp_list_comments explicitly here since it's already called in comments.php. If I'm not missing something, it seems that this can be simplified to:

ob_start();

comments_template();

return ob_get_clean();

We can optionally call it with dummy_path or similar if we want to force the usage of theme-compat template.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can't do that since this function generates the deprecated message.
Also, it seems that this function doesn't output the HTML consistently.

Will not display the comments template if not on single post or page, or if the post does not have comments.

https://developer.wordpress.org/reference/functions/comments_template/

@youknowriad youknowriad force-pushed the update/post-comments-template branch 3 times, most recently from 688a996 to 7306d1c Compare March 26, 2020 13:06
@youknowriad youknowriad force-pushed the update/post-comments-template branch from 7306d1c to 8686244 Compare March 27, 2020 08:06
@youknowriad youknowriad merged commit 6e56d6b into master Mar 27, 2020
@youknowriad youknowriad deleted the update/post-comments-template branch March 27, 2020 11:46
@github-actions github-actions bot added this to the Gutenberg 7.9 milestone Mar 27, 2020
@ellatrix ellatrix mentioned this pull request Jun 16, 2020
12 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Type] Enhancement A suggestion for improvement.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants