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 with Ditty. For general information on working with items check out the following articles:

WP Posts Feed Settings

Select the Gear/Edit icon shown on your WP Posts Feed item to adjust the settings.

General Settings

Set the general settings of the WP Posts 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.
  • Item List Label – Add a custom label to display for the item in the Items panel of the Ditty.
  • Timestamp Source – Choose to use publish or last updated date when ordering items (from the Items panel) by timestamp.

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.

Links

Configure global link settings for this items elements.

  • 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.

Customize (Layout Tags)

Customize the layout tags used in the layout for a WP Posts Feed item. Keep in mind that your layout may not use all of the tags shown on this panel. If the tag is not included in your layout, modifications in this panel will have no effect.

  • Click the checkmark next to each tag to toggle visibility.
  • Click the gear icon to open the available attributes for each tag.
  • If you want to modify an attribute, click the pencil icon next to the attribute name. This will open a field to set a custom value for the attribute.

For more information view the documentation here: https://www.metaphorcreations.com/article/ditty/general/adding-new-items/#customize-tab

WP Posts Feed Layout Settings

Select the Pencil/Brush icon shown on your WP Posts Feed item to modify the layout for the item. Read more about what Layouts are and how they are used here: https://www.metaphorcreations.com/article/ditty/general/using-layouts/

HTML Tags

The following tags are available to use with the WP Posts Feed Item type.

  • {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

The following css classed are available to use with the WP Posts Feed Item type.

  • .ditty-item__elements – The container wrapping around the item’s content.
  • .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