3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2014 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
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. |
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. |
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 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2014
36 class CRM_Financial_BAO_FinancialTypeAccount
extends CRM_Financial_DAO_EntityFinancialAccount
{
41 public function __construct( ) {
42 parent
::__construct( );
50 private static $financialAccount;
53 * Fetch object based on array of properties
55 * @param array $params (reference ) an assoc array of name/value pairs
56 * @param array $defaults (reference ) an assoc array to hold the flattened values
58 * @param array $allValues
60 * @return CRM_Contribute_BAO_ContributionType object
63 public static function retrieve(&$params, &$defaults, &$allValues = array()) {
64 $financialTypeAccount = new CRM_Financial_DAO_EntityFinancialAccount();
65 $financialTypeAccount->copyValues($params);
66 $financialTypeAccount->find();
67 while ($financialTypeAccount->fetch()) {
68 CRM_Core_DAO
::storeValues($financialTypeAccount, $defaults);
69 $allValues[] = $defaults;
75 * Add the financial types
77 * @param array $params reference array contains the values submitted by the form
78 * @param array $ids reference array contains the id
83 public static function add(&$params, &$ids = NULL) {
84 // action is taken depending upon the mode
85 $financialTypeAccount = new CRM_Financial_DAO_EntityFinancialAccount();
86 if ($params['entity_table'] != 'civicrm_financial_type') {
87 $financialTypeAccount->entity_id
= $params['entity_id'];
88 $financialTypeAccount->entity_table
= $params['entity_table'];
89 $financialTypeAccount->find(TRUE);
92 $financialTypeAccount->id
= CRM_Utils_Array
::value('entityFinancialAccount', $ids);
94 if (!empty($ids['entityFinancialAccount'])) {
95 $financialTypeAccount->id
= $ids['entityFinancialAccount'];
97 $financialTypeAccount->copyValues($params);
98 $financialTypeAccount->save();
99 return $financialTypeAccount;
103 * Delete financial Types
105 * @param int $financialTypeAccountId
106 * @param int $accountId
110 public static function del($financialTypeAccountId, $accountId = null) {
111 //checking if financial type is present
113 $relationValues = CRM_Core_PseudoConstant
::get('CRM_Financial_DAO_EntityFinancialAccount', 'account_relationship');
115 $financialTypeId = CRM_Core_DAO
::getFieldValue( 'CRM_Financial_DAO_EntityFinancialAccount', $financialTypeAccountId, 'entity_id' );
117 // FIXME more table containing financial_type_id to come
119 array('Contribute', 'Contribution'),
120 array('Contribute', 'ContributionPage'),
121 array('Member', 'MembershipType'),
122 array('Price', 'PriceFieldValue'),
123 array('Grant', 'Grant'),
124 array('Contribute', 'PremiumsProduct'),
125 array('Contribute', 'Product'),
126 array('Price', 'LineItem'),
129 foreach ($dependancy as $name) {
130 $daoString = 'CRM_' . $name[0] . '_DAO_' . $name[1];
131 $dao = new $daoString();
132 $dao->financial_type_id
= $financialTypeId;
133 if ($dao->find(true)) {
140 if ($name[1] == 'PremiumsProduct' ||
$name[1] == 'Product') {
141 CRM_Core_Session
::setStatus(ts('You cannot remove an account with a %1 relationship while the Financial Type is used for a Premium.', array(1 => $relationValues[$financialTypeAccountId])));
144 $accountRelationShipId = CRM_Core_DAO
::getFieldValue('CRM_Financial_DAO_EntityFinancialAccount', $financialTypeAccountId, 'account_relationship');
145 CRM_Core_Session
::setStatus(ts('You cannot remove an account with a %1 relationship because it is being referenced by one or more of the following types of records: Contributions, Contribution Pages, or Membership Types. Consider disabling this type instead if you no longer want it used.', array(1 => $relationValues[$accountRelationShipId])), NUll, 'error');
147 return CRM_Utils_System
::redirect( CRM_Utils_System
::url( 'civicrm/admin/financial/financialType/accounts', "reset=1&action=browse&aid={$accountId}" ));
150 //delete from financial Type table
151 $financialType = new CRM_Financial_DAO_EntityFinancialAccount( );
152 $financialType->id
= $financialTypeAccountId;
153 $financialType->find(TRUE);
154 $financialType->delete();
155 CRM_Core_Session
::setStatus(ts('Unbalanced transactions may be created if you delete the account of type: %1.', array(1 => $relationValues[$financialType->account_relationship
])));
159 * Get Financial Account Name
161 * @param int $entityId
163 * @param string $entityTable
165 * @param string $columnName Column to fetch
167 * @return null|string
170 public static function getFinancialAccount($entityId, $entityTable, $columnName = 'name') {
171 $join = $columnName == 'name' ?
'LEFT JOIN civicrm_financial_account ON civicrm_entity_financial_account.financial_account_id = civicrm_financial_account.id' : NULL;
174 FROM civicrm_entity_financial_account
176 WHERE entity_table = %1
180 1 => array($entityTable, 'String'),
181 2 => array($entityId, 'Integer'),
183 return CRM_Core_DAO
::singleValueQuery($query, $params);
187 * Financial Account for payment instrument
189 * @param int $paymentInstrumentValue payment instrument value
191 * @return array|null|string
194 public static function getInstrumentFinancialAccount($paymentInstrumentValue = NULL) {
195 if (!self
::$financialAccount) {
196 $query = "SELECT ceft.financial_account_id, cov.value
197 FROM civicrm_entity_financial_account ceft
198 INNER JOIN civicrm_option_value cov ON cov.id = ceft.entity_id AND ceft.entity_table = 'civicrm_option_value'
199 INNER JOIN civicrm_option_group cog ON cog.id = cov.option_group_id
200 WHERE cog.name = 'payment_instrument' ";
202 if ($paymentInstrumentValue) {
203 $query .= " AND cov.value = '{$paymentInstrumentValue}' ";
204 return CRM_Core_DAO
::singleValueQuery($query);
207 $result = CRM_Core_DAO
::executeQuery($query);
208 while ($result->fetch()) {
209 self
::$financialAccount[$result->value
] = $result->financial_account_id
;
211 return self
::$financialAccount;
215 return $paymentInstrumentValue ? self
::$financialAccount[$paymentInstrumentValue] : self
::$financialAccount;
219 * Create default entity financial accounts
223 * @param $financialType
228 public static function createDefaultFinancialAccounts($financialType) {
230 $financialAccountTypeID = CRM_Core_PseudoConstant
::accountOptionValues('financial_account_type');
231 $accountRelationship = CRM_Core_PseudoConstant
::accountOptionValues('account_relationship');
232 $relationships = array (
233 array_search('Accounts Receivable Account is', $accountRelationship) => array_search('Asset', $financialAccountTypeID),
234 array_search('Expense Account is', $accountRelationship) => array_search('Expenses', $financialAccountTypeID),
235 array_search('Cost of Sales Account is', $accountRelationship) => array_search('Cost of Sales', $financialAccountTypeID),
236 array_search('Income Account is', $accountRelationship) => array_search('Revenue', $financialAccountTypeID),
239 $dao = CRM_Core_DAO
::executeQuery('SELECT id, financial_account_type_id FROM civicrm_financial_account WHERE name LIKE %1',
240 array(1 => array($financialType->name
, 'String'))
243 $existingFinancialAccount = array();
246 'name' => $financialType->name
,
247 'contact_id' => CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_Domain', CRM_Core_Config
::domainID(), 'contact_id'),
248 'financial_account_type_id' => array_search('Revenue', $financialAccountTypeID),
249 'description' => $financialType->description
,
250 'account_type_code' => 'INC',
253 $financialAccount = CRM_Financial_BAO_FinancialAccount
::add($params, CRM_Core_DAO
::$_nullArray);
256 $existingFinancialAccount[$dao->financial_account_type_id
] = $dao->id
;
259 'entity_table' => 'civicrm_financial_type',
260 'entity_id' => $financialType->id
,
262 foreach ($relationships as $key => $value) {
263 if (!array_key_exists($value, $existingFinancialAccount)) {
264 if ($accountRelationship[$key] == 'Accounts Receivable Account is') {
265 $params['financial_account_id'] = CRM_Core_DAO
::getFieldValue('CRM_Financial_DAO_FinancialAccount', 'Accounts Receivable', 'id', 'name');
266 if (!empty($params['financial_account_id'])) {
267 $titles[] = 'Accounts Receivable';
270 $query = "SELECT financial_account_id, name FROM civicrm_entity_financial_account
271 LEFT JOIN civicrm_financial_account ON civicrm_financial_account.id = civicrm_entity_financial_account.financial_account_id
272 WHERE account_relationship = {$key} AND entity_table = 'civicrm_financial_type' LIMIT 1";
273 $dao = CRM_Core_DAO
::executeQuery($query);
275 $params['financial_account_id'] = $dao->financial_account_id
;
276 $titles[] = $dao->name
;
279 elseif ($accountRelationship[$key] == 'Income Account is' && empty($existingFinancialAccount)) {
280 $params['financial_account_id'] = $financialAccount->id
;
283 $query = "SELECT id, name FROM civicrm_financial_account WHERE is_default = 1 AND financial_account_type_id = {$value}";
284 $dao = CRM_Core_DAO
::executeQuery($query);
286 $params['financial_account_id'] = $dao->id
;
287 $titles[] = $dao->name
;
291 $params['financial_account_id'] = $existingFinancialAccount[$value];
292 $titles[] = $financialType->name
;
294 $params['account_relationship'] = $key;
297 if (!empty($existingFinancialAccount)) {