Listing Layout 3 Documentation

Layout Demo URL: https://diviwp.com/ui/page-layouts/listing-pages/listing-page-3/

This layout uses a card based design to list rows of content: courses, services or anything you'd like!

It includes 10 versatile and beautifully designed sections you can mix and match to make your own.

Editing the demo content

Each DiviWP Layout can be edited using the Visual Builder. 

You can make your changes to various module settings, upload new images, change colors, toggle between the desktop, tablet and mobile views and publish your page to achieve the look in the demo.

In some sections outlined below, Custom CSS is necessary to achieve a desired affect or an optimal responsive user experience and where the Divi Builder was unable to do it with it's Module settings alone. 

Why Custom CSS is used in Sections

Divi is an incredible builder and you can certainly do a ton of things with its built-in settings. 

We're sure we'll see the introduction of even more new settings in time, but for now, we believe it does not (yet) have the ability to configure the necessary settings to create a particular interface design or effects. 

So by including Custom CSS in a seperate Code Module or labeled within the Row, Column or Module, you can learn how we've used various CSS properties to achieve a desired effect. 

How to view Custom CSS

When you are editing in the Visual Mode and building on the front-end of your website, Custom CSS Code Modules or Custom CSS configured within a Row, Column or Module is not visible.

Accessing the Layer View or Wireframe mode gives you access to your page and section structure, displaying all elements in an organized, nested hierarchy list that clearly showcases your page structure. Learn more about Layer View and Wireframe mode.

Custom CSS in use in this Layout (scroll down for in-depth documentation)

  • Listing Card Sections
    • CSS Code Module - Image Modules
  • Feature Section
    • CSS Code Module - Image Module
  • Contact Section
    • CSS Code Module - Contact Form Module

Related documentation:

Support is always on hand

You can rest assured that support is always on-hand and we'll be able to guide you as far as possible should you require assistance with any custom CSS we have included in our layouts, templates or sections. 


Listing Card Sections - Image Module

Accessing the  Layer View or Wireframe mode gives you access to your page and section structure, displaying all elements in an organized, nested hierarchy list that clearly showcases your page structure.

Let's look at an example via the Layer View ( Learn more about the Layer View here)

For example, the image module, listed in the screenshot above, and labeled "Image .diviwp-listing-height-100 500x500" is describing:

  • An image module
  • With a custom class name diviwp-listing-height-100 (You can view this in Module Settings → Advanced → CSS ID and Classes
  • And with suggested image dimensions of 500x500 (WxH) proportions (these are suggested, you may of course use your own image dimensions)

Above the image module you'll see the Column with an admin label "Column .diviwp-col-flex". This means the column has a custom class applied of diviwp-col-flex. You can view this in  Module Settings → Advanced → CSS ID and Classes 

Above the image module and the column, you'll a see Code Module labeled "CSS Code for .diviwp-listing-height-100 to maintain image 100% height to container row"

The Code Module admin label is describing what the CSS properties within it's module are targeting and describes what it is used for. 

In this case, the code module contains CSS that is targeting the classname .diviwp-listing-height-100 and applying CSS properties to maintain the image height 100% to it's parent column, thereby preserving the "card" design of the row at various responsive breakpoints. 

This same technique is used on the other card sections:


Feature Section - Image Module

In this section, the code module contains CSS that is targeting the classname .diviwp-blurb-14-portrait and applying CSS properties to maintain the image height 100% to it's parent column. The image above demonstrates this in action.

The CSS Code module also contains CSS to that will maintain the image aspect ratio to 16:9 tablet and mobile breakpoints. This enables images to have a smaller height while cropping the image automatically without distorting it. 

The reason this technique is used is to reduce the overall height of the image at tablet and mobile breakpoints. 

Notice how the section below looks correct and easy to digest.

Tablet view

If we didn't use the aspect ratio CSS trick, the image would take up a huge portion of the screen unnecessarily and woudn't feel as polished. Here's an example below:

Tablet view. Notice how much vertical space the image takes up unnecessarily - that's crazy huge! I had to zoom out just to make sense of it! 

A few alternative solutions you might be interested in or want to try yourself:

  • Upload different images for Desktop, Tablet and Mobile views in the builder. 

We don't like this solution because it triples the amount of work you're doing for yourself, having to create the images and then upload them individually for each change. 

  • Duplicate the row and make the "Desktop" row invisible and the "Tablet" row visible.

We don't like how this solution doubles your time to make a change. Any change you make to the first row, you'll have to remember to make for the second. We like striving for a " single source of truth" as far as possible.

  • Use the image as a background image of it's parent column and leave the column empty

The card design in the template is optimised for usability so the ability to click on the image is important. You can't click on background images. 

You might say that you can set the  column to be clickable which would "mimic" the same effect as having a clickable image. This is true and is an alternative option, however, setting the background image in the column is not an intuitive editing experience for users who might be updating the layout on a regular basis. There are also SEO sacrifices such as the background image not being indexed for Google Image.


Contact Section - Contact Form Module

In the layers view, you can see the Custom CSS module which is targeting the Contact Form:

This CSS enables the Contact Form module to format beautifully across various responsive breakpoints.

Tablet view

Mobile view