Display Posts allows you easily list content from all across your website. Start by adding this shortcode in the content editor to display a list of your most recent posts:<\/p>\n\n
[display-posts]\n<\/code><\/pre>\n\nFilter by Category<\/strong><\/p>\n\nTo only show posts within a certain category, use the category parameter:<\/p>\n\n
[display-posts category=\"news\"]\n<\/code><\/pre>\n\nDisplay as Post Grid<\/strong><\/p>\n\nYou can create a great looking, column-based grid of posts with a bit of styling. Here's how!<\/a><\/p>\n\nList Popular Posts<\/strong>\nYou can highlight your popular content in multiple ways. If you want to feature the posts with the most comments, use:<\/p>\n\n[display-posts orderby=\"comment_count\"]\n<\/code><\/pre>\n\nYou can also list most popular posts by social shares<\/a>.<\/p>\n\nInclude thumbnails, excerpts, and more<\/strong>\nThe display parameters<\/a> let you control what information is displayed for each post. To include an image and summary, use:<\/p>\n\n[display-posts include_excerpt=\"true\" image_size=\"thumbnail\"]\n<\/code><\/pre>\n\nYou can use any image size added by WordPress (thumbnail, medium, medium_large, large) OR any custom image size added by your theme or other plugins.<\/p>\n\n
Sort the list however you like<\/strong>\nBy default the listing will list the newest content first, but you can order by title, menu order, relevance, content type, metadata, and more.<\/p>\n\nList upcoming events<\/strong>\nYou can easily list upcoming events from any event calendar. Each plugin will require slightly different code.<\/p>\n\nHere are tutorials for popular event calendar plugins<\/a>. If your plugin is not listed here, submit a support request and I'll add it!<\/p>\n\nTutorials<\/strong>\nOur tutorials<\/a> cover common customization requests, and are updated often.<\/p>\n\nFull Documentation<\/strong><\/p>\n\n\n- Query parameters<\/a> for customizing which posts are listed (filter by category, tag, date...)<\/li>\n
- Display parameters<\/a> determine how the posts appear (title, excerpt, image...)<\/li>\n
- Template parts<\/a> for Display Posts to perfectly match your theme's post listings<\/li>\n
- Output filter<\/a> for complete control over how the listing looks on your site<\/li>\n
- Filters<\/a> for even more powerful customizations for developers<\/li>\n<\/ul>\n\n
Extensions<\/strong><\/p>\n\n\n- Display Posts \u2013 Pagination<\/a> \u2013 Allow results of Display Posts to be paginated<\/li>\n
- Display Posts \u2013 Date View<\/a> \u2013 Lets you break your content down by month or year.<\/li>\n
- Display Posts \u2013 Alpha View<\/a> \u2013 Display an alphabetical listing of your content, broken down by letter<\/li>\n
- Display Posts \u2013 Transient Cache<\/a> \u2013 Cache the output using transients<\/li>\n
- Co-Authors Plus Addon<\/a> \u2013 multiple authors on posts<\/li>\n
- Columns Extension<\/a> \u2013 display posts in columns<\/li>\n
- DPS Exclude Sticky<\/a> \u2013 exclude sticky posts unless specifically requested<\/li>\n
- DPS Pinch Zoomer<\/a> \u2013 adds support pinch zooming post images on mobile devices and mouse wheel zooming on desktops<\/li>\n
- Display Posts Shortcode Remote<\/a> \u2013 display posts from a remote WordPress site utilizing the WP REST API.<\/li>\n<\/ul>\n\n\n
\n- Upload
display-posts-shortcode<\/code> to the \/wp-content\/plugins\/<\/code> directory.<\/li>\n- Activate the plugin through the Plugins<\/em> menu in WordPress.<\/li>\n
- Add the
[display-posts]<\/code> shortcode to a post or page.<\/li>\n<\/ol>\n\n\nVersion 3.0.3<\/strong>\n* Bumped the \"Tested To\" number to WP 6.6\n* Updated text of the plugin notice<\/p>\n\nVersion 3.0.2<\/strong>\n* Added pre_display_posts_shortcode_output<\/code> filter before shortcode runs, used for transient caching, see #210<\/a>\n* Updated plugin to pass coding standards, see #214<\/a>\n* Removed survey admin notice, see #213<\/a>\n* Don't display empty term list, see #208<\/a><\/p>\n\nVersion 3.0.1<\/strong>\n* Prevent empty empty parameters from being added to the query, see #207<\/a><\/p>\n\nVersion 3.0.0<\/strong>\n* Added author_id parameter, see #195<\/a>\n* Added has_password parameter\n* Added s parameter for performing a site search, see #184<\/a>\n* Added date_format=\"relative\" format option (ex: 2 days ago), see #194<\/a>\n* Added post_parent__in and post_parent__not_in parameters, see #193<\/a>\n* Added excerpt_dash=\"false\" option to disable dash in excerpt, see #204<\/a>\n* Added additional parameters to the display_posts_shortcode_output<\/code> filter\n* Added additional parameters to the display_posts_shortcode_category_display<\/code> filter, see #185<\/a>\n* $dps_listing loop now accessible globally, see #198<\/a>\n* $dps_listing loop now accessible in open\/close filters\n* Added .excerpt-more class to excerpt more text, see #205<\/a>\n* Now excerpt_more text is always appended to end of excerpt, see #197<\/a>\n* In parameters that support multiple terms, they can now be separated with a comma or comma-space, see #183<\/a><\/p>\n\nVersion 2.9.0<\/strong>\n* New parameter exclude<\/code> for excluding specific post IDs, see #154<\/a>\n* New parameter category_id<\/code> for specifying category by ID (note: only accepts a single ID), see #156<\/a>\n* New parameter include_date_modified<\/code> for displaying the date the post was last updated, see #150<\/a>\n* Shortcode title now appears above the wrapper (ul\/ol\/div), fixing invalid markup, see #165<\/a>\n* Limit visibility to readable posts<\/p>\n\nVersion 2.8.0<\/strong>\n* Added include_link=\"false\" to remove link from post title and image, see #137<\/a>\n* Fixed category display when using multiple post types, see #143<\/a>\n* Fixed issue combining multiple taxonomies, see #131<\/a><\/p>\n\nVersion 2.7.0<\/strong>\n* Added support for Co-Authors Plus Addon<\/a>.\n* Added parameter to exclude children terms in tax queries, more information<\/a>\n* Added a filter to display the full version of manual excerpt, regardless of excerpt_length. more information<\/a>\n* Removed shortcodes from custom excerpts, more information<\/a>\n* Fixed private post visibility, more information<\/a><\/p>\n\nVersion 2.6.2<\/strong>\n* More improvements to excerpts, see #110\n* Added content_class parameter\n* Fix date query bug, see #108\n* Fixed undefined variable notice if include_title=\"false\"<\/p>\n\nVersion 2.6.1<\/strong>\n* Fix issue with manually specified excerpts<\/p>\n\nVersion 2.6<\/strong><\/p>\n\n\n- Add support for author=\"current\"<\/li>\n
- Add support for multiple wrapper classes<\/li>\n
- Add support for excerpt_length parameter<\/li>\n
- Add support for excerpt_more parameter<\/li>\n<\/ul>\n\n
Version 2.5.1<\/strong><\/p>\n\n\n- Fix an issue with manually specified excerpts<\/li>\n<\/ul>\n\n
Version 2.5<\/strong><\/p>\n\n\n- Add support for date queries<\/li>\n
- Exclude child pages with post_parent=\"0\"<\/li>\n
- Query by current taxonomy terms. Ex: [display-posts taxonomy=\"category\" tax_term=\"current\"]<\/li>\n
- Display the post's categories with [display-posts category_display=\"true\"]<\/li>\n
- Many more fixes. See GitHub for a full list of changes.<\/li>\n<\/ul>\n\n
Version 2.4<\/strong><\/p>\n\n\n- Add 'include_author' parameter<\/li>\n
- Add 'exclude_current' parameter for excluding the current post from the results<\/li>\n
- If you display the full content of results, additional uses of the shortcode within those posts are now turned off<\/li>\n
- Other minor improvements<\/li>\n<\/ul>\n\n
Version 2.3<\/strong><\/p>\n\n\n- Include the shortcode attributes on wrapper filter<\/li>\n
- Add 'no_posts_message' parameter to specify content displayed if no posts found<\/li>\n
- Add filters to the title and permalink<\/li>\n
- Limit private posts to logged in users<\/li>\n
- Add support for excluding sticky posts<\/li>\n
- Add support for ordering by meta_key<\/li>\n<\/ul>\n\n
Version 2.2<\/strong><\/p>\n\n\n- Use original attributes for filters<\/li>\n
- Add support for multiple taxonomy queries<\/li>\n
- Add filter for post classes<\/li>\n
- Add support for post content in the post loop<\/li>\n<\/ul>\n\n
Version 2.1<\/strong><\/p>\n\n\n- Add support for post status<\/li>\n
- Add support for post author<\/li>\n
- Add support for post offset<\/li>\n<\/ul>\n\n
Version 2.0<\/strong><\/p>\n\n\n- Explicitly declare arguments, props danielbachhuber<\/li>\n
- Sanitize each shortcode attribute for security, props danielbachhuber<\/li>\n<\/ul>\n\n
Version 1.9<\/strong><\/p>\n\n\n- Add 'date_format' parameter, so you can customize how dates are displayed<\/li>\n
- Added a class of .excerpt-dash so CSS can be used to remove the dash<\/li>\n
- Cleaned up the codebase according to WordPress coding standards<\/li>\n<\/ul>\n\n
Version 1.8<\/strong><\/p>\n\n\n- Added
display_posts_shortcode_no_results<\/code> filter for displaying content if there's no posts matching current query.<\/li>\n- Add support for multiple post types. [display-posts post_type=\"page, post\"]<\/li>\n<\/ul>\n\n
Version 1.7<\/strong><\/p>\n\n\n- Added
id<\/code> argument to specify specific post IDs<\/li>\n- Added
display_posts_shortcode_args<\/code> filter in case the arguments you want aren't already included in the shortcode. See example: http:\/\/www.billerickson.net\/code\/display-posts-shortcode-exclude-posts\/<\/li>\n<\/ul>\n\nVersion 1.6<\/strong><\/p>\n\n\n- Added
post_parent<\/code> where you can specify a parent by ID, or you can say post_parent=current<\/code> and it will use the current page's ID.<\/li>\n- Added
wrapper<\/code> where you can decide if the posts are an unordered list, ordered list, or div's<\/li>\n- Added support for multiple taxonomy terms (comma separated) and taxonomy operator (IN, NOT IN, or AND).<\/li>\n<\/ul>\n\n
Version 1.5<\/strong>\n* For the sake of clarity I'm changing version numbers. No feature changes<\/p>\n\nVersion 0.1.5<\/strong>\n* Added a filter (display_posts_shortcode_output) so you can modify the output of individual posts however you like.<\/p>\n\nVersion 0.1.4<\/strong><\/p>\n\n\n- Added post_type, taxonomy, tax_term, and include_excerpt<\/li>\n
- Added classes to each part of the listing (image, title, date, excerpt) to make it easier to change the look using CSS<\/li>\n<\/ul>\n\n
Version 0.1.3<\/strong><\/p>\n\n\n- Updated Readme<\/li>\n<\/ul>\n\n
Version 0.1.2<\/strong><\/p>\n\n\n- Added image_size option<\/li>\n<\/ul>\n\n
Version 0.1.1<\/strong><\/p>\n\n\n- Fix spacing issue in plugin<\/li>\n<\/ul>\n\n
Version 0.1<\/strong><\/p>\n\n\n- This is version 0.1. Everything's new!<\/li>\n<\/ul>","raw_excerpt":"Add a listing of content on your website using a simple shortcode. Filter the results by category, author, and more.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/487","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=487"}],"author":[{"embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/billerickson"}],"wp:attachment":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=487"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=487"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=487"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=487"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=487"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=487"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}