Descripción
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
Instalación
Automatic Plugin Installation
- Go to Plugins > Add New.
- 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.
- Find the WordPress Plugin you wish to install.
- Click Details for more information about the Plugin and instructions you may wish to print or save to help setup the Plugin.
- Click Install Now to install the WordPress Plugin.
- The resulting installation screen will list the installation as successful or note any problems during the install.
- If successful, click Activate Plugin to activate it, or Return to Plugin Installer for further actions.
Manual Plugin Installation
- Download your WordPress Plugin to your desktop.
- If downloaded as a zip archive, extract the Plugin folder to your desktop.
- Read through the \\”readme\\” file thoroughly to ensure you follow the installation instructions.
- With your FTP program, upload the Plugin folder to the wp-content/plugins folder in your WordPress directory online.
- Go to Plugins screen and find the newly uploaded Plugin in the list.
- Click Activate to activate it.
Colaboradores y desarrolladores
Este software es de código abierto. Las siguientes personas han contribuido a este plugin.
ColaboradoresTraduce “Display Terms Shortcode” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
2019/08/11 – 1.0.4
- Filter all the things!
2019/08/11 – 1.0.3
- Added class_prefix parameter.
- Added pot file for translation.
- Removed child_class parameter.
- Removed parent_class parameter.
2019/08/09 – 1.0.2
- Added tax_query parameter.
2019/08/09 – 1.0.1
- Add ability to choose post type to retrieve image from.
- Add other get_posts parameters.
2019/08/09 – 1.0.0
- Plugin overhaul.
- Added more parameters and filters.
- Removed heavy function.
2017/08/09 – 0.1.1
- Plugin clean up.
2017/08/08 – 0.1.0
- Initial release.