wordpress-plugin-ditty-metaphor-creations

Documentation

Item Types

WP Posts Feed

Last Updated: 

The WP Posts Feed Item type allows you create advanced WordPress post queries and display the results through Ditty.

Editor Settings

The following settings are located on the settings panel for the WP Posts Feed Item type. Hover over your item and select the Edit icon to adjust your settings.

Basic Query Args

Add basic query args for your feed.

  • Post Type – Select the post type to display.
  • Limit – Set the number of Posts to display.
  • Offset – Set an offset from the latest Post.
  • Post Format – Select the post format to display.
  • Orderby – Select the orderby key of the feed.
  • Orderby Meta Key – Add the custom field key.
  • Order – Select the order of the feed.

Advanced Query Args

Add advanced query args for advanced post queries.

  • Parameter – Choose the parameter.
  • Value – Set the value. Use commas to split values into an array.

Taxonomy Query Args

Add taxonomy query args for advanced post queries.

  • Taxonomy Query Relation – Choose the relationship between multiple taxonomy arguments.
  • Taxonomy – Add the taxonomy you wish to use.
  • Terms – Add the terms to filter the query by.
  • Field – Select the taxonomy term by the specified value.
  • Operator – Select the operator to test.
  • Children – Select whether or not to include children for hierarchical taxonomies.

Meta Query Args

Add meta query args for advanced post queries.

  • Meta Query Relation – Choose the relationship between multiple meta query arguments.
  • Key – Custom field key.
  • Value – Use commas to split values into an array. It can be an array only when compare is ‘IN’, ‘NOT IN’, ‘BETWEEN’, or ‘NOT BETWEEN’. You don’t have to specify a value when using the ‘EXISTS’ or ‘NOT EXISTS’ comparisons
  • Compare – Select the operator to test.
  • Type – Select the custom field type. The ‘type’ DATE works with the ‘compare’ value BETWEEN only if the date is stored at the format YYYY-MM-DD and tested with this format.

Title Settings

  • Title Element – Choose the html wrapper element for titles.
  • Title Link – Add a link to the post.

Content Settings

  • Content Display – Configure settings for the post content.
  • Excerpt Element – Choose the html wrapper element for excerpts.
  • Excerpt Length – Set the length of the excerpt.
  • Read More Text – Add read more text to the excerpt.
  • Read More Before Text – Add text before the Read More text.
  • Read More After Text – Add text after the Read More text.
  • Read More Link – Link the read more text to the post.

Link Settings

  • Link Target – Set a target for your links.
  • Link No Follow – Enabling this setting will add an attribute called ‘nofollow’ to your links. This tells search engines to not follow this link.

Layout Tags

The following tags are available to use with the WP Posts Feed Item type. Read more about what Layouts are and how they are used here: What are Layouts?.

HTML Tags

  • {author_avatar} – Render the item’s author avatar.
  • {author_bio} – Render the item’s author biography.
  • {author_name} – Render the item’s author name.
  • {categories} – Render the item’s categories.
  • {content} – Render the item’s content.
  • {custom_field} – Render a custom field for the item.
  • {excerpt} – Render the item’s excerpt.
  • {icon} – Render the item’s icon.
  • {image} – Render the item’s image.
  • {image_url} – Render the item’s image url.
  • {permalink} – Render the item’s permalink.
  • {terms} – Render specified taxonomy terms for the item.
  • {time} – Render the item’s date/time.
  • {title} – Render the item’s title.

CSS Selectors

  • .ditty-item__elements
  • .ditty-item__author_avatar
  • .ditty-item__author_bio
  • .ditty-item__author_name
  • .ditty-item__categories
  • .ditty-item__content
  • .ditty-item__custom_field
  • .ditty-item__excerpt
  • .ditty-item__icon
  • .ditty-item__image
  • .ditty-item__image_url
  • .ditty-item__permalink
  • .ditty-item__terms
  • .ditty-item__time
  • .ditty-item__title