Title: Custom Query Shortcode Author: Peter Hebert Published: 22 septembre 2015 Last modified: 22 août 2025 --- Recherche d’extensions ![](https://s.w.org/plugins/geopattern-icon/custom-query-shortcode.svg) # Custom Query Shortcode Par [Peter Hebert](https://profiles.wordpress.org/peterhebert/) [Télécharger](https://downloads.wordpress.org/plugin/custom-query-shortcode.0.5.0.zip) * [Détails](https://fr.wordpress.org/plugins/custom-query-shortcode/#description) * [Avis](https://fr.wordpress.org/plugins/custom-query-shortcode/#reviews) * [Installation](https://fr.wordpress.org/plugins/custom-query-shortcode/#installation) * [Développement](https://fr.wordpress.org/plugins/custom-query-shortcode/#developers) [Support](https://wordpress.org/support/plugin/custom-query-shortcode/) ## Description This plugin gives you `[query]` shortcode which enables you to query and output any posts filtered by specific attributes. #### Usage You can use most parameters supported by [WP_Query class](https://codex.wordpress.org/Class_Reference/WP_Query) to filter the posts; you can query for specific post types, categories, tags, authors, etc. #### Other supported parameters Aside from WP_Query parameters, the shortcode also supports the following 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](https://codex.wordpress.org/Function_Reference/add_image_size#Reserved_Image_Size_Names) 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. * _lens_: custom output template – see description below. * _twig\_template_: output template using Twig templating engine – requires the Timber library. #### Formatting the output You can define how you want to format the output inline within an opening `[query]` and closing `[/query]` tag. Available keywords are: TITLE, CONTENT, AUTHOR, AUTHOR_URL, DATE, THUMBNAIL, CONTENT, COMMENT_COUNT. The following example will display the latest 5 posts from the category with the ID of 3, showing a post title and comment count, with a link to the post: [query posts_per_page= »5″ cat= »3″] ### 󠀁[{TITLE} ({COMMENT_COUNT})](https://fr.wordpress.org/plugins/custom-query-shortcode/{URL}?output_format=md)󠁿 [/query] Grid display With the « cols » parameter you can display the output in a grid. [query posts_per_page = »3″ cols= »3″] {THUMBNAIL} ### {TITLE} {CONTENT} [/query] will display the latest 3 posts in the defined template, in 3 columns. The plugin will automatically divide the grid into rows based upon the‘ posts_per_page’ option, divided by the ‘cols’ option. #### Lenses (output templates) With the « lens » parameter you can customize the display of the query results using a template. Some basic lenses/templates are provided: * **ul**: unordered list of linked post titles. * **ul-title-date**: same as ‘ul’, but also displays the posted date. * **article-excerpt**: series of articles, with a header containing the linked post title, and the excerpt. * **article-excerpt-date**: same as ‘article-excerpt’, but also displays the posted date. * **cards**: displays the post thumb above the header with linked post title, followed by the excerpt. Bootstrap lenses Some pre-defined lenses/templates are provided which use JavaScript Components from the [Bootstrap](http://getbootstrap.com/) CSS framework. The generated markup is compliant with the 5.x version of Bootstrap. This feature relies on Bootstrap library to be already loaded on the page, the plugin does _not_ include it. If you’re using a Bootstrap-based theme, this _should_ work; otherwise you can use the [Bootstrap plugin](https://wordpress.org/extend/plugins/bootstrap/)). [Tabs](http://getbootstrap.com/javascript/#tabs) This will show the latest 3 posts in a tabbed widget. [query posts_per_page= »3″ lens= »tabs »] [Accordion](http://getbootstrap.com/javascript/#tabs) This will create an accordion widget of all our posts from the « faq » post type. [ query posts_per_page= »0″ post_type= »faq » lens= »accordion »] [Carousel](http://getbootstrap.com/javascript/#carousel) This creates a carousel of latest five featured posts: [query posts_per_page= » 5″ featured= »true » lens= »carousel »] Custom Lenses/templates You can create your own custom templates and put them into one of these pre-defined folder names within your theme: * ‘query-shortcode-templates’ * ‘partials/query-shortcode-lenses/’ * ‘html/lenses/’ Or simply specify your own subfolder in the ‘lens’ parameter: [query lens= »folder/ template-name »] #### Twig Template Support Starting with version 0.4, you can use Twig templates for your output. Support for Twig is provided by the [Timber](https://github.com/timber/timber) library. This requires that Timber 2.x be installed as a [Composer dependency](https://timber.github.io/docs/v2/installation/installation/). To use a Twig template for your query output, simply use the 'twig_template' parameter instead of the 'lens' parameter, and provide the path to your template. By default, Timber looks within the `views` folder in your active theme. You can [change the default template location](https://timber.github.io/docs/v2/guides/template-locations/#changing-the-default-folder-for-twig-files) in Timber. Examples: ``` [query twig_template="template-name.twig"] [query twig_template="folder/template-name.twig"] ``` ## Captures d’écrans * [[ * Example of shortcode syntax ## Installation 1. Upload the whole plugin directory to the `/wp-content/plugins/` directory 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. Now use `[query]` shortcode anywhere you want. 4. Enjoy! ## FAQ no questions have been asked yet. ## Avis ![](https://secure.gravatar.com/avatar/bb5acc7c7e238d6c7b86dd8887a2d3ec53d6448b96ebb838d5b6ec6f86587c8d? s=60&d=retro&r=g) ### 󠀁[Simple and nice](https://wordpress.org/support/topic/simple-and-nice-50/)󠁿 [ibes](https://profiles.wordpress.org/ib4s/) 15 septembre 2017 Nice Plugin to have simple and useful shortcodes to present content. Super helpful to be able to use custom templates. I would like to have a way to give data to the templates. For example a class that should be added for this one. [ Lire l’avis ](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/) ## Contributeurs/contributrices & développeurs/développeuses « Custom Query Shortcode » est un logiciel libre. Les personnes suivantes ont contribué à cette extension. Contributeurs * [ Peter Hebert ](https://profiles.wordpress.org/peterhebert/) * [ shazdeh ](https://profiles.wordpress.org/shazdeh/) [Traduisez « Custom Query Shortcode » dans votre langue.](https://translate.wordpress.org/projects/wp-plugins/custom-query-shortcode) ### Le développement vous intéresse ? [Parcourir le code](https://plugins.trac.wordpress.org/browser/custom-query-shortcode/), consulter le [SVN dépôt](https://plugins.svn.wordpress.org/custom-query-shortcode/), ou s’inscrire au [journal de développement](https://plugins.trac.wordpress.org/log/custom-query-shortcode/) par [RSS](https://plugins.trac.wordpress.org/log/custom-query-shortcode/?limit=100&mode=stop_on_copy&format=rss). ## Journal des modifications #### 0.5.0 * Security release – fixes to address path traversal vulnerability as noted in CVE-2025-8562. * Added localization template .pot #### 0.4.0 * Added Twig templating support via the Timber Library – note we do not include Timber with this plugin. #### 0.3 * Added a new directory to search for lenses within the current theme – ‘query- shortcode-templates’ * Revamped readme.txt documentation #### 0.2.5 * Changed lens ‘ul’, removing post date. I also added lens ‘ul-title-date’, which is the equivalent of the previous ‘ul’ lens. #### 0.2.4 * Added lens ‘ul’, presenting an unordered list of query results with post date displayed. #### 0.2.3 * Added lens ‘article-excerpt-date’, which is the same as ‘article-excerpt’, except with the post date displayed. #### 0.2.2 * Added a filter to allow shortcodes within widget areas, which makes this plugin a lot more useful. #### 0.2.1.1 * Added a second directory to search for lenses within the current theme – ‘partials/ custom-query-lenses’. #### 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. ## Méta * Version **0.5.0** * Dernière mise à jour **il y a 8 mois** * Installations actives **20+** * Version de WordPress ** 3.3 ou plus ** * Testé jusqu’à **6.8.5** * Langue * [English (US)](https://wordpress.org/plugins/custom-query-shortcode/) * Étiquettes * [post](https://fr.wordpress.org/plugins/tags/post/)[query](https://fr.wordpress.org/plugins/tags/query/) [shortcode](https://fr.wordpress.org/plugins/tags/shortcode/) * [Vue avancée](https://fr.wordpress.org/plugins/custom-query-shortcode/advanced/) ## Évaluations 5 sur 5 étoiles. * [ 1 avis à 5 étoile ](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/?filter=5) * [ 0 avis à 4 étoile ](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/?filter=4) * [ 0 avis à 3 étoile ](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/?filter=3) * [ 0 avis à 2 étoile ](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/?filter=2) * [ 0 avis à 1 étoile ](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/#new-post) [Voir tous les avis](https://wordpress.org/support/plugin/custom-query-shortcode/reviews/) ## Contributeurs * [ Peter Hebert ](https://profiles.wordpress.org/peterhebert/) * [ shazdeh ](https://profiles.wordpress.org/shazdeh/) ## Support Quelque chose à dire ? Besoin d’aide ? [Voir le forum de support](https://wordpress.org/support/plugin/custom-query-shortcode/)