Description
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.
Installation
- Upload the whole plugin directory to the
/wp-content/plugins/
directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Now use
[query]
shortcode anywhere you want. - Enjoy!= 0.2.1 =
* Added posts_separator parameter.
0.2
- Added Lens functionality. Now you can build tabs, accordions, and carousels (and build custom ones) out of queried posts. Relies on Twitter Bootstrap framework.
Reviews
There are no reviews for this plugin.
Contributors and Developers
“Query Shortcode” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Query Shortcode” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.