Fix deprecation notices with PHP 7.4.
Posts
The [post] shortcode can be used to display a secondary loop of posts anywhere using WP_Query.
Posts shortcode arguments
| Classes |
| ||||||||
query | WordPress query string or keyword (Available keywords: related). | ||||||||
template | Custom template name. Template file must reside in the (child) theme's templates directory and be prefixed with loop- (ex. templates/loop-list). | ||||||||
excerpt | Custom excerpt length (number of words). Set to 0 to disable excerpts. (Default: 55) | ||||||||
thumbnail | Custom thumbnail image size (none|thumbnail|small|medium|large|full). (Default: medium) | ||||||||
header | Posts header size (tiny|small|medium|large|huge). (Default: small) | ||||||||
meta | Info displayed below post title. (date_author|timeago_author|date|timeago|author|none) | ||||||||
tags | Set to false to disable tags (categories, tags and sticky post indicator). | ||||||||
read_more | Set to false to disable the "Read more" link. | ||||||||
pagination | Set to true to enable pagination. | ||||||||
pagination_alignment | Pagination alignment (left|center|right). | ||||||||
pagination_menu | Additional classes for the pagination menu. | ||||||||
next | Pagination next posts link text (default: "Older posts"). | ||||||||
prev | Pagination previous posts link text (default: "Newer posts"). | ||||||||
count | Specify post count when query is a keyword (default: 4). | ||||||||
header_text | Header text to display above posts (only displayed if there are posts). | ||||||||
header_classes | Classes for the header. | ||||||||
content_before | Content before the posts (only displayed if there are posts). | ||||||||
content_after | Content after the posts (only displayed if there are posts). |
Items
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts items query="posts_per_page=3&ignore_sticky_posts=1">Divided items
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts divided items query="posts_per_page=3&ignore_sticky_posts=1">Relaxed items
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts very relaxed items query="posts_per_page=3&ignore_sticky_posts=1">Grid
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts grid query="posts_per_page=3&ignore_sticky_posts=1">Divided grid
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
Back to top button
Many sites often have a button that allows the user to scroll all the way back to the top easily. Chap theme doesn’t include this feature out of the box, but it can be added with some custom code in the theme options. This CSS will make the button appear in the bottom right corner,…
<posts divided two column grid query="posts_per_page=4&ignore_sticky_posts=1">Celled grid
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
Back to top button
Many sites often have a button that allows the user to scroll all the way back to the top easily. Chap theme doesn’t include this feature out of the box, but it can be added with some custom code in the theme options. This CSS will make the button appear in the bottom right corner,…
Performance guidelines
Guidelines for getting the best performance out of this theme.
<posts celled two column grid query="posts_per_page=6&ignore_sticky_posts=1">Internally celled grid
Update Theme and Plugins from Zip
Update Theme and Plugins from Zip File is a good quality of life plugin that allows to update/roll back your current theme or plugins by simply uploading them as if they weren’t already installed. By default WordPress doesn’t provide such functionality – when you upload a .zip file for a plugin that is already installed…
Adding a custom attribute to Gutenberg block
Using Gutenberg Block Filters to add an editable rel attribute to the core Button block.
Blank template
Creating a blank page template file without any header, footer or sidebars.
Breadcrumb NavXT
Setting up the NavXT breadcrumbs plugin to display breadcrumbs with Semantic UI breadcrumb component styling.
<posts internally celled two column grid query="posts_per_page=6&ignore_sticky_posts=1&meta_key=_thumbnail_id">Cards
Font Awesome SVG
Documentation of the Font Awesome SVG icon theme.
Read more about Font Awesome SVG
Update Theme and Plugins from Zip
Update Theme and Plugins from Zip File is a good quality of life plugin that allows to update/roll back your current theme or plugins by simply uploading them as if they weren’t already installed. By default WordPress doesn’t provide such functionality – when you upload a .zip file for a plugin that is already installed…
Read more about Update Theme and Plugins from Zip
Adding a custom attribute to Gutenberg block
Using Gutenberg Block Filters to add an editable rel attribute to the core Button block.
Read more about Adding a custom attribute to Gutenberg block
<posts cards query="posts_per_page=3&ignore_sticky_posts=1&meta_key=_thumbnail_id">Cards count
Chap 1.21.6
Fix deprecation notices with PHP 7.4.
Read more about Chap 1.21.6
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Read more about Chap 1.21.5
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
Read more about Chap 1.21.4
Back to top button
Many sites often have a button that allows the user to scroll all the way back to the top easily. Chap theme doesn’t include this feature out of the box, but it can be added with some custom code in the theme options. This CSS will make the button appear in the bottom right corner,…
Read more about Back to top button
<posts four stackable cards query="posts_per_page=4&ignore_sticky_posts=1">Basic pagination
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts divided items query="posts_per_page=3&ignore_sticky_posts=1" pagination="true">Advanced pagination
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
Back to top button
Many sites often have a button that allows the user to scroll all the way back to the top easily. Chap theme doesn’t include this feature out of the box, but it can be added with some custom code in the theme options. This CSS will make the button appear in the bottom right corner,…
<posts two column grid
query="posts_per_page=4"
pagination="true"
next="Older entries"
prev="Newer entries"
pagination_alignment="right"
pagination_menu="tiny secondary"
>Content instead of excerpt
<posts one column vertically divided grid
query="posts_per_page=1&ignore_sticky_posts=1"
template="templates/loop-content"
pagination="true"
next="Older post"
prev="Newer post"
>Notes
The loop-content template is designed to show posts with content inside grid loops.Custom header size
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts items query="posts_per_page=3&ignore_sticky_posts=1" header="huge">No thumbnails
Update Theme and Plugins from Zip
Update Theme and Plugins from Zip File is a good quality of life plugin that allows to update/roll back your…
Adding a custom attribute to Gutenberg block
Using Gutenberg Block Filters to add an editable rel attribute to the core Button block.
<posts three column grid query="posts_per_page=3&ignore_sticky_posts=1&meta_key=_thumbnail_id" excerpt="20" thumbnail="none">No excerpt
<posts three column grid query="posts_per_page=3&ignore_sticky_posts=1&meta_key=_thumbnail_id" excerpt="0">No meta
Update Theme and Plugins from Zip
Update Theme and Plugins from Zip File is a good quality of life plugin that allows to update/roll back your…
Adding a custom attribute to Gutenberg block
Using Gutenberg Block Filters to add an editable rel attribute to the core Button block.
<posts three column grid query="posts_per_page=3&ignore_sticky_posts=1&meta_key=_thumbnail_id" excerpt="20" meta="false">No tags
Update Theme and Plugins from Zip
Update Theme and Plugins from Zip File is a good quality of life plugin that allows to update/roll back your…
Adding a custom attribute to Gutenberg block
Using Gutenberg Block Filters to add an editable rel attribute to the core Button block.
<posts three column grid query="posts_per_page=3&ignore_sticky_posts=1&meta_key=_thumbnail_id" excerpt="20" tags="false">No read more link
Update Theme and Plugins from Zip
Update Theme and Plugins from Zip File is a good quality of life plugin that allows to update/roll back your…
Adding a custom attribute to Gutenberg block
Using Gutenberg Block Filters to add an editable rel attribute to the core Button block.
<posts three column grid query="posts_per_page=3&ignore_sticky_posts=1&meta_key=_thumbnail_id" excerpt="20" read_more="false">Plain
<subheader dividing>More posts</subheader>
<posts compact marginless items query="posts_per_page=5&ignore_sticky_posts=1" header="tiny" excerpt="0" thumbnail="none" meta="true" tags="false" read_more="false"><posts query="related" count="5">Notes
Using the "related" keyword as query will fetch related posts. You can use custom WP_Query arguments programmatically by using the
csc_posts_query filter. Argument 2 of that filter will contain the shortcode's arguments which can be used to identify which instance of the shortcode it is.<posts id="custom">add_filter('csc_posts_query', function($query, $args) {
if(isset($args['id']) && $args['id'] === 'custom') {
return [
'category__in' => [2, 6],
'posts_per_page' => 3,
];
}
return $query;
}, 10, 2);Header
Header shown when there are posts
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts items query="posts_per_page=3&ignore_sticky_posts=1" header_text="Header shown when there are posts" header_classes="large dividing">
<posts items query="posts_per_page=3&cat=123123" header_text="Header not shown because there are no posts">Notes
Header can be prepended with the header_text argument for only when there are results.Wrapper: content before/after
Chap 1.21.5
Add compatibility for AMP transitional mode and AMP plugin 2.0.
Chap 1.21.4
Compatibility with WordPress 5.5 and updated templates for WooCommerce 4.4.
<posts items query="posts_per_page=3&ignore_sticky_posts=1" content_before="{lt}div class='ui primary segment'{gt}" content_after="{lt}/div{gt}">
<posts items query="posts_per_page=3&cat=123123" content_before="{lt}div class='ui primary segment'{gt}" content_after="{lt}/div{gt}">Notes
You can specify before and after content to wrap the posts in something. The wrapper elements won't be displayed when there are no posts. That way there won't be an empty container when there are no related posts for example.
Related posts for theme options
Related posts
Duplicate Post
Often when creating WordPress content it will be similar, following the same structure. For that reason Duplicate Post is a really useful and handy plugin, that is recommended for any WordPress installation.
Chap 1.19.0
Minor update for WooCommerce compatibility, new posts block.
<posts three column internally celled stackable grid query="related" count="6" header_text="Related posts" header_classes="large dividing" content_before="{lt}div class='ui segment'{gt}" content_after="{lt}/div{gt}">Notes
Adding this shortcode to Chap Theme -> Code -> After post content can easily display related posts for all posts.
Leave a comment