Difference between revisions of "Planning and organizing JReviews setup"

From JReviews Documentation
Jump to: navigation, search
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
== Listing Types ==
 
== Listing Types ==
  
The Joomla content system provides only one text area field for all articles and it can be split into two: '''Intro Text''' (summary) and '''Full Text''' (description).
+
Listing types are different types of content that you can setup. Basically, with listing types you define how the listing and review forms will look like (which fields they will include).
  
With JReviews, you can define '''Listing Types''' for different types of content and create different custom fields for each listing type. You can also define criteria for editor and user ratings and reviews.
+
Examples of listing types you might create:
 
+
Listing Types will be assigned to Joomla Categories.
+
  
 +
* '''Business''' - a type of listing that will include field groups (fields) like ''Location'' (City, Address, Postcode), ''Contact Info'' (Phone number, Email address, Website url), etc.
 +
* '''Hotel''' - this listing type would include ''Location'' and ''Contact Info'' field groups the same as the business listing type, but it can also include additional ''Hotel Info'' field group with fields like Hotel Amenities, Pricing, etc.
 +
* '''Restaurant''' - similarly to hotels and businesses, this listing type would include ''Location'' and ''Contact Info'' field groups as well, but you can also create additional field group(s) for entering information about restaurant's Cuisine and Menus.
 +
* '''Product''' - this type of listing would have a ''Product Info'' field group with fields like Brand, Model, Release Date, Product Website, etc.
 +
* '''Movie''' - a type of listing that would include a field group with information about the movie (Year, Directors, Actors, Genre) and a field group with affiliate links where visitors can buy/rent movies (Amazon, iTunes, Netflix)
 +
* '''Event''' - it would contain event information fields like Event Date and Event Venue.
  
== Directories & Categories ==
+
Listing Types will be assigned to Joomla Categories.
  
Since JReviews uses Joomla’s content system, it is required to create Joomla Categories for JReviews listings.
+
== Directories & Categories ==
  
Joomla 1.7 and above provides unlimited levels of categories. Joomla categories can be grouped together using '''JReviews Directory'''.
+
Since JReviews uses Joomla’s content system, you will need to create Joomla categories for JReviews listings. Categories will be assigned to a listing type and a directory.
Here is an example of the "City Guide" JReviews directory which contains many Joomla categories:
+
  
[[File:Directory.png]]
+
Joomla allows you to create unlimited levels of categories and JReviews provides additional Directory level that can be used to group similar categories. Here is an example of a directory page:
  
+
[[File:directory-example.png]]
When planning your category structure, you also need to consider which Listing Type will be used for each category. Whenever you need a different submit form for listings in a certain category, you need to create a new Listing Type.  
+
  
If you are creating a City Guide site with many categories, it is possible that you will want to have different submit forms for some of the categories. For example, Hotels and Restaurant categories could share the same location custom fields (City, Address, Postal Code, ...), but for Restaurants you will want additional fields like "Cuisine" and other.
+
Creating at least one directory is required, but you don't need to show the directory page on your site if you don't want to. The advantage of the directory page is that it can display the complete category tree (all levels of categories), unlike category pages which can only show direct subcategories.
That is why you need to create separate "Restaurant" listing type that will be assigned to restaurant categories and contain restaurant related custom fields.
+
  
 +
Examples of directories can be found on the JReviews demo site (every top level menu item in the Top Menu is a directory page):
 +
 +
* [http://demo.reviewsforjoomla.com/business-directory Business Directory]
 +
* [http://demo.reviewsforjoomla.com/city-guide City Guide]
 +
* [http://demo.reviewsforjoomla.com/products-catalog Products Catalog]
 +
* [http://demo.reviewsforjoomla.com/movies Movies]
 +
* [http://demo.reviewsforjoomla.com/games Games]
 +
* [http://demo.reviewsforjoomla.com/music Music]
 +
* [http://demo.reviewsforjoomla.com/downloads Downloads]
 +
* [http://demo.reviewsforjoomla.com/classifieds Classifieds]
 +
* [http://demo.reviewsforjoomla.com/events Events]
 +
 +
Even though the demo site has many directories (to show different types of sites you can create with JReviews), most sites need just one directory.
 +
 +
The only reason why you might need to create more than one directory is if your site will have categories that are completely unrelated to each other (i.e. business categories and product categories).
 +
 +
Directories that you create will need to be assigned to categories in the JReviews Categories Manager.
  
 
== Using JReviews Custom Fields for additional categories ==
 
== Using JReviews Custom Fields for additional categories ==
  
With JReviews custom fields you can have additional "virtual" categories by enabling '''Click2Search''' setting for certain fields. Then each field value will become a "virtual category".
+
Even though Joomla allows you to create unlimited number of categories and unlimited levels of categories, it is not recommended to create a large number of categories as that can make the overall site setup too complex and time consuming (i.e. creating required menu items for every category).
 +
 
 +
We recommend to create a small number of Joomla categories and extend those categories with JReviews '''virtual categories'''.
  
Some of the advantages of virtual categories is that new virtual categories can be added "on the fly" during the listing submission and one listing can have multiple virtual categories (both is not possible with Joomla categories).
+
The ''virtual categories'' are actually values of JReviews custom fields. For certain single select or multiple select custom fields you can enable the '''Click2Search''' setting and then each field value of that field becomes a '''virtual category'''.
  
A good example of using virtual categories is for restaurant's cuisines. You can create a multiple select custom field "Cuisines" and enable Click2Search so that that field values become virtual categories. When visitors click on a certain cuisine, they will get a list page with all listings that have the same cuisine.
+
Some of the advantages of virtual categories are that new virtual categories can be added "on the fly" during the listing submission and one listing can have multiple virtual categories (both is not possible with Joomla categories).
  
 +
A good example of using virtual categories is for restaurant's cuisines. You can create a multiple select custom field "Cuisines" and enable Click2Search so that that field values become virtual categories. When visitors click on a certain cuisine, they will get a list page with all listings that have the same cuisine. Examples of virtual categories can be found on the JReviews demo site:
  
== Steps to Setup JReviews ==
+
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/italian/ Italian Cuisine]
#[[Creating Joomla Categories]] - before setting up JReviews, create Joomla Categories.
+
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/american-new/ American (New) Cuisine]
#[[Field Groups Manager]] - create field groups that will contain listing or review custom fields. You will assign field groups to different listing types in the Listing Types Manager.
+
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/japanese/ Japanese Cuisine]
#[[Fields Manager]] - create listing or review custom fields and assign them to field groups.
+
#[[Listing Type Manager|Listing Types Manager]] - create different listing types and assign field groups and rating criteria for designated JReviews editors and users to rate the listings.
+
#[[Directories Manager]] - create directories that will be assigned to Joomla categories.
+
#[[Categories Manager]] - select the Joomla categories that will be used with JReviews and associate them with a Directory and Listing Type.
+
  
 +
For more info read [[How to use custom fields as virtual categories]].
  
  
Line 46: Line 64:
 
[[Category:Joomla]]
 
[[Category:Joomla]]
 
[[Category:Setup]]
 
[[Category:Setup]]
[[Category:Organizing]]
 

Latest revision as of 14:44, 1 December 2019

Listing Types

Listing types are different types of content that you can setup. Basically, with listing types you define how the listing and review forms will look like (which fields they will include).

Examples of listing types you might create:

  • Business - a type of listing that will include field groups (fields) like Location (City, Address, Postcode), Contact Info (Phone number, Email address, Website url), etc.
  • Hotel - this listing type would include Location and Contact Info field groups the same as the business listing type, but it can also include additional Hotel Info field group with fields like Hotel Amenities, Pricing, etc.
  • Restaurant - similarly to hotels and businesses, this listing type would include Location and Contact Info field groups as well, but you can also create additional field group(s) for entering information about restaurant's Cuisine and Menus.
  • Product - this type of listing would have a Product Info field group with fields like Brand, Model, Release Date, Product Website, etc.
  • Movie - a type of listing that would include a field group with information about the movie (Year, Directors, Actors, Genre) and a field group with affiliate links where visitors can buy/rent movies (Amazon, iTunes, Netflix)
  • Event - it would contain event information fields like Event Date and Event Venue.

Listing Types will be assigned to Joomla Categories.

Directories & Categories

Since JReviews uses Joomla’s content system, you will need to create Joomla categories for JReviews listings. Categories will be assigned to a listing type and a directory.

Joomla allows you to create unlimited levels of categories and JReviews provides additional Directory level that can be used to group similar categories. Here is an example of a directory page:

Directory-example.png

Creating at least one directory is required, but you don't need to show the directory page on your site if you don't want to. The advantage of the directory page is that it can display the complete category tree (all levels of categories), unlike category pages which can only show direct subcategories.

Examples of directories can be found on the JReviews demo site (every top level menu item in the Top Menu is a directory page):

Even though the demo site has many directories (to show different types of sites you can create with JReviews), most sites need just one directory.

The only reason why you might need to create more than one directory is if your site will have categories that are completely unrelated to each other (i.e. business categories and product categories).

Directories that you create will need to be assigned to categories in the JReviews Categories Manager.

Using JReviews Custom Fields for additional categories

Even though Joomla allows you to create unlimited number of categories and unlimited levels of categories, it is not recommended to create a large number of categories as that can make the overall site setup too complex and time consuming (i.e. creating required menu items for every category).

We recommend to create a small number of Joomla categories and extend those categories with JReviews virtual categories.

The virtual categories are actually values of JReviews custom fields. For certain single select or multiple select custom fields you can enable the Click2Search setting and then each field value of that field becomes a virtual category.

Some of the advantages of virtual categories are that new virtual categories can be added "on the fly" during the listing submission and one listing can have multiple virtual categories (both is not possible with Joomla categories).

A good example of using virtual categories is for restaurant's cuisines. You can create a multiple select custom field "Cuisines" and enable Click2Search so that that field values become virtual categories. When visitors click on a certain cuisine, they will get a list page with all listings that have the same cuisine. Examples of virtual categories can be found on the JReviews demo site:

For more info read How to use custom fields as virtual categories.