Listing Layout 1 Documentation

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

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 Section
- CSS Code Module - Image Modules
Card Section
- CSS Code Module - Image Modules
Newsletter Section
- CSS Code Module - Email Optin Module

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 and Card Sections

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)

Note: Each module starts with what it is and then describes the html hierarchy of the elements in use.

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 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.

Here's the result of the design at various breakpoints with the CSS applied:

Notice how the image maintains it's proportional height to the card row and also crops to a perspective that maintains an aspect ratio of 16:9. This allows any image to be uploaded and dynamically resized correctly to the fill the correct height proportionately.

Note: This does not produce a new image file, it merely uses an aspect-ratio friendly CSS trick at tablet and mobile breakpoints.

This same technique is used for the instructor card:

What if I don't want to use any Custom CSS?

You may remove any Custom CSS module within the layout by simply deleting the code module or by going into the Row, Column or Module Settings → Advanced → Custom CSS and removing it.

This may result in a sub-optimal user experience as the design may not look as polished across mobile, tablet and desktop screen sizes.

Here are a few use-cases using the example above:

In the example above, a larger sized image is used (400x400) and because the image needs to retain it's original proportions it results in white-space below the image (the setting "Show Space Below The Image" in the image module is toggled off).

Notice how the space below the image doesn't make the card design feel "polished".

Here's the same row in tablet view.

Notice how much vertical space the image takes up unnecessarily - that's crazy huge! I had to zoom out 50% 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.