Jentil allows a user to set how posts display on pages and archives, right from the theme customizer:
- From the theme customizer, go to ‘Posts‘ panel.
- Click the section you need to edit.
- Change settings as needed.
- 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
orsmall
: Make posts text (title, content, etc) big or smalllayout-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 120
px, 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
orcategory
tag_list
orpost_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.