Title: List Custom Post with featured image Author: Vikas Sharma Published: فووریه 11, 2017 Last modified: سپتامبر 9, 2026 --- Search plugins ![](https://s.w.org/plugins/geopattern-icon/list-custom-post-with-featured-image. svg) # List Custom Post with featured image By [Vikas Sharma](https://profiles.wordpress.org/devikas301/) [Download](https://downloads.wordpress.org/plugin/list-custom-post-with-featured-image.1.3.0.zip) * [Details](https://azb.wordpress.org/plugins/list-custom-post-with-featured-image/#description) * [Reviews](https://azb.wordpress.org/plugins/list-custom-post-with-featured-image/#reviews) * [Installation](https://azb.wordpress.org/plugins/list-custom-post-with-featured-image/#installation) * [Development](https://azb.wordpress.org/plugins/list-custom-post-with-featured-image/#developers) [Support](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/) ## Description This plugin creates a responsive gallery of any public post type using a shortcode. Each item shows the featured image (or a placeholder when none is set) and the post title, linked to the post. Pagination is optional. **Features** * Works with posts, pages and any public custom post type * Responsive CSS Grid layout: 4 / 3 / 2 / 1 columns as the screen narrows * Optional pagination that works with pretty and plain permalinks * Placeholder image when a post has no featured image * Templates can be overridden from your theme * No jQuery, no external frameworks ### Shortcode ``` [lcpostlist post_type="post" limit="4" order="ASC" pagination="off"] ``` Attributes: * `post_type` – any public post type. Default `post`. * `limit` – posts per page, 1 to 100. `-1` means “as many as possible” and resolves to 100. Default `5`. * `order` – `ASC` or `DESC`. Default `DESC`. * `pagination` – `on` or `off`. Default `on`. In a theme file: ``` ``` ## Screenshots [⌊Gallery page in the front-end.⌉⌊Gallery page in the front-end.⌉[ Gallery page in the front-end. [⌊Showing shortcode on plugin section back-end.⌉⌊Showing shortcode on plugin section back-end.⌉[ Showing shortcode on plugin section back-end. [⌊Using shortcode on back-end & same as its working with phpcode using do_shortcode().⌉⌊ Using shortcode on back-end & same as its working with phpcode using do_shortcode() .⌉[ Using shortcode on back-end & same as its working with phpcode using do_shortcode(). ## Installation Use WordPress Add New Plugin feature, searching “List Custom Post with featured image”, or download the archive and: 1. Unzip the archive on your computer 2. Upload the `list-custom-post-with-featured-image` directory to the `/wp-content/ plugins/` directory 3. Activate the plugin through the ‘Plugins’ menu in WordPress 4. Use the shortcode to show the post gallery anywhere ## FAQ ### How do I change the number of columns? The layout is driven by a CSS custom property. Add this to your theme’s Additional CSS: ``` .lcpfi-post-gallery { --lcpfi-columns: 3; } ``` You can also change `--lcpfi-gap` and `--lcpfi-ratio` the same way. ### How do I change the markup? Copy any file from the plugin’s `templates/` folder into a `lcpfi/` folder in your theme, for example `yourtheme/lcpfi/gallery-item.php`, and edit it there. Your copy survives plugin updates. ### The old uppercase shortcode still works? Yes. `[LCPOSTLIST]` is still registered alongside the new lowercase `[lcpostlist]`. ### Why does my gallery show fewer posts than I asked for? limit is capped at 100 per page to protect the site, and `limit="-1"` resolves to that same cap rather than running an unbounded query. Use pagination for larger sets. ### How do I show a message when there are no posts? Nothing is output by default. To show a message: ``` add_filter( 'lcpfi_no_posts_message', function () { return 'Nothing here yet.'; } ); ``` ## Reviews ![](https://secure.gravatar.com/avatar/9951b8075158948825743d44f46c7108908b0e75a779b553705a51d770dcac91? s=60&d=retro&r=g) ### 󠀁[Just what I needed—no more, no less](https://wordpress.org/support/topic/just-what-i-needed-no-more-no-less/)󠁿 [SomniumLucidus](https://profiles.wordpress.org/somniumlucidus/) آقوست 20, 2023 Sometimes you need something as simple as this. All functionality, no bloat. Edited: By the way, it's working fine with WordPress version 6.3! ![](https://secure.gravatar.com/avatar/d7db0bdb3a37f0ef1c4b3a97f01b71d9d4d6e2cedb7d3de3234ac00546fe55a0? s=60&d=retro&r=g) ### 󠀁[Working fine with 4.8](https://wordpress.org/support/topic/working-fine-with-4-8/)󠁿 [Vikas Sharma](https://profiles.wordpress.org/devikas301/) جولای 20, 2017 I have test this with latest WP version (4.8) and its working fine and easy to customize.. ![](https://secure.gravatar.com/avatar/f9ba1df47a5c7a19a4c90924e261effddc4af56dadc9437409159f0162421393? s=60&d=retro&r=g) ### 󠀁[Great & Simple plugin](https://wordpress.org/support/topic/great-simple-plugin-45/)󠁿 [tgvs3002](https://profiles.wordpress.org/tgvs3002/) فووریه 11, 2017 Great plug-in. Easy to use. Simple code is to customize… [ Read all 3 reviews ](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/) ## Contributors & Developers “List Custom Post with featured image” is open source software. The following people have contributed to this plugin. Contributors * [ Vikas Sharma ](https://profiles.wordpress.org/devikas301/) [Translate “List Custom Post with featured image” into your language.](https://translate.wordpress.org/projects/wp-plugins/list-custom-post-with-featured-image) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/list-custom-post-with-featured-image/), check out the [SVN repository](https://plugins.svn.wordpress.org/list-custom-post-with-featured-image/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/list-custom-post-with-featured-image/) by [RSS](https://plugins.trac.wordpress.org/log/list-custom-post-with-featured-image/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.3.0 * New: plugin dashboard in the admin area, under the “Post Gallery” menu, with an overview, getting started steps, full shortcode reference, changelog and support links. * New: the dashboard lists the post types available on your site, so you always know what to put in the post_type attribute. * New: “Dashboard” link next to Deactivate on the Plugins screen. * Security: escape all output (post titles, permalinks and image attributes). * Security: validate `post_type` against public post types, clamp `limit` to 1- 100 and whitelist `order`. * Security: removed unsanitised `$_SERVER['REQUEST_URI']` parsing, which was also unused. * Security: added a direct file access guard. * Fix: pagination links now build correctly with plain permalinks, query strings and static front pages. * Fix: the gallery no longer renders an empty block when there are no matching posts. Output stays empty as before; use the `lcpfi_no_posts_message` filter to show a message. * Fix: `limit="-1"` still means “show everything”, now resolved to the 100 per page cap. * Fix: removed the invalid `page` query argument and unused globals. * Improved: namespaced CSS. The generic `.row` and Bootstrap `col-md-3` classes are gone, so the plugin no longer collides with theme or page builder grids. * Improved: responsive CSS Grid layout with 4 / 3 / 2 / 1 columns and consistent image aspect ratios. * Improved: the stylesheet is only loaded on pages that use the shortcode, and is versioned for cache busting. The admin stylesheet only loads on the plugin’s own page. * Improved: rewritten as classes with theme-overridable templates in `templates/`. * Improved: lowercase `[lcpostlist]` shortcode added, uppercase `[LCPOSTLIST]` kept for compatibility. * Improved: translation ready, and accessible pagination with a labelled `nav` element. #### 1.2 * Pagination support added to the shortcode. #### 1.1 * Placeholder image for posts without a featured image. #### 1.0 * Initial release. ## Meta * Version **1.3.0** * Last updated **1 آی ago** * Active installations **10+** * WordPress version ** 5.0 or higher ** * Tested up to **7.0.7** * PHP version ** 7.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/list-custom-post-with-featured-image/) * Tags * [custom post type](https://azb.wordpress.org/plugins/tags/custom-post-type/)[featured image](https://azb.wordpress.org/plugins/tags/featured-image/) [pagination](https://azb.wordpress.org/plugins/tags/pagination/)[post grid](https://azb.wordpress.org/plugins/tags/post-grid/) [shortcode](https://azb.wordpress.org/plugins/tags/shortcode/) * [Advanced View](https://azb.wordpress.org/plugins/list-custom-post-with-featured-image/advanced/) ## Ratings 5 out of 5 stars. * [ 3 5-star reviews ](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/reviews/) ## Contributors * [ Vikas Sharma ](https://profiles.wordpress.org/devikas301/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/list-custom-post-with-featured-image/)