Posts

Jentil allows a user to set how posts display on pages and archives, right from the theme customizer:

  1. From the theme customizer, go to ‘Posts‘ panel.
  2. Click the section you need to edit.
  3. Change settings as needed.
  4. Click ‘Publish’ to save

The posts panel in the customizer comes with the following sections:

  • Post_Type Archive (for every public post type with archive)
  • Taxonomy Archive (for every public taxonomy with archive)
  • Sticky Post_Type (for every public post type that has sticky posts)
  • Single Post_Type (for every public post type)
  • Related Post_Type (for every public post type)

Available Settings

All sections have similar settings as follows:

Show sticky posts?

Tick this checkbox to show the sticky posts on this particular post type archive. Untick to hide.

This setting only show when the post type in question has, at least, one sticky post.

Number of posts

This sets the maximum number of posts to show. Set to 0 to disable, -1 to show all posts (not recommended).

Wrapper class

This adds a class to the posts wrapper tag (div). Set this as space- or comma-separated HTML class names (without the leading dots).

Jentil comes with pre-defined classes you can use:

  • archive-posts: Diplays posts with a border between successive posts.
  • big or small: Make posts text (title, content, etc) big or small
  • layout-stack: Show posts in stack (top to bottom) layout.
  • layout-grid: Show posts in grid (left to right) layout.

Title length

Sets the number of words for the post title. Use -1 to show the full title.

Title position

This sets the position of the post title, relative to the post image (if shown). You may set to top or side.

Image size

Sets the size of the featured image to show for all posts.

Image alignment

Sets the alignment of the featured image for all posts. Valid values are:

  • none: Centers the image, with text below it.
  • left: Floats the image left, with text around it.
  • right: Floats image right, with text around it.

Image margin

Sets the margin of the featured image for all posts. Should be in the form top right bottom left, just like CSS margin definitions.

For example: 0 20px 0 0

Text offset

This sets the gap to leave between the nearest side of the featured image and the nearest side of the text (title, excerpt, etc), in pixels.

This is used to align text relative to the image, rather than letting the text flow around the image (if image is aligned left or right).

For instance, if the featured image is 100px wide, and you set text offset to 120px, then the text would be aligned 20px from the image.

Excerpt

This sets the length (number of words) of excerpt for all posts. Use -1 to show all excerpt, -2 to show full post content rather than excerpt.

More link text/label

Sets the text to use for the read more link.

Before title, After title, After content

Enter a comma-separated list of items to display before or after the post title, or after the post excerpt/content, respectively.

Valid values include:

  • avatar__size: Eg: avatar__40
  • updated_ago, updated_ago__actual, updated_ago__difference
  • published_ago, published_ago__actual, published_ago__difference
  • author_name
  • comments_link
  • updated_date
  • updated_time
  • published_date
  • published_time
  • post_type
  • category_list or category
  • tag_list or post_tag
  • edit_link
  • delete_link
  • tweet_button
  • plusone_button
  • googleshare_button
  • sharethis_button
  • share_link
  • tweet_link
  • googleplus_link
  • pin_link
  • linkedin_link
  • buffer_link
  • digg_link
  • tumblr_link
  • reddit_link
  • blogger_link
  • pocket_link
  • skype_link
  • viber_link
  • whatsapp_link
  • telegram_link
  • vk_link
  • The name of a filter hook. A function should then be defined and added to that filter. Function args: string $output, int $post_id, string $separator.
  • A post meta key. This would display a single meta value for that key.
  • A taxonomy name. This would display a list of all terms of that taxonomy the post was assigned to.

Before title, After title, After content separators

Sets the separator to use between ‘Before title‘, ‘After title‘ and ‘After content‘ items, respectively.

Pagination position

Sets where to display posts pagination. Set this to None to hide the pagination.

Previous page link text

Sets the text to use as link for previous page.

Next page link text

Sets the text to use as link for next page.