CRM/Campaign/Form/Campaign.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 campaign
  38  *
  39  */
  40 class CRM_Campaign_Form_Campaign extends CRM_Core_Form {
  41
  42   /**
  43    * action
  44    *
  45    * @var int
  46    */
  47   protected $_action;
  48
  49   /**
  50    * context
  51    *
  52    * @var string
  53    */
  54   protected $_context;
  55
  56   /**
  57    * object values.
  58    *
  59    * @var array
  60    */
  61   protected $_values;
  62
  63   /**
  64    * the id of the campaign we are proceessing
  65    *
  66    * @var int
  67    * @protected
  68    */
  69   protected $_campaignId;
  70
  71   public function preProcess() {
  72     if (!CRM_Campaign_BAO_Campaign::accessCampaign()) {
  73       CRM_Utils_System::permissionDenied();
  74     }
  75
  76     //check for custom data type.
  77     $this->_cdType = CRM_Utils_Array::value('type', $_GET);
  78     $this->assign('cdType', FALSE);
  79     if ($this->_cdType) {
  80       $this->assign('cdType', TRUE);
  81       return CRM_Custom_Form_CustomData::preProcess($this);
  82     }
  83
  84     $this->_context = CRM_Utils_Request::retrieve('context', 'String', $this);
  85
  86     $this->assign('context', $this->_context);
  87
  88     $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this);
  89     $this->_campaignId = CRM_Utils_Request::retrieve('id', 'Positive', $this);
  90
  91     $title = NULL;
  92     if ($this->_action & CRM_Core_Action::UPDATE) {
  93       $title = ts('Edit Campaign');
  94     }
  95     if ($this->_action & CRM_Core_Action::DELETE) {
  96       $title = ts('Delete Campaign');
  97     }
  98     if ($title) {
  99       CRM_Utils_System::setTitle($title);
 100     }
 101
 102     $session = CRM_Core_Session::singleton();
 103     $session->pushUserContext(CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=campaign'));
 104     $this->assign('action', $this->_action);
 105
 106     //load the values;
 107     $this->_values = $this->get('values');
 108     if (!is_array($this->_values)) {
 109       $this->_values = array();
 110
 111       // if we are editing
 112       if (isset($this->_campaignId) && $this->_campaignId) {
 113         $params = array('id' => $this->_campaignId);
 114         CRM_Campaign_BAO_Campaign::retrieve($params, $this->_values);
 115       }
 116
 117       //lets use current object session.
 118       $this->set('values', $this->_values);
 119     }
 120
 121     // when custom data is included in form.
 122     if (!empty($_POST['hidden_custom'])) {
 123       $this->set('type', 'Campaign');
 124       $this->set('subType', CRM_Utils_Array::value('campaign_type_id', $_POST));
 125       $this->set('entityId', $this->_campaignId);
 126
 127       CRM_Custom_Form_CustomData::preProcess($this);
 128       CRM_Custom_Form_CustomData::buildQuickForm($this);
 129       CRM_Custom_Form_CustomData::setDefaultValues($this);
 130     }
 131   }
 132
 133   /**
 134    * This function sets the default values for the form. Note that in edit/view mode
 135    * the default values are retrieved from the database
 136    *
 137    * @access public
 138    *
 139    * @return void
 140    */
 141   function setDefaultValues() {
 142     $defaults = $this->_values;
 143
 144     //load only custom data defaults.
 145     if ($this->_cdType) {
 146       return CRM_Custom_Form_CustomData::setDefaultValues($this);
 147     }
 148
 149     if (isset($defaults['start_date'])) {
 150       list($defaults['start_date'],
 151         $defaults['start_date_time']
 152       ) = CRM_Utils_Date::setDateDefaults($defaults['start_date'],
 153         'activityDateTime'
 154       );
 155     }
 156     else {
 157       list($defaults['start_date'],
 158         $defaults['start_date_time']
 159       ) = CRM_Utils_Date::setDateDefaults();
 160     }
 161
 162     if (isset($defaults['end_date'])) {
 163       list($defaults['end_date'],
 164         $defaults['end_date_time']
 165       ) = CRM_Utils_Date::setDateDefaults($defaults['end_date'],
 166         'activityDateTime'
 167       );
 168     }
 169
 170     if (!isset($defaults['is_active'])) {
 171       $defaults['is_active'] = 1;
 172     }
 173
 174     if (!$this->_campaignId) {
 175       return $defaults;
 176     }
 177
 178     $dao = new CRM_Campaign_DAO_CampaignGroup();
 179
 180     $campaignGroups = array();
 181     $dao->campaign_id = $this->_campaignId;
 182     $dao->find();
 183
 184     while ($dao->fetch()) {
 185       $campaignGroups[$dao->entity_table][$dao->group_type][] = $dao->entity_id;
 186     }
 187
 188     if (!empty($campaignGroups)) {
 189       $defaults['includeGroups'] = $campaignGroups['civicrm_group']['Include'];
 190     }
 191     return $defaults;
 192   }
 193
 194   public function buildQuickForm() {
 195     if ($this->_action & CRM_Core_Action::DELETE) {
 196
 197       $this->addButtons(array(
 198           array(
 199             'type' => 'next',
 200             'name' => ts('Delete'),
 201             'isDefault' => TRUE,
 202           ),
 203           array(
 204             'type' => 'cancel',
 205             'name' => ts('Cancel'),
 206           ),
 207         )
 208       );
 209       return;
 210     }
 211
 212     $this->applyFilter('__ALL__', 'trim');
 213
 214     if ($this->_cdType) {
 215       return CRM_Custom_Form_CustomData::buildQuickForm($this);
 216     }
 217
 218     //lets assign custom data type and subtype.
 219     $this->assign('customDataType', 'Campaign');
 220     $this->assign('entityID', $this->_campaignId);
 221     $this->assign('customDataSubType', CRM_Utils_Array::value('campaign_type_id', $this->_values));
 222
 223     $attributes = CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Campaign');
 224
 225     // add comaign title.
 226     $this->add('text', 'title', ts('Title'), $attributes['title'], TRUE);
 227
 228     // add description
 229     $this->add('textarea', 'description', ts('Description'), $attributes['description']);
 230
 231     // add campaign start date
 232     $this->addDateTime('start_date', ts('Start Date'), TRUE, array('formatType' => 'activityDateTime'));
 233
 234     // add campaign end date
 235     $this->addDateTime('end_date', ts('End Date'), FALSE, array('formatType' => 'activityDateTime'));
 236
 237     // add campaign type
 238     $this->addSelect('campaign_type_id', array('onChange' => "CRM.buildCustomData( 'Campaign', this.value );"), TRUE);
 239
 240     // add campaign status
 241     $this->addSelect('status_id');
 242
 243     // add External Identifier Element
 244     $this->add('text', 'external_identifier', ts('External ID'),
 245       CRM_Core_DAO::getAttribute('CRM_Campaign_DAO_Campaign', 'external_identifier'), FALSE
 246     );
 247
 248     // add Campaign Parent Id
 249     $campaigns = CRM_Campaign_BAO_Campaign::getCampaigns(CRM_Utils_Array::value('parent_id', $this->_values),
 250       $this->_campaignId
 251     );
 252     if (!empty($campaigns)) {
 253       $this->addElement('select', 'parent_id', ts('Parent Id'),
 254         array(
 255           '' => ts('- select Parent -')) + $campaigns
 256       );
 257     }
 258 $groups = CRM_Core_PseudoConstant::nestedGroup();
 259     //get the campaign groups.
 260     $this->add('select', 'includeGroups',
 261       ts('Include Group(s)'),
 262       $groups,
 263       FALSE,
 264       array(
 265         'multiple' => TRUE,
 266         'class' => 'crm-select2 huge',
 267         'placeholder' => ts('- none -'),
 268       )
 269     );
 270
 271     $this->addWysiwyg('goal_general', ts('Campaign Goals'), array('rows' => 2, 'cols' => 40));
 272     $this->add('text', 'goal_revenue', ts('Revenue Goal'), array('size' => 8, 'maxlength' => 12));
 273     $this->addRule('goal_revenue', ts('Please enter a valid money value (e.g. %1).',
 274         array(1 => CRM_Utils_Money::format('99.99', ' '))
 275       ), 'money');
 276
 277     // is this Campaign active
 278     $this->addElement('checkbox', 'is_active', ts('Is Active?'));
 279
 280     $this->addButtons(array(
 281         array(
 282           'type' => 'upload',
 283           'name' => ts('Save'),
 284           'isDefault' => TRUE,
 285         ),
 286         array(
 287           'type' => 'upload',
 288           'name' => ts('Save and New'),
 289           'subName' => 'new',
 290         ),
 291         array(
 292           'type' => 'cancel',
 293           'name' => ts('Cancel'),
 294         ),
 295       )
 296     );
 297   }
 298
 299   /**
 300    * This function is used to add the rules (mainly global rules) for form.
 301    * All local rules are added near the element
 302    *
 303    * @param $fields
 304    * @param $files
 305    * @param $errors
 306    *
 307    * @return void
 308    * @access public
 309    * @see valid_date
 310    */
 311   static function formRule($fields, $files, $errors) {
 312     $errors = array();
 313
 314     return empty($errors) ? TRUE : $errors;
 315   }
 316
 317   /**
 318    * Form submission of new/edit campaign is processed.
 319    *
 320    * @access public
 321    *
 322    * @return void
 323    */
 324   public function postProcess() {
 325     // store the submitted values in an array
 326     $params = $this->controller->exportValues($this->_name);
 327     $session = CRM_Core_Session::singleton();
 328
 329     $groups = array();
 330     if (isset($this->_campaignId)) {
 331       if ($this->_action & CRM_Core_Action::DELETE) {
 332         CRM_Campaign_BAO_Campaign::del($this->_campaignId);
 333         CRM_Core_Session::setStatus(ts('Campaign has been deleted.'), ts('Record Deleted'), 'success');
 334         $session->replaceUserContext(CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=campaign'));
 335         return;
 336       }
 337       $params['id'] = $this->_campaignId;
 338     }
 339     else {
 340       $params['created_id'] = $session->get('userID');
 341       $params['created_date'] = date('YmdHis');
 342     }
 343     // format params
 344     $params['start_date'] = CRM_Utils_Date::processDate($params['start_date'], $params['start_date_time']);
 345     $params['end_date'] = CRM_Utils_Date::processDate($params['end_date'], $params['end_date_time'], TRUE);
 346     $params['is_active'] = CRM_Utils_Array::value('is_active', $params, FALSE);
 347     $params['last_modified_id'] = $session->get('userID');
 348     $params['last_modified_date'] = date('YmdHis');
 349
 350     if (is_array($params['includeGroups'])) {
 351       foreach ($params['includeGroups'] as $key => $id) {
 352         if ($id) {
 353           $groups['include'][] = $id;
 354         }
 355       }
 356     }
 357     $params['groups'] = $groups;
 358
 359     // delete previous includes/excludes, if campaign already existed
 360     $groupTableName    = CRM_Contact_BAO_Group::getTableName();
 361     $dao               = new CRM_Campaign_DAO_CampaignGroup();
 362     $dao->campaign_id  = $this->_campaignId;
 363     $dao->entity_table = $groupTableName;
 364     $dao->find();
 365     while ($dao->fetch()) {
 366       $dao->delete();
 367     }
 368
 369     //process custom data.
 370     $customFields = CRM_Core_BAO_CustomField::getFields('Campaign', FALSE, FALSE,
 371       CRM_Utils_Array::value('campaign_type_id', $params)
 372     );
 373     $params['custom'] = CRM_Core_BAO_CustomField::postProcess($params,
 374       $customFields,
 375       $this->_campaignId,
 376       'Campaign'
 377     );
 378
 379     $result = CRM_Campaign_BAO_Campaign::create($params);
 380
 381     if ($result) {
 382       CRM_Core_Session::setStatus(ts('Campaign %1 has been saved.', array(1 => $result->title)), ts('Saved'), 'success');
 383       $session->pushUserContext(CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=campaign'));
 384     }
 385
 386     $buttonName = $this->controller->getButtonName();
 387     if ($buttonName == $this->getButtonName('upload', 'new')) {
 388       CRM_Core_Session::setStatus(ts(' You can add another Campaign.'), '', 'info');
 389       $session->replaceUserContext(CRM_Utils_System::url('civicrm/campaign/add', 'reset=1&action=add'));
 390     }
 391     else {
 392       $session->replaceUserContext(CRM_Utils_System::url('civicrm/campaign', 'reset=1&subPage=campaign'));
 393     }
 394   }
 395 }
 396
 397
 398