Documentation

Item Types

WP Post

Last Updated: 

The WP Post Item type allows you select and display a specific post with Ditty. For general information on working with items check out the following articles:

WP Post Settings

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

General Settings

Set the general settings of the WP Post.

  • Post ID – Add the ID of the post you want to display.
  • Label – Add a custom label to display for the item in the Items panel of the Ditty.

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 Post 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 Post Layout Settings

Select the Pencil/Brush icon shown on your WP Post 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 Post 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 Post 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