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'])) { if (isset($this->definition['options arguments']) && is_array($this->definition['options arguments'])) { $this->value_options = call_user_func_array($this->definition['options callback'], $this->definition['options arguments']); } else { $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(&$form, &$form_state) { parent::expose_form($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(); $options['expose']['contains']['reduce'] = array('default' => FALSE); 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 (NOT 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(); $options = array(); if (empty($form_state['exposed'])) { // Add a select all option to the value form. $options = array('all' => t('Select all')); } $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_id'])) { // exposed and locked. $which = in_array($this->operator, $this->operator_values(1)) ? 'value' : 'none'; } else { $source = 'edit-' . drupal_html_id($this->options['expose']['operator_id']); } if (!empty($this->options['expose']['reduce'])) { $options = $this->reduce_value_options(); if (!empty($this->options['expose']['multiple']) && empty($this->options['expose']['required'])) { $default_value = array(); } } if (empty($this->options['expose']['multiple'])) { if (empty($this->options['expose']['required']) && (empty($default_value) || !empty($this->options['expose']['reduce']))) { $default_value = 'All'; } elseif (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; } if ($which == 'all') { if (empty($form_state['exposed']) && (in_array($this->value_form_type, array('checkbox', 'checkboxes', 'radios', 'select')))) { $form['value']['#prefix'] = '