CRM/Activity/Task.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | Copyright CiviCRM LLC. All rights reserved.                        |
   5  |                                                                    |
   6  | This work is published under the GNU AGPLv3 license with some      |
   7  | permitted exceptions and without any warranty. For full license    |
   8  | and copyright information, see https://civicrm.org/licensing       |
   9  +--------------------------------------------------------------------+
  10  */
  11
  12 /**
  13  * @package CRM
  14  * @copyright CiviCRM LLC https://civicrm.org/licensing
  15  */
  16
  17 /**
  18  * Class to represent the actions that can be performed on a group of contacts used by the search forms.
  19  */
  20 class CRM_Activity_Task extends CRM_Core_Task {
  21
  22   public static $objectType = 'activity';
  23
  24   /**
  25    * These tasks are the core set of tasks that the user can perform
  26    * on a contact / group of contacts.
  27    *
  28    * @return array
  29    *   the set of tasks for a group of contacts
  30    */
  31   public static function tasks() {
  32     if (!(self::$_tasks)) {
  33       self::$_tasks = [
  34         self::TASK_DELETE => [
  35           'title' => ts('Delete activities'),
  36           'class' => 'CRM_Activity_Form_Task_Delete',
  37           'result' => FALSE,
  38         ],
  39         self::TASK_PRINT => [
  40           'title' => ts('Print selected rows'),
  41           'class' => 'CRM_Activity_Form_Task_Print',
  42           'result' => FALSE,
  43         ],
  44         self::TASK_EXPORT => [
  45           'title' => ts('Export activities'),
  46           'class' => [
  47             'CRM_Export_Form_Select',
  48             'CRM_Export_Form_Map',
  49           ],
  50           'result' => FALSE,
  51         ],
  52         self::BATCH_UPDATE => [
  53           'title' => ts('Update multiple activities'),
  54           'class' => [
  55             'CRM_Activity_Form_Task_PickProfile',
  56             'CRM_Activity_Form_Task_Batch',
  57           ],
  58           'result' => FALSE,
  59         ],
  60         self::TASK_EMAIL => [
  61           'title' => ts('Email - send now (to %1 or less)', [
  62             1 => Civi::settings()
  63               ->get('simple_mail_limit'),
  64           ]),
  65           'class' => [
  66             'CRM_Activity_Form_Task_PickOption',
  67             'CRM_Activity_Form_Task_Email',
  68           ],
  69           'result' => FALSE,
  70         ],
  71         self::TASK_SMS => [
  72           'title' => ts('SMS - send reply'),
  73           'class' => 'CRM_Activity_Form_Task_SMS',
  74           'result' => FALSE,
  75         ],
  76         self::TAG_ADD => [
  77           'title' => ts('Tag - add to activities'),
  78           'class' => 'CRM_Activity_Form_Task_AddToTag',
  79           'result' => FALSE,
  80         ],
  81         self::TAG_REMOVE => [
  82           'title' => ts('Tag - remove from activities'),
  83           'class' => 'CRM_Activity_Form_Task_RemoveFromTag',
  84           'result' => FALSE,
  85         ],
  86       ];
  87
  88       $config = CRM_Core_Config::singleton();
  89       if (in_array('CiviCase', $config->enableComponents)) {
  90         if (CRM_Core_Permission::check('access all cases and activities') ||
  91           CRM_Core_Permission::check('access my cases and activities')
  92         ) {
  93           self::$_tasks[self::TASK_SMS] = [
  94             'title' => ts('File on case'),
  95             'class' => 'CRM_Activity_Form_Task_FileOnCase',
  96             'result' => FALSE,
  97           ];
  98         }
  99       }
 100
 101       // CRM-4418, check for delete
 102       if (!CRM_Core_Permission::check('delete activities')) {
 103         unset(self::$_tasks[self::TASK_DELETE]);
 104       }
 105
 106       parent::tasks();
 107     }
 108
 109     return self::$_tasks;
 110   }
 111
 112   /**
 113    * Show tasks selectively based on the permission level of the user.
 114    *
 115    * @param int $permission
 116    * @param array $params
 117    *
 118    * @return array
 119    *   set of tasks that are valid for the user
 120    */
 121   public static function permissionedTaskTitles($permission, $params = []) {
 122     if ($permission == CRM_Core_Permission::EDIT) {
 123       $tasks = self::taskTitles();
 124     }
 125     else {
 126       $tasks = [
 127         self::TASK_EXPORT => self::$_tasks[self::TASK_EXPORT]['title'],
 128       ];
 129
 130       //CRM-4418,
 131       if (CRM_Core_Permission::check('delete activities')) {
 132         $tasks[self::TASK_DELETE] = self::$_tasks[self::TASK_DELETE]['title'];
 133       }
 134     }
 135
 136     $tasks = parent::corePermissionedTaskTitles($tasks, $permission, $params);
 137     return $tasks;
 138   }
 139
 140   /**
 141    * These tasks are the core set of tasks that the user can perform on activity.
 142    *
 143    * @param int $value
 144    *
 145    * @return array
 146    *   the set of tasks for a group of activity
 147    */
 148   public static function getTask($value) {
 149     self::tasks();
 150     if (!$value || !CRM_Utils_Array::value($value, self::$_tasks)) {
 151       // make the print task by default
 152       $value = self::TASK_PRINT;
 153     }
 154
 155     return [
 156       self::$_tasks[$value]['class'],
 157       self::$_tasks[$value]['result'],
 158     ];
 159   }
 160
 161 }