xml/templates/dao.tpl

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.7                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2017                                |
   7  +--------------------------------------------------------------------+
   8  | This file is a part of CiviCRM.                                    |
   9  |                                                                    |
  10  | CiviCRM is free software; you can copy, modify, and distribute it  |
  11  | under the terms of the GNU Affero General Public License           |
  12  | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
  13  |                                                                    |
  14  | CiviCRM is distributed in the hope that it will be useful, but     |
  15  | WITHOUT ANY WARRANTY; without even the implied warranty of         |
  16  | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
  17  | See the GNU Affero General Public License for more details.        |
  18  |                                                                    |
  19  | You should have received a copy of the GNU Affero General Public   |
  20  | License and the CiviCRM Licensing Exception along                  |
  21  | with this program; if not, contact CiviCRM LLC                     |
  22  | at info[AT]civicrm[DOT]org. If you have questions about the        |
  23  | GNU Affero General Public License or the licensing of CiviCRM,     |
  24  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  25  +--------------------------------------------------------------------+
  26 */
  27
  28 /**
  29  * @package CRM
  30  * @copyright CiviCRM LLC (c) 2004-2017
  31  *
  32  * Generated from {$table.sourceFile}
  33  * {$generated}
  34  * (GenCodeChecksum:{$genCodeChecksum})
  35  */
  36
  37 require_once 'CRM/Core/DAO.php';
  38 require_once 'CRM/Utils/Type.php';
  39
  40 /**
  41  * {$table.className} constructor.
  42  */
  43 class {$table.className} extends CRM_Core_DAO {ldelim}
  44
  45      /**
  46       * Static instance to hold the table name.
  47       *
  48       * @var string
  49       */
  50       static $_tableName = '{$table.name}';
  51
  52       /**
  53        * Should CiviCRM log any modifications to this table in the civicrm_log table.
  54        *
  55        * @var boolean
  56        */
  57       static $_log = {$table.log};
  58
  59 {foreach from=$table.fields item=field}
  60     /**
  61 {if $field.comment}
  62      * {$field.comment}
  63 {/if}
  64      *
  65      * @var {$field.phpType}
  66      */
  67     public ${$field.name};
  68
  69 {/foreach} {* table.fields *}
  70
  71     /**
  72      * Class constructor.
  73      */
  74     function __construct( ) {ldelim}
  75         $this->__table = '{$table.name}';
  76
  77         parent::__construct( );
  78     {rdelim}
  79
  80 {if $table.foreignKey || $table.dynamicForeignKey}
  81     /**
  82      * Returns foreign keys and entity references.
  83      *
  84      * @return array
  85      *   [CRM_Core_Reference_Interface]
  86      */
  87     static function getReferenceColumns() {ldelim}
  88       if (!isset(Civi::$statics[__CLASS__]['links'])) {ldelim}
  89         Civi::$statics[__CLASS__]['links'] = static::createReferenceColumns(__CLASS__);
  90 {foreach from=$table.foreignKey item=foreign}
  91         Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Basic(self::getTableName(), '{$foreign.name}', '{$foreign.table}', '{$foreign.key}');
  92 {/foreach}
  93
  94 {foreach from=$table.dynamicForeignKey item=foreign}
  95         Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Dynamic(self::getTableName(), '{$foreign.idColumn}', NULL, '{$foreign.key|default:'id'}', '{$foreign.typeColumn}');
  96 {/foreach}
  97         CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'links_callback', Civi::$statics[__CLASS__]['links']);
  98       {rdelim}
  99       return Civi::$statics[__CLASS__]['links'];
 100     {rdelim}
 101 {/if} {* table.foreignKey *}
 102
 103       /**
 104        * Returns all the column names of this table
 105        *
 106        * @return array
 107        */
 108       static function &fields( ) {ldelim}
 109         if ( ! isset(Civi::$statics[__CLASS__]['fields']) ) {ldelim}
 110           Civi::$statics[__CLASS__]['fields'] = array (
 111 {foreach from=$table.fields item=field}
 112
 113 {if $field.uniqueName}
 114   '{$field.uniqueName}'
 115 {else}
 116                                             '{$field.name}'
 117 {/if}
 118                => array(
 119                  'name'      => '{$field.name}',
 120                                                                       'type'      => {$field.crmType},
 121 {if $field.title}
 122                                                                       'title'     => ts('{$field.title}'),
 123 {/if}
 124 {if $field.comment}
 125                                                                       'description'     => '{$field.comment|replace:"'":"\'"}',
 126 {/if}
 127 {if $field.required}
 128                                         'required'  => {$field.required},
 129 {/if} {* field.required *}
 130 {if $field.length}
 131                       'maxlength' => {$field.length},
 132 {/if} {* field.length *}
 133 {if $field.precision}
 134                       'precision'      => array({$field.precision}),
 135 {/if}
 136 {if $field.size}
 137                       'size'      => {$field.size},
 138 {/if} {* field.size *}
 139 {if $field.rows}
 140                       'rows'      => {$field.rows},
 141 {/if} {* field.rows *}
 142 {if $field.cols}
 143                       'cols'      => {$field.cols},
 144 {/if} {* field.cols *}
 145
 146 {if $field.import}
 147                       'import'    => {$field.import},
 148                                                                       'where'     => '{$table.name}.{$field.name}',
 149                                       'headerPattern' => '{$field.headerPattern}',
 150                                       'dataPattern' => '{$field.dataPattern}',
 151 {/if} {* field.import *}
 152 {if $field.export}
 153                       'export'    => {$field.export},
 154                                       {if ! $field.import}
 155                       'where'     => '{$table.name}.{$field.name}',
 156                                       'headerPattern' => '{$field.headerPattern}',
 157                                       'dataPattern' => '{$field.dataPattern}',
 158               {/if}
 159 {/if} {* field.export *}
 160 {if $field.rule}
 161                       'rule'      => '{$field.rule}',
 162 {/if} {* field.rule *}
 163 {if $field.default}
 164                          'default'   => '{if ($field.default[0]=="'" or $field.default[0]=='"')}{$field.default|substring:1:-1}{else}{$field.default}{/if}',
 165 {/if} {* field.default *}
 166   'table_name' => '{$table.name}',
 167   'entity' => '{$table.entity}',
 168   'bao' => '{$table.bao}',
 169   'localizable' => {if ($field.localizable)}{1}{else}{0}{/if},
 170
 171 {if $field.FKClassName}
 172                       'FKClassName' => '{$field.FKClassName}',
 173 {/if} {* field.FKClassName *}
 174 {if $field.html}
 175   {assign var=htmlOptions value=$field.html}
 176   'html' => array(
 177 {*{$htmlOptions|@print_array}*}
 178   {foreach from=$htmlOptions key=optionKey item=optionValue}
 179     '{$optionKey}' => '{$optionValue}',
 180   {/foreach}
 181   ),
 182 {/if} {* field.html *}
 183 {if $field.pseudoconstant}
 184 {assign var=pseudoOptions value=$field.pseudoconstant}
 185 'pseudoconstant' => array(
 186 {*{$pseudoOptions|@print_array}*}
 187 {foreach from=$pseudoOptions key=optionKey item=optionValue}
 188   '{$optionKey}' => '{$optionValue}',
 189 {/foreach}
 190                 )
 191 {/if} {* field.pseudoconstant *}                                                                    ),
 192 {/foreach} {* table.fields *}
 193                                       );
 194             CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'fields_callback', Civi::$statics[__CLASS__]['fields']);
 195           {rdelim}
 196           return Civi::$statics[__CLASS__]['fields'];
 197       {rdelim}
 198
 199       /**
 200        * Return a mapping from field-name to the corresponding key (as used in fields()).
 201        *
 202        * @return array
 203        *   Array(string $name => string $uniqueName).
 204        */
 205       static function &fieldKeys( ) {ldelim}
 206         if (!isset(Civi::$statics[__CLASS__]['fieldKeys'])) {ldelim}
 207           Civi::$statics[__CLASS__]['fieldKeys'] = array_flip(CRM_Utils_Array::collect('name', self::fields()));
 208         {rdelim}
 209         return Civi::$statics[__CLASS__]['fieldKeys'];
 210       {rdelim}
 211
 212       /**
 213        * Returns the names of this table
 214        *
 215        * @return string
 216        */
 217       static function getTableName( ) {ldelim}
 218         {if $table.localizable}
 219           return CRM_Core_DAO::getLocaleTableName( self::$_tableName );
 220         {else}
 221           return self::$_tableName;
 222         {/if}
 223       {rdelim}
 224
 225       /**
 226        * Returns if this table needs to be logged
 227        *
 228        * @return boolean
 229        */
 230       function getLog( ) {ldelim}
 231           return self::$_log;
 232       {rdelim}
 233
 234       /**
 235        * Returns the list of fields that can be imported
 236        *
 237        * @param bool $prefix
 238        *
 239        * @return array
 240        */
 241        static function &import( $prefix = false ) {ldelim}
 242             $r = CRM_Core_DAO_AllCoreTables::getImports(__CLASS__, '{$table.labelName}', $prefix, array(
 243             {if $table.foreignKey}{foreach from=$table.foreignKey item=foreign}
 244               {if $foreign.import}'{$foreign.className}',{/if}
 245             {/foreach}{/if}
 246             ));
 247             return $r;
 248       {rdelim}
 249
 250        /**
 251         * Returns the list of fields that can be exported
 252         *
 253         * @param bool $prefix
 254         *
 255         * @return array
 256         */
 257        static function &export( $prefix = false ) {ldelim}
 258             $r = CRM_Core_DAO_AllCoreTables::getExports(__CLASS__, '{$table.labelName}', $prefix, array(
 259             {if $table.foreignKey}{foreach from=$table.foreignKey item=foreign}
 260               {if $foreign.export}'{$foreign.className}',{/if}
 261             {/foreach}{/if}
 262             ));
 263             return $r;
 264       {rdelim}
 265
 266       /**
 267        * Returns the list of indices
 268        */
 269       public static function indices($localize = TRUE) {ldelim}
 270         $indices = {$indicesPhp};
 271         return ($localize && !empty($indices)) ? CRM_Core_DAO_AllCoreTables::multilingualize(__CLASS__, $indices) : $indices;
 272       {rdelim}
 273 {rdelim}