HOW TO: Override a Template

[luisfdo]

Overriding a template from detailview, listview or editview:

1. Create a directory called /modules/<YOUR_MODULE>/views

2. Create the file /modules/<YOUR_MODULE>/views/view.list.php
You can change list to detail or edit, to another view.

3. Put the following code on view.list.php

 <?php
    require_once('include/MVC/View/views/view.list.php');
 
    class <YOUR_MODULE>ViewList extends ViewList{    
    function <YOUR_MODULE>ViewList(){        
        parent::ViewList();    
    }
        function display(){
                parent::display();
        }
        function listViewProcess(){
        $this->processSearchForm();
        $this->lv->searchColumns = $this->searchForm->searchColumns;
        
        if(!$this->headers)
            return;
        if(empty($_REQUEST['search_form_only']) || $_REQUEST['search_form_only'] == false){
            //here we are overriding with your custom template, in my case I just modified ListViewGeneric.
                        $this->lv->setup($this->seed, 'custom/modules/<YOUR_MODULE>/tpls/ListViewGeneric.tpl', $this->where, $this->params);
            $savedSearchName = empty($_REQUEST['saved_search_select_name']) ? '' : (' - ' . $_REQUEST['saved_search_select_name']);
            echo get_form_header($GLOBALS['mod_strings']['LBL_LIST_FORM_TITLE'] . $savedSearchName, '', false);
            echo $this->lv->display();
        }
     } 
} 
?>  

4. Create a file ListViewGeneric.tpl in /custom/modules/<YOUR_MODULE>/tpls.
You can copy the original template from /include/ListView/ListViewGeneric.tpl
Here you can modified the template in many ways.


Enjoy it.

[genius786]

Hi,

A great description you provided which is very helpful to me.


Best regards,

[monicaDC]

this is good stuff!!! Thank you!!

[Qamrun]

Its very helpful.... Thanks a lot

[carlaa]

I follow this tutorial but nothing change, my list is showing no itens

there is a similar way to change a subpanel 's template ?

[notestopies]

hi all,
thanks a lot luisfdo's Avatar luisfdo!
I could create customized temlate as per instructions.

Now, my need is to disable checkbox in listview. Does anyone how to display 'checked n disabled' checkbox based on condition in ListView?

i tried this in custom ListViewGeneric.tpl

changed

<input onclick='sListView.check_item(this, document.MassUpdate)' type='checkbox' class='checkbox' name='mass[]' value='{$rowData.ID}'>

to

<input onclick='sListView.check_item(this, document.MassUpdate)' type='checkbox' class='checkbox' name='mass[]' value='{$rowData.ID}' checked disabled>

result: App is displaying checked n disabled chekbox for a while and again app is reverting back to unchecked enabled checkbox. WHY?

regards,
prashant.y

[SugarDev.net]

If you are doing this tutorial, always check for an existing override in modules/<module>/views/view.list.php. If there is one, use that one instead of the code above.

[Rom_]

3. Put the following code on view.list.php

 <?php
    require_once('include/MVC/View/views/view.list.php');
 
    class <YOUR_MODULE>ViewList extends ViewList{    
    function <YOUR_MODULE>ViewList(){        
        parent::ViewList();    
    }
        function display(){
                parent::display();
        }
        function listViewProcess(){
        $this->processSearchForm();
        $this->lv->searchColumns = $this->searchForm->searchColumns;
        
        if(!$this->headers)
            return;
        if(empty($_REQUEST['search_form_only']) || $_REQUEST['search_form_only'] == false){
            //here we are overriding with your custom template, in my case I just modified ListViewGeneric.
                        $this->lv->setup($this->seed, 'custom/modules/<YOUR_MODULE>/tpls/ListViewGeneric.tpl', $this->where, $this->params);
            $savedSearchName = empty($_REQUEST['saved_search_select_name']) ? '' : (' - ' . $_REQUEST['saved_search_select_name']);
            echo get_form_header($GLOBALS['mod_strings']['LBL_LIST_FORM_TITLE'] . $savedSearchName, '', false);
            echo $this->lv->display();
        }
     } 
} 
?>  

Someone can give me the code PHP for detail view and edit detail please ?

[cchiu]

can anyone answer this? how do you do it for detail or edit?

[jamdavjame_2007]

Thanks for sharing the description .I solved my problem that way