YOOtheme Pro

Create custom layouts for JReviews pages with the addon for YOOTheme Pro.

#Overview

The combination of the YOOTheme Pro page builder and JReviews provides unlimited possibilities for creating beautiful functional templates for your site.

The addon is currently in beta and provides the functionality listed below.

#Limitations

Functionality is limited to templates, sources and the elements documented below. Further development will continue over time.

There isn't an integration for comments/reviews. So using the review system in a fully custom YOOTheme-designed listing detail template is not possible yet, but coming soon in JReviews v6!

There isn't a standalone sorting element that can be used in category/search pages.

It's not possible to list all the limitations without actually knowing what you would like to implement with YOOTheme Pro. If you have any questions about current capabilities, please don't hesitate to contact us before you purchase.

#Requirements

In addition to the JReviews addon, you need to install YOOTheme Pro to be able to create custom layouts using their page builder.

#Templates

Current functionality allows creating custom templates for:

• JReviews listing detail page
• JReviews category pages
• JReviews search results pages
• JReviews Default Layout (Joomla) - Generic template for JReviews pages

The core pagination element works in category and search pages.

#Template Types

#JReviews Search Results

Create custom layouts for search results pages. Use dynamic sources to access search data or add the JReviews Output element to your layout to display the complete search results.

#JReviews Default Layout (Joomla Only)

This template type provides a fallback layout for JReviews pages that don't have a specific template type.

Template Cascading: YOOtheme applies templates in this order:

1. Menu-specific layout (if assigned to the menu item)
2. Specific template type (e.g., Search Results)
3. JReviews Default Layout
4. Raw JReviews output (standard rendering)

Settings:

• Apply to Category Pages: Enable this option to apply the default layout template to category listing pages. When disabled, category pages will use menu-specific layouts or standard JReviews rendering.

Usage: Add the JReviews Output element to your layout to display the JReviews content, then add additional YOOtheme elements around it for custom headers, footers, or sidebars.

#Listing Detail Template

Shown below is a simple layout that uses:

• JReviews custom button elements for add to favorite and send inquiry
• Slideshow element with the JReviews multiple items photos source
• Description list element with the JReviews multiple items custom fields source for several field groups.
• JReviews listing map custom element

#Dynamic Sources

When you install the add-on you'll inmediately see enhanced dynamic sources for Joomla Articles and WordPress posts. The extended fields for JReviews include:

#JReviews Custom Fields

Place fields anywhere you want and display the JReviews generated output, which includes any custom output you've created using the output format and php formatting settings.

Fields can be included using single source elements, and JReviews also makes fields as multiple item sources allowing you to easily diplay all fields, or fields in a specific group, using a list element.

#JReviews Media

Use fields for Main Image, Cover, Logo to place these images in your templates. You also have access to the individual media counts.

Media is also available as a multiple items source, which allows retrieving each media type to use in elements that support multiple values like galleries, grids and tables.

#JReviews Extras

Extras include things like listing featured state, user rating and count, editor rating and count, and if you are using MapsPro you can easily add a the listing map using a field.

#JReviews Actions

Actions allow you to create buttons or links to management activities like edit listing, add media and edit media, which automatically display only for users with the right permissions.

#JReviews Conditions (WordPress Only)

In WordPress, JReviews extends YOOtheme's Site dynamic source with conditional fields that you can use to control element visibility based on the current page context.

#Is JReviews Page

This condition allows you to show or hide elements based on whether the current page is a JReviews page.

Use cases:

• Display custom headers only on JReviews pages
• Show/hide navigation elements based on page type
• Conditionally render sections that should only appear on directory pages
• Create different layouts for JReviews vs. regular WordPress content

How to use:

1. Select any element in the YOOtheme builder
2. Go to the element's Advanced tab
3. Under Visibility, click Dynamic
4. Choose Site as the source
5. Select Is JReviews Page as the condition

The element will now only display on pages where JReviews content is rendered, including:

• WordPress pages with JReviews menus assigned
• Categories configured as JReviews directory pages
• Any page rendering JReviews output

Note: For Joomla, use the JReviews Default Layout template type instead to create JReviews-specific layouts.

#Custom Elements

At this time the following custom elements are available for JReviews listings. These elements allow you to add buttons in your layouts that implement the corresponding JReviews functionality. In the case of the Listing Map element, you'll be able to add the listing map powered by MapsPro anywhere in your layouts.

• Add Favorite
• Claim Listing
• Compare Listing
• Display Rating
• Send Inquiry
• Listing Map (MapsPro)
• JReviews Output - Embed complete JReviews page output in your layouts (see JReviews Output Element for details)

#JReviews Output Element

The JReviews Output element is a powerful custom element that allows you to embed complete JReviews page content within your YOOtheme layouts. Unlike the listing-specific elements above, this element works with almost any JReviews page type including directories, search results, categories, calendars and more.

#How It Works

The element captures the full output from JReviews and renders it within your YOOtheme layout, allowing you to combine JReviews functionality with custom YOOtheme design elements.

WordPress:

• Works on Pages with JReviews menus assigned
• Works on Categories configured as JReviews pages
• Use the "Is JReviews Page" dynamic condition to control when elements display

Joomla:

• Works on menu items linked to JReviews
• Use with the JReviews Default Layout template type for generic pages

#When to Use

Use the JReviews Output element when you want to:

• Create custom headers or footers around JReviews content
• Add custom sections before or after JReviews pages
• Combine JReviews functionality with YOOtheme design elements
• Build completely custom layouts while preserving JReviews features

#Usage

1. Create or edit a YOOtheme layout for your page
2. Add the JReviews Output element from the element picker (found in the JReviews group)
3. Position it where you want the JReviews content to appear
4. Add any additional YOOtheme elements above or below it for custom sections
5. Save and preview your layout

The element will automatically display the appropriate JReviews content based on the page context (directory listing, search results, category page, etc.).