{"id":72965,"date":"2017-08-09T01:10:02","date_gmt":"2017-08-09T01:10:02","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/display-terms-shortcode\/"},"modified":"2019-08-11T10:17:50","modified_gmt":"2019-08-11T10:17:50","slug":"display-terms-shortcode","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/display-terms-shortcode\/","author":15246076,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.4","stable_tag":"trunk","tested":"5.2.24","requires":"4.9.1","requires_php":"","requires_plugins":"","header_name":"Display Terms Shortcode","header_author":"SEO Themes","header_description":"Display a list of terms using the [display-terms] shortcode.","assets_banners_color":"5f84e8","last_updated":"2019-08-11 10:17:50","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/seothemes.com\/","header_plugin_uri":"https:\/\/github.com\/seothemes\/display-terms-shortcode\/","header_author_uri":"https:\/\/seothemes.com\/","rating":5,"author_block_rating":0,"active_installs":20,"downloads":1482,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"2136700","resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"2136700","resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":"2136700","resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":"2136700","resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[610,245,80,609,1901],"plugin_category":[43,57],"plugin_contributors":[139207],"plugin_business_model":[],"class_list":["post-72965","plugin","type-plugin","status-closed","hentry","plugin_tags-categories","plugin_tags-list","plugin_tags-shortcode","plugin_tags-tags","plugin_tags-terms","plugin_category-customization","plugin_category-taxonomy","plugin_contributors-seothemes","plugin_committers-seothemes"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/display-terms-shortcode_5f84e8.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>The Display Terms Shortcode was written to allow users to easily display listings of terms without knowing PHP or editing template files.<\/p>\n\n<p>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.<\/p>\n\n<p>To use the shortcode, simply place the <code>[display-terms]<\/code> shortcode in any post, page or widget and change the parameters to your liking.<\/p>\n\n<h4>Available parameters (and defaults):<\/h4>\n\n<ul>\n<li>taxonomy               =&gt; 'category'<\/li>\n<li>orderby                =&gt; 'name'<\/li>\n<li>order                  =&gt; 'ASC'<\/li>\n<li>hide_empty             =&gt; true<\/li>\n<li>include                =&gt; 'all'<\/li>\n<li>exclude                =&gt; 'all'<\/li>\n<li>exclude_tree           =&gt; 'all'<\/li>\n<li>number                 =&gt; false<\/li>\n<li>offset                 =&gt; ''<\/li>\n<li>fields                 =&gt; 'all'<\/li>\n<li>name                   =&gt; ''<\/li>\n<li>slug                   =&gt; ''<\/li>\n<li>hierarchical           =&gt; true<\/li>\n<li>search                 =&gt; ''<\/li>\n<li>name__like             =&gt; ''<\/li>\n<li>description__like      =&gt; ''<\/li>\n<li>pad_counts             =&gt; false<\/li>\n<li>get                    =&gt; ''<\/li>\n<li>child_of               =&gt; false<\/li>\n<li>childless              =&gt; false<\/li>\n<li>cache_domain           =&gt; 'core'<\/li>\n<li>update_term_meta_cache =&gt; true<\/li>\n<li>meta_query             =&gt; ''<\/li>\n<li>meta_key               =&gt; array()<\/li>\n<li>meta_value             =&gt; ''<\/li>\n<li>show_link              =&gt; true<\/li>\n<li>show_name              =&gt; true<\/li>\n<li>show_description       =&gt; false<\/li>\n<li>show_count             =&gt; false<\/li>\n<li>show_image             =&gt; true<\/li>\n<li>image_size             =&gt; 'full'<\/li>\n<li>post_type              =&gt; 'post',<\/li>\n<li>post_include           =&gt; [],<\/li>\n<li>post_exclude           =&gt; [],<\/li>\n<li>post_order             =&gt; 'DESC',<\/li>\n<li>post_orderby           =&gt; 'modified',<\/li>\n<li>number_to_search       =&gt; 10,<\/li>\n<li>parent_element         =&gt; 'ul',<\/li>\n<li>child_element          =&gt; 'li',<\/li>\n<li>class_prefix           =&gt; 'terms',<\/li>\n<\/ul>\n\n<h4>Available filters<\/h4>\n\n<p>Every line of output in this plugin runs through a filter.<\/p>\n\n<pre><code>display_terms_shortcode_open\ndisplay_terms_shortcode_inner_open\ndisplay_terms_shortcode_link_open\ndisplay_terms_shortcode_name\ndisplay_terms_shortcode_description\ndisplay_terms_shortcode_count\ndisplay_terms_shortcode_latest\ndisplay_terms_shortcode_image_id\ndisplay_terms_shortcode_image\ndisplay_terms_shortcode_link_close\ndisplay_terms_shortcode_inner_close\ndisplay_terms_shortcode_close\ndisplay_terms_shortcode_output\n<\/code><\/pre>\n\n<h4>Featured images<\/h4>\n\n<p>If the <code>show_image<\/code> parameter is set to <code>true<\/code>, 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 <code>image_size<\/code> attribute.<\/p>\n\n<h3>Contributing<\/h3>\n\n<p>Feature suggestions and pull requests are welcome at this plugins Github repository - https:\/\/github.com\/seothemes\/display-terms-shortcode\/<\/p>\n\n<p>Before submitting a pull request please run translations using the following command (wp cli required):<\/p>\n\n<pre><code>wp i18n make-pot .\/ .\/languages\/display-terms-shortcode.pot\n<\/code><\/pre>\n\n<!--section=installation-->\n<p>Automatic Plugin Installation<\/p>\n\n<ol>\n<li>Go to Plugins &gt; Add New.<\/li>\n<li>Type in the name of the WordPress Plugin or descriptive keyword, author, or tag in Search Plugins box or click a tag link below the screen.<\/li>\n<li>Find the WordPress Plugin you wish to install.<\/li>\n<li>Click Details for more information about the Plugin and instructions you may wish to print or save to help setup the Plugin.<\/li>\n<li>Click Install Now to install the WordPress Plugin.<\/li>\n<li>The resulting installation screen will list the installation as successful or note any problems during the install.<\/li>\n<li>If successful, click Activate Plugin to activate it, or Return to Plugin Installer for further actions.<\/li>\n<\/ol>\n\n<p>Manual Plugin Installation<\/p>\n\n<ol>\n<li>Download your WordPress Plugin to your desktop.<\/li>\n<li>If downloaded as a zip archive, extract the Plugin folder to your desktop.<\/li>\n<li>Read through the &#092;\\\"readme&#092;\\\" file thoroughly to ensure you follow the installation instructions.<\/li>\n<li>With your FTP program, upload the Plugin folder to the wp-content\/plugins folder in your WordPress directory online.<\/li>\n<li>Go to Plugins screen and find the newly uploaded Plugin in the list.<\/li>\n<li>Click Activate to activate it.<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>2019\/08\/11 - 1.0.4<\/h4>\n\n<ul>\n<li>Filter all the things!<\/li>\n<\/ul>\n\n<h4>2019\/08\/11 - 1.0.3<\/h4>\n\n<ul>\n<li>Added class_prefix parameter.<\/li>\n<li>Added pot file for translation.<\/li>\n<li>Removed child_class parameter.<\/li>\n<li>Removed parent_class parameter.<\/li>\n<\/ul>\n\n<h4>2019\/08\/09 - 1.0.2<\/h4>\n\n<ul>\n<li>Added tax_query parameter.<\/li>\n<\/ul>\n\n<h4>2019\/08\/09 - 1.0.1<\/h4>\n\n<ul>\n<li>Add ability to choose post type to retrieve image from.<\/li>\n<li>Add other get_posts parameters.<\/li>\n<\/ul>\n\n<h4>2019\/08\/09 - 1.0.0<\/h4>\n\n<ul>\n<li>Plugin overhaul.<\/li>\n<li>Added more parameters and filters.<\/li>\n<li>Removed heavy function.<\/li>\n<\/ul>\n\n<h4>2017\/08\/09 - 0.1.1<\/h4>\n\n<ul>\n<li>Plugin clean up.<\/li>\n<\/ul>\n\n<h4>2017\/08\/08 - 0.1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Display a listing of terms using the [display-terms] shortcode","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/72965","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=72965"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/seothemes"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=72965"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=72965"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=72965"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=72965"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=72965"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=72965"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}