Description
Provides a [moka-get-posts] shortcode for displaying posts or pages using the get_posts function. The shortcode accepts most parameters that you can pass to the get_posts() function. Additional arguments are: show_fields=”post_content,post_excerpt,post_thumbnail” (use post properties; additional fields include post_thumbnail and post_permalink), thumbnail_size=”large” (default: “thumbnail” to set post_thumbnail size), and permalink_title (default: “true” to wrap title in permalink). To show posts or pages, add [get-posts category=”NN”] in the page or post body. To get pages, use the post_type parameter, e.g., [moka-get-posts post_type=”page”]. You can also pass a template using shortcode content. Use the %post_title% format to have fields substituted. Substitution fields most be listed in the “show_fields” argument.
Note: unlike the get_posts function, this shortcode defaults to 99 items. Override using the numberposts attribute.
Please Note
The default values are the same as for the get_posts()
function (https://codex.wordpress.org/Template_Tags/get_posts) with the following exceptions:
Standard Attributes
‘numberposts’ => -1,
‘orderby’ => ‘post_date’,
‘order’ => ‘DESC’,
‘post_type’ => ‘post’,
‘post_parent’ => ”,
Note: ‘post_parent’ also supports a non-standard “this” value, which will use the current post or page as its argument.
Non-Standard Attributes
‘show_fields’ => ‘post_title’,
Selects fields to include in output. By default, post_title is shown. Other options are: post_excerpt, post_content, post_thumbnail, post_permalink
‘thumbnail_size’ => ‘thumbnail’,
If ‘post_thumbnail’ is used in ‘show_fields’, this will determine the size of the thumbnail.
‘permalink_title’ => ‘true’,
If true, wrap post_title with post_permalink.
‘class_name’ => ‘get-posts’,
Can use an alternate classname for the wrapping div. Use if a template is not provided.
Installation
- Download and unzip the most recent version of this plugin
- Upload the show-menu-shortcode folder to /path-to-wordpress/wp-content/plugins/
- Login to your WP Admin panel, click Plugins, and activate “Show Aposts Shortcode”
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Moka Get Posts Shortcode” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Moka Get Posts Shortcode” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0
- First release.