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 helpful text to Query Loop block #32694

Merged
merged 2 commits into from
Jun 16, 2021
Merged

Add helpful text to Query Loop block #32694

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3966b00
Update and expand block descriptions for Query and Post Template.
mtias Jun 15, 2021
23dd6df
Add helpful text explaining the different intricate parts of a WP query.
mtias Jun 15, 2021
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
2 changes: 1 addition & 1 deletion packages/block-library/src/post-template/block.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"title": "Post Template",
"category": "design",
"parent": [ "core/query" ],
"description": "Post Template.",
"description": "Contains the block elements used to render a post, like the title, date, featured image, content or excerpt, and more.",
"textdomain": "default",
"usesContext": [
"queryId",
Expand Down
2 changes: 1 addition & 1 deletion packages/block-library/src/query/block.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"name": "core/query",
"title": "Query Loop",
"category": "design",
"description": "Displays a list of posts as a result of a query.",
"description": "An advanced block that allows displaying post types based on different query parameters and visual configurations.",
"textdomain": "default",
"attributes": {
"queryId": {
Expand Down
10 changes: 8 additions & 2 deletions packages/block-library/src/query/edit/query-inspector-controls.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -178,9 +178,9 @@ export default function QueryInspectorControls( {
<InspectorControls>
<PanelBody title={ __( 'Settings' ) }>
<ToggleControl
label={ __( 'Inherit query from URL' ) }
label={ __( 'Inherit query from template' ) }
help={ __(
'Disable the option to customize the query arguments. Leave enabled to inherit the global query depending on the URL.'
'Toggle to use the global query context that is set with the current template, such as an archive or search. Disable to customize the settings independently.'
) }
checked={ !! inherit }
onChange={ ( value ) => setQuery( { inherit: !! value } ) }
Expand All @@ -191,6 +191,9 @@ export default function QueryInspectorControls( {
value={ postType }
label={ __( 'Post Type' ) }
onChange={ onPostTypeChange }
help={ __(
'WordPress contains different types of content and they are divided into collections called "Post Types". By default there are a few different ones such as blog posts and pages, but plugins could add more.'
) }
/>
) }
{ displayLayout?.type === 'flex' && (
Expand Down Expand Up @@ -230,6 +233,9 @@ export default function QueryInspectorControls( {
options={ stickyOptions }
value={ sticky }
onChange={ ( value ) => setQuery( { sticky: value } ) }
help={ __(
'Blog posts can be "stickied", a feature that places them at the top of the front page of posts, keeping it there until new sticky posts are published.'
) }
/>
) }
</PanelBody>
Expand Down