Viewing 2 posts - 1 through 2 (of 2 total)
  • Author
    Posts
  • Hung Dinh Friend
    #170338
    Userguide – JA Masshead Module for Joomla 1.7

    JA Masshead Module is used to display masshead title like the JoomlArt masshead. Title and description could be specify configured for any page


    Module Configuration

    If you are new to Joomla!, please follow the instruction in the guide below to install module in your Joomla! 1.7 system.

    How to install module for joomla 1.7

    Back-end Setting

    Parameter Explanation

    • Default Title: set the default tile for this module. The title will be displayed incase the Extra configuration field is not set
    • Default Description: set the default descriptionfor this module. The title will be displayed incase the Extra configuration field is not set
    • Configuration Condition: This field allows you to assign masshead to display in specific pages by using Itemid of that pages
    • The field uses 2 format:
      Format 1:

      [Masshead option="com_name" view="view_name" layout="layout_name" task="task_name" id="id" title="Title" ]Description here[/Masshead]

      Format 2:

      [Masshead Itemid="page_id_1,page_id_2,..." title="Title" ]Description here[/Masshead]

    Front-end Appearance

    Note: There are some cases that you should pay attention when configuring the module.

    1. If configuration field is empty:
      • If this is an article view: use Article title as Mass title, use default description set in backend of the module to display as Mass description
      • Example:

      • If this is an Menu view: use page heading as Mass title, use default description set in backend of the module to display as Mass description
      • Example:

        To view Page heading of menu, from backend of your site, navigate to: Menus –> Main menus –> select a Menu –> Page Display Options –> Page heading

        Front-end Appearance

      • If this is an Menu view and the page heading of the menu = null: use default title and description set in backend of the module to display as Mass title and descript
      • Example:

        Front-end Appearance

  • If configuration field is found:
    1. Use that value
    2. Support multiple config, each config on a line; eg:
    3. [Masshead option="com_name1" view="view_name1" layout="layout_name1" task="task_name1" id="id1" title="Title1" ]Description 1 here[/Masshead]
      [Masshead option="com_name2" view="view_name1" layout="layout_name2" task="task_name2" id="id2" title="Title2" ]Description 2 here[/Masshead]
      [Masshead Itemid="page_id1_1,page_id1_2,..." title="Title page 1" ]Description page 1 here[/Masshead]
      [Masshead Itemid="page_id2_1,page_id2_2,..." title="Title page 2" ]Description page 2 here[/Masshead]

    4. If config set multiple condition, the module will return value in the first condition true

    5. Example 1: using format 1:

      [Masshead option="com_name1" view="view_name1" layout="layout_name1" task="task_name1" id="id1" title="Title1" ]Description 1 here[/Masshead]

      How to get condition values for: option, view, layout ….
      Firstly, you have to disable Search Engine Friendly URLs option. To do that, from the back-end of your site, go to: Site –> Global Configuration –> then navigate to SEO Settings —> set No for field: Search Engine Friendly URLs
      When done, from front-end, go to page where you want to add condition in masshead module, you will see the condition of the page where you can get to configure for the masshead module.

      If you add all the conditions so the code for the Configuration Condition should be:

      [Masshead option="com_content" view="category" layout="blog" id="84" title="Enter your mass title" ]Enter your mass description[/Masshead]

      Example 2: using format 2:

      [Masshead Itemid="page_id1_1,page_id1_2,..." title="Title page 1" ]Description page 1 here[/Masshead]

      How to get condition values for: Itemid?
      You do the same with the guide in the Example 1 but now, the condition is page_id.

      If you decide to add the condition in the module so the code for the Configuration Condition should be:

      [Masshead Itemid="238,499" title="Using Format 2" ]Display Masshead in defined page id = 238 and 499[/Masshead]

      • The Mass title and description should be displayed the same in the all defined page id in the back-end of masshead module
      • If config set multiple condition, the module will return value in the first condition true

    6. Validate masshead data, if each part of masshead data is empty, it is assigned to default value:
      • If masshead title is empty: masshead title = default title
      • Example:

        [Masshead Itemid="238"]Display Masshead in defined page id = 238 and 499[/Masshead]

      • If masshead description is empty: masshead description = default description
      • Example:

        [Masshead Itemid="238" title="Using Format 2"][/Masshead]

    7. Use extra parameters
      • Extra parameters can put in config as name=”value” and access through variable $masshead[‘params’][‘name’] by overwritting module layout in template
      • [Masshead Itemid="page_id" title="Title" background="image url"]Description[/Masshead]

      • Access the param background:
      • [PHP]<div class=”jamasshead” <?php if(isset($masshead[‘params’][‘background’])): ?> style=”background-image: url(<?php echo $masshead[‘params’][‘background’] ?>)” <?php endif; ?>> [/PHP]
        Example:

        [Masshead Itemid="238" title="Using Format 2r" background="images/stories/masshead/mh-5.jpg"]Display Masshead in defined page id = 238 and 499[/Masshead]

        Front-end

John Wesley Brett Moderator
#436916

View the JA Tiris User Guide for more information

Viewing 2 posts - 1 through 2 (of 2 total)

This topic contains 2 replies, has 2 voices, and was last updated by  John Wesley Brett 12 years, 9 months ago.

We moved to new unified forum. Please post all new support queries in our New Forum