Introduction
The posts block allows you to display posts from your blog or another site. With powerful filtering and styling options, this block gives you many different options when it comes to showing groups of content on your site.
Options
Content Source
Choose between populating posts from the current site or another site. If you choose posts from another site, you’ll need to supply an external link (i.e. news.cals.wisc.edu) and posts will populate from that site.
If you are using posts from another site, make sure that you are confident the content is appropriate and relevant. We are not responsible for the content you fetch from another site. Keep in mind, only WordPress sites are supported, and not all sites make their posts public. If the provided URL cannot be used to display posts, an error message will be displayed.
Number of Posts
The maximum number of posts you would like to display. If there are not enough posts, only the number of available posts will display.
Post Elements
Allows you to toggle which content to display in each post. Currently you can display the image, date, and excerpt. The title will always display. If the image is enabled but the source post doesn’t have an image, a placeholder will display.
Source Filters
- Offset: The number of posts to skip over. For example, if you put “3” the block will skip over the 3 most recent posts before loading.
- Categories: The categories that you would like to display. Any post matching at least one of the categories will display. Clicking into the text field will display a list of available categories from the source.
Note: The categories are stored as a list of numeric IDs from the source. If you change the source URL, the block will try to match the numeric IDs with the new IDs from the source. These are likely to be completely different categories, so you should double check that only the ones you want selected are selected. If the new source doesn’t have a category with that ID, it will be removed from the list entirely. - Tags: The tag ID(s), separated by commas, that you would like to display. Any post matching at least one of the tags will display. Clicking into the text field will display a popup list of the top 100 tags from the source.
Note: The tags are stored as a list of numeric IDs from the source. If you change the source URL, the block will try to match the numeric IDs with the new IDs from the source. These are likely to be completely different tags, so you should double check that only the ones you want selected are selected. If the new source doesn’t have a tag with that ID, it will be removed from the list entirely. - Post Type: The post type to use. By default, this block will use posts from the “posts” post type.
Note: While one site has a custom post type (other than page or post), another site may not. If you change the source and the new source does not have the selected post type, it will revert back to “post.” - Other Parameters: If you need more advanced sorting and filtering options than are provided in the interface, they can be added here.
https://developer.wordpress.org/rest-api/reference/posts/
Styles
Post Layout
- Grid (most common): Content will be displayed in a grid layout. You can specify the number of columns (2-4) that you would like to display.
Note: In smaller containers and on smaller screens, the number of columns may be automatically reduced to fit the content properly. - List: Display posts in a 1 column grid with the images on the left or right.
- Carousel: Display posts in a carousel layout. You can specify the number of columns to display per page.
Style
- Default: Image above heading/excerpt/date. Available in grid and carousel layout only.
- Image on Left/Right: Display the image in the left or right third of the card.
- Minimal: Only show the image and content with no styling around the post.
- Content Overlaying Image: Display heading, excerpt, and date on top of the image. Available in grid and carousel layout only. If you opt to hide the featured image, this option is not available.
Posts Heading Tag
This is used for accessibility purposes. Your posts titles should use the appropriate heading tag based on the layout of your page. By default, it will use an h3 tag (assumes there is a heading with an h2 above the posts that introduces the posts section.)
Max Cache Duration (Advanced)
To improve efficiency and speed, the posts block stores (caches) post data directly on a user’s computer. The next time the user loads your page, the block instantly displays the cached posts, unless the specified duration has expired. By default, the duration is 1 week. For example, a user who visits on January 1st will continue to see the posts available on that date until January 8th, even if you publish new content during that week. For maximum performance, we recommend leaving the duration at 1 week unless it is absolutely critical that users always see the newest posts immediately.