Commit | Line | Data |
---|---|---|
6a488035 TO |
1 | <?php |
2 | /* | |
3 | +--------------------------------------------------------------------+ | |
06b69b18 | 4 | | CiviCRM version 4.5 | |
6a488035 | 5 | +--------------------------------------------------------------------+ |
06b69b18 | 6 | | Copyright CiviCRM LLC (c) 2004-2014 | |
6a488035 TO |
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 | |
06b69b18 | 31 | * @copyright CiviCRM LLC (c) 2004-2014 |
6a488035 TO |
32 | * $Id$ |
33 | * | |
34 | */ | |
35 | ||
36 | /** | |
37 | * This class provides the functionality to email a group of contacts | |
38 | */ | |
39 | class CRM_Activity_Form_Task_PickOption extends CRM_Activity_Form_Task { | |
40 | ||
41 | /** | |
42 | * the title of the group | |
43 | * | |
44 | * @var string | |
45 | */ | |
46 | protected $_title; | |
47 | ||
48 | /** | |
49 | * maximum Activities that should be allowed to update | |
50 | * | |
51 | */ | |
52 | protected $_maxActivities = 100; | |
53 | ||
54 | /** | |
55 | * variable to store redirect path | |
56 | * | |
57 | */ | |
58 | protected $_userContext; | |
59 | ||
60 | /** | |
61 | * variable to store contact Ids | |
62 | * | |
63 | */ | |
64 | public $_contacts; | |
65 | ||
66 | /** | |
67 | * build all the data structures needed to build the form | |
68 | * | |
69 | * @return void | |
70 | * @access public | |
71 | */ | |
72 | function preProcess() { | |
73 | /* | |
74 | * initialize the task and row fields | |
75 | */ | |
f813f78e | 76 | |
6a488035 TO |
77 | parent::preProcess(); |
78 | $session = CRM_Core_Session::singleton(); | |
79 | $this->_userContext = $session->readUserContext(); | |
80 | ||
81 | CRM_Utils_System::setTitle(ts('Send Email to Contacts')); | |
82 | ||
83 | $validate = FALSE; | |
84 | //validations | |
85 | if (count($this->_activityHolderIds) > $this->_maxActivities) { | |
86 | CRM_Core_Session::setStatus(ts("The maximum number of Activities you can select to send an email is %1. You have selected %2. Please select fewer Activities from your search results and try again.", array(1 => $this->_maxActivities, 2 => count($this->_activityHolderIds))), ts("Maximum Exceeded"), "error"); | |
87 | $validate = TRUE; | |
88 | } | |
89 | // then redirect | |
90 | if ($validate) { | |
91 | CRM_Utils_System::redirect($this->_userContext); | |
92 | } | |
93 | } | |
94 | ||
95 | /** | |
96 | * Build the form | |
97 | * | |
98 | * @access public | |
99 | * | |
100 | * @return void | |
101 | */ | |
102 | function buildQuickForm() { | |
103 | $this->addElement('checkbox', 'with_contact', ts('With Contact')); | |
104 | $this->addElement('checkbox', 'assigned_to', ts('Assigned to Contact')); | |
105 | $this->addElement('checkbox', 'created_by', ts('Created by')); | |
106 | $this->setDefaults(array('with_contact' => 1)); | |
107 | $this->addDefaultButtons(ts('Continue >>')); | |
108 | } | |
109 | ||
110 | /** | |
111 | * Add local and global form rules | |
112 | * | |
113 | * @access protected | |
114 | * | |
115 | * @return void | |
116 | */ | |
117 | function addRules() { | |
118 | $this->addFormRule(array('CRM_Activity_Form_Task_PickOption', 'formRule')); | |
119 | } | |
120 | ||
121 | /** | |
122 | * global validation rules for the form | |
123 | * | |
124 | * @param array $fields posted values of the form | |
125 | * | |
126 | * @return array list of errors to be posted back to the form | |
127 | * @static | |
128 | * @access public | |
129 | */ | |
130 | static function formRule($fields) { | |
131 | if ( !isset($fields['with_contact']) && | |
132 | !isset($fields['assigned_to']) && | |
133 | !isset($fields['created_by']) | |
134 | ) { | |
135 | return array('with_contact' => ts('You must select at least one email recipient type.')); | |
136 | } | |
137 | return TRUE; | |
138 | } | |
139 | ||
140 | /** | |
141 | * process the form after the input has been submitted and validated | |
142 | * | |
143 | * @access public | |
144 | * | |
355ba699 | 145 | * @return void |
6a488035 TO |
146 | */ |
147 | public function postProcess() { | |
148 | // Clear any formRule errors from Email form in case they came back here via Cancel button | |
149 | $this->controller->resetPage('Email'); | |
150 | $params = $this->exportValues(); | |
151 | $this->_contacts = array(); | |
f813f78e | 152 | |
e7e657f0 | 153 | $activityContacts = CRM_Core_OptionGroup::values('activity_contacts', FALSE, FALSE, FALSE, NULL, 'name'); |
034500d4 | 154 | $assigneeID = CRM_Utils_Array::key('Activity Assignees', $activityContacts); |
f813f78e | 155 | $targetID = CRM_Utils_Array::key('Activity Targets', $activityContacts); |
6a488035 TO |
156 | //get assignee contacts |
157 | if (!empty($params['assigned_to'])) { | |
158 | foreach ($this->_activityHolderIds as $key => $id) { | |
034500d4 | 159 | $ids = array_keys(CRM_Activity_BAO_ActivityContact::getNames($id, $assigneeID)); |
6a488035 TO |
160 | $this->_contacts = array_merge($this->_contacts, $ids); |
161 | } | |
162 | } | |
163 | //get target contacts | |
164 | if (!empty($params['with_contact'])) { | |
165 | foreach ($this->_activityHolderIds as $key => $id) { | |
034500d4 | 166 | $ids = array_keys(CRM_Activity_BAO_ActivityContact::getNames($id, $targetID)); |
6a488035 TO |
167 | $this->_contacts = array_merge($this->_contacts, $ids); |
168 | } | |
169 | } | |
170 | //get 'Added by' contacts | |
171 | if (!empty($params['created_by'])) { | |
172 | parent::setContactIDs(); | |
173 | if (!empty($this->_contactIds)) { | |
174 | $this->_contacts = array_merge($this->_contacts, $this->_contactIds); | |
175 | } | |
176 | } | |
177 | $this->_contacts = array_unique($this->_contacts); | |
178 | ||
179 | //bounce to pick option if no contacts to send to | |
180 | if ( empty($this->_contacts) ) { | |
181 | $urlParams = "_qf_PickOption_display=true&qfKey={$params['qfKey']}"; | |
182 | $urlRedirect = CRM_Utils_System::url('civicrm/activity/search', $urlParams); | |
183 | CRM_Core_Error::statusBounce( | |
184 | ts('It appears you have no contacts with emails from the selected recipients.'), | |
185 | $urlRedirect | |
186 | ); | |
187 | } | |
188 | ||
189 | $this->set('contacts', $this->_contacts); | |
190 | } | |
191 | } | |
192 |