class quiz_views_handler_filter_user_quiz_state in Quiz 7.6

Hierarchy

• class \views_object
  • class \views_handler
    • class \views_handler_filter
      • class \quiz_views_handler_filter_user_quiz_state

File

includes/views/handlers/quiz_views_handler_filter_user_quiz_state.inc, line 7

class quiz_views_handler_filter_user_quiz_state extends views_handler_filter {
  var $states = array();
  var $no_operator = TRUE;

  // for nicer formatting of the form
  var $no_single = TRUE;

  // always only a single value, at least for now
  function init(&$view, &$options) {
    parent::init($view, $options);
    $this->states = array(
      'any' => t('All Results (Do not filter)'),
      'not_started' => t('Not Started'),
      'in_progress' => t('In Progress'),
      'finished' => t('Finished'),
    );
  }
  function option_definition() {
    $options = parent::option_definition();
    $options['value']['quiz_state'] = array(
      'default' => 'finished',
    );
    return $options;
  }
  function value_form(&$form, &$form_state) {
    $form['value'] = array();
    $form['value']['quiz_state'] = $this
      ->base_form_item();
  }
  function base_form_item() {
    return array(
      '#type' => 'radios',
      '#title' => t('Quiz State'),
      '#description' => t('Output will be limited to only include quiz results in this state. If the filter is exposed, the value set here will be used as the default. Note that "Any" is only useful for exposed filters.'),
      '#options' => $this->states,
      '#default_value' => !empty($this->value['quiz_state']) ? $this->value['quiz_state'] : 'any',
    );
  }
  function exposed_form(&$form, &$form_state) {
    if (empty($this->options['exposed'])) {
      return;
    }
    if (!empty($this->options['expose']['identifier'])) {
      $value = $this->options['expose']['identifier'];
      $form[$value]['quiz_state'] = $this
        ->base_form_item();
      unset($form[$value]['quiz_state']['#title'], $form[$value]['quiz_state']['#description']);
    }
  }
  function admin_summary() {
    return 'is ' . $this->states[$this->value['quiz_state']];
  }
  function query() {
    $val = is_array($this->value) ? $this->value['quiz_state'] : $this->value;
    if (empty($val) || $val == 'any') {
      return;
    }
    $this
      ->ensure_my_table();
    if ($val == 'not_started') {
      $this->query
        ->add_where($this->options['group'], "{$this->table_alias}.time_end", NULL, "IS NULL");
    }
    else {
      $operator = $val == 'in_progress' ? '=' : '>';
      $this->query
        ->add_where($this->options['group'], "{$this->table_alias}.time_end", 0, $operator);
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
quiz_views_handler_filter_user_quiz_state::$no_operator		property	Disable the possibility to use operators. Overrides views_handler_filter::$no_operator
quiz_views_handler_filter_user_quiz_state::$no_single		property
quiz_views_handler_filter_user_quiz_state::$states		property
quiz_views_handler_filter_user_quiz_state::admin_summary		function	Display the filter on the administrative summary. Overrides views_handler_filter::admin_summary
quiz_views_handler_filter_user_quiz_state::base_form_item		function
quiz_views_handler_filter_user_quiz_state::exposed_form		function	Render our chunk of the exposed filter form when selecting. Overrides views_handler_filter::exposed_form
quiz_views_handler_filter_user_quiz_state::init		function	Provide some extra help to get the operator/value easier to use. Overrides views_handler_filter::init
quiz_views_handler_filter_user_quiz_state::option_definition		function	Information about options for all kinds of purposes will be held here. Overrides views_handler_filter::option_definition
quiz_views_handler_filter_user_quiz_state::query		function	Add this filter to the query. Overrides views_handler_filter::query
quiz_views_handler_filter_user_quiz_state::value_form		function	Options form subform for setting options. Overrides views_handler_filter::value_form
views_handler::$handler_type	public	property	The type of the handler, for example filter/footer/field.
views_handler::$query	public	property	Where the $query object will reside:.	1
views_handler::$real_field	public	property	The actual field in the database table, maybe different on other kind of query plugins/special handlers.
views_handler::$relationship	public	property	The relationship used for this field.
views_handler::$table_alias	public	property	The alias of the table of this handler which is used in the query.
views_handler::$view	public	property	The top object of a view. Overrides views_object::$view
views_handler::access	public	function	Check whether current user has access to this handler.	10
views_handler::broken	public	function	Determine if the handler is considered 'broken'.	6
views_handler::case_transform	public	function	Transform a string by a certain method.
views_handler::ensure_my_table	public	function	Ensure the main table for this handler is in the query. This is used a lot.	8
views_handler::exposed_submit	public	function	Submit the exposed handler form.
views_handler::exposed_validate	public	function	Validate the exposed handler form.	4
views_handler::expose_submit	public	function	Perform any necessary changes to the form exposes prior to storage. There is no need for this function to actually store the data.
views_handler::extra_options	public	function	Provide defaults for the handler.
views_handler::extra_options_form	public	function	Provide a form for setting options.	1
views_handler::extra_options_submit	public	function	Perform any necessary changes to the form values prior to storage. There is no need for this function to actually store the data.
views_handler::extra_options_validate	public	function	Validate the options form.
views_handler::get_field	public	function	Shortcut to get a handler's raw field value.
views_handler::get_join	public	function	Get the join object that should be used for this handler.
views_handler::groupby_form	public	function	Provide a form for aggregation settings.	1
views_handler::groupby_form_submit	public	function	Perform any necessary changes to the form values prior to storage. There is no need for this function to actually store the data.	1
views_handler::has_extra_options	public	function	If a handler has 'extra options' it will get a little settings widget and another form called extra_options.	1
views_handler::is_exposed	public	function	Determine if this item is 'exposed', meaning it provides form elements to let users modify the view.
views_handler::needs_style_plugin	public	function	Determine if the argument needs a style plugin.	1
views_handler::placeholder	public	function	Provides a unique placeholders for handlers.
views_handler::post_execute	public	function	Run after the view is executed, before the result is cached.	1
views_handler::pre_query	public	function	Run before the view is built.	1
views_handler::sanitize_value	public	function	Sanitize the value for output.
views_handler::set_relationship	public	function	Called just prior to query(), this lets a handler set up any relationship it needs.
views_handler::show_expose_form	public	function	Shortcut to display the exposed options form.
views_handler::ui_name	public	function	Return a string representing this handler's name in the UI.	9
views_handler::use_group_by	public	function	Provides the handler some groupby.	2
views_handler::validate	public	function	Validates the handler against the complete View.	1
views_handler_filter::$always_multiple	public	property	Disable the possibility to force a single value.	6
views_handler_filter::$always_required	public	property	Disable the possibility to allow a exposed input to be optional.
views_handler_filter::$group_info	public	property	Contains the information of the selected item in a gruped filter.
views_handler_filter::$operator	public	property	Contains the operator which is used on the query.
views_handler_filter::$value	public	property	Contains the actual value of the field.
views_handler_filter::accept_exposed_input	public	function	Check to see if input from the exposed filters should change the behavior. Overrides views_handler::accept_exposed_input	2
views_handler_filter::build_group_form	public	function	Build the form to let users create the group of exposed filters.
views_handler_filter::build_group_options	public	function	Provide default options for exposed filters.
views_handler_filter::build_group_submit	public	function	Save new group items, re-enumerates and remove groups marked to delete.
views_handler_filter::build_group_validate	public	function	Validate the build group options form.	1
views_handler_filter::can_build_group	public	function	Determine if a filter can be converted into a group.
views_handler_filter::can_expose	public	function	Determine if a filter can be exposed. Overrides views_handler::can_expose	5
views_handler_filter::can_group	public	function	Can this filter be used in OR groups?	1
views_handler_filter::convert_exposed_input	public	function	Transform the input from a grouped filter into a standard filter.
views_handler_filter::exposed_info	public	function	Tell the renderer about our exposed form. Overrides views_handler::exposed_info
views_handler_filter::exposed_translate	public	function	Make some translations to a form item to make it more suitable to exposing.
views_handler_filter::expose_form	public	function	Options form subform for exposed filter options. Overrides views_handler::expose_form	2
views_handler_filter::expose_options	public	function	Provide default options for exposed filters. Overrides views_handler::expose_options	2
views_handler_filter::expose_validate	public	function	Validate the options form. Overrides views_handler::expose_validate
views_handler_filter::group_form	public	function	Build a form with a group of operator | values to apply as a single filter.
views_handler_filter::group_multiple_exposed_input	public	function	Options available for a grouped filter which uses checkboxes.
views_handler_filter::is_a_group	public	function	Returns TRUE if the exposed filter works like a grouped filter. Overrides views_handler::is_a_group
views_handler_filter::multiple_exposed_input	public	function	Indicate whether users can select multiple group items. Overrides views_handler::multiple_exposed_input
views_handler_filter::operator_form	public	function	Options form subform for setting the operator.	6
views_handler_filter::operator_options	public	function	Provide a list of options for the default operator form.	4
views_handler_filter::operator_submit	public	function	Perform any necessary changes to the form values prior to storage.
views_handler_filter::operator_validate	public	function	Validate the operator form.
views_handler_filter::options_form	public	function	Provide the basic form which calls through to subforms. Overrides views_handler::options_form	4
views_handler_filter::options_submit	public	function	Simple submit handler. Overrides views_handler::options_submit
views_handler_filter::options_validate	public	function	Simple validate handler. Overrides views_handler::options_validate	1
views_handler_filter::prepare_filter_select_options	public	function	Sanitizes the HTML select element's options.
views_handler_filter::show_build_group_button	public	function	Shortcut to display the build_group/hide button.
views_handler_filter::show_build_group_form	public	function	Shortcut to display the exposed options form.
views_handler_filter::show_expose_button	public	function	Shortcut to display the expose/hide button. Overrides views_handler::show_expose_button
views_handler_filter::show_operator_form	public	function	Shortcut to display the operator form.
views_handler_filter::show_value_form	public	function	Shortcut to display the value form.
views_handler_filter::store_exposed_input	public	function	Store the exposed input for processing later. Overrides views_handler::store_exposed_input
views_handler_filter::store_group_input	public	function	If set to remember exposed input in the session, store it there.
views_handler_filter::value_submit	public	function	Perform any necessary changes to the form values prior to storage.	1
views_handler_filter::value_validate	public	function	Validate the options form.	3
views_object::$definition	public	property	Handler's definition.
views_object::$options	public	property	Except for displays, options for the object will be held here.	1
views_object::altered_option_definition		function	Collect this handler's option definition and alter them, ready for use.
views_object::construct	public	function	Views handlers use a special construct function.	4
views_object::destroy	public	function	Destructor.	2
views_object::export_option	public	function		1
views_object::export_options	public	function
views_object::export_option_always	public	function	Always exports the option, regardless of the default value.
views_object::options Deprecated	public	function	Set default options on this object.	1
views_object::set_default_options	public	function	Set default options.
views_object::set_definition	public	function	Let the handler know what its full definition is.
views_object::unpack_options	public	function	Unpack options over our existing defaults, drilling down into arrays so that defaults don't get totally blown away.
views_object::unpack_translatable	public	function	Unpack a single option definition.
views_object::unpack_translatables	public	function	Unpacks each handler to store translatable texts.
views_object::_set_option_defaults	public	function