CRM/Event/Form/ManageEvent.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 5                                                  |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2019                                |
   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  * @package CRM
  30  * @copyright CiviCRM LLC (c) 2004-2019
  31  */
  32
  33 /**
  34  * This class generates form components for processing Event.
  35  */
  36 class CRM_Event_Form_ManageEvent extends CRM_Core_Form {
  37
  38   /**
  39    * The id of the event we are processing.
  40    *
  41    * @var int
  42    */
  43   public $_id;
  44
  45   /**
  46    * Is this the first page?
  47    *
  48    * @var bool
  49    */
  50   protected $_first = FALSE;
  51
  52   /**
  53    * Are we in single form mode or wizard mode?
  54    *
  55    * @var bool
  56    */
  57   protected $_single;
  58
  59   public $_action;
  60
  61   /**
  62    * Are we actually managing an event template?
  63    * @var bool
  64    */
  65   protected $_isTemplate = FALSE;
  66
  67   /**
  68    * Pre-populate fields based on this template event_id.
  69    *
  70    * @var int
  71    */
  72   protected $_templateId;
  73
  74   protected $_cancelURL = NULL;
  75
  76   /**
  77    * The campaign id of the existing event, we use this to know if we need to update
  78    * the participant records
  79    * @var int
  80    */
  81   protected $_campaignID = NULL;
  82
  83   /**
  84    * Check if repeating event.
  85    * @var bool
  86    */
  87   public $_isRepeatingEvent;
  88
  89   /**
  90    * Explicitly declare the entity api name.
  91    */
  92   public function getDefaultEntity() {
  93     return 'Event';
  94   }
  95
  96   /**
  97    * Explicitly declare the form context.
  98    */
  99   public function getDefaultContext() {
 100     return 'create';
 101   }
 102
 103   /**
 104    * Set the active tab
 105    *
 106    * @param string $default
 107    *
 108    * @throws \CRM_Core_Exception
 109    */
 110   public function setSelectedChild($default = NULL) {
 111     $selectedChild = CRM_Utils_Request::retrieve('selectedChild', 'Alphanumeric', $this, FALSE, $default);
 112     if (!empty($selectedChild)) {
 113       $this->set('selectedChild', $selectedChild);
 114       $this->assign('selectedChild', $selectedChild);
 115     }
 116   }
 117
 118   /**
 119    * Set variables up before form is built.
 120    */
 121   public function preProcess() {
 122     $config = CRM_Core_Config::singleton();
 123     if (in_array('CiviEvent', $config->enableComponents)) {
 124       $this->assign('CiviEvent', TRUE);
 125     }
 126     CRM_Core_Form_RecurringEntity::preProcess('civicrm_event');
 127
 128     $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this, FALSE, 'add', 'REQUEST');
 129
 130     $this->assign('action', $this->_action);
 131
 132     $this->_id = CRM_Utils_Request::retrieve('id', 'Positive', $this, FALSE, NULL, 'GET');
 133     if ($this->_id) {
 134       $this->_isRepeatingEvent = CRM_Core_BAO_RecurringEntity::getParentFor($this->_id, 'civicrm_event');
 135       $this->assign('eventId', $this->_id);
 136       if (!empty($this->_addBlockName) && empty($this->_addProfileBottom) && empty($this->_addProfileBottomAdd)) {
 137         $this->add('hidden', 'id', $this->_id);
 138       }
 139       $this->_single = TRUE;
 140
 141       $params = ['id' => $this->_id];
 142       CRM_Event_BAO_Event::retrieve($params, $eventInfo);
 143
 144       // its an update mode, do a permission check
 145       if (!CRM_Event_BAO_Event::checkPermission($this->_id, CRM_Core_Permission::EDIT)) {
 146         CRM_Core_Error::fatal(ts('You do not have permission to access this page.'));
 147       }
 148
 149       $participantListingID = CRM_Utils_Array::value('participant_listing_id', $eventInfo);
 150       //CRM_Core_DAO::getFieldValue( 'CRM_Event_DAO_Event', $this->_id, 'participant_listing_id' );
 151       if ($participantListingID) {
 152         $participantListingURL = CRM_Utils_System::url('civicrm/event/participant',
 153           "reset=1&id={$this->_id}",
 154           TRUE, NULL, TRUE, TRUE
 155         );
 156         $this->assign('participantListingURL', $participantListingURL);
 157       }
 158
 159       $this->assign('isOnlineRegistration', CRM_Utils_Array::value('is_online_registration', $eventInfo));
 160
 161       $this->assign('id', $this->_id);
 162     }
 163
 164     // figure out whether we’re handling an event or an event template
 165     if ($this->_id) {
 166       $this->_isTemplate = CRM_Utils_Array::value('is_template', $eventInfo);
 167     }
 168     elseif ($this->_action & CRM_Core_Action::ADD) {
 169       $this->_isTemplate = CRM_Utils_Request::retrieve('is_template', 'Boolean', $this);
 170     }
 171
 172     $this->assign('isTemplate', $this->_isTemplate);
 173
 174     if ($this->_id) {
 175       if ($this->_isTemplate) {
 176         $title = CRM_Utils_Array::value('template_title', $eventInfo);
 177         CRM_Utils_System::setTitle(ts('Edit Event Template') . " - $title");
 178       }
 179       else {
 180         $configureText = ts('Configure Event');
 181         $title = CRM_Utils_Array::value('title', $eventInfo);
 182         //If it is a repeating event change title
 183         if ($this->_isRepeatingEvent) {
 184           $configureText = 'Configure Repeating Event';
 185         }
 186         CRM_Utils_System::setTitle($configureText . " - $title");
 187       }
 188       $this->assign('title', $title);
 189     }
 190     elseif ($this->_action & CRM_Core_Action::ADD) {
 191       if ($this->_isTemplate) {
 192         $title = ts('New Event Template');
 193         CRM_Utils_System::setTitle($title);
 194       }
 195       else {
 196         $title = ts('New Event');
 197         CRM_Utils_System::setTitle($title);
 198       }
 199       $this->assign('title', $title);
 200     }
 201
 202     if (CRM_Core_Permission::check('view event participants') &&
 203       CRM_Core_Permission::check('view all contacts')
 204     ) {
 205       $statusTypes = CRM_Event_PseudoConstant::participantStatus(NULL, 'is_counted = 1', 'label');
 206       $statusTypesPending = CRM_Event_PseudoConstant::participantStatus(NULL, 'is_counted = 0', 'label');
 207       $findParticipants['statusCounted'] = implode(', ', array_values($statusTypes));
 208       $findParticipants['statusNotCounted'] = implode(', ', array_values($statusTypesPending));
 209       $this->assign('findParticipants', $findParticipants);
 210     }
 211
 212     $this->_templateId = (int) CRM_Utils_Request::retrieve('template_id', 'Integer', $this);
 213
 214     //Is a repeating event
 215     if ($this->_isRepeatingEvent) {
 216       $isRepeatingEntity = TRUE;
 217       $this->assign('isRepeatingEntity', $isRepeatingEntity);
 218     }
 219
 220     // CRM-16776 - show edit/copy/create buttons for Profiles if user has required permission.
 221     $ufGroups = CRM_Core_PseudoConstant::get('CRM_Core_DAO_UFField', 'uf_group_id');
 222     $ufCreate = CRM_ACL_API::group(CRM_Core_Permission::CREATE, NULL, 'civicrm_uf_group', $ufGroups);
 223     $ufEdit = CRM_ACL_API::group(CRM_Core_Permission::EDIT, NULL, 'civicrm_uf_group', $ufGroups);
 224     $checkPermission = [
 225       [
 226         'administer CiviCRM',
 227         'manage event profiles',
 228       ],
 229     ];
 230     if (CRM_Core_Permission::check($checkPermission) || !empty($ufCreate) || !empty($ufEdit)) {
 231       $this->assign('perm', TRUE);
 232     }
 233
 234     // also set up tabs
 235     CRM_Event_Form_ManageEvent_TabHeader::build($this);
 236
 237     // Set Done button URL and breadcrumb. Templates go back to Manage Templates,
 238     // otherwise go to Manage Event for new event or ManageEventEdit if event if exists.
 239     $breadCrumb = [];
 240     if (!$this->_isTemplate) {
 241       if ($this->_id) {
 242         $this->_doneUrl = CRM_Utils_System::url(CRM_Utils_System::currentPath(),
 243           "action=update&reset=1&id={$this->_id}"
 244         );
 245       }
 246       else {
 247         $this->_doneUrl = CRM_Utils_System::url('civicrm/event/manage',
 248           'reset=1'
 249         );
 250         $breadCrumb = [
 251           [
 252             'title' => ts('Manage Events'),
 253             'url' => $this->_doneUrl,
 254           ],
 255         ];
 256       }
 257     }
 258     else {
 259       $this->_doneUrl = CRM_Utils_System::url('civicrm/admin/eventTemplate', 'reset=1');
 260       $breadCrumb = [
 261         [
 262           'title' => ts('Manage Event Templates'),
 263           'url' => $this->_doneUrl,
 264         ],
 265       ];
 266     }
 267     CRM_Utils_System::appendBreadCrumb($breadCrumb);
 268   }
 269
 270   /**
 271    * Set default values for the form.
 272    *
 273    * For edit/view mode the default values are retrieved from the database.
 274    */
 275   public function setDefaultValues() {
 276     $defaults = [];
 277     if (isset($this->_id)) {
 278       $params = ['id' => $this->_id];
 279       CRM_Event_BAO_Event::retrieve($params, $defaults);
 280
 281       $this->_campaignID = CRM_Utils_Array::value('campaign_id', $defaults);
 282     }
 283     elseif ($this->_templateId) {
 284       $params = ['id' => $this->_templateId];
 285       CRM_Event_BAO_Event::retrieve($params, $defaults);
 286       $defaults['is_template'] = $this->_isTemplate;
 287       $defaults['template_id'] = $defaults['id'];
 288       unset($defaults['id']);
 289     }
 290     else {
 291       $defaults['is_active'] = 1;
 292       $defaults['style'] = 'Inline';
 293     }
 294
 295     return $defaults;
 296   }
 297
 298   /**
 299    * Build the form object.
 300    */
 301   public function buildQuickForm() {
 302     $session = CRM_Core_Session::singleton();
 303
 304     $this->_cancelURL = CRM_Utils_Array::value('cancelURL', $_POST);
 305
 306     if (!$this->_cancelURL) {
 307       if ($this->_isTemplate) {
 308         $this->_cancelURL = CRM_Utils_System::url('civicrm/admin/eventTemplate',
 309           'reset=1'
 310         );
 311       }
 312       else {
 313         $this->_cancelURL = CRM_Utils_System::url('civicrm/event/manage',
 314           'reset=1'
 315         );
 316       }
 317     }
 318
 319     if ($this->_cancelURL) {
 320       $this->addElement('hidden', 'cancelURL', $this->_cancelURL);
 321     }
 322
 323     if ($this->_single) {
 324       $buttons = [
 325         [
 326           'type' => 'upload',
 327           'name' => ts('Save'),
 328           'isDefault' => TRUE,
 329         ],
 330         [
 331           'type' => 'upload',
 332           'name' => ts('Save and Done'),
 333           'spacing' => '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;',
 334           'subName' => 'done',
 335         ],
 336         [
 337           'type' => 'cancel',
 338           'name' => ts('Cancel'),
 339         ],
 340       ];
 341       $this->addButtons($buttons);
 342     }
 343     else {
 344       $buttons = [];
 345       if (!$this->_first) {
 346         $buttons[] = [
 347           'type' => 'back',
 348           'name' => ts('Previous'),
 349           'spacing' => '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;',
 350         ];
 351       }
 352       $buttons[] = [
 353         'type' => 'upload',
 354         'name' => ts('Continue'),
 355         'spacing' => '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;',
 356         'isDefault' => TRUE,
 357       ];
 358       $buttons[] = [
 359         'type' => 'cancel',
 360         'name' => ts('Cancel'),
 361       ];
 362
 363       $this->addButtons($buttons);
 364     }
 365     $session->replaceUserContext($this->_cancelURL);
 366     $this->add('hidden', 'is_template', $this->_isTemplate);
 367   }
 368
 369   public function endPostProcess() {
 370     // make submit buttons keep the current working tab opened.
 371     if ($this->_action & CRM_Core_Action::UPDATE) {
 372       $className = CRM_Utils_String::getClassName($this->_name);
 373
 374       // hack for special cases.
 375       switch ($className) {
 376         case 'Event':
 377           $attributes = $this->getVar('_attributes');
 378           $subPage = CRM_Utils_Request::retrieveComponent($attributes);
 379           break;
 380
 381         case 'EventInfo':
 382           $subPage = 'settings';
 383           break;
 384
 385         case 'ScheduleReminders':
 386           $subPage = 'reminder';
 387           break;
 388
 389         default:
 390           $subPage = strtolower($className);
 391           break;
 392       }
 393
 394       CRM_Core_Session::setStatus(ts("'%1' information has been saved.",
 395         [1 => CRM_Utils_Array::value('title', CRM_Utils_Array::value($subPage, $this->get('tabHeader')), $className)]
 396       ), ts('Saved'), 'success');
 397
 398       $config = CRM_Core_Config::singleton();
 399       if (in_array('CiviCampaign', $config->enableComponents)) {
 400         $values = $this->controller->exportValues($this->_name);
 401         $newCampaignID = CRM_Utils_Array::value('campaign_id', $values);
 402         $eventID = CRM_Utils_Array::value('id', $values);
 403         if ($eventID && $this->_campaignID != $newCampaignID) {
 404           CRM_Event_BAO_Event::updateParticipantCampaignID($eventID, $newCampaignID);
 405         }
 406       }
 407       $this->postProcessHook();
 408       if ($this->controller->getButtonName('submit') == "_qf_{$className}_upload_done") {
 409         if ($this->_isTemplate) {
 410           CRM_Core_Session::singleton()
 411             ->pushUserContext(CRM_Utils_System::url('civicrm/admin/eventTemplate', 'reset=1'));
 412         }
 413         else {
 414           CRM_Core_Session::singleton()->pushUserContext(CRM_Utils_System::url('civicrm/event/manage', 'reset=1'));
 415         }
 416       }
 417       else {
 418         CRM_Core_Session::singleton()->pushUserContext(CRM_Utils_System::url("civicrm/event/manage/{$subPage}",
 419           "action=update&reset=1&id={$this->_id}"
 420         ));
 421       }
 422     }
 423   }
 424
 425   /**
 426    * @return string
 427    */
 428   public function getTemplateFileName() {
 429     if ($this->controller->getPrint() || $this->getVar('_id') <= 0 || $this->_action & CRM_Core_Action::DELETE) {
 430       return parent::getTemplateFileName();
 431     }
 432     else {
 433       // hack lets suppress the form rendering for now
 434       self::$_template->assign('isForm', FALSE);
 435       return 'CRM/Event/Form/ManageEvent/Tab.tpl';
 436     }
 437   }
 438
 439   /**
 440    * Pre-load libraries required by Online Registration Profile fields
 441    */
 442   public static function addProfileEditScripts() {
 443     CRM_UF_Page_ProfileEditor::registerProfileScripts();
 444     CRM_UF_Page_ProfileEditor::registerSchemas(['IndividualModel', 'ParticipantModel']);
 445   }
 446
 447 }