Below, you’ll find a detailed guide on how to add the Display Posts Shortcode Shortcode to your WordPress website, including its parameters, examples, and PHP function code. Additionally, we’ll assist you with common issues that might cause the Display Posts Shortcode Plugin shortcode not to show or not to work correctly.
Before starting, here is an overview of the Display Posts Shortcode Plugin and the shortcodes it provides:
Display Posts – Easy lists, grids, navigation, and more
"Display Posts – Easy lists, grids, navigation, and more is a versatile WordPress plugin that simplifies the creation and customization of post displays. It adds shortcode functionality for easy integration."
Included Shortcodes:
- [display-posts]
Display Posts [display-posts] Shortcode
The Display Posts Shortcode plugin allows you to list content from all across your site, right inside your posts and pages. It’s incredibly flexible, letting you specify the post type, category, author, and many other parameters to customize the output. The shortcode fetches and displays posts based on the attributes provided. It offers numerous filters for customization, including author, category, date, and more. It also allows for displaying post metadata and content. Shortcode: [display-posts]
Shortcode: [display-posts]
Parameters
Here is a list of all possible display-posts shortcode parameters and attributes:
author– specifies the author of the posts to be displayedauthor_id– specifies the ID of the author of the posts to be displayedcategory– specifies the category of the posts to be displayedcategory_display– controls how the category of the posts is displayedcategory_id– specifies the ID of the category of the posts to be displayedcategory_label– sets the label for the category of the postscontent_class– sets the CSS class for the post contentdate_format– sets the format for the date of the postsdate– specifies a specific date for the posts to be displayeddate_column– sets the column to be used for date queriesdate_compare– sets the comparison operator for date queriesdate_query_before– sets a date to retrieve posts beforedate_query_after– sets a date to retrieve posts afterdate_query_column– sets the column to be used for date queriesdate_query_compare– sets the comparison operator for date queriesdisplay_posts_off– turns off the display of posts if set to trueexcerpt_length– sets the length of the post excerptsexcerpt_more– sets the text for the “read more” link in post excerptsexcerpt_more_link– adds a “read more” link to post excerpts if set to trueexclude– excludes specific posts from being displayedexclude_current– excludes the current post from being displayed if set to truehas_password– specifies whether to display posts that have a passwordid– specifies the ID of the posts to be displayedignore_sticky_posts– ignores sticky posts if set to trueimage_size– sets the size of the post imagesinclude_author– includes the author of the posts if set to trueinclude_content– includes the content of the posts if set to trueinclude_date– includes the date of the posts if set to trueinclude_date_modified– includes the modified date of the posts if set to trueinclude_excerpt– includes the excerpt of the posts if set to trueinclude_excerpt_dash– includes a dash before the post excerpt if set to trueinclude_link– includes a link to the posts if set to trueinclude_title– includes the title of the posts if set to truemeta_key– specifies a meta key for the postsmeta_value– specifies a meta value for the postsno_posts_message– sets the message to be displayed when no posts are foundoffset– offsets the start point for the posts to be displayedorder– sets the order of the posts (ASC or DESC)orderby– sets the parameter to order the posts bypost_parent– specifies the parent of the posts to be displayedpost_parent__in– specifies the parents of the posts to be displayedpost_parent__not_in– specifies the parents of the posts not to be displayedpost_status– sets the status of the posts to be displayedpost_type– sets the type of the posts to be displayedposts_per_page–
Examples and Usage
Basic example – Display posts from a specific category
[display-posts category="news" posts_per_page="5"]Advanced examples
Display posts from multiple categories, ordered by title in ascending order, and only show the title and excerpt.
[display-posts category="news,events" orderby="title" order="ASC" include_title="true" include_excerpt="true"]Display posts from a specific author, exclude current post, and include the post date.
[display-posts author="john" exclude_current="true" include_date="true" date_format="(Y/m/d)"]Display posts that have a specific meta key and value, and limit the number of posts displayed.
[display-posts meta_key="featured" meta_value="yes" posts_per_page="3"]Display posts from a custom post type and taxonomy.
[display-posts post_type="product" taxonomy="product_cat" tax_term="electronics"]PHP Function Code
In case you have difficulties debugging what causing issues with
[display-posts]shortcode, check below the related PHP functions code.Shortcode line:
add_shortcode( 'display-posts', 'be_display_posts_shortcode' );Shortcode PHP function:
function be_display_posts_shortcode( $atts ) { /** * Short circuit filter. * * Use this filter to return from this function immediately, with the return of the filter callback. * * @since 3.0.2 * * @param bool $short_circuit False to allow this function to continue, anything else to return that value. * @param array $atts Shortcode attributes. */ $output = apply_filters( 'pre_display_posts_shortcode_output', false, $atts ); if ( false !== $output ) { return $output; } // Original attributes, for filters. $original_atts = $atts; // Pull in shortcode attributes and set defaults. $atts = shortcode_atts( array( 'author' => '', 'author_id' => '', 'category' => '', 'category_display' => '', 'category_id' => false, 'category_label' => 'Posted in: ', 'content_class' => 'content', 'date_format' => '(n/j/Y)', 'date' => '', 'date_column' => 'post_date', 'date_compare' => '=', 'date_query_before' => '', 'date_query_after' => '', 'date_query_column' => '', 'date_query_compare' => '', 'display_posts_off' => false, 'excerpt_length' => false, 'excerpt_more' => false, 'excerpt_more_link' => false, 'exclude' => false, 'exclude_current' => false, 'has_password' => null, 'id' => false, 'ignore_sticky_posts' => false, 'image_size' => false, 'include_author' => false, 'include_content' => false, 'include_date' => false, 'include_date_modified' => false, 'include_excerpt' => false, 'include_excerpt_dash' => true, 'include_link' => true, 'include_title' => true, 'meta_key' => '', // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_key 'meta_value' => '', // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_value 'no_posts_message' => '', 'offset' => 0, 'order' => 'DESC', 'orderby' => 'date', 'post_parent' => false, 'post_parent__in' => false, 'post_parent__not_in' => false, 'post_status' => 'publish', 'post_type' => 'post', 'posts_per_page' => '10', 's' => false, 'tag' => '', 'tax_operator' => 'IN', 'tax_include_children' => true, 'tax_term' => false, 'taxonomy' => false, 'time' => '', 'title' => '', 'wrapper' => 'ul', 'wrapper_class' => 'display-posts-listing', 'wrapper_id' => false, ), $atts, 'display-posts' ); // End early if shortcode should be turned off. if ( $atts['display_posts_off'] ) { return; } $author = sanitize_text_field( $atts['author'] ); $author_id = (int) $atts['author_id']; $category = sanitize_text_field( $atts['category'] ); $category_display = 'true' === $atts['category_display'] ? 'category' : sanitize_text_field( $atts['category_display'] ); $category_id = (int) $atts['category_id']; $category_label = sanitize_text_field( $atts['category_label'] ); $content_class = array_map( 'sanitize_html_class', explode( ' ', $atts['content_class'] ) ); $date_format = sanitize_text_field( $atts['date_format'] ); $date = sanitize_text_field( $atts['date'] ); $date_column = sanitize_text_field( $atts['date_column'] ); $date_compare = sanitize_text_field( $atts['date_compare'] ); $date_query_before = sanitize_text_field( $atts['date_query_before'] ); $date_query_after = sanitize_text_field( $atts['date_query_after'] ); $date_query_column = sanitize_text_field( $atts['date_query_column'] ); $date_query_compare = sanitize_text_field( $atts['date_query_compare'] ); $excerpt_length = (int) $atts['excerpt_length']; $excerpt_more = sanitize_text_field( $atts['excerpt_more'] ); $excerpt_more_link = filter_var( $atts['excerpt_more_link'], FILTER_VALIDATE_BOOLEAN ); $exclude = $atts['exclude']; // Sanitized later as an array of integers. $exclude_current = filter_var( $atts['exclude_current'], FILTER_VALIDATE_BOOLEAN ); $has_password = null !== $atts['has_password'] ? filter_var( $atts['has_password'], FILTER_VALIDATE_BOOLEAN ) : null; $id = $atts['id']; // Sanitized later as an array of integers. $ignore_sticky_posts = filter_var( $atts['ignore_sticky_posts'], FILTER_VALIDATE_BOOLEAN ); $image_size = sanitize_key( $atts['image_size'] ); $include_title = filter_var( $atts['include_title'], FILTER_VALIDATE_BOOLEAN ); $include_author = filter_var( $atts['include_author'], FILTER_VALIDATE_BOOLEAN ); $include_content = filter_var( $atts['include_content'], FILTER_VALIDATE_BOOLEAN ); $include_date = filter_var( $atts['include_date'], FILTER_VALIDATE_BOOLEAN ); $include_date_modified = filter_var( $atts['include_date_modified'], FILTER_VALIDATE_BOOLEAN ); $include_excerpt = filter_var( $atts['include_excerpt'], FILTER_VALIDATE_BOOLEAN ); $include_excerpt_dash = filter_var( $atts['include_excerpt_dash'], FILTER_VALIDATE_BOOLEAN ); $include_link = filter_var( $atts['include_link'], FILTER_VALIDATE_BOOLEAN ); $meta_key = sanitize_text_field( $atts['meta_key'] ); $meta_value = sanitize_text_field( $atts['meta_value'] ); $no_posts_message = sanitize_text_field( $atts['no_posts_message'] ); $offset = (int) $atts['offset']; $order = sanitize_key( $atts['order'] ); $orderby = sanitize_key( $atts['orderby'] ); $post_parent = $atts['post_parent']; // Validated later, after check for 'current'. $post_parent__in = $atts['post_parent__in']; $post_parent__not_in = $atts['post_parent__not_in']; $post_status = $atts['post_status']; // Validated later as one of a few values. $post_type = sanitize_text_field( $atts['post_type'] ); $posts_per_page = (int) $atts['posts_per_page']; $s = sanitize_text_field( $atts['s'] ); $tag = sanitize_text_field( $atts['tag'] ); $tax_operator = $atts['tax_operator']; // Validated later as one of a few values. $tax_include_children = filter_var( $atts['tax_include_children'], FILTER_VALIDATE_BOOLEAN ); $tax_term = sanitize_text_field( $atts['tax_term'] ); $taxonomy = sanitize_key( $atts['taxonomy'] ); $time = sanitize_text_field( $atts['time'] ); $shortcode_title = sanitize_text_field( $atts['title'] ); $wrapper = sanitize_text_field( $atts['wrapper'] ); $wrapper_class = array_map( 'sanitize_html_class', explode( ' ', $atts['wrapper_class'] ) ); if ( ! empty( $wrapper_class ) ) { $wrapper_class = ' class="' . implode( ' ', $wrapper_class ) . '"'; } $wrapper_id = sanitize_html_class( $atts['wrapper_id'] ); if ( ! empty( $wrapper_id ) ) { $wrapper_id = ' id="' . $wrapper_id . '"'; } // Set up initial query for post. $args = array( 'perm' => 'readable', ); // Add args if they aren't empty. if ( ! empty( $category_id ) ) { $args['cat'] = $category_id; } if ( ! empty( $category ) ) { $args['category_name'] = $category; } if ( ! empty( $order ) ) { $args['order'] = $order; } if ( ! empty( $orderby ) ) { $args['orderby'] = $orderby; } if ( ! empty( $post_type ) ) { $args['post_type'] = be_dps_explode( $post_type ); } if ( ! empty( $posts_per_page ) ) { $args['posts_per_page'] = $posts_per_page; } if ( ! empty( $s ) ) { $args['s'] = $s; } if ( ! empty( $tag ) ) { $args['tag'] = $tag; } // Date query. if ( ! empty( $date ) || ! empty( $time ) || ! empty( $date_query_after ) || ! empty( $date_query_before ) ) { $initial_date_query = array(); $date_query_top_lvl = array(); $valid_date_columns = array( 'post_date', 'post_date_gmt', 'post_modified', 'post_modified_gmt', 'comment_date', 'comment_date_gmt', ); $valid_compare_ops = array( '=', '!=', '>', '>=', '<', '<=', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN' ); // Sanitize and add date segments. $dates = be_sanitize_date_time( $date ); if ( ! empty( $dates ) ) { if ( is_string( $dates ) ) { $timestamp = strtotime( $dates ); $dates = array( 'year' => date( 'Y', $timestamp ), 'month' => date( 'm', $timestamp ), 'day' => date( 'd', $timestamp ), ); } foreach ( $dates as $arg => $segment ) { $initial_date_query[ $arg ] = $segment; } } // Sanitize and add time segments. $times = be_sanitize_date_time( $time, 'time' ); if ( ! empty( $times ) ) { foreach ( $times as $arg => $segment ) { $initial_date_query[ $arg ] = $segment; } } // Date query 'before' argument. $before = be_sanitize_date_time( $date_query_before, 'date', true ); if ( ! empty( $before ) ) { $initial_date_query['before'] = $before; } // Date query 'after' argument. $after = be_sanitize_date_time( $date_query_after, 'date', true ); if ( ! empty( $after ) ) { $initial_date_query['after'] = $after; } // Date query 'column' argument. if ( ! empty( $date_query_column ) && in_array( $date_query_column, $valid_date_columns, true ) ) { $initial_date_query['column'] = $date_query_column; } // Date query 'compare' argument. if ( ! empty( $date_query_compare ) && in_array( $date_query_compare, $valid_compare_ops, true ) ) { $initial_date_query['compare'] = $date_query_compare; } // Top-level date_query arguments. Only valid arguments will be added. // // 'column' argument. if ( ! empty( $date_column ) && in_array( $date_column, $valid_date_columns, true ) ) { $date_query_top_lvl['column'] = $date_column; } // 'compare' argument. if ( ! empty( $date_compare ) && in_array( $date_compare, $valid_compare_ops, true ) ) { $date_query_top_lvl['compare'] = $date_compare; } // Bring in the initial date query. if ( ! empty( $initial_date_query ) ) { $date_query_top_lvl[] = $initial_date_query; } // Date queries. $args['date_query'] = $date_query_top_lvl; } // Ignore Sticky Posts. if ( $ignore_sticky_posts ) { $args['ignore_sticky_posts'] = true; } // Password protected content. if ( null !== $has_password ) { $args['has_password'] = $has_password; } // Meta key (for ordering). if ( ! empty( $meta_key ) ) { $args['meta_key'] = $meta_key; // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_key } // Meta value (for simple meta queries). if ( ! empty( $meta_value ) ) { $args['meta_value'] = $meta_value; // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_value } // If Post IDs. if ( $id ) { $posts_in = array_map( 'intval', be_dps_explode( $id ) ); $args['post__in'] = $posts_in; } // If Exclude. $post__not_in = array(); if ( ! empty( $exclude ) ) { $post__not_in = array_map( 'intval', be_dps_explode( $exclude ) ); } if ( is_singular() && $exclude_current ) { $post__not_in[] = get_the_ID(); } if ( ! empty( $post__not_in ) ) { $args['post__not_in'] = $post__not_in; // phpcs:ignore WordPressVIPMinimum.VIP.WPQueryParams.post__not_in } // Post Author. if ( ! empty( $author ) ) { if ( 'current' === $author && is_user_logged_in() ) { $args['author_name'] = wp_get_current_user()->user_login; } elseif ( 'current' === $author ) { $args['meta_key'] = 'dps_no_results'; // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_key } else { $args['author_name'] = $author; } } elseif ( ! empty( $author_id ) ) { $args['author'] = $author_id; } // Offset. if ( ! empty( $offset ) ) { $args['offset'] = $offset; } // Post Status. $post_status = be_dps_explode( $post_status ); $validated = array(); $available = array( 'publish', 'pending', 'draft', 'auto-draft', 'future', 'private', 'inherit', 'trash', 'any' ); foreach ( $post_status as $unvalidated ) { if ( in_array( $unvalidated, $available, true ) ) { $validated[] = $unvalidated; } } if ( ! empty( $validated ) ) { $args['post_status'] = $validated; } // If taxonomy attributes, create a taxonomy query. if ( ! empty( $taxonomy ) && ! empty( $tax_term ) ) { if ( 'current' === $tax_term ) { global $post; $terms = wp_get_post_terms( get_the_ID(), $taxonomy ); $tax_term = array(); foreach ( $terms as $term ) { $tax_term[] = $term->slug; } } else { // Term string to array. $tax_term = be_dps_explode( $tax_term ); } // Validate operator. if ( ! in_array( $tax_operator, array( 'IN', 'NOT IN', 'AND' ), true ) ) { $tax_operator = 'IN'; } $tax_args = array( 'tax_query' => array( // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_tax_query array( 'taxonomy' => $taxonomy, 'field' => 'slug', 'terms' => $tax_term, 'operator' => $tax_operator, 'include_children' => $tax_include_children, ), ), ); // Check for multiple taxonomy queries. $count = 2; $more_tax_queries = false; while ( isset( $original_atts[ 'taxonomy_' . $count ] ) && ! empty( $original_atts[ 'taxonomy_' . $count ] ) && isset( $original_atts[ 'tax_' . $count . '_term' ] ) && ! empty( $original_atts[ 'tax_' . $count . '_term' ] ) ) : // Sanitize values. $more_tax_queries = true; $taxonomy = sanitize_key( $original_atts[ 'taxonomy_' . $count ] ); $terms = be_dps_explode( sanitize_text_field( $original_atts[ 'tax_' . $count . '_term' ] ) ); $tax_operator = isset( $original_atts[ 'tax_' . $count . '_operator' ] ) ? $original_atts[ 'tax_' . $count . '_operator' ] : 'IN'; $tax_operator = in_array( $tax_operator, array( 'IN', 'NOT IN', 'AND' ), true ) ? $tax_operator : 'IN'; $tax_include_children = isset( $original_atts[ 'tax_' . $count . '_include_children' ] ) ? filter_var( $atts[ 'tax_' . $count . '_include_children' ], FILTER_VALIDATE_BOOLEAN ) : true; $tax_args['tax_query'][] = array( 'taxonomy' => $taxonomy, 'field' => 'slug', 'terms' => $terms, 'operator' => $tax_operator, 'include_children' => $tax_include_children, ); $count++; endwhile; if ( $more_tax_queries ) : $tax_relation = 'AND'; if ( isset( $original_atts['tax_relation'] ) && in_array( $original_atts['tax_relation'], array( 'AND', 'OR' ), true ) ) { $tax_relation = $original_atts['tax_relation']; } $args['tax_query']['relation'] = $tax_relation; endif; $args = array_merge_recursive( $args, $tax_args ); } // If post parent attribute, set up parent. if ( false !== $post_parent ) { if ( 'current' === $post_parent ) { $post_parent = get_the_ID(); } $args['post_parent'] = (int) $post_parent; } if ( false !== $post_parent__in ) { $args['post_parent__in'] = array_map( 'intval', be_dps_explode( $atts['post_parent__in'] ) ); } if ( false !== $post_parent__not_in ) { $args['post_parent__not_in'] = array_map( 'intval', be_dps_explode( $atts['post_parent__in'] ) ); } // Set up html elements used to wrap the posts. // Default is ul/li, but can also be ol/li and div/div. $wrapper_options = array( 'ul', 'ol', 'div' ); if ( ! in_array( $wrapper, $wrapper_options, true ) ) { $wrapper = 'ul'; } $inner_wrapper = 'div' === $wrapper ? 'div' : 'li'; /** * Filter the arguments passed to WP_Query. * * @since 1.7 * * @param array $args Parsed arguments to pass to WP_Query. * @param array $original_atts Original attributes passed to the shortcode. */ global $dps_listing; $dps_listing = new WP_Query( apply_filters( 'display_posts_shortcode_args', $args, $original_atts ) ); if ( ! $dps_listing->have_posts() ) { /** * Filter content to display if no posts match the current query. * * @since 1.8 * * @param string $no_posts_message Content to display, returned via {@see wpautop()}. */ return apply_filters( 'display_posts_shortcode_no_results', wpautop( $no_posts_message ) ); } $inner = ''; while ( $dps_listing->have_posts() ) : $dps_listing->the_post(); global $post; $image = ''; $date = ''; $author = ''; $excerpt = ''; $content = ''; if ( $include_title && $include_link ) { /** This filter is documented in wp-includes/link-template.php */ $title = '<a class="title" href="' . apply_filters( 'the_permalink', get_permalink() ) . '">' . get_the_title() . '</a>'; } elseif ( $include_title ) { $title = '<span class="title">' . get_the_title() . '</span>'; } else { $title = ''; } if ( $image_size && has_post_thumbnail() && $include_link ) { $image = '<a class="image" href="' . get_permalink() . '">' . get_the_post_thumbnail( get_the_ID(), $image_size ) . '</a> '; } elseif ( $image_size && has_post_thumbnail() ) { $image = '<span class="image">' . get_the_post_thumbnail( get_the_ID(), $image_size ) . '</span> '; } if ( $include_date ) { $date = 'relative' === $date_format ? be_dps_relative_date( get_the_date( 'U' ) ) : get_the_date( $date_format ); } elseif ( $include_date_modified ) { $date = 'relative' === $date_format ? be_dps_relative_date( get_the_modified_time( 'U' ) ) : get_the_modified_date( $date_format ); } if ( ! empty( $date ) ) { $date = ' <span class="date">' . $date . '</span>'; } if ( $include_author ) { /** * Filter the HTML markup to display author information for the current post. * * @since 2.4.0 * * @param string $author_output HTML markup to display author information. */ $author = apply_filters( 'display_posts_shortcode_author', ' <span class="author">by ' . get_the_author() . '</span>', $original_atts ); } if ( $include_excerpt ) { // Custom build excerpt based on shortcode parameters. if ( $excerpt_length || $excerpt_more || $excerpt_more_link ) { $length = $excerpt_length ? $excerpt_length : apply_filters( 'excerpt_length', 55 ); $more = $excerpt_more ? $excerpt_more : apply_filters( 'excerpt_more', '' ); $more = $excerpt_more_link ? ' <a class="excerpt-more" href="' . get_permalink() . '">' . $more . '</a>' : ' <span class="excerpt-more">' . $more . '</span>'; if ( has_excerpt() && apply_filters( 'display_posts_shortcode_full_manual_excerpt', false ) ) { $excerpt = $post->post_excerpt . $more; } elseif ( has_excerpt() ) { $excerpt = wp_trim_words( strip_shortcodes( $post->post_excerpt ), $length ) . $more; } else { $excerpt = wp_trim_words( strip_shortcodes( $post->post_content ), $length ) . $more; } // Use default, can customize with WP filters. } else { $excerpt = get_the_excerpt(); } $excerpt = ' <span class="excerpt">' . $excerpt . '</span>'; if ( $include_excerpt_dash ) { $excerpt = ' <span class="excerpt-dash">-</span>' . $excerpt; } } if ( $include_content ) { add_filter( 'shortcode_atts_display-posts', 'be_display_posts_off', 10, 3 ); /** This filter is documented in wp-includes/post-template.php */ $content = '<div class="' . implode( ' ', $content_class ) . '">' . apply_filters( 'the_content', get_the_content() ) . '</div>'; remove_filter( 'shortcode_atts_display-posts', 'be_display_posts_off', 10, 3 ); } // Display categories the post is in. $category_display_text = ''; if ( $category_display && is_object_in_taxonomy( get_post_type(), $category_display ) ) { $terms = get_the_terms( get_the_ID(), $category_display ); $term_output = array(); if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) { foreach ( $terms as $term ) { $term_output[] = '<a href="' . get_term_link( $term, $category_display ) . '">' . $term->name . '</a>'; } $category_display_text = ' <span class="category-display"><span class="category-display-label">' . $category_label . '</span> ' . implode( ', ', $term_output ) . '</span>'; } /** * Filter the list of categories attached to the current post. * * @since 2.4.2 * * @param string $category_display Current Category Display text */ $category_display_text = apply_filters( 'display_posts_shortcode_category_display', $category_display_text, $terms, $category_display, $original_atts ); } $class = array( 'listing-item' ); /** * Filter the post classes for the inner wrapper element of the current post. * * @since 2.2 * * @param array $class Post classes. * @param WP_Post $post Post object. * @param WP_Query $dps_listing WP_Query object for the posts listing. * @param array $original_atts Original attributes passed to the shortcode. */ $class = array_map( 'sanitize_html_class', apply_filters( 'display_posts_shortcode_post_class', $class, $post, $dps_listing, $original_atts ) ); $output = '<' . $inner_wrapper . ' class="' . implode( ' ', $class ) . '">' . $image . $title . $date . $author . $category_display_text . $excerpt . $content . '</' . $inner_wrapper . '>'; /** * Filter the HTML markup for output via the shortcode. * * @since 0.1.5 * * @param string $output The shortcode's HTML output. * @param array $original_atts Original attributes passed to the shortcode. * @param string $image HTML markup for the post's featured image element. * @param string $title HTML markup for the post's title element. * @param string $date HTML markup for the post's date element. * @param string $excerpt HTML markup for the post's excerpt element. * @param string $inner_wrapper Type of container to use for the post's inner wrapper element. * @param string $content The post's content. * @param string $class Space-separated list of post classes to supply to the $inner_wrapper element. * @param string $author HTML markup for the post's author. * @param string $category_display_text */ $inner .= apply_filters( 'display_posts_shortcode_output', $output, $original_atts, $image, $title, $date, $excerpt, $inner_wrapper, $content, $class, $author, $category_display_text ); endwhile; wp_reset_postdata(); /** * Filter the shortcode output's opening outer wrapper element. * * @since 1.7 * * @param string $wrapper_open HTML markup for the opening outer wrapper element. * @param array $original_atts Original attributes passed to the shortcode. * @param object $dps_listing, WP Query object */ $open = apply_filters( 'display_posts_shortcode_wrapper_open', '<' . $wrapper . $wrapper_class . $wrapper_id . '>', $original_atts, $dps_listing ); /** * Filter the shortcode output's closing outer wrapper element. * * @since 1.7 * * @param string $wrapper_close HTML markup for the closing outer wrapper element. * @param array $original_atts Original attributes passed to the shortcode. * @param object $dps_listing, WP Query object */ $close = apply_filters( 'display_posts_shortcode_wrapper_close', '</' . $wrapper . '>', $original_atts, $dps_listing ); $return = ''; if ( $shortcode_title ) { /** * Filter the shortcode output title tag element. * * @since 2.3 * * @param string $tag Type of element to use for the output title tag. Default 'h2'. * @param array $original_atts Original attributes passed to the shortcode. */ $title_tag = apply_filters( 'display_posts_shortcode_title_tag', 'h2', $original_atts ); $return .= '<' . $title_tag . ' class="display-posts-title">' . $shortcode_title . '</' . $title_tag . '>' . "\n"; } $return .= $open . $inner . $close; return $return; }Code file location:
display-posts-shortcode/display-posts-shortcode/display-posts-shortcode.phpConclusion
Now that you’ve learned how to embed the Display Posts Shortcode Plugin shortcode, understood the parameters, and seen code examples, it’s easy to use and debug any issue that might cause it to ‘not work’. If you still have difficulties with it, don’t hesitate to leave a comment below.
Leave a Reply