INFRA-132 - Fix spacing of @return tag in comments
[civicrm-core.git] / CRM / Core / BAO / Discount.php
1 <?php
2 /*
3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2014 |
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 *
30 * @package CRM
31 * @copyright CiviCRM LLC (c) 2004-2014
32 * $Id$
33 *
34 */
35 class CRM_Core_BAO_Discount extends CRM_Core_DAO_Discount {
36
37 /**
38 * Class constructor
39 */
40 public function __construct() {
41 parent::__construct();
42 }
43
44 /**
45 * Delete the discount
46 *
47 * @param int $entityId
48 * @param string $entityTable
49 *
50 * @return boolean
51 * @static
52 */
53 public static function del($entityId, $entityTable) {
54 // delete all discount records with the selected discounted id
55 $discount = new CRM_Core_DAO_Discount();
56 $discount->entity_id = $entityId;
57 $discount->entity_table = $entityTable;
58 if ($discount->delete()) {
59 return TRUE;
60 }
61 return FALSE;
62 }
63
64 /**
65 *
66 * The function extracts all the params it needs to create a
67 * discount object. the params array contains additional unused name/value
68 * pairs
69 *
70 * @param array $params
71 * (reference) an assoc array of name/value pairs.
72 *
73 * @return object
74 * CRM_Core_DAO_Discount object on success, otherwise null
75 * @static
76 */
77 public static function add(&$params) {
78 $discount = new CRM_Core_DAO_Discount();
79 $discount->copyValues($params);
80 $discount->save();
81 return $discount;
82 }
83
84 /**
85 * Determine whether the given table/id
86 * has discount associated with it
87 *
88 * @param int $entityIdEntity id to be searched.
89 * Entity id to be searched.
90 * @param string $entityTable
91 * Entity table to be searched.
92 *
93 * @return array
94 * option group Ids associated with discount
95 *
96 */
97 public static function getOptionGroup($entityId, $entityTable) {
98 $optionGroupIDs = array();
99 $dao = new CRM_Core_DAO_Discount();
100 $dao->entity_id = $entityId;
101 $dao->entity_table = $entityTable;
102 $dao->find();
103 while ($dao->fetch()) {
104 $optionGroupIDs[$dao->id] = $dao->price_set_id;
105 }
106 return $optionGroupIDs;
107 }
108
109 /**
110 * Determine in which discount set the registration date falls
111 *
112 * @param int $entityID
113 * Entity id to be searched.
114 * @param string $entityTable
115 * Entity table to be searched.
116 *
117 * @return integer
118 * $dao->id discount id of the set which matches
119 * the date criteria
120 */
121 public static function findSet($entityID, $entityTable) {
122 if (empty($entityID) || empty($entityTable)) {
123 // adding this here, to trap errors if values are not sent
124 CRM_Core_Error::fatal();
125 return NULL;
126 }
127
128 $dao = new CRM_Core_DAO_Discount();
129 $dao->entity_id = $entityID;
130 $dao->entity_table = $entityTable;
131 $dao->find();
132
133 while ($dao->fetch()) {
134 $endDate = $dao->end_date;
135 // if end date is not we consider current date as end date
136 if (!$endDate) {
137 $endDate = date('Ymd');
138 }
139 $falls = CRM_Utils_Date::getRange($dao->start_date, $endDate);
140 if ($falls == TRUE) {
141 return $dao->id;
142 }
143 }
144 return FALSE;
145 }
146
147 }