A simple shortcode that enables you to query anything you want and display it however you like.
| Author: | Hassan Derakhshandeh (profile at wordpress.org) |
| WordPress version required: | 3.3 |
| WordPress version tested: | 3.6.1 |
| Plugin version: | 0.2.1 |
| Added to WordPress repository: | 15-01-2013 |
| Last updated: | 27-04-2013
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: | 5 |
| Plugin URI: | |
| Total downloads: | 2 419 |
| Active installs: | 40+ |
 Click to start download |
|
This plugin gives you [query] shortcode which enables you to output posts filtered by specific attributes. You can format the output to your liking and even display the results in a grid of customizable columns and rows.
Also supports “lenses” which can turn your query results into Tabs, Accordion, or Carousel widgets. This feature relies on Bootstrap library to be already loaded on the page, the plugin does not include it (for that you can use the Bootstrap plugin). You can create new lenses or override the built-in ones in your theme to customize the output.
Usage
You can use all parameters supported by WP_Query class to filter the posts; you can query for specific post types, categories, tags, authors, etc. You also have to define how you want to format the output:
[query posts_per_page=”5″ cat=”3″]
{TITLE} ({COMMENT_COUNT})
[/query]
The above shortcode will display the title of the latest 5 posts from the category with the ID of 3. Available keywords are: TITLE, CONTENT, AUTHOR, AUTHOR_URL, DATE, THUMBNAIL, CONTENT, COMMENT_COUNT and more to be added later.
Grid display
With the “cols” parameter you can display the output in a grid. So this:
[query posts_per_page=”3″ cols=”3″] {THUMBNAIL}
{TITLE}
{CONTENT} [/query]
will display the latest 3 posts in the defined template, in 3 columns. If in the above snippet we set the posts_per_page option to 6, it will display the latest 6 posts in two rows that each has 3 columns.
Lenses
With the “lens” parameter you can display the query results in a Tab, Accordion, or Carousel widget. Example:
[query posts_per_page=”0″ post_type=”faq” lens=”accordion”]
This will create an accordion widget of all our posts from the “faq” post type. This creates a carousel of latest five featured posts:
[query posts_per_page=”5″ featured=”true” lens=”carousel”]
Other supported parameters
Aside from wp_query parameters, the shortcode also supports additional parameters:
- featured : to query for sticky posts which by default are excluded from the query.
- thumbnail_size : to specify the size of the {THUMBNAIL} images. You can use built-in image sizes or custom ones you’ve defined.
- content_limit : to limit the number of words of the {CONTENT} var; by default it’s “0” which means it outputs the whole content.
- posts_separator : text to display between individual posts.