value_title = t('Options'); $this->value_options = NULL; } /** * Child classes should be used to override this function and set the * 'value options', unless 'options callback' is defined as a valid function * or static public method to generate these values. * * This can use a guard to be used to reduce database hits as much as * possible. */ function get_value_options() { if (isset($this->value_options)) { return; } if (isset($this->definition['options callback']) && is_callable($this->definition['options callback'])) { $this->value_options = call_user_func($this->definition['options callback']); } else { $this->value_options = array(t('Yes'), t('No')); } } function expose_options() { parent::expose_options(); $this->options['expose']['reduce'] = FALSE; } function expose_form_right(&$form, &$form_state) { parent::expose_form_right($form, $form_state); $form['expose']['reduce'] = array( '#type' => 'checkbox', '#title' => t('Limit list to selected items'), '#description' => t('If checked, the only items presented to the user will be the ones selected here.'), '#default_value' => !empty($this->options['expose']['reduce']), // safety ); } function option_definition() { $options = parent::option_definition(); $options['operator']['default'] = 'in'; $options['value']['default'] = array(); return $options; } /** * This kind of construct makes it relatively easy for a child class * to add or remove functionality by overriding this function and * adding/removing items from this array. */ function operators() { $operators = array( 'in' => array( 'title' => t('Is one of'), 'short' => t('in'), 'short_single' => t('='), 'method' => 'op_simple', 'values' => 1, ), 'not in' => array( 'title' => t('Is not one of'), 'short' => t('not in'), 'short_single' => t('<>'), 'method' => 'op_simple', 'values' => 1, ), ); // if the definition allows for the empty operator, add it. if (!empty($this->definition['allow empty'])) { $operators += array( 'empty' => array( 'title' => t('Is empty (NULL)'), 'method' => 'op_empty', 'short' => t('empty'), 'values' => 0, ), 'not empty' => array( 'title' => t('Is not empty (NULL)'), 'method' => 'op_empty', 'short' => t('not empty'), 'values' => 0, ), ); } return $operators; } /** * Build strings from the operators() for 'select' options */ function operator_options($which = 'title') { $options = array(); foreach ($this->operators() as $id => $info) { $options[$id] = $info[$which]; } return $options; } function operator_values($values = 1) { $options = array(); foreach ($this->operators() as $id => $info) { if (isset($info['values']) && $info['values'] == $values) { $options[] = $id; } } return $options; } function value_form(&$form, &$form_state) { $form['value'] = array(); $this->get_value_options(); $options = $this->value_options; $default_value = (array) $this->value; $which = 'all'; if (!empty($form['operator'])) { $source = ($form['operator']['#type'] == 'radios') ? 'radio:options[operator]' : 'edit-options-operator'; } if (!empty($form_state['exposed'])) { $identifier = $this->options['expose']['identifier']; if (empty($this->options['expose']['use_operator']) || empty($this->options['expose']['operator'])) { // exposed and locked. $which = in_array($this->operator, $this->operator_values(1)) ? 'value' : 'none'; } else { $source = 'edit-' . form_clean_id($this->options['expose']['operator']); } if (!empty($this->options['expose']['reduce'])) { $options = $this->reduce_value_options(); if (empty($this->options['expose']['single']) && !empty($this->options['expose']['optional'])) { $default_value = array(); } } if (!empty($this->options['expose']['single'])) { if (!empty($this->options['expose']['optional']) && (empty($default_value) || !empty($this->options['expose']['reduce']))) { $default_value = 'All'; } else if (empty($default_value)) { $keys = array_keys($options); $default_value = array_shift($keys); } else { $copy = $default_value; $default_value = array_shift($copy); } } } if ($which == 'all' || $which == 'value') { $form['value'] = array( '#type' => $this->value_form_type, '#title' => $this->value_title, '#options' => $options, '#default_value' => $default_value, // These are only valid for 'select' type, but do no harm to checkboxes. '#multiple' => TRUE, '#size' => count($options) > 8 ? 8 : count($options), ); if (!empty($form_state['exposed']) && !isset($form_state['input'][$identifier])) { $form_state['input'][$identifier] = $default_value; } $process = array(); if ($this->value_form_type == 'checkboxes') { // If this form element will use checkboxes in the UI, we need to // check_plain() all the options ourselves since FAPI is inconsistent // about this. However, instead of directly doing that to the #options // right now, we define a #process callback since we might change our // mind later and convert this into a 'select' form element, which // would lead to double-escaping the options. $process[] = 'views_process_check_options'; } if ($which == 'all') { if (empty($form_state['exposed']) && ($this->value_form_type == 'checkboxes' || $this->value_form_type == 'radios')) { $process[] = "expand_$this->value_form_type"; $form['value']['#prefix'] = '