The Display Posts tool makes it easy to render dynamic lists of posts that meet specific criteria.
The Display Posts tool is a third party plugin with extensive documentation on its parameters and usage. However, the tool has a few custom capabilities that help integrate it into the theme and components.
Adding Display Posts
Display Posts can be implemented with the shortcode display-posts.
[display-posts category="News"]
Display Posts can show results as cards, heroes, or panels:
[display-posts category="News" component="card" cl-button="Read Now"]
Note that, in this example, the native card attribute button is also set, with the prefix cl-. Any attributes of the chosen results component can be set this way, overriding any default or dynamic values the Display Posts plugin might set for them.
Custom Attributes
component
(string) (optional) (values: card, hero, panel)
Set a component to use for rendering results.
cl-[attr]
(string) (optional)
Set an applicable attribute to be passed to the component shortcode set in component. Values set here will override any similar data retrieved by Display Posts.
(examples: cl-format="fullwidth" or cl-button="My Button Text")