Skip to content
RT-Theme 19 WordPress Theme

Products List / Post

A product showcase is made of products. You can group the products by category and show them on an overview page, the product showcase. You manage the products under Product Showcase in the WordPress admin. This is the theme’s own catalogue, separate from WooCommerce.

The Product Showcase screen in the admin, with arrows to the Product Showcase menu, the Add New link and the Add New button

The Product Showcase post type comes with the RT-Theme 19 Extensions plugin, so keep that plugin active.

  • A product can have a featured image and more images that appear as a product image gallery.

  • You can change the global product layout on a single product to give it a different look.

  • Every product needs at least one category.

  • To add a featured image, click Set featured image in the Featured Image box.

    The Featured Image box in the editor with the Set featured image link

  • To add gallery images, click Add New Images in the Image Gallery box.

    The Image Gallery box in the editor with the Add New Images button

  • A product has its own RT-Theme 19 Product Options that only this post type has:

    The RT-Theme 19 Product Options box with the Product Info, Free Tab 1 to 4, Related Products and Attached Documents tabs

    • Product Info: SKU or article number, price, sale price and short description.
    • Four Free Tabs. Each has its own title, icon and content: HTML, shortcodes or even a contact form.
    • Related Products: choose any number of related products to show with this product.
    • Attached Documents: add documents, spreadsheets, PDFs, manuals and other files to a product.

To set up a products listing page:

  1. Create your products.
  2. Create a page.
  3. Add the product shortcode to the page, or add the Product Showcase element with WPBakery Page Builder.

Go to Pages › Add New and create the page that will hold the product showcase.

The Pages screen with the Add New button for creating a new page

Adding the Product Showcase element (WPBakery Page Builder)

Section titled “Adding the Product Showcase element (WPBakery Page Builder)”
  1. In WPBakery Page Builder, click Add element (the + sign).

    The empty WPBakery Page Builder editor with arrows to the + icon and the Add element button

  2. Choose Product Showcase.

    The Add Element window in WPBakery Page Builder with the Product Showcase element marked

  3. A window opens with all the settings of the element.

    The Product Showcase element settings window in WPBakery Page Builder

  4. Adjust the settings. You can always edit them later if you don’t like the result.

  5. Click Save changes in the window. The page editor now shows the element:

    The Product Showcase element placed in the page in the WPBakery Page Builder editor

Adding the product showcase with a shortcode

Section titled “Adding the product showcase with a shortcode”

Click Shortcodes in the admin bar, or the shortcode icon in the Classic Editor toolbar. In the Theme Shortcodes window, select Product Posts, adjust the example to your needs, and copy and paste the shortcode into the page where you want the showcase to appear. The numbers below match the screenshot.

The Theme Shortcodes window: the Shortcodes button (1), Product Posts in the list (2), the example shortcode (3) and the parameter explanations (4)

  1. The Shortcodes button.
  2. The Product Posts (showcase) shortcode.
  3. The example shortcode. Adjust it, then copy and paste it into the page content.
  4. The explanation of each parameter. Use it to adjust the parameters in the example from step 3.

In the page, the shortcode can look like this:

The product showcase shortcode pasted into the content of the page

If the page needs a look that differs from your Customizer settings, change its Design Options. View the abilities of the Design Options

When you are done, click Publish and view the page on your site. It might look like this:

A finished product showcase page on the site

Add your products with the Product Showcase post type:

  1. In the WordPress admin, go to Product Showcase.
  2. Click Add New in the menu, or the Add New button at the top of the list.

The Product Showcase menu in the admin with the Add New link and the Add New button

  • Assign every product to at least one product category.

  • A product can have several gallery images. As soon as it has more than one, they appear as a gallery on the single product page.

  • A product can have a short description. It appears:

    1. On the single product page, next to the product image or slider, below the price.
    2. On product listing pages.
    3. On product category pages.
  • You can pick other products to list as related products. They appear below the product content, or in a tab when the tabbed layout is active.

  • You can add several attachments to a product. For each attachment you set:

    1. The title or file name.
    2. The URL of the file.
    3. The target.
  • A product page can use the normal, tabbed or accordion layout. Each product can have one to four tabs with any content you like, called Free Tabs. As soon as you use one or more free tabs, the whole single product page switches to a tabbed layout.

    A single product page in the tabbed layout with the default tabs and the free tabs

    1. The regular product information goes into a tab called General Details.
    2. The attachments go into a tab called Attachments.
    3. The related products go into a tab called Related Products.
    4. The comments go into a tab called Comments.
    5. Each free tab appears with its own title and HTML content.

You can also change the global design settings, such as the backgrounds and background colours of the body and the left and right side areas, on each single product.

The product editor has many options. The numbers below match the screenshot.

The Add New Product Item screen with numbered markers: title (1), content (2), product options (3), short description (4) and the sidebar boxes (5 to 10)

  1. The title of the product.

  2. The content of the product.

  3. The product information:

    1. SKU, price and short description.
    2. One to four free tabs, each with its own title, icon and content.
    3. A list of related products.
    4. Attached documents.
  4. Short Description: shown on product listing pages and on the single product page next to the product images.

  5. Featured Image: the image used for the product on listing pages.

  6. Image Gallery: add more images to show as a gallery.

  7. Single Product Layout: normal, tabbed or accordion.

  8. Product Categories: put the product in a category.

  9. Publish: make the product visible on your site, or change its date or visibility, save it as a draft or preview it.

  10. Backend Editor: switch to WPBakery Page Builder to add its elements, or stay in the Classic Editor and add shortcodes or text the usual WordPress way.

You can set these for each free tab:

  1. The tab title.
  2. The tab icon. Click in the icon field to pick an icon.
  3. The tab content. HTML and shortcodes are allowed.

The Free Tab settings of a product: tab title, icon field and tab content

The Related Products tab of a product with the list of products to choose from

Enter one attachment per line in this format: title, URL of the document and target, separated by a | character. The target (new_window) is optional. For example:

Product Documentation | https://yourwebsite.com/wp-content/uploads/2015/03/documentation.docx
Product Pricelist | https://yourwebsite.com/wp-content/uploads/2015/03/spreadsheet.xls | new_window
Product Layout | https://yourwebsite.com/wp-content/uploads/2015/03/presentation.ppt
Product Brochure | https://yourwebsite.com/wp-content/uploads/2015/03/brochure.pdf | new_window

The Attached Documents tab of a product with four example attachments

When the content and settings are complete, publish the product. It then appears in every product list whose page has the product shortcode or the Product Showcase element in the place where you want the list.

Every product has a Design Options section that overrides the global Customizer styling, such as backgrounds and colours, for that product only. View the abilities of the Design Options