CRM/Campaign/Form/Survey/Main.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.5                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2014                                |
   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-2014
  32  * $Id$
  33  *
  34  */
  35
  36 /**
  37  * This class generates form components for processing a survey
  38  *
  39  */
  40 class CRM_Campaign_Form_Survey_Main extends CRM_Campaign_Form_Survey {
  41
  42   /* values
  43      *
  44      * @var array
  45      */
  46
  47   public $_values;
  48
  49   /**
  50    * context
  51    *
  52    * @var string
  53    */
  54   protected $_context;
  55
  56   public function preProcess() {
  57     parent::preProcess();
  58
  59     $this->_context = CRM_Utils_Request::retrieve('context', 'String', $this);
  60
  61     $this->assign('context', $this->_context);
  62
  63     $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this);
  64
  65     if ($this->_action & CRM_Core_Action::UPDATE) {
  66       CRM_Utils_System::setTitle(ts('Configure Survey') . ' - ' . $this->_surveyTitle);
  67     }
  68
  69     $this->_cdType = CRM_Utils_Array::value('type', $_GET);
  70     $this->assign('cdType', FALSE);
  71     if ($this->_cdType) {
  72       $this->assign('cdType', TRUE);
  73       return CRM_Custom_Form_CustomData::preProcess($this);
  74     }
  75
  76     // when custom data is included in this page
  77     if (!empty($_POST['hidden_custom'])) {
  78       CRM_Custom_Form_CustomData::preProcess($this);
  79       CRM_Custom_Form_CustomData::buildQuickForm($this);
  80     }
  81
  82     if ($this->_name != 'Petition') {
  83       $url = CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=survey');
  84       CRM_Utils_System::appendBreadCrumb(array(array('title' => ts('Survey Dashboard'), 'url' => $url)));
  85     }
  86
  87     $this->_values = $this->get('values');
  88     if (!is_array($this->_values)) {
  89       $this->_values = array();
  90       if ($this->_surveyId) {
  91         $params = array('id' => $this->_surveyId);
  92         CRM_Campaign_BAO_Survey::retrieve($params, $this->_values);
  93       }
  94       $this->set('values', $this->_values);
  95     }
  96
  97     $this->assign('action', $this->_action);
  98     $this->assign('surveyId', $this->_surveyId);
  99     // for custom data
 100     $this->assign('entityID', $this->_surveyId);
 101   }
 102
 103   /**
 104    * This function sets the default values for the form. Note that in edit/view mode
 105    * the default values are retrieved from the database
 106    *
 107    * @param null
 108    *
 109    * @return array    array of default values
 110    * @access public
 111    */
 112   function setDefaultValues() {
 113     if ($this->_cdType) {
 114       return CRM_Custom_Form_CustomData::setDefaultValues($this);
 115     }
 116
 117     $defaults = $this->_values;
 118
 119     if ($this->_surveyId) {
 120
 121       if (!empty($defaults['result_id']) && !empty($defaults['recontact_interval'])) {
 122
 123         $resultId = $defaults['result_id'];
 124         $recontactInterval = unserialize($defaults['recontact_interval']);
 125
 126         unset($defaults['recontact_interval']);
 127         $defaults['option_group_id'] = $resultId;
 128       }
 129     }
 130
 131     if (!isset($defaults['is_active'])) {
 132       $defaults['is_active'] = 1;
 133     }
 134
 135     $defaultSurveys = CRM_Campaign_BAO_Survey::getSurveys(TRUE, TRUE);
 136     if (!isset($defaults['is_default']) && empty($defaultSurveys)) {
 137       $defaults['is_default'] = 1;
 138     }
 139
 140     return $defaults;
 141   }
 142
 143   /**
 144    * Function to actually build the form
 145    *
 146    * @param null
 147    *
 148    * @return void
 149    * @access public
 150    */
 151   public function buildQuickForm() {
 152     if ($this->_cdType) {
 153       return CRM_Custom_Form_CustomData::buildQuickForm($this);
 154     }
 155
 156     $this->add('text', 'title', ts('Title'), CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey', 'title'), TRUE);
 157
 158     $surveyActivityTypes = CRM_Campaign_BAO_Survey::getSurveyActivityType();
 159     // Activity Type id
 160     $this->addSelect('activity_type_id', array('option_url' => 'civicrm/admin/campaign/surveyType'), TRUE);
 161
 162     // Campaign id
 163     $campaigns = CRM_Campaign_BAO_Campaign::getCampaigns(CRM_Utils_Array::value('campaign_id', $this->_values));
 164     $this->add('select', 'campaign_id', ts('Campaign'), array('' => ts('- select -')) + $campaigns);
 165
 166     // script / instructions
 167     $this->addWysiwyg('instructions', ts('Instructions for interviewers'), array('rows' => 5, 'cols' => 40));
 168
 169     // release frequency
 170     $this->add('text', 'release_frequency', ts('Release Frequency'), CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey', 'release_frequency'));
 171
 172     $this->addRule('release_frequency', ts('Release Frequency interval should be a positive number.'), 'positiveInteger');
 173
 174     // max reserved contacts at a time
 175     $this->add('text', 'default_number_of_contacts', ts('Maximum reserved at one time'), CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey', 'default_number_of_contacts'));
 176     $this->addRule('default_number_of_contacts', ts('Maximum reserved at one time should be a positive number'), 'positiveInteger');
 177
 178     // total reserved per interviewer
 179     $this->add('text', 'max_number_of_contacts', ts('Total reserved per interviewer'), CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Survey', 'max_number_of_contacts'));
 180     $this->addRule('max_number_of_contacts', ts('Total reserved contacts should be a positive number'), 'positiveInteger');
 181
 182     // is active ?
 183     $this->add('checkbox', 'is_active', ts('Active?'));
 184
 185     // is default ?
 186     $this->add('checkbox', 'is_default', ts('Default?'));
 187
 188     parent::buildQuickForm();
 189   }
 190
 191   /**
 192    * Process the form
 193    *
 194    * @param null
 195    *
 196    * @return void
 197    * @access public
 198    */
 199   public function postProcess() {
 200     // store the submitted values in an array
 201     $params = $this->controller->exportValues($this->_name);
 202
 203     $session = CRM_Core_Session::singleton();
 204
 205     $params['last_modified_id'] = $session->get('userID');
 206     $params['last_modified_date'] = date('YmdHis');
 207
 208     if ($this->_surveyId) {
 209       $params['id'] = $this->_surveyId;
 210     }
 211     else {
 212       $params['created_id'] = $session->get('userID');
 213       $params['created_date'] = date('YmdHis');
 214     }
 215
 216     $params['is_active'] = CRM_Utils_Array::value('is_active', $params, 0);
 217     $params['is_default'] = CRM_Utils_Array::value('is_default', $params, 0);
 218
 219     $params['custom'] = CRM_Core_BAO_CustomField::postProcess($params,
 220       $customFields,
 221       $this->_surveyId,
 222       'Survey'
 223     );
 224     $survey = CRM_Campaign_BAO_Survey::create($params);
 225     $this->_surveyId = $survey->id;
 226
 227     if (!empty($this->_values['result_id'])) {
 228       $query = "SELECT COUNT(*) FROM civicrm_survey WHERE result_id = %1";
 229       $countSurvey = (int)CRM_Core_DAO::singleValueQuery($query,
 230         array(
 231           1 => array($this->_values['result_id'],
 232             'Positive',
 233           ))
 234       );
 235       // delete option group if no any survey is using it.
 236       if (!$countSurvey) {
 237         CRM_Core_BAO_OptionGroup::del($this->_values['result_id']);
 238       }
 239     }
 240
 241     parent::endPostProcess();
 242   }
 243 }
 244