CCRM-15821 Provide option to notify PCP owner
[civicrm-core.git] / CRM / PCP / Form / Contribute.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
36 /**
37 * This class generates form components for Tell A Friend
38 *
39 */
40 class CRM_PCP_Form_Contribute extends CRM_Contribute_Form_ContributionPage {
41
42 /**
43 * The type of pcp component.
44 *
45 * @var int
46 */
47 public $_component = 'contribute';
48
49 public function preProcess() {
50 parent::preProcess();
51 }
52
53 /**
54 * Set default values for the form. Note that in edit/view mode
55 * the default values are retrieved from the database
56 *
57 *
58 * @return void
59 */
60 public function setDefaultValues() {
61 $defaults = array();
62
63 if (isset($this->_id)) {
64 $params = array('entity_id' => $this->_id, 'entity_table' => 'civicrm_contribution_page');
65 CRM_Core_DAO::commonRetrieve('CRM_PCP_DAO_PCPBlock', $params, $defaults);
66 $defaults['pcp_active'] = CRM_Utils_Array::value('is_active', $defaults);
67 // Assign contribution page ID to pageId for referencing in PCP.hlp - since $id is overwritten there. dgg
68 if (!CRM_Utils_Array::value('owner_notify_id', $defaults)) {
69 $defaults['owner_notify_id'] = CRM_Core_OptionGroup::getDefaultValue('pcp_owner_notify');
70 }
71 $this->assign('pageId', $this->_id);
72 }
73
74 if (empty($defaults['id'])) {
75 $defaults['target_entity_type'] = 'contribute';
76 $defaults['is_approval_needed'] = 1;
77 $defaults['is_tellfriend_enabled'] = 1;
78 $defaults['tellfriend_limit'] = 5;
79 $defaults['link_text'] = ts('Create your own fundraising page');
80 $defaults['owner_notify_id'] = CRM_Core_OptionGroup::getDefaultValue('pcp_owner_notify');
81
82 if ($ccReceipt = CRM_Core_DAO::getFieldValue('CRM_Contribute_DAO_ContributionPage', $this->_id, 'cc_receipt')) {
83 $defaults['notify_email'] = $ccReceipt;
84 }
85 }
86 return $defaults;
87 }
88
89 /**
90 * Build the form object
91 *
92 * @return void
93 */
94 public function buildQuickForm() {
95 CRM_PCP_BAO_PCP::buildPCPForm($this);
96
97 $this->addElement('checkbox', 'pcp_active', ts('Enable Personal Campaign Pages? (for this contribution page)'), NULL, array('onclick' => "return showHideByValue('pcp_active',true,'pcpFields','table-row','radio',false);"));
98
99 parent::buildQuickForm();
100 $this->addFormRule(array('CRM_PCP_Form_Contribute', 'formRule'), $this);
101 }
102
103 /**
104 * Validation
105 *
106 * @param array $params
107 * (ref.) an assoc array of name/value pairs.
108 *
109 * @param $files
110 * @param $self
111 *
112 * @return bool|array
113 * mixed true or array of errors
114 */
115 public static function formRule($params, $files, $self) {
116 $errors = array();
117 if (!empty($params['is_active'])) {
118
119 if (!empty($params['is_tellfriend_enabled']) &&
120 (CRM_Utils_Array::value('tellfriend_limit', $params) <= 0)
121 ) {
122 $errors['tellfriend_limit'] = ts('if Tell Friend is enabled, Maximum recipients limit should be greater than zero.');
123 }
124 if (empty($params['supporter_profile_id'])) {
125 $errors['supporter_profile_id'] = ts('Supporter profile is a required field.');
126 }
127 else {
128 if (CRM_PCP_BAO_PCP::checkEmailProfile($params['supporter_profile_id'])) {
129 $errors['supporter_profile_id'] = ts('Profile is not configured with Email address.');
130 }
131 }
132
133 if ($emails = CRM_Utils_Array::value('notify_email', $params)) {
134 $emailArray = explode(',', $emails);
135 foreach ($emailArray as $email) {
136 if ($email && !CRM_Utils_Rule::email(trim($email))) {
137 $errors['notify_email'] = ts('A valid Notify Email address must be specified');
138 }
139 }
140 }
141 }
142 return empty($errors) ? TRUE : $errors;
143 }
144
145 /**
146 * Process the form submission
147 *
148 *
149 * @return void
150 */
151 public function postProcess() {
152 // get the submitted form values.
153 $params = $this->controller->exportValues($this->_name);
154
155 // Source
156 $params['entity_table'] = 'civicrm_contribution_page';
157 $params['entity_id'] = $this->_id;
158
159 // Target
160 $params['target_entity_type'] = CRM_Utils_Array::value('target_entity_type', $params, 'contribute');
161 $params['target_entity_id'] = $this->_id;
162
163 $dao = new CRM_PCP_DAO_PCPBlock();
164 $dao->entity_table = $params['entity_table'];
165 $dao->entity_id = $this->_id;
166 $dao->find(TRUE);
167 $params['id'] = $dao->id;
168 $params['is_active'] = CRM_Utils_Array::value('pcp_active', $params, FALSE);
169 $params['is_approval_needed'] = CRM_Utils_Array::value('is_approval_needed', $params, FALSE);
170 $params['is_tellfriend_enabled'] = CRM_Utils_Array::value('is_tellfriend_enabled', $params, FALSE);
171
172 $dao = CRM_PCP_BAO_PCP::add($params);
173
174 parent::endPostProcess();
175 }
176
177 /**
178 * Return a descriptive name for the page, used in wizard header
179 *
180 * @return string
181 */
182 public function getTitle() {
183 return ts('Enable Personal Campaign Pages');
184 }
185
186 }