include/SubPanel/SubPanel.php

   1 <?php
   2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
   3 /*********************************************************************************
   4  * SugarCRM Community Edition is a customer relationship management program developed by
   5  * SugarCRM, Inc. Copyright (C) 2004-2011 SugarCRM Inc.
   6  *
   7  * This program is free software; you can redistribute it and/or modify it under
   8  * the terms of the GNU Affero General Public License version 3 as published by the
   9  * Free Software Foundation with the addition of the following permission added
  10  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
  11  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
  12  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
  13  *
  14  * This program is distributed in the hope that it will be useful, but WITHOUT
  15  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  16  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
  17  * details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License along with
  20  * this program; if not, see http://www.gnu.org/licenses or write to the Free
  21  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  22  * 02110-1301 USA.
  23  *
  24  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
  25  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
  26  *
  27  * The interactive user interfaces in modified source and object code versions
  28  * of this program must display Appropriate Legal Notices, as required under
  29  * Section 5 of the GNU Affero General Public License version 3.
  30  *
  31  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
  32  * these Appropriate Legal Notices must retain the display of the "Powered by
  33  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
  34  * technical reasons, the Appropriate Legal Notices must display the words
  35  * "Powered by SugarCRM".
  36  ********************************************************************************/
  37
  38 require_once('include/SubPanel/registered_layout_defs.php');
  39 /**
  40  * Subpanel
  41  * @api
  42  */
  43 class SubPanel
  44 {
  45         var $hideNewButton = false;
  46         var $subpanel_id;
  47         var $parent_record_id;
  48         var $parent_module;  // the name of the parent module
  49         var $parent_bean;  // the instantiated bean of the parent
  50         var $template_file;
  51         var $linked_fields;
  52         var $action = 'DetailView';
  53         var $show_select_button = true;
  54         var $subpanel_define = null;  // contains the layout_def.php
  55         var $subpanel_defs;
  56         var $subpanel_query=null;
  57     var $layout_def_key='';
  58         function SubPanel($module, $record_id, $subpanel_id, $subpanelDef, $layout_def_key='')
  59         {
  60                 global $theme, $beanList, $beanFiles, $focus, $app_strings;
  61
  62                 $this->subpanel_defs=$subpanelDef;
  63                 $this->subpanel_id = $subpanel_id;
  64                 $this->parent_record_id = $record_id;
  65                 $this->parent_module = $module;
  66         $this->layout_def_key = $layout_def_key;
  67
  68                 $this->parent_bean = $focus;
  69                 $result = $focus;
  70
  71                 if(empty($result))
  72                 {
  73                         $parent_bean_name = $beanList[$module];
  74                         $parent_bean_file = $beanFiles[$parent_bean_name];
  75                         require_once($parent_bean_file);
  76                         $this->parent_bean = new $parent_bean_name();
  77             $this->parent_bean->retrieve($this->parent_record_id);
  78             $result = $this->parent_bean;
  79                 }
  80
  81                 if($record_id!='fab4' && $result == null)
  82                 {
  83                         sugar_die($app_strings['ERROR_NO_RECORD']);
  84                 }
  85
  86                 if (empty($subpanelDef)) {
  87                         //load the subpanel by name.
  88                         if (!class_exists('MyClass')) {
  89                                 require_once 'include/SubPanel/SubPanelDefinitions.php' ;
  90                         }
  91                         $panelsdef=new SubPanelDefinitions($result,$layout_def_key);
  92                         $subpanelDef=$panelsdef->load_subpanel($subpanel_id);
  93                         $this->subpanel_defs=$subpanelDef;
  94
  95                 }
  96
  97         }
  98
  99         function setTemplateFile($template_file)
 100         {
 101                 $this->template_file = $template_file;
 102         }
 103
 104         function setBeanList(&$value){
 105                 $this->bean_list =$value;
 106         }
 107
 108         function setHideNewButton($value){
 109                 $this->hideNewButton = $value;
 110         }
 111
 112
 113         function getHeaderText( $currentModule){
 114         }
 115
 116         function get_buttons( $panel_query=null)
 117         {
 118
 119                 $thisPanel =& $this->subpanel_defs;
 120                 $subpanel_def = $thisPanel->get_buttons();
 121
 122                 if(!isset($this->listview)){
 123                         $this->listview = new ListView();
 124                 }
 125                 $layout_manager = $this->listview->getLayoutManager();
 126                 $widget_contents = '<div><table cellpadding="0" cellspacing="0"><tr>';
 127                 foreach($subpanel_def as $widget_data)
 128                 {
 129                         $widget_data['query']=urlencode($panel_query);
 130                         $widget_data['action'] = $_REQUEST['action'];
 131                         $widget_data['module'] =  $thisPanel->get_inst_prop_value('module');
 132                         $widget_data['focus'] = $this->parent_bean;
 133                         $widget_data['subpanel_definition'] = $thisPanel;
 134                         $widget_contents .= '<td style="padding-right: 2px; padding-bottom: 2px;">' . "\n";
 135
 136                         if(empty($widget_data['widget_class']))
 137                         {
 138                                 $widget_contents .= "widget_class not defined for top subpanel buttons";
 139                         }
 140                         else
 141                         {
 142                                 $widget_contents .= $layout_manager->widgetDisplay($widget_data);
 143                         }
 144
 145                         $widget_contents .= '</td>';
 146                 }
 147
 148                 $widget_contents .= '</tr></table></div>';
 149                 return $widget_contents;
 150         }
 151
 152
 153         function ProcessSubPanelListView($xTemplatePath, &$mod_strings)
 154         {
 155                 global $app_strings;
 156                 global $current_user;
 157                 global $sugar_config;
 158
 159                 if(isset($this->listview)){
 160                         $ListView =& $this->listview;
 161                 }else{
 162                         $ListView = new ListView();
 163                 }
 164                 $ListView->initNewXTemplate($xTemplatePath,$this->subpanel_defs->mod_strings);
 165                 $ListView->xTemplateAssign("RETURN_URL", "&return_module=".$this->parent_module."&return_action=DetailView&return_id=".$this->parent_bean->id);
 166                 $ListView->xTemplateAssign("RELATED_MODULE", $this->parent_module);  // TODO: what about unions?
 167                 $ListView->xTemplateAssign("RECORD_ID", $this->parent_bean->id);
 168                 $ListView->xTemplateAssign("EDIT_INLINE_PNG", SugarThemeRegistry::current()->getImage('edit_inline','align="absmiddle"  border="0"',null,null,'.gif',$app_strings['LNK_EDIT']));
 169                 $ListView->xTemplateAssign("DELETE_INLINE_PNG", SugarThemeRegistry::current()->getImage('delete_inline','align="absmiddle" border="0"',null,null,'.gif',$app_strings['LBL_DELETE_INLINE']));
 170                 $ListView->xTemplateAssign("REMOVE_INLINE_PNG", SugarThemeRegistry::current()->getImage('delete_inline','align="absmiddle" border="0"',null,null,'.gif',$app_strings['LBL_ID_FF_REMOVE']));
 171                 $header_text= '';
 172
 173                 if(is_admin($current_user) && $_REQUEST['module'] != 'DynamicLayout' && !empty($_SESSION['editinplace']))
 174                 {
 175                         $exploded = explode('/', $xTemplatePath);
 176                         $file_name = $exploded[sizeof($exploded) - 1];
 177                         $mod_name =  $exploded[sizeof($exploded) - 2];
 178                         $header_text= "&nbsp;<a href='index.php?action=index&module=DynamicLayout&from_action=$file_name&from_module=$mod_name&mod_lang="
 179                                 .$_REQUEST['module']."'>".SugarThemeRegistry::current()->getImage("EditLayout","border='0' align='bottom'",null,null,'.gif','Edit Layout')."</a>";
 180                 }
 181                 $ListView->setHeaderTitle('');
 182                 $ListView->setHeaderText('');
 183
 184                 ob_start();
 185
 186                 $ListView->is_dynamic = true;
 187                 $ListView->records_per_page = $sugar_config['list_max_entries_per_subpanel'] + 0;
 188                 $ListView->start_link_wrapper = "javascript:showSubPanel('".$this->subpanel_id."','";
 189                 $ListView->subpanel_id = $this->subpanel_id;
 190                 $ListView->end_link_wrapper = "',true);";
 191         if ( !empty($this->layout_def_key) ) {
 192             $ListView->end_link_wrapper = '&layout_def_key='.$this->layout_def_key.$ListView->end_link_wrapper;
 193         }
 194
 195                 $where = '';
 196                 $ListView->setQuery($where, '', '', '');
 197                 $ListView->show_export_button = false;
 198
 199                 //function returns the query that was used to populate sub-panel data.
 200
 201                 $query=$ListView->process_dynamic_listview($this->parent_module, $this->parent_bean,$this->subpanel_defs);
 202         $this->subpanel_query=$query;
 203                 $ob_contents = ob_get_contents();
 204                 ob_end_clean();
 205                 return $ob_contents;
 206         }
 207
 208         function display()
 209         {
 210                 global $timedate;
 211                 global $mod_strings;
 212                 global $app_strings;
 213                 global $app_list_strings;
 214                 global $beanList;
 215                 global $beanFiles;
 216                 global $current_language;
 217
 218                 $result_array = array();
 219
 220                 $return_string = $this->ProcessSubPanelListView($this->template_file,$result_array);
 221
 222                 print $return_string;
 223         }
 224
 225         function getModulesWithSubpanels()
 226         {
 227                 global $beanList;
 228                 $dir = dir('modules');
 229                 $modules = array();
 230                 while($entry = $dir->read())
 231                 {
 232                         if(file_exists('modules/' . $entry . '/layout_defs.php'))
 233                         {
 234                                 $modules[$entry] = $entry;
 235                         }
 236                 }
 237                 return $modules;
 238         }
 239
 240   function getModuleSubpanels($module){
 241         require_once('include/SubPanel/SubPanelDefinitions.php');
 242                 global $beanList, $beanFiles;
 243                 if(!isset($beanList[$module])){
 244                         return array();
 245                 }
 246
 247                 $class = $beanList[$module];
 248                 require_once($beanFiles[$class]);
 249                 $mod = new $class();
 250                 $spd = new SubPanelDefinitions($mod);
 251                 $tabs = $spd->get_available_tabs(true);
 252                 $ret_tabs = array();
 253                 $reject_tabs = array('history'=>1, 'activities'=>1);
 254                 foreach($tabs as $key=>$tab){
 255                     foreach($tab as $k=>$v){
 256                 if (! isset ( $reject_tabs [$k] )) {
 257                     $ret_tabs [$k] = $v;
 258                 }
 259             }
 260                 }
 261
 262                 return $ret_tabs;
 263
 264
 265   }
 266
 267   //saves overrides for defs
 268   function saveSubPanelDefOverride( $panel, $subsection, $override){
 269                 global $layout_defs, $beanList;
 270
 271                 //save the new subpanel
 272                 $name = "subpanel_layout['list_fields']";
 273
 274                 //bugfix: load looks for moduleName/metadata/subpanels, not moduleName/subpanels
 275                 $path = 'custom/modules/'. $panel->_instance_properties['module'] . '/metadata/subpanels';
 276
 277                 //bug# 40171: "Custom subpanels not working as expected"
 278                 //each custom subpanel needs to have a unique custom def file
 279                 $filename = $panel->parent_bean->object_name . "_subpanel_" . $panel->name; //bug 42262 (filename with $panel->_instance_properties['get_subpanel_data'] can create problem if had word "function" in it)
 280                 $oldName1 = '_override' . $panel->parent_bean->object_name .$panel->_instance_properties['module'] . $panel->_instance_properties['subpanel_name'] ;
 281                 $oldName2 = '_override' . $panel->parent_bean->object_name .$panel->_instance_properties['get_subpanel_data'] ;
 282                 if (file_exists('custom/Extension/modules/'. $panel->parent_bean->module_dir . "/Ext/Layoutdefs/$oldName1.php")){
 283                   unlink('custom/Extension/modules/'. $panel->parent_bean->module_dir . "/Ext/Layoutdefs/$oldName1.php");
 284                 }
 285                 if (file_exists('custom/Extension/modules/'. $panel->parent_bean->module_dir . "/Ext/Layoutdefs/$oldName2.php")){
 286          unlink('custom/Extension/modules/'. $panel->parent_bean->module_dir . "/Ext/Layoutdefs/$oldName2.php");
 287                 }
 288                 $extname = '_override'.$filename;
 289                 //end of bug# 40171
 290
 291                 mkdir_recursive($path, true);
 292                 write_array_to_file( $name, $override,$path.'/' . $filename .'.php');
 293
 294                 //save the override for the layoutdef
 295         //tyoung 10.12.07 pushed panel->name to lowercase to match case in subpaneldefs.php files -
 296         //gave error on bad index 'module' as this override key didn't match the key in the subpaneldefs
 297                 $name = "layout_defs['".  $panel->parent_bean->module_dir. "']['subpanel_setup']['" .strtolower($panel->name). "']";
 298 //      $GLOBALS['log']->debug('SubPanel.php->saveSubPanelDefOverride(): '.$name);
 299                 $newValue = override_value_to_string($name, 'override_subpanel_name', $filename);
 300                 mkdir_recursive('custom/Extension/modules/'. $panel->parent_bean->module_dir . '/Ext/Layoutdefs', true);
 301                 $fp = sugar_fopen('custom/Extension/modules/'. $panel->parent_bean->module_dir . "/Ext/Layoutdefs/$extname.php", 'w');
 302                 fwrite($fp, "<?php\n//auto-generated file DO NOT EDIT\n$newValue\n?>");
 303                 fclose($fp);
 304                 require_once('ModuleInstall/ModuleInstaller.php');
 305                 $moduleInstaller = new ModuleInstaller();
 306                 $moduleInstaller->silent = true; // make sure that the ModuleInstaller->log() function doesn't echo while rebuilding the layoutdefs
 307                 $moduleInstaller->rebuild_layoutdefs();
 308                 if (file_exists('modules/'.  $panel->parent_bean->module_dir . '/layout_defs.php'))
 309                         include('modules/'.  $panel->parent_bean->module_dir . '/layout_defs.php');
 310                 if (file_exists('custom/modules/'.  $panel->parent_bean->module_dir . '/Ext/Layoutdefs/layoutdefs.ext.php'))
 311                         include('custom/modules/'.  $panel->parent_bean->module_dir . '/Ext/Layoutdefs/layoutdefs.ext.php');
 312   }
 313
 314         function get_subpanel_setup($module)
 315         {
 316                 $subpanel_setup = '';
 317                 $layout_defs = get_layout_defs();
 318
 319                 if(!empty($layout_defs) && !empty($layout_defs[$module]['subpanel_setup']))
 320       {
 321         $subpanel_setup = $layout_defs[$module]['subpanel_setup'];
 322       }
 323
 324       return $subpanel_setup;
 325         }
 326
 327         /**
 328          * Retrieve the subpanel definition from the registered layout_defs arrays.
 329          */
 330         function getSubPanelDefine($module, $subpanel_id)
 331         {
 332                 $default_subpanel_define = SubPanel::_get_default_subpanel_define($module, $subpanel_id);
 333                 $custom_subpanel_define = SubPanel::_get_custom_subpanel_define($module, $subpanel_id);
 334
 335                 $subpanel_define = array_merge($default_subpanel_define, $custom_subpanel_define);
 336
 337                 if(empty($subpanel_define))
 338                 {
 339                         print('Could not load subpanel definition for: ' . $subpanel_id);
 340                 }
 341
 342                 return $subpanel_define;
 343         }
 344
 345         function _get_custom_subpanel_define($module, $subpanel_id)
 346         {
 347                 $ret_val = array();
 348
 349                 if($subpanel_id != '')
 350                 {
 351                         $layout_defs = get_layout_defs();
 352
 353                         if(!empty($layout_defs[$module]['custom_subpanel_defines'][$subpanel_id]))
 354                         {
 355                                 $ret_val = $layout_defs[$module]['custom_subpanel_defines'][$subpanel_id];
 356                         }
 357                 }
 358
 359                 return $ret_val;
 360         }
 361
 362         function _get_default_subpanel_define($module, $subpanel_id)
 363         {
 364                 $ret_val = array();
 365
 366                 if($subpanel_id != '')
 367                 {
 368                         $layout_defs = get_layout_defs();
 369
 370                         if(!empty($layout_defs[$subpanel_id]['default_subpanel_define']))
 371                         {
 372                                 $ret_val = $layout_defs[$subpanel_id]['default_subpanel_define'];
 373                         }
 374                 }
 375
 376                 return $ret_val;
 377         }
 378 }
 379 ?>