Difference between revisions of "Planning and organizing JReviews setup"

From JReviews Documentation
Jump to: navigation, search
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Listing Types ==
 
== Listing Types ==
  
We already mentioned that Joomla content system provides only two fields for all articles -> '''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 and create different custom fields for each listing type. You can also define criteria for editor and user reviews.
+
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.
 
Listing Types will be assigned to Joomla Categories.
  
 +
== Directories &amp; Categories ==
  
== Directories, Sections & 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.
  
Since JReviews uses Joomla’s content system, it is required to create Joomla Sections and Categories for JReviews listings.
+
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:
  
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'''.
+
[[File: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 how to organize Directories, Sections and Categories ==
+
Examples of directories can be found on the JReviews demo site (every top level menu item in the Top Menu is a directory page):
  
{| class="wikitable" cellpadding="0" cellspacing="0"
+
* [http://demo.reviewsforjoomla.com/business-directory Business Directory]
|-
+
* [http://demo.reviewsforjoomla.com/city-guide City Guide]
! Directories !! Sections !! Categories
+
* [http://demo.reviewsforjoomla.com/products-catalog Products Catalog]
|-
+
* [http://demo.reviewsforjoomla.com/movies Movies]
| Listings || Products || Computers, Smartphones, TVs, Cameras ...
+
* [http://demo.reviewsforjoomla.com/games Games]
|-
+
* [http://demo.reviewsforjoomla.com/music Music]
| || Entertainment || Books, Movies, Games, Comics
+
* [http://demo.reviewsforjoomla.com/downloads Downloads]
|-
+
* [http://demo.reviewsforjoomla.com/classifieds Classifieds]
| || Software || Windows Apps, Mac Apps, iPhone Apps, ...
+
* [http://demo.reviewsforjoomla.com/events Events]
|-
+
| Articles || News || Business, Entertainment, Sport, ...
+
|-
+
| || Tutorials || Programming, Design, ...
+
|}
+
  
 +
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.
  
When you plan your categories structure, you also need to think about which Listing Type will be used for which category.
+
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).
Whenever you need a different submit form for listings in certain category, you need to create a new Listing Type.
+
 
+
For example, it is possible to 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.
+
 
+
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.
+
 
+
Here is an example of the [[Submit Listing Layout]] 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 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.
+
  
You could create a JReviews Single select custom field (or Multiple select if you want to put listings in more than one subcategory)
+
We recommend to create a small number of Joomla categories and extend those categories with JReviews '''virtual categories'''.
  
For example, if you want additional categorization for Computer listings, create a custom field with options ''Desktops, Laptops, Netbooks, Tablets, ...''
+
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'''.
  
If you enable '''Click to Add''' in the field's preferences, you will be able to add new category options while submitting a listing.
+
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).
  
 +
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:
  
== JReviews Setup Steps ==
+
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/italian/ Italian Cuisine]
#[[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.
+
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/american-new/ American (New) Cuisine]
#[[Fields Manager]] - create listing or review custom fields and assign them to field groups.
+
* [http://demo.reviewsforjoomla.com/city-guide/restaurants/tag/cuisine/japanese/ Japanese Cuisine]
#[[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.
+
  
 +
For more info read [[How to use custom fields as virtual categories]].
  
  
Line 68: 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.