include/SugarFields/SugarFieldHandler.php

   1 <?php
   2 /*********************************************************************************
   3  * SugarCRM Community Edition is a customer relationship management program developed by
   4  * SugarCRM, Inc. Copyright (C) 2004-2011 SugarCRM Inc.
   5  *
   6  * This program is free software; you can redistribute it and/or modify it under
   7  * the terms of the GNU Affero General Public License version 3 as published by the
   8  * Free Software Foundation with the addition of the following permission added
   9  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
  10  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
  11  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
  12  *
  13  * This program is distributed in the hope that it will be useful, but WITHOUT
  14  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  15  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
  16  * details.
  17  *
  18  * You should have received a copy of the GNU Affero General Public License along with
  19  * this program; if not, see http://www.gnu.org/licenses or write to the Free
  20  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  21  * 02110-1301 USA.
  22  *
  23  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
  24  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
  25  *
  26  * The interactive user interfaces in modified source and object code versions
  27  * of this program must display Appropriate Legal Notices, as required under
  28  * Section 5 of the GNU Affero General Public License version 3.
  29  *
  30  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
  31  * these Appropriate Legal Notices must retain the display of the "Powered by
  32  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
  33  * technical reasons, the Appropriate Legal Notices must display the words
  34  * "Powered by SugarCRM".
  35  ********************************************************************************/
  36
  37 class SugarFieldHandler {
  38
  39     function SugarFieldHandler() {
  40     }
  41
  42     static function fixupFieldType($field) {
  43             switch($field) {
  44                case 'double':
  45                case 'decimal':
  46                     $field = 'float';
  47                     break;
  48                case 'uint':
  49                case 'ulong':
  50                case 'long':
  51                case 'short':
  52                case 'tinyint':
  53                     $field = 'int';
  54                     break;
  55                case 'date':
  56                     $field = 'datetime';
  57                     break;
  58                case 'url':
  59                         $field = 'link';
  60                         break;
  61                case 'varchar':
  62                     $field = 'base';
  63                     break;
  64             }
  65
  66         return ucfirst($field);
  67     }
  68
  69     /**
  70      * return the singleton of the SugarField
  71      *
  72      * @param field string field type
  73      */
  74     static function getSugarField($field, $returnNullIfBase=false) {
  75         static $sugarFieldObjects = array();
  76
  77         $field = self::fixupFieldType($field);
  78         $field = ucfirst($field);
  79
  80         if(!isset($sugarFieldObjects[$field])) {
  81                 //check custom directory
  82                 if(file_exists('custom/include/SugarFields/Fields/' . $field . '/SugarField' . $field. '.php')){
  83                         $file = 'custom/include/SugarFields/Fields/' . $field . '/SugarField' . $field. '.php';
  84                 $type = $field;
  85                         //else check the fields directory
  86                         }else if(file_exists('include/SugarFields/Fields/' . $field . '/SugarField' . $field. '.php')){
  87                         $file = 'include/SugarFields/Fields/' . $field . '/SugarField' . $field. '.php';
  88                 $type = $field;
  89                 }else{
  90                 // No direct class, check the directories to see if they are defined
  91                         if( $returnNullIfBase &&
  92                     !is_dir('custom/include/SugarFields/Fields/'.$field) &&
  93                     !is_dir('include/SugarFields/Fields/'.$field) ) {
  94                     return null;
  95                 }
  96                         $file = 'include/SugarFields/Fields/Base/SugarFieldBase.php';
  97                 $type = 'Base';
  98                 }
  99                         require_once($file);
 100
 101                         $class = 'SugarField' . $type;
 102                         //could be a custom class check it
 103                         $customClass = 'Custom' . $class;
 104                 if(class_exists($customClass)){
 105                         $sugarFieldObjects[$field] = new $customClass($field);
 106                 }else{
 107                         $sugarFieldObjects[$field] = new $class($field);
 108                 }
 109         }
 110         return $sugarFieldObjects[$field];
 111     }
 112
 113     /**
 114      * Returns the smarty code to be used in a template built by TemplateHandler
 115      * The SugarField class is choosen dependant on the vardef's type field.
 116      *
 117      * @param parentFieldArray string name of the variable in the parent template for the bean's data
 118      * @param vardef vardef field defintion
 119      * @param displayType string the display type for the field (eg DetailView, EditView, etc)
 120      * @param displayParam parameters for displayin
 121      *      available paramters are:
 122      *      * labelSpan - column span for the label
 123      *      * fieldSpan - column span for the field
 124      */
 125     static function displaySmarty($parentFieldArray, $vardef, $displayType, $displayParams = array(), $tabindex = 1) {
 126         $string = '';
 127         $displayTypeFunc = 'get' . $displayType . 'Smarty'; // getDetailViewSmarty, getEditViewSmarty, etc...
 128
 129                 // This will handle custom type fields.
 130                 // The incoming $vardef Array may have custom_type set.
 131                 // If so, set $vardef['type'] to the $vardef['custom_type'] value
 132                 if(isset($vardef['custom_type'])) {
 133                    $vardef['type'] = $vardef['custom_type'];
 134                 }
 135                 if(empty($vardef['type'])) {
 136                         $vardef['type'] = 'varchar';
 137                 }
 138
 139                 $field = self::getSugarField($vardef['type']);
 140                 if ( !empty($vardef['function']) ) {
 141                         $string = $field->displayFromFunc($displayType, $parentFieldArray, $vardef, $displayParams, $tabindex);
 142                 } else {
 143                         $string = $field->$displayTypeFunc($parentFieldArray, $vardef, $displayParams, $tabindex);
 144                 }
 145
 146         return $string;
 147     }
 148 }
 149
 150
 151 ?>