3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2014 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
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. |
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. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License along with this program; if not, contact CiviCRM LLC |
21 | at info[AT]civicrm[DOT]org. If you have questions about the |
22 | GNU Affero General Public License or the licensing of CiviCRM, |
23 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
24 +--------------------------------------------------------------------+
28 * Base class for most search forms
30 class CRM_Core_Form_Search
extends CRM_Core_Form
{
33 * Are we forced to run a search
40 * Name of search button
44 protected $_searchButtonName;
47 * Name of action button
51 protected $_actionButtonName;
54 * Form values that we will be using
61 * Have we already done this search
68 * What context are we being invoked from
72 protected $_context = NULL;
75 * The list of tasks or actions that a searcher can perform on a result set.
79 protected $_taskList = array();
82 * Builds the list of tasks or actions that a searcher can perform on a result set.
84 * To modify the task list, child classes should alter $this->_taskList,
85 * preferably by extending this method.
89 protected function buildTaskList() {
90 return $this->_taskList
;
94 * Common buildform tasks required by all searches
96 public function buildQuickform() {
97 $resources = CRM_Core_Resources
::singleton();
99 if ($resources->ajaxPopupsEnabled
) {
100 // Script needed by some popups
101 $this->assign('includeWysiwygEditor', TRUE);
104 $resources->addScriptFile('civicrm', 'js/crm.searchForm.js', 1, 'html-header');
106 $this->addButtons(array(
109 'name' => ts('Search'),
114 $this->addClass('crm-search-form');
116 // for backwards compatibility we pass an argument to addTaskMenu even though
117 // it could just as well access $this->_taskList internally
118 $tasks = $this->buildTaskList();
119 $this->addTaskMenu($tasks);
123 * Add checkboxes for each row plus a master checkbox
125 public function addRowSelectors($rows) {
126 $this->addElement('checkbox', 'toggleSelect', NULL, NULL, array('class' => 'select-rows'));
127 foreach ($rows as $row) {
128 $this->addElement('checkbox', $row['checkbox'], NULL, NULL, array('class' => 'select-row'));
133 * Add actions menu to search results form
136 public function addTaskMenu($tasks) {
137 if (is_array($tasks) && !empty($tasks)) {
138 $tasks = array('' => ts('Actions')) +
$tasks;
139 $this->add('select', 'task', NULL, $tasks, FALSE, array('class' => 'crm-select2 crm-action-menu huge crm-search-result-actions'));
140 $this->add('submit', $this->_actionButtonName
, ts('Go'), array('class' => 'hiddenElement crm-search-go-button'));
142 // Radio to choose "All items" or "Selected items only"
143 $selectedRowsRadio = $this->addElement('radio', 'radio_ts', NULL, '', 'ts_sel', array('checked' => 'checked'));
144 $allRowsRadio = $this->addElement('radio', 'radio_ts', NULL, '', 'ts_all');
145 $this->assign('ts_sel_id', $selectedRowsRadio->_attributes
['id']);
146 $this->assign('ts_all_id', $allRowsRadio->_attributes
['id']);