3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2015 |
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-2015
37 * This class provides the functionality to email a group of contacts
39 class CRM_Activity_Form_Task_PickOption
extends CRM_Activity_Form_Task
{
42 * The title of the group.
49 * Maximum Activities that should be allowed to update.
51 protected $_maxActivities = 100;
54 * Variable to store redirect path.
56 protected $_userContext;
59 * Variable to store contact Ids.
64 * Build all the data structures needed to build the form.
68 public function preProcess() {
70 * initialize the task and row fields
74 $session = CRM_Core_Session
::singleton();
75 $this->_userContext
= $session->readUserContext();
77 CRM_Utils_System
::setTitle(ts('Send Email to Contacts'));
81 if (count($this->_activityHolderIds
) > $this->_maxActivities
) {
82 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(
83 1 => $this->_maxActivities
,
84 2 => count($this->_activityHolderIds
),
85 )), ts("Maximum Exceeded"), "error");
90 CRM_Utils_System
::redirect($this->_userContext
);
95 * Build the form object.
100 public function buildQuickForm() {
101 $this->addElement('checkbox', 'with_contact', ts('With Contact'));
102 $this->addElement('checkbox', 'assigned_to', ts('Assigned to Contact'));
103 $this->addElement('checkbox', 'created_by', ts('Created by'));
104 $this->setDefaults(array('with_contact' => 1));
105 $this->addDefaultButtons(ts('Continue'));
109 * Add local and global form rules.
114 public function addRules() {
115 $this->addFormRule(array('CRM_Activity_Form_Task_PickOption', 'formRule'));
119 * Global validation rules for the form.
121 * @param array $fields
122 * Posted values of the form.
125 * list of errors to be posted back to the form
127 public static function formRule($fields) {
128 if (!isset($fields['with_contact']) &&
129 !isset($fields['assigned_to']) &&
130 !isset($fields['created_by'])
132 return array('with_contact' => ts('You must select at least one email recipient type.'));
138 * Process the form after the input has been submitted and validated.
143 public function postProcess() {
144 // Clear any formRule errors from Email form in case they came back here via Cancel button
145 $this->controller
->resetPage('Email');
146 $params = $this->exportValues();
147 $this->_contacts
= array();
149 $activityContacts = CRM_Core_OptionGroup
::values('activity_contacts', FALSE, FALSE, FALSE, NULL, 'name');
150 $assigneeID = CRM_Utils_Array
::key('Activity Assignees', $activityContacts);
151 $targetID = CRM_Utils_Array
::key('Activity Targets', $activityContacts);
152 //get assignee contacts
153 if (!empty($params['assigned_to'])) {
154 foreach ($this->_activityHolderIds
as $key => $id) {
155 $ids = array_keys(CRM_Activity_BAO_ActivityContact
::getNames($id, $assigneeID));
156 $this->_contacts
= array_merge($this->_contacts
, $ids);
159 //get target contacts
160 if (!empty($params['with_contact'])) {
161 foreach ($this->_activityHolderIds
as $key => $id) {
162 $ids = array_keys(CRM_Activity_BAO_ActivityContact
::getNames($id, $targetID));
163 $this->_contacts
= array_merge($this->_contacts
, $ids);
166 //get 'Added by' contacts
167 if (!empty($params['created_by'])) {
168 parent
::setContactIDs();
169 if (!empty($this->_contactIds
)) {
170 $this->_contacts
= array_merge($this->_contacts
, $this->_contactIds
);
173 $this->_contacts
= array_unique($this->_contacts
);
175 //bounce to pick option if no contacts to send to
176 if (empty($this->_contacts
)) {
177 $urlParams = "_qf_PickOption_display=true&qfKey={$params['qfKey']}";
178 $urlRedirect = CRM_Utils_System
::url('civicrm/activity/search', $urlParams);
179 CRM_Core_Error
::statusBounce(
180 ts('It appears you have no contacts with emails from the selected recipients.'),
185 $this->set('contacts', $this->_contacts
);