Difference between revisions of "Directories Module"

From JReviews Documentation
Jump to: navigation, search
Line 1: Line 1:
You can use Directories Module as Directory/Section/Category '''navigation tree'''.
 
  
 +
You can use the Directories module to display the complete directory/category navigation tree.
  
== Example of the module layout ==
+
'''Example of the module layout:'''
  
[[File:DirectoriesModule.png]]
+
[[File:directories-module.png]]
*to modify the layout, edit the theme file of the Directories Module:
+
**<span style="color: blue">\com_jreviews\jreviews\views\themes\default\modules\directories.thtml</span>
+
*if you want to hide directory links, set '''$showDirectoryLinks''' to false in the theme file
+
*if you want to hide category links, set '''$showCategoryLinks''' to false in the theme file
+
  
 +
=== Directories Module Parameters ===
  
==Module's Parameters==
+
[[File:directories-module-params.png]]
  
[[File:DirectoriesModuleParameters.png]]
+
'''JReviews Theme Suffix''' - this suffix will be applied to the module view file and is useful to create multiple instances of the module that have different outputs. The module comes with one default suffix &quot;_folders&quot; which will add folder icons next to the links.
*'''Module Class Suffix''' - a suffix will be applied to the CSS class of the module. This allows individual module styling
+
*'''jReviews Template Suffix''' - you can set "_folders" as suffix to display an alternative theme file with folder icons:
+
[[File:DirectoriesModule2.png]]
+
  
*'''Directory IDs (optional)''' - you can configure which directories will be displayed in the module
+
'''Directory IDs (optional)''' - here you can choose to show only specific directories by entering their ID numbers. ID numbers of directories can be found in JReviews Directories Manager.
  
 +
'''Show Directory Links''' - if disabled, the module will hide directory links and show only category links.
 +
 +
=== Customizing the Directories Module ===
 +
 +
If you want to customize the theme file of the Directories Module, this is its default location:
 +
 +
*<span style="color: blue">/com_jreviews/jreviews/views/themes/default/modules/directories.thtml</span>
 +
 +
Before you start customizing the theme files, make sure you read about  [[JReviews Code Overrides]] functionality and create a custom theme.
 +
 +
You can create multiple custom copies of the Directories Module theme file and enter their suffixes in the '''Theme Suffix''' parameter. Remember to clear JReviews File Registry when creating new theme files.
  
  

Revision as of 14:12, 9 January 2014

You can use the Directories module to display the complete directory/category navigation tree.

Example of the module layout:

Directories-module.png

Directories Module Parameters

Directories-module-params.png

JReviews Theme Suffix - this suffix will be applied to the module view file and is useful to create multiple instances of the module that have different outputs. The module comes with one default suffix "_folders" which will add folder icons next to the links.

Directory IDs (optional) - here you can choose to show only specific directories by entering their ID numbers. ID numbers of directories can be found in JReviews Directories Manager.

Show Directory Links - if disabled, the module will hide directory links and show only category links.

Customizing the Directories Module

If you want to customize the theme file of the Directories Module, this is its default location:

  • /com_jreviews/jreviews/views/themes/default/modules/directories.thtml

Before you start customizing the theme files, make sure you read about JReviews Code Overrides functionality and create a custom theme.

You can create multiple custom copies of the Directories Module theme file and enter their suffixes in the Theme Suffix parameter. Remember to clear JReviews File Registry when creating new theme files.