Files
crm.e5.pl/modules/ModuleBuilder/parsers/views/ListLayoutMetaDataParser.php

362 lines
15 KiB
PHP
Raw Normal View History

2024-04-27 09:23:34 +02:00
<?php
if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
/*********************************************************************************
* SugarCRM is a customer relationship management program developed by
* SugarCRM, Inc. Copyright (C) 2004-2010 SugarCRM Inc.
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU Affero General Public License version 3 as published by the
* Free Software Foundation with the addition of the following permission added
* to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
* IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
* OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
* details.
*
* You should have received a copy of the GNU Affero General Public License along with
* this program; if not, see http://www.gnu.org/licenses or write to the Free
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301 USA.
*
* You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
* SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "Powered by
* SugarCRM" logo. If the display of the logo is not reasonably feasible for
* technical reasons, the Appropriate Legal Notices must display the words
* "Powered by SugarCRM".
********************************************************************************/
require_once 'modules/ModuleBuilder/parsers/views/AbstractMetaDataParser.php' ;
require_once 'modules/ModuleBuilder/parsers/views/MetaDataParserInterface.php' ;
class ListLayoutMetaDataParser extends AbstractMetaDataParser implements MetaDataParserInterface
{
// Columns is used by the view to construct the listview - each column is built by calling the named function
public $columns = array ( 'LBL_DEFAULT' => 'getDefaultFields' , 'LBL_AVAILABLE' => 'getAdditionalFields' , 'LBL_HIDDEN' => 'getAvailableFields' ) ;
protected $labelIdentifier = 'label' ; // labels in the listviewdefs.php are tagged 'label' =>
protected $allowParent = false;
/*
* Simple function for array_udiff_assoc function call in getAvailableFields()
*/
static function getArrayDiff ($one , $two)
{
$retArray = array();
foreach($one as $key => $value)
{
if (!isset($two[$key]))
{
$retArray[$key] = $value;
}
}
return $retArray;
}
/*
* Constructor
* @param string view The view type, that is, editview, searchview etc
* @param string moduleName The name of the module to which this listview belongs
* @param string packageName If not empty, the name of the package to which this listview belongs
*/
function __construct ($view , $moduleName , $packageName = '')
{
$GLOBALS [ 'log' ]->debug ( get_class ( $this ) . ": __construct()" ) ;
// BEGIN ASSERTIONS
$views = array ( MB_LISTVIEW, MB_DASHLET, MB_DASHLETSEARCH, MB_POPUPLIST, MB_POPUPSEARCH ) ;
if (! in_array ( $view , $views ) )
{
sugar_die ( "ListLayoutMetaDataParser: View $view is not supported" ) ;
}
// END ASSERTIONS
if (empty ( $packageName ))
{
require_once 'modules/ModuleBuilder/parsers/views/DeployedMetaDataImplementation.php' ;
$this->implementation = new DeployedMetaDataImplementation ( $view, $moduleName ) ;
} else
{
require_once 'modules/ModuleBuilder/parsers/views/UndeployedMetaDataImplementation.php' ;
$this->implementation = new UndeployedMetaDataImplementation ( $view, $moduleName, $packageName ) ;
}
$this->view = $view;
$this->_fielddefs = $this->implementation->getFielddefs () ;
$this->_standardizeFieldLabels( $this->_fielddefs );
$this->_viewdefs = array_change_key_case ( $this->implementation->getViewdefs () ) ; // force to lower case so don't have problems with case mismatches later
}
/*
* Deploy the layout
* @param boolean $populate If true (default), then update the layout first with new layout information from the $_REQUEST array
*/
function handleSave ($populate = true)
{
if ($populate)
$this->_populateFromRequest () ;
$this->implementation->deploy ( array_change_key_case ( $this->_viewdefs, CASE_UPPER ) ) ; // force the field names back to upper case so the list view will work correctly
}
function getLayout ()
{
return $this->_viewdefs ;
}
/**
* Return a list of the default fields for a listview
* @return array List of default fields as an array, where key = value = <field name>
*/
function getDefaultFields ()
{
$defaultFields = array ( ) ;
foreach ( $this->_viewdefs as $key => $def )
{
// add in the default fields from the listviewdefs but hide fields disabled in the listviewdefs.
if (! empty ( $def [ 'default' ] )
&& (!isset($def [ 'studio' ]) || ($def [ 'studio' ] !== false && $def [ 'studio' ] != "false")))
{
if (isset($this->_fielddefs [ $key ] )) {
$defaultFields [ $key ] = self::_trimFieldDefs ( $this->_fielddefs [ $key ] ) ;
if (!empty($def['label']))
$defaultFields [ $key ]['label'] = $def['label'];
}
else {
$defaultFields [ $key ] = $def;
}
}
}
return $defaultFields ;
}
/**
* Returns additional fields available for users to create fields
@return array List of additional fields as an array, where key = value = <field name>
*/
function getAdditionalFields ()
{
$additionalFields = array ( ) ;
foreach ( $this->_viewdefs as $key => $def )
{
//#25322
if(strtolower ( $key ) == 'email_opt_out'){
continue;
}
if (empty ( $def [ 'default' ] ))
{
if (isset($this->_fielddefs [ $key ] ))
$additionalFields [ $key ] = self::_trimFieldDefs ( $this->_fielddefs [ $key ] ) ;
else
$additionalFields [ $key ] = $def;
}
}
return $additionalFields ;
}
/**
* Returns unused fields that are available for use in either default or additional list views
* @return array List of available fields as an array, where key = value = <field name>
*/
function getAvailableFields ()
{
$availableFields = array ( ) ;
// Select available fields from the field definitions - don't need to worry about checking if ok to include as the Implementation has done that already in its constructor
foreach ( $this->_fielddefs as $key => $def )
{
if ($this->isValidField($key, $def))
$availableFields [ $key ] = self::_trimFieldDefs( $this->_fielddefs [ $key ] ) ;
$origDefs = $this->getOriginalViewDefs();
foreach($origDefs as $key => $def)
{
$availableFields [ $key ] = $def;
}
}
//$GLOBALS['log']->debug(get_class($this).'->getAvailableFields(): '.print_r($availableFields,true));
// now remove all fields that are already in the viewdef - they are not available; they are in use
return ListLayoutMetaDataParser::getArrayDiff ( $availableFields, $this->_viewdefs) ;
}
public function isValidField($key, $def)
{
//Studio invisible fields should always be hidden
if (! empty ($def[ 'studio' ] ) )
{
if (is_array($def [ 'studio' ]))
{
if (isset($def [ 'studio' ]['listview']))
return $def [ 'studio' ]['listview'] !== false && $def [ 'studio' ]['listview'] != 'false';
if (isset($def [ 'studio' ]['visible']))
return $def [ 'studio' ]['visible'];
} else
{
return ($def [ 'studio' ] != 'false' && $def [ 'studio' ] !== false && $def [ 'studio' ] != 'hidden') ;
}
}
//Bug 32520. We need to dissalow currency_id fields on list views.
//This should be removed once array based studio definitions are in.
if (isset($def['type']) && $def['type'] == "id" && $def['name'] == 'currency_id')
return false;
//Check fields types
if (isset($def['dbType']) && $def['dbType'] == "id")
{
return false;
}
if (isset($def['type']))
{
if ($def['type'] == 'html' || ($def['type'] == 'parent' && !$this->allowParent)
|| $def['type'] == "id" || $def['type'] == "link" || $def['type'] == 'image')
return false;
}
//hide currency_id, deleted, and _name fields by key-name
if(strcmp ( $key, 'deleted' ) == 0 ) {
return false;
}
//if all the tests failed, the field is probably ok
return true;
}
protected function _populateFromRequest ()
{
$GLOBALS [ 'log' ]->debug ( get_class ( $this ) . "->populateFromRequest() - fielddefs = ".print_r($this->_fielddefs, true));
// Transfer across any reserved fields, that is, any where studio !== true, which are not editable but must be preserved
$newViewdefs = array ( ) ;
$rejectTypes = array ( 'html'=>'html' , 'enum'=>'enum' , 'text'=>'text', 'encrypt'=>'encrypt' ) ;
$originalViewDefs = $this->getOriginalViewDefs();
foreach ( $this->_viewdefs as $key => $def )
{
//If the field is on the layout, but studio disabled, put it back on the layout at the front
if (isset ($def['studio']) && (
(is_array($def['studio']) && isset($def['studio']['listview']) &&
($def['studio']['listview'] === false || strtolower($def['studio']['listview']) == 'false'
|| strtolower($def['studio']['listview']) == 'required')
)
|| (!is_array($def['studio']) &&
($def [ 'studio' ] === false || strtolower($def['studio']) == 'false' || strtolower($def['studio']) == 'required'))
))
{
$newViewdefs [ $key ] = $def ;
}
}
// only take items from group_0 for searchviews (basic_search or advanced_search) and subpanels (which both are missing the Available column) - take group_0, _1 and _2 for all other list views
$lastGroup = (isset ( $this->columns [ 'LBL_AVAILABLE' ] )) ? 2 : 1 ;
for ( $i = 0 ; isset ( $_POST [ 'group_' . $i ] ) && $i < $lastGroup ; $i ++ )
{
foreach ( $_POST [ 'group_' . $i ] as $fieldname )
{
$fieldname = strtolower ( $fieldname ) ;
//Check if the field was previously on the layout
if (isset ($this->_viewdefs[$fieldname])) {
$newViewdefs [ $fieldname ] = $this->_viewdefs[$fieldname];
// print_r($this->_viewdefs[ $fieldname ]);
}
//Next check if the original view def contained it
else if (isset($originalViewDefs[ $fieldname ]))
{
$newViewdefs [ $fieldname ] = $originalViewDefs[ $fieldname ];
}
//create a definition from the fielddefs
else
{
// if we don't have a valid fieldname then just ignore it and move on...
if ( ! isset ( $this->_fielddefs [ $fieldname ] ) )
continue ;
$newViewdefs [ $fieldname ] = $this->_trimFieldDefs($this->_fielddefs [ $fieldname ]) ;
// sorting fields of certain types will cause a database engine problems
if ( isset($this->_fielddefs[$fieldname]['type']) &&
isset ( $rejectTypes [ $this->_fielddefs [ $fieldname ] [ 'type' ] ] ))
{
$newViewdefs [ $fieldname ] [ 'sortable' ] = false ;
}
// Bug 23728 - Make adding a currency type field default to setting the 'currency_format' to true
if (isset ( $this->_fielddefs [ $fieldname ] [ 'type' ]) && $this->_fielddefs [ $fieldname ] [ 'type' ] == 'currency')
{
$newViewdefs [ $fieldname ] [ 'currency_format' ] = true;
}
}
if (isset ( $_REQUEST [ strtolower ( $fieldname ) . 'width' ] ))
{
$width = substr ( $_REQUEST [ $fieldname . 'width' ], 6, 3 ) ;
if (strpos ( $width, "%" ) != false)
{
$width = substr ( $width, 0, 2 ) ;
}
if (!($width < 101 && $width > 0))
{
$width = 10;
}
$newViewdefs [ $fieldname ] [ 'width' ] = $width."%" ;
} else if (isset ( $this->_viewdefs [ $fieldname ] [ 'width' ] ))
{
$newViewdefs [ $fieldname ] [ 'width' ] = $this->_viewdefs [ $fieldname ] [ 'width' ] ;
}
else {
$newViewdefs [ $fieldname ] [ 'width' ] = "10%";
}
$newViewdefs [ $fieldname ] [ 'default' ] = ($i == 0) ;
}
}
$this->_viewdefs = $newViewdefs ;
}
/*
* Remove all instances of a field from the layout
* @param string $fieldName Name of the field to remove
* @return boolean True if the field was removed; false otherwise
*/
function removeField ($fieldName)
{
if (isset ( $this->_viewdefs [ $fieldName ] ))
{
unset( $this->_viewdefs [ $fieldName ] ) ;
return true ;
}
return false ;
}
function getOriginalViewDefs() {
$defs = $this->implementation->getOriginalViewdefs ();
$out = array();
foreach ($defs as $field => $def)
{
$out[strtolower($field)] = $def;
}
return $out;
}
static function _trimFieldDefs ( $def )
{
if ( isset ( $def [ 'vname' ] ) )
$def [ 'label' ] = $def [ 'vname' ] ;
return array_intersect_key ( $def , array ( 'type' => true, 'studio' => true , 'label' => true , 'width' => true , 'sortable' => true , 'related_fields' => true , 'default' => true , 'link' => true , 'align' => true , 'orderBy' => true ,'hideLabel' => true, 'customLable' => true , 'currency_format' => true ) ) ;
}
}