CRM/Campaign/Form/Petition.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  *
  30  * @package CRM
  31  * @copyright CiviCRM LLC (c) 2004-2019
  32  */
  33
  34 /**
  35  * This class generates form components for adding a petition.
  36  */
  37 class CRM_Campaign_Form_Petition extends CRM_Core_Form {
  38
  39   /**
  40    * Making this public so we can reference it in the formRule
  41    * @var int
  42    */
  43   public $_surveyId;
  44
  45   /**
  46    * Explicitly declare the entity api name.
  47    */
  48   public function getDefaultEntity() {
  49     return 'Survey';
  50   }
  51
  52   /**
  53    * Get the entity id being edited.
  54    *
  55    * @return int|null
  56    */
  57   public function getEntityId() {
  58     return $this->_surveyId;
  59   }
  60
  61   public function preProcess() {
  62     if (!CRM_Campaign_BAO_Campaign::accessCampaign()) {
  63       CRM_Utils_System::permissionDenied();
  64     }
  65
  66     $this->_context = CRM_Utils_Request::retrieve('context', 'Alphanumeric', $this);
  67
  68     $this->assign('context', $this->_context);
  69
  70     $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this);
  71
  72     if ($this->_action & (CRM_Core_Action::UPDATE | CRM_Core_Action::DELETE)) {
  73       $this->_surveyId = CRM_Utils_Request::retrieve('id', 'Positive', $this, TRUE);
  74
  75       if ($this->_action & CRM_Core_Action::UPDATE) {
  76         CRM_Utils_System::setTitle(ts('Edit Survey'));
  77       }
  78       else {
  79         CRM_Utils_System::setTitle(ts('Delete Survey'));
  80       }
  81     }
  82
  83     // Add custom data to form
  84     CRM_Custom_Form_CustomData::addToForm($this);
  85
  86     $session = CRM_Core_Session::singleton();
  87     $url = CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=survey');
  88     $session->pushUserContext($url);
  89
  90     $this->_values = $this->get('values');
  91
  92     if (!is_array($this->_values)) {
  93       $this->_values = array();
  94       if ($this->_surveyId) {
  95         $params = array('id' => $this->_surveyId);
  96         CRM_Campaign_BAO_Survey::retrieve($params, $this->_values);
  97       }
  98       $this->set('values', $this->_values);
  99     }
 100
 101     $this->assign('action', $this->_action);
 102     $this->assign('surveyId', $this->_surveyId);
 103
 104     if ($this->_action & (CRM_Core_Action::UPDATE | CRM_Core_Action::DELETE)) {
 105       $this->_surveyId = CRM_Utils_Request::retrieve('id', 'Positive', $this, TRUE);
 106
 107       if ($this->_action & CRM_Core_Action::UPDATE) {
 108         CRM_Utils_System::setTitle(ts('Edit Petition'));
 109       }
 110       else {
 111         CRM_Utils_System::setTitle(ts('Delete Petition'));
 112       }
 113     }
 114
 115     $session = CRM_Core_Session::singleton();
 116     $url = CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=petition');
 117     $session->pushUserContext($url);
 118
 119     CRM_Utils_System::appendBreadCrumb(array(array('title' => ts('Petition Dashboard'), 'url' => $url)));
 120   }
 121
 122   /**
 123    * Set default values for the form. Note that in edit/view mode
 124    * the default values are retrieved from the database
 125    *
 126    * @return array
 127    *   array of default values
 128    */
 129   public function setDefaultValues() {
 130     $defaults = $this->_values;
 131
 132     $ufContactJoinParams = array(
 133       'entity_table' => 'civicrm_survey',
 134       'entity_id' => $this->_surveyId,
 135       'weight' => 2,
 136     );
 137
 138     if ($ufContactGroupId = CRM_Core_BAO_UFJoin::findUFGroupId($ufContactJoinParams)) {
 139       $defaults['contact_profile_id'] = $ufContactGroupId;
 140     }
 141     $ufActivityJoinParams = array(
 142       'entity_table' => 'civicrm_survey',
 143       'entity_id' => $this->_surveyId,
 144       'weight' => 1,
 145     );
 146
 147     if ($ufActivityGroupId = CRM_Core_BAO_UFJoin::findUFGroupId($ufActivityJoinParams)) {
 148       $defaults['profile_id'] = $ufActivityGroupId;
 149     }
 150
 151     if (!isset($defaults['is_active'])) {
 152       $defaults['is_active'] = 1;
 153     }
 154
 155     $defaultSurveys = CRM_Campaign_BAO_Survey::getSurveys(TRUE, TRUE);
 156     if (!isset($defaults['is_default']) && empty($defaultSurveys)) {
 157       $defaults['is_default'] = 1;
 158     }
 159
 160     return $defaults;
 161   }
 162
 163
 164   public function buildQuickForm() {
 165
 166     if ($this->_action & CRM_Core_Action::DELETE) {
 167       $this->addButtons(
 168         array(
 169           array(
 170             'type' => 'next',
 171             'name' => ts('Delete'),
 172             'isDefault' => TRUE,
 173           ),
 174           array(
 175             'type' => 'cancel',
 176             'name' => ts('Cancel'),
 177           ),
 178         )
 179       );
 180       return;
 181     }
 182
 183     $this->add('text', 'title', ts('Petition Title'), CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey', 'title'), TRUE);
 184
 185     $attributes = CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey');
 186
 187     $petitionTypeID = CRM_Core_PseudoConstant::getKey('CRM_Activity_BAO_Activity', 'activity_type_id', 'Petition');
 188     $this->addElement('hidden', 'activity_type_id', $petitionTypeID);
 189
 190     // script / instructions / description of petition purpose
 191     $this->add('wysiwyg', 'instructions', ts('Introduction'), $attributes['instructions']);
 192
 193     $this->addEntityRef('campaign_id', ts('Campaign'), [
 194       'entity' => 'campaign',
 195       'create' => TRUE,
 196     ]);
 197
 198     $customContactProfiles = CRM_Core_BAO_UFGroup::getProfiles(array('Individual'));
 199     // custom group id
 200     $this->add('select', 'contact_profile_id', ts('Contact Profile'),
 201       array(
 202         '' => ts('- select -'),
 203       ) + $customContactProfiles, TRUE
 204     );
 205
 206     $customProfiles = CRM_Core_BAO_UFGroup::getProfiles(array('Activity'));
 207     // custom group id
 208     $this->add('select', 'profile_id', ts('Activity Profile'),
 209       array(
 210         '' => ts('- select -'),
 211       ) + $customProfiles
 212     );
 213
 214     // thank you title and text (html allowed in text)
 215     $this->add('text', 'thankyou_title', ts('Thank-you Page Title'), CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey', 'thankyou_title'));
 216     $this->add('wysiwyg', 'thankyou_text', ts('Thank-you Message'), CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey', 'thankyou_text'));
 217
 218     // bypass email confirmation?
 219     $this->add('checkbox', 'bypass_confirm', ts('Bypass email confirmation'));
 220
 221     //is share through social media
 222     $this->addElement('checkbox', 'is_share', ts('Allow sharing through social media?'));
 223
 224     // is active ?
 225     $this->add('checkbox', 'is_active', ts('Is Active?'));
 226
 227     // is default ?
 228     $this->add('checkbox', 'is_default', ts('Is Default?'));
 229
 230     // add buttons
 231     $this->addButtons(
 232       array(
 233         array(
 234           'type' => 'next',
 235           'name' => ts('Save'),
 236           'isDefault' => TRUE,
 237         ),
 238         array(
 239           'type' => 'next',
 240           'name' => ts('Save and New'),
 241           'subName' => 'new',
 242         ),
 243         array(
 244           'type' => 'cancel',
 245           'name' => ts('Cancel'),
 246         ),
 247       )
 248     );
 249
 250     // add a form rule to check default value
 251     $this->addFormRule(array('CRM_Campaign_Form_Petition', 'formRule'), $this);
 252   }
 253
 254   /**
 255    * Global validation rules for the form.
 256    * @param $fields
 257    * @param $files
 258    * @param $form
 259    * @return array|bool
 260    */
 261   public static function formRule($fields, $files, $form) {
 262     $errors = array();
 263     // Petitions should be unique by: title, campaign ID (if assigned) and activity type ID
 264     // NOTE: This class is called for both Petition create / update AND for Survey Results tab, but this rule is only for Petition.
 265     $where = array('activity_type_id = %1', 'title = %2');
 266     $params = array(
 267       1 => array($fields['activity_type_id'], 'Integer'),
 268       2 => array($fields['title'], 'String'),
 269     );
 270     $uniqueRuleErrorMessage = ts('This title is already associated with the selected activity type. Please specify a unique title.');
 271
 272     if (empty($fields['campaign_id'])) {
 273       $where[] = 'campaign_id IS NULL';
 274     }
 275     else {
 276       $where[] = 'campaign_id = %3';
 277       $params[3] = array($fields['campaign_id'], 'Integer');
 278       $uniqueRuleErrorMessage = ts('This title is already associated with the selected campaign and activity type. Please specify a unique title.');
 279     }
 280
 281     // Exclude current Petition row if UPDATE.
 282     if ($form->_surveyId) {
 283       $where[] = 'id != %4';
 284       $params[4] = array($form->_surveyId, 'Integer');
 285     }
 286
 287     $whereClause = implode(' AND ', $where);
 288
 289     $query = "
 290 SELECT COUNT(*) AS row_count
 291 FROM   civicrm_survey
 292 WHERE  $whereClause
 293 ";
 294
 295     $result = CRM_Core_DAO::singleValueQuery($query, $params);
 296     if ($result >= 1) {
 297       $errors['title'] = $uniqueRuleErrorMessage;
 298     }
 299     return empty($errors) ? TRUE : $errors;
 300   }
 301
 302
 303   public function postProcess() {
 304     // store the submitted values in an array
 305     $params = $this->controller->exportValues($this->_name);
 306
 307     $session = CRM_Core_Session::singleton();
 308
 309     $params['last_modified_id'] = $session->get('userID');
 310     $params['last_modified_date'] = date('YmdHis');
 311     $params['is_share'] = CRM_Utils_Array::value('is_share', $params, FALSE);
 312
 313     if ($this->_surveyId) {
 314
 315       if ($this->_action & CRM_Core_Action::DELETE) {
 316         CRM_Campaign_BAO_Survey::del($this->_surveyId);
 317         CRM_Core_Session::setStatus(ts(' Petition has been deleted.'), ts('Record Deleted'), 'success');
 318         $session->replaceUserContext(CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=petition'));
 319         return;
 320       }
 321
 322       $params['id'] = $this->_surveyId;
 323     }
 324     else {
 325       $params['created_id'] = $session->get('userID');
 326       $params['created_date'] = date('YmdHis');
 327     }
 328
 329     $params['bypass_confirm'] = CRM_Utils_Array::value('bypass_confirm', $params, 0);
 330     $params['is_active'] = CRM_Utils_Array::value('is_active', $params, 0);
 331     $params['is_default'] = CRM_Utils_Array::value('is_default', $params, 0);
 332
 333     $params['custom'] = CRM_Core_BAO_CustomField::postProcess($params, $this->getEntityId(), $this->getDefaultEntity());
 334
 335     $surveyId = CRM_Campaign_BAO_Survey::create($params);
 336
 337     // also update the ProfileModule tables
 338     $ufJoinParams = array(
 339       'is_active' => 1,
 340       'module' => 'CiviCampaign',
 341       'entity_table' => 'civicrm_survey',
 342       'entity_id' => $surveyId->id,
 343     );
 344
 345     // first delete all past entries
 346     if ($this->_surveyId) {
 347       CRM_Core_BAO_UFJoin::deleteAll($ufJoinParams);
 348     }
 349     if (!empty($params['profile_id'])) {
 350       $ufJoinParams['weight'] = 1;
 351       $ufJoinParams['uf_group_id'] = $params['profile_id'];
 352       CRM_Core_BAO_UFJoin::create($ufJoinParams);
 353     }
 354
 355     if (!empty($params['contact_profile_id'])) {
 356       $ufJoinParams['weight'] = 2;
 357       $ufJoinParams['uf_group_id'] = $params['contact_profile_id'];
 358       CRM_Core_BAO_UFJoin::create($ufJoinParams);
 359     }
 360
 361     if (!is_a($surveyId, 'CRM_Core_Error')) {
 362       CRM_Core_Session::setStatus(ts('Petition has been saved.'), ts('Saved'), 'success');
 363     }
 364
 365     $buttonName = $this->controller->getButtonName();
 366     if ($buttonName == $this->getButtonName('next', 'new')) {
 367       CRM_Core_Session::setStatus(ts(' You can add another Petition.'), '', 'info');
 368       $session->replaceUserContext(CRM_Utils_System::url('civicrm/petition/add', 'reset=1&action=add'));
 369     }
 370     else {
 371       $session->replaceUserContext(CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=petition'));
 372     }
 373   }
 374
 375 }