Using WP Show Posts

Adding post lists and grids to your Site couldn’t be easier than with the WP Show Posts plugin. Dispatch uses the Free version to display posts on the Front page and in the Sidebars. Of course with a little Flint Skin CSS treatment.

Head off to Dashboard > WP Show Posts > All Lists. Within are six lists:

  • Align
  • Standard
  • Sidebar
  • Header
  • Simple
  • Simple Sidebar

Each of them have very particular settings required to match the demo content you see here. Changing those settings may affect the way the post is displayed, and not necessarily for the better. So please work on a duplicate or make a note before changing.

Note: the name of the List has no relevance to the different styles displayed.

General ( and important ) information

Before we go into the detail let’s cover some basic and very important information.

Advanced Settings

For the purpose of the demo content a couple of the Lists are using Advanced Settings. First off the Standard List is using Ascending Order (Default: Descending).  Secondly the Simple List is using Offset, so it omits the first 4 posts. You may want to put these back to default if you’re not intending to replace them.

Duplicating WP Show Posts List

So we have four lists, and we want to make a new Standard list with a different category. The easiest way is to use one of the Duplicate Post plugins in the WordPress repository. Simple hey. And it works for all post types including GP Elements. Awesome. Note: When making a duplicate you are generally given two options. Clone and New Draft. I advise using the New Draft as some people have reported issues when using Clone.


List: Standard

This is the standard WP Show Post list that has the same custom styling applied to the GP Blog:

Keep It Simple

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean gravida mattis turpis sed cursus. Quisque suscipit nisl quis finibus dapibus. Fusce turpis nisi, suscipit ut…

This is how the list is displayed within the Content area just by adding the WP Show Post Shortcode. Here follows the basic styling changes that have been made.

Content Wrap (WPSP Only)

Using a custom Hook Element the Post article content is now wrapped within a DIV container. This container carries a class of wpsp-content-wrap for styling. This wrap is present on all WP Show Posts that are output inside Dispatch.

Featured Image

The featured image has a fixed height to match the layout. This is achieved using this CSS:

.generate-columns-container article .inside-article img,  .wp-show-posts-image img {
    height: 180px;
    width: 100%;
    -o-object-fit: cover !important;
    object-fit: cover !important;

You can edit the height property to suit, or remove the CSS it entirely if you want to use your own sizes.

Meta above title

This is achieved using a flex box on the Entry Header. Again this applied to the GP Blog:

.generate-columns-container article .entry-header, .wp-show-posts-entry-header {
    display: -webkit-box;
    display: -ms-flexbox;
    display: flex;
    -webkit-box-orient: vertical;
    -webkit-box-direction: reverse;
    -ms-flex-direction: column-reverse;
    flex-direction: column-reverse;

Entry Title forced to 2 lines

The entry title always displays a minimum and maximum of 2 lines. This mantains the across row alignment. Again this is applied to GP Blog. The ex unit is used to define the number of lines visible. The lines are set by defining the line-height and setting the height to as many mutiples as you require lines. e.g up the height to 7.5ex will create three lines.

.generate-columns-container article .entry-header .entry-title, .wp-show-posts article .wp-show-posts-entry-title {
    line-height: 2.5ex;
    height: 5ex;
    overflow: hidden;
    text-overflow: ellipsis;


List: Align

Designed for a single column list this displays the content the image to the left and content to the right. This is subtly different to just resizing the image in the WP Show Posts list settings and aligning it left. Thanks to the Content Wrap we added (above) the content will never wrap around the image. On mobile it just stacks.

To add one of these your posts requires a little markup. And is done like so:

<div class="wpsp-align">shortcode_goes_here</div>

A guide to styling and making Dispatch your own

Dispatch is a Magazine style blog for your new website. Each of its features have been designed and built using GeneratePress and WP Show Posts. As expected of a Flint Skin Site it uses Custom CSS. At over 350 lines it is recommended, but not necessary, to move the Additional CSS to a Child Theme…


Lists: Sidebar

In the right had sidebar you can see the Sidebar list. This List is set to 1 column and only displays the Featured Image, Title and Category. This is designed for Widgets, a narrow column or as part of a grid (like in our next List).

To add this style the Widget requires a CSS Class of:


Dispatch comes with Widget Classes Plugin installed. This provides this function.


List: Header

The Header list as seen on the Front Page requires a list containing only 5 posts. And can accomodate most of the content elements. Which are only displayed on the large leader post.

To add this style the Header Element requires the following element classes:

wpsp-grid wpsp-card

List: Simple

This is output using the wpsp-card inserted into a containing DIV like so:

<div class="wpsp-card">shortcode goes here</dib>


List: Simple Sidebar

Nothing fancy here,  just a list being output using the a Widget in the sidebar.



Aside for Widgets

Sidebar Widgets are a main feature of any Magazine Blogging site. To aid with that Dispatch uses a nifty little plugin and a couple of custom CSS classes to make styling your sidebar a breeze.

Widget CSS Classes

Using the namesake plugin you can now add CSS Classes to Widgets. Simple.

Dispatch Widget Classes

CSS Class: zero-padding
Removes the padding from the widget. Perfect for adding those banner ads for maximum space.

CSS Class: no-background
Removes the widget color background that is set in the Customizer.

CSS Class: wpsp-card
Used exclusively with the WP Show Posts Widget and with zero-padding and no-background.
Read more here

Adding your own classes

Want different color background for your widgets. Heres how to. Add you Custom Class Name to your widget. In this example we’ll go for a red color and name our class red-background. Now thats added lets add some CSS. {
    background-color: #ff0000;

Keep It Simple

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean gravida mattis turpis sed cursus. Quisque suscipit nisl quis finibus dapibus. Fusce turpis nisi, suscipit ut velit eu, fringilla fringilla neque. Fusce a bibendum nisi. Donec maximus gravida velit, nec gravida felis molestie id. Proin laoreet urna id mollis lobortis. Sed quis sagittis tortor. Curabitur scelerisque leo in est viverra, vel tincidunt nisl lobortis. Vestibulum in augue eu orci mollis placerat.

Aenean consectetur feugiat iaculis. Proin vitae purus sed mauris mollis tincidunt. Donec posuere pellentesque sem, sed elementum eros placerat vel. Fusce varius congue felis, quis egestas augue pulvinar et. Mauris ut quam velit. Phasellus malesuada dolor sit amet augue sagittis rhoncus. Suspendisse potenti. Donec pellentesque, justo ut efficitur gravida, leo dui dictum lectus, sed laoreet lacus nulla at diam. Aenean lectus urna, tempor et blandit et, eleifend at enim. Nunc sagittis eleifend nulla. Etiam ac metus at turpis placerat maximus. Quisque id magna urna. Integer sit amet nisl nec nunc elementum maximus. Praesent porta augue eget arcu bibendum varius.

Nulla pharetra, massa sed pharetra lacinia, risus metus congue massa, in laoreet turpis eros vitae ante. Praesent vitae justo at felis semper pretium. In in bibendum orci, nec ullamcorper diam. Ut et fermentum tellus. Nulla dictum ultrices quam, sit amet aliquam nulla sollicitudin eget. Vestibulum blandit sagittis massa, at fringilla dolor fermentum non. Aenean eu nibh eu purus aliquet tempor. Aenean eget pulvinar justo, vitae efficitur lacus. Cras consequat ultrices lectus sed euismod. Morbi nec odio iaculis, rutrum tortor vel, pulvinar leo. Donec rutrum sem vitae placerat commodo. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae;

Cras non arcu volutpat, congue dui eget, ornare velit. Donec ac odio nunc. Aliquam erat volutpat. Cras a pulvinar nisl. Cras enim turpis, finibus a nulla sed, pharetra ullamcorper turpis. Sed quam leo, consequat vel dui eu, elementum consectetur enim. Maecenas faucibus ornare malesuada.

An Example Blog Post

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus eu dolor iaculis massa placerat fermentum quis at enim. Mauris tristique ligula tortor, et accumsan felis porta varius. Aliquam erat volutpat. Maecenas eget mauris sed mi maximus pharetra non eu mauris. Nullam finibus ante sed elit facilisis, sed sodales magna dapibus. Maecenas pulvinar, justo vel laoreet pulvinar, libero lacus scelerisque tortor, et auctor nisi dui a libero. Nam ac hendrerit urna. Nam condimentum tempus nunc in porttitor. Nullam faucibus nisi vitae urna ornare, vitae ultrices tellus fermentum. Mauris erat magna, efficitur id nibh vel, interdum pellentesque tortor. Sed tincidunt interdum arcu, eget mollis leo lobortis ut. In a convallis purus. Morbi suscipit est erat, at aliquet leo ultricies nec. Suspendisse iaculis dictum dolor, at maximus est ullamcorper ac. Donec dictum odio id ex vulputate consequat.

Nam rutrum eu neque vulputate tempor. Aliquam dapibus convallis nisi sit amet pellentesque. Cras tincidunt, leo quis bibendum volutpat, erat ipsum posuere tortor, nec dignissim lacus turpis pellentesque justo. Fusce nec ipsum vitae orci gravida iaculis. Nulla ultricies odio ultricies, mollis sem vitae, molestie risus. Interdum et malesuada fames ac ante ipsum primis in faucibus. Pellentesque et mauris ornare, ultrices erat ut, euismod augue. Interdum et malesuada fames ac ante ipsum primis in faucibus. Suspendisse aliquam, sapien non luctus placerat, nisi enim rhoncus dui, in ultrices nibh dolor in metus. Aliquam erat volutpat.

Proin id tellus in mi mollis eleifend non vel magna. Vestibulum sed libero vitae justo feugiat maximus vitae ut ante. Fusce ornare diam sed metus malesuada convallis. Vivamus semper, felis quis malesuada mollis, est purus finibus felis, id faucibus enim nulla vitae ligula. Donec consequat nisl sed turpis luctus, eu egestas orci aliquet. Vivamus eu sapien ex. Pellentesque sit amet elit molestie, tincidunt mi eget, condimentum sapien. Vestibulum suscipit fermentum ligula, in condimentum risus semper varius. Nam eleifend tempor ante, vel porta quam porta et. Ut commodo lorem neque, ut volutpat dui mattis ut. Pellentesque porta magna ut magna dapibus, vitae faucibus turpis hendrerit. Phasellus consequat mauris non posuere volutpat. Suspendisse sed nulla vestibulum erat porta vulputate. Aliquam commodo, sem cursus laoreet consectetur, eros diam vestibulum mi, quis pellentesque diam purus gravida eros. Quisque aliquet metus massa, id auctor tortor tempus a.