Difference between revisions of "Field Groups Manager"

From JReviews Documentation
Jump to: navigation, search
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Field Groups ==
+
== About Field Groups ==
  
Field Groups allow you to "categorize" custom fields by grouping them together. For example, a "Contact" field group will contain fields such as address, phone number and email.  
+
One of the main advantages of JReviews listings over Joomla articles is the ability to have additional fields besides standard ''Title'', ''Summary'' and ''Description'' fields.
 +
 
 +
Field Groups allow you to "categorize" those additional custom fields by grouping them together. For example, a ''Contact'' field group will contain fields such as address, phone number and email.
  
 
There are two types of field groups:
 
There are two types of field groups:
#Listing Field Groups
 
#Review Field Groups
 
  
Field groups can be re-used across different listing types. So for example you can use your "Contact" field group in a "Hotel" listing type and also in a "Restaurant" listing type. And you can also assign more than one field group to each listing type.
+
# '''Listing Field Groups''' - for listing submit forms
 +
# '''Review Field Groups''' - for review submit forms
  
===Comparison of Listing and Review field groups and fields===
+
Field groups can be re-used across different listing types. For example, you can use your ''Contact'' field group in a ''Hotel'' listing type and also in a ''Restaurant'' listing type. And you can also assign more than one field group to each listing type.
  
[[File:FieldGroups.png]]
+
Creating field groups and custom fields is optional and you can create them later at any time.
  
 +
== Listing Field Groups ==
  
 +
A Listing field group will group listing custom fields, which are used to structure the entry and display of information of your listings.
  
When creating a new Field Group make sure you first select the Type of field group you need:
+
Here is an example of a listing submit form:
  
[[File:FieldGroupTypes.png]]
+
[[File:listing-submit-form.png]]
  
 +
On the screenshot you can see the default Joomla fields + additional JReviews listing field groups that contain custom fields:
  
 +
* '''Location''' - contains custom fields about listing location. This field group would be reused for many listing types (i.e. Hotels, Restaurants, Local Businesses, ...)
 +
* '''Hotel Info''' - this field group contains fields for more info about the hotel and it would be used only for hotel listings.
 +
* '''Contact Info''' - contains contact information. This field group would also be reused for many listing types.
  
== Listing Field Groups ==
+
Other Examples of listing field groups:
  
A Listing field group will group listing custom fields which are used to structure the entry and display of information of your listings.
+
* '''Product Info''' - for product listings, it would contain fields like product brand, model and other product features.
 +
* '''Event Info''' - it would contain fields like event date and event venue.
  
=== Examples ===
+
== Review Field Groups ==
  
'''Product listings:'''
+
A Review field group will group review fields which are used to structure the entry and display of information in user and editor reviews. Review fields are mostly used to ask reviewers for their experience with the listing they are reviewing. You can also ask users for information about themselves, so that others reading their reviews know whether the reviewer is similar to them.
*'Brand' field group - containing fields for manufacturer information
+
*'Features' field group - containing fields for products features
+
*'Shopping' field group - containing fields for advertising links
+
  
 +
A Review field group will group review fields, which are used to structure the entry and display of information in user and editor reviews. Review fields are mostly used to ask reviewers for their experience with the listing they are reviewing. You can also ask users for information about themselves, so that others reading their reviews know whether the reviewer is similar to them.
  
'''Company listings:'''
+
Here is an example of a review submit form:
*'Address' field group - for address custom fields
+
*'Info' field group - for information regarding services or products
+
*'Shopping' field group - containing fields for advertising links
+
  
 +
[[File:review-submit-form.png]]
  
== Review Field Groups ==
+
On the review submit form you can see several standard review fields like ''Title'' and ''Comments'', rating criteria (more about this later) and a single review custom field group named '''Travel Details''' which we use to ask hotel reviewers more info about their stay at the hotel.
 +
 
 +
Other Examples of review field groups:
 +
 
 +
* '''Product Experience''' - ask product listing reviewers for pros and cons of the product they are reviewing.
 +
* '''About Me''' - ask reviewers about their age or age range, interests, level of expertise, etc.
 +
* '''Companies Services''' - ask reviewers if they are satisfied with the company's services or products.
 +
 
 +
== Steps to create Field Groups ==
 +
 
 +
* Click on the '''Field Groups Manager''' menu link in JReviews administration.
 +
* Choose whether you are creating a ''Listing field group'' or ''Review field group'' by selecting ''Listing'' or ''Review'' in the '''Location''' select list.
 +
* Enter the title of the field group into the '''Title''' input and click the '''Add''' button:
 +
 
 +
[[File:creating-field-groups.png]]
 +
 
 +
When you are done creating field groups, you can go to the '''Fields Manager''' to create custom fields for them.
 +
 
 +
== Controlled Field Groups ==
  
A Review field group will group review fields which are used to structure the entry and display of information in user and editor reviews.<br />
+
It is possible to have field groups that are controlled by values of a specific custom field. The controlled field group will be hidden on the submit form and it will appear only when the user selects its parent custom field value.
Review fields are mostly used to ask reviewers for their experience with the listing they are reviewing.<br />
+
You can also ask users for information about themselves so others reading their reviews know whether the reviewer is similar to them.
+
  
=== Examples ===
+
For example, if you have product listings on your site and you want to have a separate set of custom fields for a specific product type, you would first create a '''Product Type''' custom field (with options like ''Laptops'', ''Tablets'', etc.) in the '''Product Info''' field group and then create a separate field group '''Laptop Info''' that would appear on the submit form only when ''Laptops'' value is selected in the ''Product Type'' custom field.
  
'''Product listing reviews:'''
+
To create a controlled field group, go to the '''Field Groups Manager'''. enter the title of the field group and enter the field name and field value in the '''Control Field''' and '''Control Value''' inputs:
*'Product Experience' field group - ask reviewers for pros and cons of the product they are reviewing.
+
*'About Me' field group - ask reviewers about their age/age range, interests, level of expertise, ...
+
  
'''Company listing reviews:'''
+
[[File:creating-controlled-field-groups.png]]
*'Review' field group - ask reviewers if they are satisfied with the company's services or products
+
  
  
By default the title of the Field Group will be displayed on your site above the custom fields. If you don't want do display it you can disable it in the "Show title" column.
+
Next step is to create custom fields in [[Fields Manager]].
  
  

Latest revision as of 09:07, 5 January 2014

About Field Groups

One of the main advantages of JReviews listings over Joomla articles is the ability to have additional fields besides standard Title, Summary and Description fields.

Field Groups allow you to "categorize" those additional custom fields by grouping them together. For example, a Contact field group will contain fields such as address, phone number and email.

There are two types of field groups:

  1. Listing Field Groups - for listing submit forms
  2. Review Field Groups - for review submit forms

Field groups can be re-used across different listing types. For example, you can use your Contact field group in a Hotel listing type and also in a Restaurant listing type. And you can also assign more than one field group to each listing type.

Creating field groups and custom fields is optional and you can create them later at any time.

Listing Field Groups

A Listing field group will group listing custom fields, which are used to structure the entry and display of information of your listings.

Here is an example of a listing submit form:

Listing-submit-form.png

On the screenshot you can see the default Joomla fields + additional JReviews listing field groups that contain custom fields:

  • Location - contains custom fields about listing location. This field group would be reused for many listing types (i.e. Hotels, Restaurants, Local Businesses, ...)
  • Hotel Info - this field group contains fields for more info about the hotel and it would be used only for hotel listings.
  • Contact Info - contains contact information. This field group would also be reused for many listing types.

Other Examples of listing field groups:

  • Product Info - for product listings, it would contain fields like product brand, model and other product features.
  • Event Info - it would contain fields like event date and event venue.

Review Field Groups

A Review field group will group review fields which are used to structure the entry and display of information in user and editor reviews. Review fields are mostly used to ask reviewers for their experience with the listing they are reviewing. You can also ask users for information about themselves, so that others reading their reviews know whether the reviewer is similar to them.

A Review field group will group review fields, which are used to structure the entry and display of information in user and editor reviews. Review fields are mostly used to ask reviewers for their experience with the listing they are reviewing. You can also ask users for information about themselves, so that others reading their reviews know whether the reviewer is similar to them.

Here is an example of a review submit form:

Review-submit-form.png

On the review submit form you can see several standard review fields like Title and Comments, rating criteria (more about this later) and a single review custom field group named Travel Details which we use to ask hotel reviewers more info about their stay at the hotel.

Other Examples of review field groups:

  • Product Experience - ask product listing reviewers for pros and cons of the product they are reviewing.
  • About Me - ask reviewers about their age or age range, interests, level of expertise, etc.
  • Companies Services - ask reviewers if they are satisfied with the company's services or products.

Steps to create Field Groups

  • Click on the Field Groups Manager menu link in JReviews administration.
  • Choose whether you are creating a Listing field group or Review field group by selecting Listing or Review in the Location select list.
  • Enter the title of the field group into the Title input and click the Add button:

Creating-field-groups.png

When you are done creating field groups, you can go to the Fields Manager to create custom fields for them.

Controlled Field Groups

It is possible to have field groups that are controlled by values of a specific custom field. The controlled field group will be hidden on the submit form and it will appear only when the user selects its parent custom field value.

For example, if you have product listings on your site and you want to have a separate set of custom fields for a specific product type, you would first create a Product Type custom field (with options like Laptops, Tablets, etc.) in the Product Info field group and then create a separate field group Laptop Info that would appear on the submit form only when Laptops value is selected in the Product Type custom field.

To create a controlled field group, go to the Field Groups Manager. enter the title of the field group and enter the field name and field value in the Control Field and Control Value inputs:

Creating-controlled-field-groups.png


Next step is to create custom fields in Fields Manager.