Creating Required Joomla Menu Items

From JReviews Documentation
Revision as of 12:49, 31 August 2010 by Jreviews (Talk | contribs)

Jump to: navigation, search

JReviews uses Joomla's content system for Listings, so the Listing pages in JReviews have the exact same url as Joomla Article pages. Because of this, it is necessary to create several core Joomla Menu items to ensure that the Listing (Article) URLs will have the correct Itemid parameter (&Itemid=) that Joomla can use for proper module assignments and better SEF URLs .

You need to create Joomla Section Blog/List Layout or Category Blog/List Layout menu items for all Joomla Sections or Categories used with JReviews. Your choice will affect the way listings' SEF URLs will look if you use Joomla Core SEF

If you create Joomla Section menu items, the URLs will look like this:

If you create Joomla Category menu items, the URLs will look like this:

If you decide to create both Joomla Section and Category menu items, the URLs will look like this:


Because JReviews also has its own menus for sections and categories, the above Joomla menus are considered duplicates and don't need to be displayed on your site. They need to be created only to ensure proper module assignments and nicer SEF URLs for listing pages. We recommend creating a new "Hidden Menu" without a module. If you want to display Section and Category menu items on your site create JReviews Section/Category List menu items.


Steps for creating Joomla Section or Category menu items

  • In the Joomla administration click on Menus => Menu Manager and to create a new menu click on the New button
  • In the next screen enter the Name and Title of the menu, but leave the Module Title empty, so that the module won't be created:

NewHiddenMenu.png

  • Next, start creating menu items in the Hidden Menu

NewJoomlaMenuItems.png

  • Make sure you enter unique Title/Alias for each menu item, because duplicates will cause SEF issues
  • After you created all menu items, go to JReviews administration and click on "Clear Cache" link in the left menu. This is necessary because JReviews stores a cached version of the menu system to improve performance.

Relation between Modules and the core Joomla Section/Category menu items

  • Joomla core Section/Category menu items are important because URLs of listing pages will have their ItemIDs
  • That means that if you want to display certain modules in listing detail pages (Joomla article pages), you must assign modules to those Joomla menu items
  • Creating the JReviews Section/Category menu items is not enough because the Joomla article system doesn't look for JReviews menus when trying to figure out the ItemIDs of the articles, it only looks for core Joomla menus.