06feed0f20a8f00aa90f51777b0132d7569ef2b8
3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
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-2013
37 * class to represent the actions that can be performed on a group of contacts
38 * used by the search forms
41 class CRM_Contribute_Task
{
42 CONST DELETE_CONTRIBUTIONS
= 1, PRINT_CONTRIBUTIONS
= 2, EXPORT_CONTRIBUTIONS
= 3, BATCH_CONTRIBUTIONS
= 4, EMAIL_CONTACTS
= 5, UPDATE_STATUS
= 6, PDF_RECEIPT
= 7;
50 static $_tasks = NULL;
53 * the optional task array
58 static $_optionalTasks = NULL;
61 * These tasks are the core set of tasks that the user can perform
62 * on a contact / group of contacts
64 * @return array the set of tasks for a group of contacts
68 static function &tasks() {
69 if (!(self
::$_tasks)) {
70 self
::$_tasks = array(
71 1 => array('title' => ts('Delete Contributions'),
72 'class' => 'CRM_Contribute_Form_Task_Delete',
75 2 => array('title' => ts('Print Contributions'),
76 'class' => 'CRM_Contribute_Form_Task_Print',
79 3 => array('title' => ts('Export Contributions'),
81 'CRM_Export_Form_Select',
82 'CRM_Export_Form_Map',
86 4 => array('title' => ts('Batch Update Contributions Via Profile'),
88 'CRM_Contribute_Form_Task_PickProfile',
89 'CRM_Contribute_Form_Task_Batch',
93 5 => array('title' => ts('Send Email to Contacts'),
94 'class' => 'CRM_Contribute_Form_Task_Email',
97 6 => array('title' => ts('Update Pending Contribution Status'),
98 'class' => 'CRM_Contribute_Form_Task_Status',
101 7 => array('title' => ts('Print or Email Contribution Receipts'),
102 'class' => 'CRM_Contribute_Form_Task_PDF',
105 8 => array('title' => ts('Thank-you Letters for Contributions'),
106 'class' => 'CRM_Contribute_Form_Task_PDFLetter',
111 //CRM-4418, check for delete
112 if (!CRM_Core_Permission
::check('delete in CiviContribute')) {
113 unset(self
::$_tasks[1]);
116 CRM_Utils_Hook
::searchTasks('contribution', self
::$_tasks);
117 asort(self
::$_tasks);
120 return self
::$_tasks;
124 * These tasks are the core set of task titles
127 * @return array the set of task titles
131 static function &taskTitles() {
134 foreach (self
::$_tasks as $id => $value) {
135 // skip Print Contribution task
137 $titles[$id] = $value['title'];
144 * show tasks selectively based on the permission level
147 * @param int $permission
149 * @return array set of tasks that are valid for the user
152 static function &permissionedTaskTitles($permission) {
154 if (($permission == CRM_Core_Permission
::EDIT
)
155 || CRM_Core_Permission
::check('edit contributions')
157 $tasks = self
::taskTitles();
161 3 => self
::$_tasks[3]['title'],
162 5 => self
::$_tasks[5]['title'],
163 7 => self
::$_tasks[7]['title'],
167 if (CRM_Core_Permission
::check('delete in CiviContribute')) {
168 $tasks[1] = self
::$_tasks[1]['title'];
175 * These tasks are the core set of tasks that the user can perform
180 * @return array the set of tasks for a group of contributors
184 static function getTask($value) {
186 if (!$value ||
!CRM_Utils_Array
::value($value, self
::$_tasks)) {
187 // make the print task by default
190 // this is possible since hooks can inject a task
192 if (!isset(self
::$_tasks[$value]['result'])) {
193 self
::$_tasks[$value]['result'] = NULL;
196 self
::$_tasks[$value]['class'],
197 self
::$_tasks[$value]['result'],