Display Terms Shortcode

plugin banner

Display a listing of terms using the [display-terms] shortcode

Author:SEO Themes (profile at wordpress.org)
WordPress version required:4.9.1
WordPress version tested:5.2.2
Plugin version:1.0.4
Added to WordPress repository:09-08-2017
Last updated:11-08-2019
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:100
Rated by:1
Plugin URI:https://github.com/seothemes/display-terms-sh...
Total downloads:1 173
Active installs:40+
plugin download
Click to start download

The Display Terms Shortcode was written to allow users to easily display listings of terms without knowing PHP or editing template files.

Add the shortcode in a post, page or widget and use the arguments to query based on tag, category, post type, and many other possibilities. You can also customize the output with parameters like: include, child_of, and show_image.

To use the shortcode, simply place the [display-terms] shortcode in any post, page or widget and change the parameters to your liking.

Available parameters (and defaults):

  • taxonomy => ‘category’
  • orderby => ‘name’
  • order => ‘ASC’
  • hide_empty => true
  • include => ‘all’
  • exclude => ‘all’
  • exclude_tree => ‘all’
  • number => false
  • offset => ”
  • fields => ‘all’
  • name => ”
  • slug => ”
  • hierarchical => true
  • search => ”
  • name__like => ”
  • description__like => ”
  • pad_counts => false
  • get => ”
  • child_of => false
  • childless => false
  • cache_domain => ‘core’
  • update_term_meta_cache => true
  • meta_query => ”
  • meta_key => array()
  • meta_value => ”
  • show_link => true
  • show_name => true
  • show_description => false
  • show_count => false
  • show_image => true
  • image_size => ‘full’
  • post_type => ‘post’,
  • post_include => [],
  • post_exclude => [],
  • post_order => ‘DESC’,
  • post_orderby => ‘modified’,
  • number_to_search => 10,
  • parent_element => ‘ul’,
  • child_element => ‘li’,
  • class_prefix => ‘terms’,

Available filters

Every line of output in this plugin runs through a filter.

display_terms_shortcode_open
display_terms_shortcode_inner_open
display_terms_shortcode_link_open
display_terms_shortcode_name
display_terms_shortcode_description
display_terms_shortcode_count
display_terms_shortcode_latest
display_terms_shortcode_image_id
display_terms_shortcode_image
display_terms_shortcode_link_close
display_terms_shortcode_inner_close
display_terms_shortcode_close
display_terms_shortcode_output

Featured images

If the show_image parameter is set to true, the shortcode will look for the featured image of the latest post in the term. You can change the size of the featured image with the image_size attribute.

Contributing

Feature suggestions and pull requests are welcome at this plugins Github repository – https://github.com/seothemes/display-terms-shortcode/

Before submitting a pull request please run translations using the following command (wp cli required):

wp i18n make-pot ./ ./languages/display-terms-shortcode.pot

ChangeLog