Difference between revisions of "Planning and organizing JReviews setup"

From JReviews Documentation
Jump to: navigation, search
(Examples how to organize Directories, Sections and Categories)
 
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Listing Types ==
 
== Listing Types ==
  
The Joomla content system provides only one texarea 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 <span style="color: blue">Listing Types</span> for different types of content. Each listing type can have a different set of custom fields and different rating criteria.
+
Examples of listing types you might create:
  
Listing Types are assigned to Joomla Categories so all listings withing a category will have the same listing type.
+
* '''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, Sections & Categories ==
+
Listing Types will be assigned to Joomla Categories.
  
Since JReviews uses Joomla’s content system, it is required to create Joomla Sections and Categories for JReviews listings.
+
== Directories &amp; Categories ==
  
Joomla 1.5. provides only two levels of categories: Sections and Categories. JReviews gives you a third level: Directory - which becomes the top level: '''Directory''' -> '''Section''' -> '''Category'''.
+
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:
  
== Examples how to organize Directories, Sections and Categories ==
+
[[File:directory-example.png]]
  
{| class="wikitable" cellpadding="0" cellspacing="0"
+
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.
|-
+
! Directories !! Sections !! Categories
+
|-
+
| Listings || Products || Computers, Smartphones, TVs, Cameras ...
+
|-
+
| || Entertainment || Books, Movies, Games, Comics
+
|-
+
| || Software || Windows Apps, Mac Apps, iPhone Apps, ...
+
|-
+
| Articles || News || Business, Entertainment, Sport, ...
+
|-
+
| || Tutorials || Programming, Design, ...
+
|}
+
  
 +
Examples of directories can be found on the JReviews demo site (every top level menu item in the Top Menu is a directory page):
  
When planning your category structure, you also need to think about which Listing Type will be used for each category.
+
* [http://demo.reviewsforjoomla.com/business-directory Business Directory]
Whenever you need a different submit form for listings in a certain category, you need to create a new Listing Type.
+
* [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]
  
For example, you can create a "Product" Listing Type that will have custom fields like ''Brand, Model, Price, ...'', and this listing type can be used for all product categories which means the same submit form would be used for all product listings.  
+
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.
  
But if you want additional custom fields for Computer listings only, than you will need to create a "Computers" listing type with additional custom fields like ''CPU Type, Memory,...'', so a different submit form would be used for computer listings only.
+
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).
  
Here is an example of the [[Listing Submit Form Layout|Listing Submit Form]] for Games listing type.
+
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 ==
  
In some cases it is not easy to find the best Section/Category set-up because of Joomla limitations: it is not possible to use the same category in more than one section and it is not possible to add categories on the fly while submitting a listing. It is also not possible for one article/listing to be published in more than one 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).
  
This is where JReviews also helps. For those types of categories, instead of setting them up in Joomla Category Manager, you can use JReviews Custom Fields.
+
We recommend to create a small number of Joomla categories and extend those categories with JReviews '''virtual categories'''.
  
You can create a JReviews Single select custom field (or Multiple select if you want to put listings in more than one subcategory), or checkbox custom field.
+
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'''.
  
For example, if you want additional categorization for Computer listings, create a custom field with options ''Desktops, Laptops, Netbooks, Tablets, ...''
+
Some of the advantages of virtual categories are that new virtual categories can be added &quot;on the fly&quot; during the listing submission and one listing can have multiple virtual categories (both is not possible with Joomla categories).
  
If you enable '''Click to Add''' in the field's preferences, you will be able to add new category options while submitting a listing.
+
A good example of using virtual categories is for restaurant's cuisines. You can create a multiple select custom field &quot;Cuisines&quot; 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:
  
 +
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/italian/ Italian Cuisine]
 +
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/american-new/ American (New) Cuisine]
 +
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/japanese/ Japanese Cuisine]
  
== JReviews Setup Steps ==
+
For more info read [[How to use custom fields as virtual categories]].
#[[Field Groups Manager]] - create field groups that will contain listing or review custom field. You will assign field groups to different listing types in Criteria Manager.
+
#[[Fields Manager]] - create listing or review custom fields and assign them to field groups.
+
#[[Listing Type Manager]] - create different listing types and assign field groups and rating criteria for editors and users to rate the listing.
+
#[[Directories Manager]] - directories will be assigned to Joomla categories.
+
#[[Categories Manager]] - select Joomla categories you will use with JReviews and assign Directory and Criteria Set for each category.
+
 
+
  
  
Line 66: 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.