INFRA-132 - Docblock @param and @return tag fixes
[civicrm-core.git] / CRM / Price / Form / Preview.php
1 <?php
2 /*
3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
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 previewing custom data
38 *
39 * It delegates the work to lower level subclasses and integrates the changes
40 * back in. It also uses a lot of functionality with the CRM API's, so any change
41 * made here could potentially affect the API etc. Be careful, be aware, use unit tests.
42 *
43 */
44 class CRM_Price_Form_Preview extends CRM_Core_Form {
45
46 /**
47 * The group tree data
48 *
49 * @var array
50 */
51 protected $_groupTree;
52
53 /**
54 * Pre processing work done here.
55 *
56 * gets session variables for group or field id
57 *
58 * @param null
59 *
60 * @return void
61 */
62 function preProcess() {
63 // get the controller vars
64 $groupId = $this->get('groupId');
65 $fieldId = $this->get('fieldId');
66
67 if ($fieldId) {
68 $groupTree = CRM_Price_BAO_PriceSet::getSetDetail($groupId);
69 $this->_groupTree[$groupId]['fields'][$fieldId] = $groupTree[$groupId]['fields'][$fieldId];
70 $this->assign('preview_type', 'field');
71 $url = CRM_Utils_System::url('civicrm/admin/price/field', "reset=1&action=browse&sid={$groupId}");
72 $breadCrumb = array(
73 array(
74 'title' => ts('Price Set Fields'),
75 'url' => $url,
76 )
77 );
78 }
79 else {
80 // group preview
81 $this->_groupTree = CRM_Price_BAO_PriceSet::getSetDetail($groupId);
82 $this->assign('preview_type', 'group');
83 $this->assign('setTitle', CRM_Price_BAO_PriceSet::getTitle($groupId));
84 $url = CRM_Utils_System::url('civicrm/admin/price', 'reset=1');
85 $breadCrumb = array(
86 array(
87 'title' => ts('Price Sets'),
88 'url' => $url,
89 )
90 );
91 }
92 CRM_Utils_System::appendBreadCrumb($breadCrumb);
93 }
94
95 /**
96 * Set the default form values
97 *
98 * @param null
99 *
100 * @return array
101 * the default array reference
102 */
103 public function setDefaultValues() {
104 $defaults = array();
105 $groupId = $this->get('groupId');
106 $fieldId = $this->get('fieldId');
107 if (!empty($this->_groupTree[$groupId]['fields'])) {
108 foreach ($this->_groupTree[$groupId]['fields'] as $key => $val) {
109 foreach ($val['options'] as $keys => $values) {
110 if ($values['is_default']) {
111 if ($val['html_type'] == 'CheckBox') {
112 $defaults["price_{$key}"][$keys] = 1;
113 }
114 else {
115 $defaults["price_{$key}"] = $keys;
116 }
117 }
118 }
119 }
120 }
121 return $defaults;
122 }
123
124 /**
125 * Build the form object
126 *
127 * @param null
128 *
129 * @return void
130 */
131 public function buildQuickForm() {
132 $this->assign('groupTree', $this->_groupTree);
133
134 // add the form elements
135
136 foreach ($this->_groupTree as $group) {
137 if (is_array($group['fields']) && !empty($group['fields'])) {
138 foreach ($group['fields'] as $field) {
139 $fieldId = $field['id'];
140 $elementName = 'price_' . $fieldId;
141 CRM_Price_BAO_PriceField::addQuickFormElement($this, $elementName, $fieldId, FALSE, $field['is_required']);
142 }
143 }
144 }
145
146 $this->addButtons(array(
147 array(
148 'type' => 'cancel',
149 'name' => ts('Done with Preview'),
150 'isDefault' => TRUE,
151 ),
152 )
153 );
154 }
155 }