Thiết kế web với joomla 1.6(5).x part 42 pdf

Chapter 17: Working with the Site Modules 383 l Greeting: Controls whether the system uses a greeting for users upon login. The default is Yes, which results in the greeting being printed in the module position after login. The default greeting is “Hi, username.” l Name/Username: This control determined whether the greeting shows the username or the real name of the user. This control is only relevant if the Greeting parameter is set to yes. l Encrypt Login Form: If the value Yes is selected, the system will encrypt the form using SSL. The default value is No. Warning Do not select the option to Encrypt Login Form unless your site is SSL-enabled and URLs with the https:// prefix are accessible. To add a Login module to your site, follow these steps: 1. Access the Module Manager. To do so, go to the Extensions menu and select the Module Manager option. The Module Manager loads in your web browser. 2. Click the New icon on the toolbar at the top of the Module Manager. The New Module dialogue opens. Refer to Figure 17.2. 3. Select the option Login and then click the Next button. The Login Module dialogue loads in your browser. 4. In the Title field, type a name for the module. This field is required. 5. Set the option Enabled to Yes. 6. Set the Position control to assign the module to a position on the page. 7. Set the Menu Assignment to specify the pages upon which the module will appear. 8. Select any additional options or parameters you wish; all other fields are optional. 9. Click the Save icon on the toolbar at the top right to save your new module. The sys- tem creates the module, closes the dialogue, and returns you to the Module Manager. Cross-Reference More detailed information about creating user registration functionality can be found in Chapter 10. The Menu modules The Menu modules play a key role in the system and are closely tied to the Menu Manager. Each menu in the system has its own module. The Menu Modules are automatically created by the sys- tem each time a menu is created in the Menu Manager. A typical Menu module output is shown in Figure 17.20. Cross-Reference The Menu Manager is dealt with in detail in Chapter 8. Part III: Working with Components, Modules, and Plugins 384 FIGURE 17.20 The front-end output of the Menu module. This example shows the default Main menu assigned to the Left module position. Menu module Though the menu module’s main purpose is to control menu placement, visibility, and access, it also impacts certain aspects of the menu’s appearance. The parameters include a number of options for assisting in the styling of the menu, as shown in Figure 17.21. In the default system with the sample data installed, you find six menu modules named: Main menu, Resources, Key Concepts, User Menu, Example Pages and Top Menu. All of the default modules are assigned to the left module position, except for the top menu, which is assigned to the User3 position. Note The system name for this module type is mod_mainmenu. The Parameters section of the Menu module is one of the most complicated module interfaces. The workspace is divided into three sections: Module parameters, Advanced parameters, and Other parameters. Chapter 17: Working with the Site Modules 385 FIGURE 17.21 The Menu module parameters. The Module parameters section contains the following options: l Menu name: Select the menu you want to control from the combo box. l Menu style: Select the formatting for the menu the menu layout. The default style is List, but other options include Legacy - Vertical, Legacy - Horizontal, and Legacy - Flat List. l Start Level: This control is used in conjunction with the End Level control to turn one menu into multiple menus by separating the menu items into hierarchical groupings. This is optional and if you do not intend to separate your menu items into multiple menus, then set the value for this control (and the End Level control as well) to zero. This item has no impact where the menu uses a flat hierarchy. l End Level: This control is used in conjunction with the Start Level control to turn one menu into multiple menus by separating the menu items into hierarchical groupings. This is optional and if you do not intend to separate your menu items into multiple menus, then set the value for this control (and the End Level control as well) to zero. This item has no impact where the menu uses a flat hierarchy. Part III: Working with Components, Modules, and Plugins 386 l Always show submenu items: This control sets the visibility of submenu items. Set this control to Yes to display all submenu items, even when the parent item is not selected. The default setting is No. This control has no impact if there are no submenu items. l Target position: This field allows you to specify the placement of any drop-down or pop- up submenus. This is an optional field and has a particular syntax that must be followed. A proper entry for this field will specify the position of the submenu in terms of position and size, for example, top=20,left=20,width=100,height=200. Note The menu style options include three Legacy modes. These Legacy options are intended primarily for site owners who are upgrading to Joomla 1.5.x from the old Joomla 1.x. The Legacy styles are intended to help you keep your pre-Joomla 1.5 formatting and they use different CSS classes than the default Joomla 1.5.x menus. The default style, List, is specifically intended for Joomla 1.5.x sites and is employed by all the menus in the default installation. The Advanced parameters section contains the following: l Show whitespace: Setting this option to No results in the code relating to the menu to com- press through the elimination of unnecessary whitespace in the code. Setting the option to Yes keeps the whitespace in place, which renders the code easier to read. Setting this option to Yes while in development is helpful; set it to No for a live site to improve performance. l Caching: This control allows you to exempt a specific module from the site’s caching, as set in the Global Configuration. Select the No Caching option to prevent the contents of this module from being cached. The default setting is Use Global. l Menu Tag ID: Set an integer value in this field and it will be appended to the UL tag for this menu. This enables you to create unique styling for the Menu UL tag. l Menu class suffix: This field allows you to specify a suffix that will be automatically appended to all CSS styles that affect this menu. The use of a specified suffix makes it pos- sible for you to style this menu individually. l Module class suffix: This field allows you to specify a suffix that will be automatically appended to all CSS styles that affect this module. The use of a specified suffix makes it possible for you to style this module individually. l Maximum menu depth: Set an integer value in this field to control the maximum number of levels the menu can have. The default value is 10. Cross-Reference I discuss the formatting of menus and the creation of submenus in Chapter 8. The Other Parameters section contains the following: l Show menu images: Set to Yes if you want to show images for the menu items. This con- trol is the trigger for the Image options that follow in this section. l Menu image alignment: Select to align the images to the left or the right. This option is dependent upon the Show Menu Images control being set to Yes. Chapter 17: Working with the Site Modules 387 l Menu image link: Set to Yes to have the image itself function as a link to the item. This option is dependent upon the Show Menu Images control being set to Yes. l Expand menu: Set this control to Yes to show submenu items expanded. l Activate parent: Set this control to Yes to make the parent items active whenever the child item is active. l Full active highlighting: Set this control to Yes to make all parts of the full menu item active. l Indent image: Use this control to specify what indent image, if any is used. The default setting is template, meaning the system should use the indent items specified by the tem- plate. Set to the option Joomla! default images to use the system defaults rather than the template images. Setting the control to None results in no indent images being used. The final option, Use Parameters below, activates the following six Indent Image controls. l Indent Image 1-6: When the Indent Image parameter is set to Use Parameters below, this control is active. Use it to select the image to be used for the first level of indentation. l Spacer: Use this field to specify a character to be used for the spacer between horizontal menu items. l End spacer: Use this field to specify a character to be used for the spacer at the end of the horizontal menu. To add a Menu module to your site, follow these steps: 1. Log in to the admin system of your site. 2. Go to Extensions menu and select the Module Manager option. The Module Manager loads in your browser. 3. Click the New icon on the toolbar at the top of the Module Manager. The New Module dialogue opens. Refer to Figure 17.2. 4. Select the Menu option and then click the Next button. The Menu Module dialogue loads in your browser. 5. In the Title field, type a name for the module. This field is required. 6. Set the option enabled to Yes. 7. Set the Position control to assign the module to a position on the page. 8. Set the Menu Assignment to specify the pages upon which the module will appear. 9. Select the name of the menu you wish to control from Menu Name combo box under Module parameters. 10. Select any additional options or parameters you wish; all other fields are optional. 11. Click the Save icon on the toolbar at the top right to save your new module. The sys- tem creates the module, closes the dialogue, and returns you to the Module Manager. Part III: Working with Components, Modules, and Plugins 388 Tip The menu modules are among the most important in the system. Fluency in menu styling requires an awareness of not only the parameters, but also the underlying CSS styles that affect the menus. Tools like Firebug or the Web Developer Toolbar for the Firefox browser can make the task of styling menus much easier by exposing the styling and making it easy to identify exactly which styles impact which items. You can download the Firebug or Web Developer extensions from http://addons.mozilla.org . Most Read Content module The Most Read Content module allows you to place on the page a list of the most popular articles on the site, as judged by the number of views the article has received. The module displays a list of the items with links to the pages, as shown in Figure 17.22. In the default installation with the sample data installed there is one Most Read Content Modules; it is named Popular and is assigned to various pages in the User2 module position. FIGURE 17.22 The front-end output of the Most Read Content module; in this case the module named Popular in the default installation, shown here assigned to the User3 module position on the front page. Most Read Content module Chapter 17: Working with the Site Modules 389 The Parameters section is divided into two sections: Module parameters and Advanced parameters. Figure 17.23 shows the Module parameters. Note The system name for this module type is mod_mostread. The Module parameters section contains the following controls: l Module class suffix: This field allows you to specify a suffix that will be automatically appended to all CSS styles that affect this module. The use of a specified suffix makes it possible for you to style this module individually. l Front page articles: Determines whether the front page articles are included in the list. l Count: Specify an integer value to control the number of items displayed by this module. The default value is 5. l Category ID: Enter a Category’s ID number to limit the display to articles of a particular category. You can list multiple Category IDs, separating them with commas. l Section ID: Enter a section’s ID number to limit the display to articles of a particular sec- tion. You can list multiple Section IDs, separating them with commas. FIGURE 17.23 The Most Read Content module parameters. Part III: Working with Components, Modules, and Plugins 390 Tip To find a section’s ID number, view the section in the Section Manager. To find a category’s ID number, view the category in the Category Manager. In both cases the ID number appears in the far right column, under the column heading ID. The Advanced parameters section contains caching options: l Caching: This control allows you to exempt a specific module from the site’s caching, as set in the Global Configuration. Select the option No Caching to prevent the contents of this Module from being cached. The default setting is Use Global. l Cache Time: The time, in minutes, you want the contents to be cached. Enter an integer value here. The default value is 900 minutes, meaning that after 900 minutes the system will re-create, or refresh this module. Note this control is only meaningful if the caching for the module is enabled. To add a Most Read Content module to your site, follow these steps: 1. Log in to the admin system of your site. 2. Go to the Extensions menu and select the Module Manager option. The Module Manager loads in your browser. 3. Click the New icon on the toolbar at the top of the Module Manager. The New Module dialogue opens. Refer to Figure 17.2. 4. Select the option Most Read Content and then click the Next button. The Most Read Content Module dialogue loads in your browser. 5. In the Title field, type a name for the module. This is a required field. 6. Set the option called Enabled to the value Yes. 7. Set the Position control to assign the module to a position on the page. 8. Set the Menu Assignment to specify the pages upon which the module will appear. 9. Select any additional options or parameters you wish; all other fields are optional. 10. Click the Save icon on the toolbar at the top right to save your new module. The sys- tem creates the module, close the dialogue and return you to the Module Manager. Tip You can create multiple instances of this module type then use the Category ID and Section ID to create mod- ules to display the most popular items in each of the various sections of your site. Newsflash The Newsflash module provides a way for you to insert into a module position a fixed or rotating content item. The content displayed can be drawn from either a dedicated category or from existing . upgrading to Joomla 1. 5 .x from the old Joomla 1. x. The Legacy styles are intended to help you keep your pre -Joomla 1. 5 formatting and they use different CSS classes than the default Joomla 1. 5 .x menus has a particular syntax that must be followed. A proper entry for this field will specify the position of the submenu in terms of position and size, for example, top=20,left=20,width =10 0,height=200. Note The. menu, as shown in Figure 17 . 21. In the default system with the sample data installed, you find six menu modules named: Main menu, Resources, Key Concepts, User Menu, Example Pages and Top Menu.