1. Documentation
  2. Themes
  3. Listings


Important: This theme was retired in February 2014. It is not for sale, and documentation is no longer being updated.

Theme Overview ↑ Back to top

The Listings theme is one of our most feature rich themes to date.

Where Canvas offers you huge flexibility in terms of design and layout, Listings offers you flexibility in creating custom post types, taxonomies and advanced search facilities. It is the perfect solution for anyone needing to create a directory-based website.

The theme activates a module called the Content Builder where you can create custom post types, taxonomies and custom fields. Before we go any further we strongly recommend you watch the video overview

Installation ↑ Back to top

After installing with Listings theme, go to Settings > Permalinks and click the “Save Changes” button, even if there have been no changes. This registers the custom post types used in the theme.

Also do this if changing the permalink slug or custom post types/taxonomies in the theme options/custom builder. If the page isn’t loading correctly, ensure that you check that the permalink structure has been updated.

Video Overview/Tutorials ↑ Back to top

An Introduction to Listings – Part 1

Listings allows any niche business to create a listings/directory based website, thanks to a Woo-powered content builder for custom post type, taxonomy and custom field generation. The theme showcases listings in a minimalistic style with advanced search capabilities and the ability to upload a listing from the front end.

Theme Options for Listings – Part 2

In this tutorial we go over the unique theme options available to you in our Listings directory based theme. We cover search options, general labels, popular keywords, the listings category panel, featured slider, upload a listing template and Google maps integration.

Listings demo setup ↑ Back to top

For demonstration purposes we used the Listings theme to set up a car sales site, but you can use it for whatever you wish.

After the theme was installed we used the custom post type that Listings install by default. You can create your own custom post type and remove “Listing” if you want. A few tweaks we made:

  • Used the “Listing” post type to create vehicle postings.
  • Labelled “listingtype” – “Make” under the “Custom Taxonomies” section of the “Content Builder”
  • Under “Makes” we added vehicle makers like Audi, BMW, Hyundai, Toyota, etc.
  • Labelled “listingfeatures” – “Vehicle Features” under the “Custom Taxonomies” section of the “Content Builder”
Tweaks we made to the taxonomies after installing Listings and using the Content Builder
The listings page as it looks on our demo after we created some vehicle entries

The content builder ↑ Back to top

Content Builder Video Overview ↑ Back to top

In this tutorial we review the Woo content builder, the backbone of the Listings directory theme. With it we build a band directory site and its corresponding custom post type, taxonomy and custom fields.

Explaining custom post types and taxonomies ↑ Back to top

Often website content doesn’t necessarily fit into the two post types WordPress offers by default – blog posts and pages.

If you want to list books, music, cars, locations, etc on your site it would be better to have another post type dedicated to what you want to list, reserving blog posts for your company/site news and the pages for the static content like “About us”, “Contact Us”, “Services”, etc. That’s where Listings and the content builder comes in handy creating additional custom post types.

The content builder showing the custom post types in use on our demo. Note the CPTs added via the content builder are editable and can be deleted. The core WordPress CPTs cannot though.

You can also create taxonomies. A taxonomy is way of classifying data in WordPress. What this means is that you can better separate your data in both the frontend and backend.  This allows you to manage your data more efficiently and to extend the default usage of WordPress to include new powerful features.

An example: You could create a custom post type called “Books” and then create a taxonomy under that called “Genre” and/or “Authors”, etc. Or you could create a custom post type called “Vehicles” and have taxonomies like “Make” and “Features”. Refer to the theme overview video for more information.

Home page layout ↑ Back to top

The screenshot shows the home page with each of its modules explained.

The Listings Home Page Modules
The Listings home page modules explained

Setting up the featured slider ↑ Back to top

The home page featured slider can be used to display noteworthy blog posts or custom post types.

It is tag based. Once you specify the tag it must loop through to display posts, add that tag to the blog posts/custom post types you want to feature. It displays the title of the post, the excerpt, and the optional but important, custom image that is the focal point.

Featured panel theme options
Remember to tag your posts.

Be sure to add the tag to the post and specify the image to use in the “Listings Custom Settings” panel below the WYSIWYG editor on the Add/Edit post form.

Add your image to display in the featured slider either via the Custom Settings panel, or using the Featured Option sidebar form to select one if you have added your images via the WordPress image uploader.

Widgets ↑ Back to top

There are nine custom widgets you can add to six widgetized areas — one in the primary sidebar, two in the sub-column sidebars and three in the footer.

The custom Woo widgets are:

  • Woo – Tabs
  • Woo – Flickr
  • Woo – Adspace
  • Woo – Address
  • Woo – Overview Map
  • Woo – Embed/Video
  • Woo – Blog Author Info
  • Woo – Twitter Stream
  • Woo – Standard Search

To learn more, see: How to Add Widgets.

WooCommerce - the most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment