class better_exposed_filters_exposed_form_plugin in Better Exposed Filters 7.3
Same name and namespace in other branches
- 6.3 better_exposed_filters_exposed_form_plugin.inc \better_exposed_filters_exposed_form_plugin
- 6 better_exposed_filters_exposed_form_plugin.inc \better_exposed_filters_exposed_form_plugin
- 7 better_exposed_filters_exposed_form_plugin.inc \better_exposed_filters_exposed_form_plugin
Better exposed filter form plugin class.
Hierarchy
- class \views_object
- class \views_plugin
Expanded class hierarchy of better_exposed_filters_exposed_form_plugin
1 string reference to 'better_exposed_filters_exposed_form_plugin'
File
- ./
better_exposed_filters_exposed_form_plugin.inc, line 11 - Provides an Better Exposed Filters exposed form plugin for View 3.x.
View source
class better_exposed_filters_exposed_form_plugin extends views_plugin_exposed_form_basic {
function init(&$view, &$display, $options = array()) {
$this->view =& $view;
$this->display =& $display;
$this->localization_keys = $this
->unpack_translatable_keys();
$this
->unpack_options($this->options, $options);
// $this->unpack_options($this->options, $options, NULL, FALSE);.
}
function summary_title() {
return t('BEF Settings');
}
function option_definition() {
$options = parent::option_definition();
// Add Better Exposed Filters options to those saved by Views.
$options['bef'] = array(
'default' => array(),
'translatable' => TRUE,
'unpack_translatable' => 'unpack_translatable_options',
);
return $options;
}
function options_form(&$form, &$form_state) {
parent::options_form($form, $form_state);
$bef_options = array();
// Get current settings and default values for new filters.
$existing = $this
->_bef_get_settings();
/*
* Add general options for exposed form items.
*/
$bef_options['general']['input_required'] = array(
'#type' => 'checkbox',
'#default_value' => $existing['general']['input_required'],
'#title' => t('Require input before results are shown'),
'#description' => t("Emulates the built in <em>Input Required</em> exposed filter handler"),
);
$bef_options['general']['text_input_required'] = array(
'#type' => 'container',
// Indent dependent options.
'#prefix' => '<div class="dependent-options">',
'#suffix' => '</div>',
'#states' => array(
// Hide this field when the input_required checkbox is disabled.
'invisible' => array(
':input[name="exposed_form_options[bef][general][input_required]"]' => array(
'checked' => FALSE,
),
),
),
);
$bef_options['general']['text_input_required']['text_input_required'] = array(
'#type' => 'text_format',
'#title' => t('Text on demand'),
'#description' => t('Text to display instead of results until the user selects and applies an exposed filter.'),
'#default_value' => $existing['general']['text_input_required']['text_input_required']['value'],
'#format' => $existing['general']['text_input_required']['text_input_required']['format'],
'#wysiwyg' => FALSE,
);
$bef_options['general']['allow_secondary'] = array(
'#type' => 'checkbox',
'#title' => t('Enable secondary exposed form options'),
'#default_value' => $existing['general']['allow_secondary'],
'#description' => t('Allows you to specify some exposed form elements as being secondary options and places those elements in a collapsible fieldset. Use this option to place some exposed filters in an "Advanced Search" area of the form, for example.'),
);
$bef_options['general']['secondary_label'] = array(
'#type' => 'textfield',
'#default_value' => $existing['general']['secondary_label'],
'#title' => t('Secondary options label'),
'#description' => t('The name of the fieldset to hold secondary options. This cannot be left blank or there will be no way to show/hide these options.'),
// Indent dependent options.
'#prefix' => '<div class="dependent-options">',
'#suffix' => '</div>',
'#states' => array(
'required' => array(
':input[name="exposed_form_options[bef][general][allow_secondary]"]' => array(
'checked' => TRUE,
),
),
'visible' => array(
':input[name="exposed_form_options[bef][general][allow_secondary]"]' => array(
'checked' => TRUE,
),
),
),
);
$bef_options['general']['secondary_collapse_override'] = array(
'#type' => 'select',
'#title' => t('Override secondary options fieldset'),
'#default_value' => $existing['general']['secondary_collapse_override'],
'#description' => t('This setting overrides the secondary options fieldset collapsed value. By default the fieldset renders opened if a value within is selected and closed otherwise.'),
'#options' => array(
0 => t('Default'),
1 => t('Always open'),
2 => t('Always closed'),
),
// Indent dependent options.
'#prefix' => '<div class="dependent-options">',
'#suffix' => '</div>',
'#states' => array(
'visible' => array(
':input[name="exposed_form_options[bef][general][allow_secondary]"]' => array(
'checked' => TRUE,
),
),
),
);
/*
* Add options for exposed sorts.
*/
$exposed = FALSE;
foreach ($this->display->handler
->get_handlers('sort') as $label => $sort) {
if ($sort->options['exposed']) {
$exposed = TRUE;
break;
}
}
if ($exposed) {
$bef_options['sort']['bef_format'] = array(
'#type' => 'select',
'#title' => t('Display exposed sort options as'),
'#default_value' => $existing['sort']['bef_format'],
'#options' => array(
'default' => t('Default select list'),
'bef' => t('Radio Buttons'),
'bef_links' => t('Links'),
'bef_toggle_links' => t('Toggle Links'),
),
'#description' => t('Select a format for the exposed sort options. Note: the "toggle links" option will only work correctly if "Combine sort order with sort by" is checked in the "Advanced Sort Options" section.'),
);
$bef_options['sort']['advanced'] = array(
'#type' => 'fieldset',
'#title' => t('Advanced sort options'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$bef_options['sort']['advanced']['collapsible'] = array(
'#type' => 'checkbox',
'#title' => t('Make sort options collapsible'),
'#default_value' => $existing['sort']['advanced']['collapsible'],
'#description' => t('Puts the sort options in a collapsible fieldset'),
);
$bef_options['sort']['advanced']['collapsible_label'] = array(
'#type' => 'textfield',
'#title' => t('Collapsible fieldset title'),
'#default_value' => empty($existing['sort']['advanced']['collapsible_label']) ? t('Sort options') : $existing['sort']['advanced']['collapsible_label'],
'#description' => t('This cannot be left blank or there will be no way to show/hide sort options.'),
// Indent dependent options.
'#prefix' => '<div class="dependent-options">',
'#suffix' => '</div>',
'#states' => array(
'visible' => array(
'input[name="exposed_form_options[bef][sort][advanced][collapsible]"]' => array(
'checked' => TRUE,
),
),
),
);
$bef_options['sort']['advanced']['combine'] = array(
'#type' => 'checkbox',
'#title' => t('Combine sort order with sort by'),
'#default_value' => $existing['sort']['advanced']['combine'],
'#description' => t('Combines the sort by options and order (ascending or decending) into a single list. Use this to display "Option1 Desc", "Option1 Asc", "Option2 Desc", "Option2 Asc" in a single form element. "Expose sort order" must be checked to enable this option.'),
'#states' => array(
'disabled' => array(
'input[name="exposed_form_options[expose_sort_order]"]' => array(
'checked' => FALSE,
),
),
),
);
$bef_options['sort']['advanced']['combine_param'] = array(
'#type' => 'textfield',
'#title' => t('Enter a query parameter to use for combined sorts'),
'#default_value' => $existing['sort']['advanced']['combine_param'],
'#description' => t('This will be the $_GET parameter used in query strings. Useful for preventing collisions between exposed filters when there are multiple instances of BEF on the page. Use only UTF-8 letters, numbers, and the dash (-), underscore (_), asterisk (*), and period(.) characters.'),
'#default_value' => empty($existing['sort']['advanced']['combine_param']) ? 'sort_bef_combine' : $existing['sort']['advanced']['combine_param'],
'#required' => TRUE,
// Indent dependent options -- closing </div> is in combine_rewrite.
'#prefix' => '<div class="dependent-options">',
'#states' => array(
'visible' => array(
'input[name="exposed_form_options[bef][sort][advanced][combine]"]' => array(
'checked' => TRUE,
),
'input[name="exposed_form_options[expose_sort_order]"]' => array(
'checked' => TRUE,
),
),
),
);
$bef_options['sort']['advanced']['combine_rewrite'] = array(
'#type' => 'textarea',
'#title' => t('Rewrite the text displayed'),
'#default_value' => $existing['sort']['advanced']['combine_rewrite'],
'#description' => t('Use this field to rewrite the text displayed for combined sort options and sort order. Use the format of current_text|replacement_text, one replacement per line. For example: <pre>
Post date Asc|Oldest first
Post date Desc|Newest first
Title Asc|A -> Z
Title Desc|Z -> A</pre> Leave the replacement text blank to remove an option altogether.'),
'#suffix' => '</div>',
'#states' => array(
'visible' => array(
'input[name="exposed_form_options[bef][sort][advanced][combine]"]' => array(
'checked' => TRUE,
),
'input[name="exposed_form_options[expose_sort_order]"]' => array(
'checked' => TRUE,
),
),
),
);
$bef_options['sort']['advanced']['reset'] = array(
'#type' => 'checkbox',
'#title' => t('Include a "Reset sort" option'),
'#default_value' => $existing['sort']['advanced']['reset'],
'#description' => t('Adds a "Reset sort" option which will use Views\' default sort order.'),
);
$bef_options['sort']['advanced']['reset_label'] = array(
'#type' => 'textfield',
'#title' => t('"Reset sort" label'),
'#default_value' => $existing['sort']['advanced']['reset_label'],
'#description' => t('This cannot be left blank if the above option is checked'),
// Indent dependent options.
'#prefix' => '<div class="dependent-options">',
'#suffix' => '</div>',
'#states' => array(
'required' => array(
'input[name="exposed_form_options[bef][sort][advanced][reset]"]' => array(
'checked' => TRUE,
),
),
'visible' => array(
'input[name="exposed_form_options[bef][sort][advanced][reset]"]' => array(
'checked' => TRUE,
),
),
),
);
$bef_options['sort']['advanced']['is_secondary'] = array(
'#type' => 'checkbox',
'#title' => t('This is a secondary option'),
'#default_value' => $existing['sort']['advanced']['is_secondary'],
'#states' => array(
'visible' => array(
':input[name="exposed_form_options[bef][general][allow_secondary]"]' => array(
'checked' => TRUE,
),
),
),
'#description' => t('Places this element in the secondary options portion of the exposed form.'),
);
$bef_options['sort']['advanced']['autosubmit'] = array(
'#type' => 'checkbox',
'#title' => t('Autosubmit'),
'#default_value' => $existing['sort']['advanced']['autosubmit'],
'#states' => array(
'disabled' => array(
':input[name="exposed_form_options[autosubmit]"]' => array(
'checked' => TRUE,
),
),
),
'#description' => t('Automatically submit the form once a sort element is changed. This option is not available if you enabled autosubmit option for the whole form.'),
);
}
/*
* Add options for exposed pager.
*/
$pager_exposed = FALSE;
$current_display = $this->display->handler->view->display[$this->display->handler->view->current_display];
$default_display = $this->display->handler->view->display['default'];
if (!empty($current_display->handler->options['defaults']["pager"])) {
$pager_exposed = isset($default_display->handler->options['pager']) && !empty($default_display->handler->options['pager']['options']['expose']['items_per_page']);
}
else {
$pager_exposed = isset($current_display->handler->options['pager']) && !empty($current_display->handler->options['pager']['options']['expose']['items_per_page']);
}
if ($pager_exposed) {
$bef_options['pager']['bef_format'] = array(
'#type' => 'select',
'#title' => t('Display exposed pager options as'),
'#default_value' => $existing['pager']['bef_format'],
'#options' => array(
'default' => t('Default select list'),
'bef' => t('Radio Buttons'),
'bef_links' => t('Links'),
),
'#description' => t('Select a format for the exposed pager options.'),
);
$bef_options['pager']['is_secondary'] = array(
'#type' => 'checkbox',
'#title' => t('This is a secondary option'),
'#default_value' => $existing['pager']['is_secondary'],
'#states' => array(
'visible' => array(
':input[name="exposed_form_options[bef][general][allow_secondary]"]' => array(
'checked' => TRUE,
),
),
),
'#description' => t('Places this element in the secondary options portion of the exposed form.'),
);
}
// Only add the description text once -- it was getting a little long to be
// added to each filter.
$bef_filter_intro = FALSE;
// Go through each filter and add BEF options.
foreach ($this->display->handler
->get_handlers('filter') as $label => $filter) {
if (!$filter->options['exposed']) {
continue;
}
// If we're adding BEF filter options, add an intro to explain what's
// going on.
if (!$bef_filter_intro) {
$link = l(t('BEF settings documentation'), 'http://drupal.org/node/1701012');
$bef_options['bef_intro'] = array(
'#markup' => '<h3>' . t('Exposed Filter Settings') . '</h3><p>' . t('This section lets you select additional options for exposed filters. Some options are only available in certain situations. If you do not see the options you expect, please see the !link page for more details.', array(
'!link' => $link,
)) . '</p>',
);
$bef_filter_intro = TRUE;
}
// These filter operators get our standard options: radio or checkboxes.
$bef_standard = FALSE;
// Allows a filter to be rendered as a hidden <input> element. Useful when
// building multi-step filter "wizards," for example.
$bef_hidden = FALSE;
// Renders the filter as a link.
// @TODO: expand to include toggle links for all bef_links filters, not
// just exposed sorts.
$bef_links = FALSE;
// These filters get a single on/off checkbox option for boolean
// operators.
$bef_single = FALSE;
// Used for taxonomy filters with hierarchy.
$bef_nested = FALSE;
// Allows the term description to be added to rendered output.
$bef_term_description = FALSE;
// Used for date-based filters.
$bef_datepicker = FALSE;
// Used for numeric, non-date filters.
$bef_slider = FALSE;
// Check various filter types and determine what options are available.
if ($filter instanceof views_handler_filter_string || $filter instanceof views_handler_filter_in_operator) {
if (in_array($filter->operator, array(
'in',
'or',
'and',
'not',
))) {
$bef_standard = TRUE;
$bef_links = TRUE;
$bef_hidden = TRUE;
}
if (in_array($filter->operator, array(
'empty',
'not empty',
))) {
$bef_standard = TRUE;
$bef_links = TRUE;
$bef_hidden = TRUE;
if (!$filter->options['expose']['multiple']) {
$bef_single = TRUE;
}
}
}
if ($filter instanceof views_handler_filter_boolean_operator) {
$bef_standard = TRUE;
$bef_links = TRUE;
$bef_hidden = TRUE;
if (!$filter->options['expose']['multiple']) {
$bef_single = TRUE;
}
}
// Grouped filters will have a limited number of filter options available
// so we can offer basic BEF options.
if ($filter->options['is_grouped']) {
$bef_standard = TRUE;
$bef_links = TRUE;
$bef_hidden = TRUE;
}
if ($filter instanceof views_handler_filter_term_node_tid) {
// Autocomplete and dropdown taxonomy filter are both instances of
// view_handler_filter_term_node_tid, but we can't show BEF options for
// the autocomplete widget.
if ('textfield' == $filter->options['type']) {
$bef_standard = FALSE;
$bef_links = FALSE;
$bef_hidden = FALSE;
}
else {
$bef_term_description = TRUE;
if (!empty($filter->options['hierarchy'])) {
$bef_nested = TRUE;
}
}
}
if ($filter instanceof views_handler_filter_date || !empty($filter->date_handler)) {
$bef_datepicker = TRUE;
$bef_hidden = TRUE;
}
// The date filter handler extends the numeric filter handler so we have
// to exclude it specifically.
if ($filter instanceof views_handler_filter_numeric && !$filter instanceof views_handler_filter_date) {
$bef_slider = TRUE;
$bef_hidden = TRUE;
}
// Search API extends the more general views_handler_filter rather than
// operator-specific classes such as views_handler_filter_in_operator.
// Handle those options here.
if ($filter instanceof SearchApiViewsHandlerFilterOptions) {
$bef_standard = TRUE;
$bef_links = TRUE;
$bef_hidden = TRUE;
}
elseif ($filter instanceof SearchApiViewsHandlerFilterDate) {
$bef_datepicker = TRUE;
if ($filter->options['is_grouped']) {
$bef_standard = TRUE;
$bef_links = TRUE;
$bef_hidden = TRUE;
}
}
elseif ($filter instanceof SearchApiViewsHandlerFilter && !$filter instanceof SearchApiViewsHandlerFilterFulltext) {
$bef_slider = TRUE;
}
elseif ($filter instanceof SearchApiViewsHandlerFilterBoolean) {
$bef_single = TRUE;
}
// All filters can use the default filter exposed by Views.
$display_options = array(
'default' => t('Default select list'),
);
if ($bef_standard) {
// Main BEF option: radios/checkboxes.
$display_options['bef'] = t('Checkboxes/Radio Buttons');
}
if ($bef_nested) {
$display_options['bef_ul'] = t('Nested Checkboxes/Radio Buttons');
}
if ($bef_single) {
$display_options['bef_single'] = t('Single on/off checkbox');
}
if ($bef_datepicker) {
$display_options['bef_datepicker'] = t('jQuery UI Datepicker');
}
if ($bef_slider) {
$display_options['bef_slider'] = t('jQuery UI slider');
}
if ($bef_links) {
$display_options['bef_links'] = t('Links');
}
if ($bef_hidden) {
$display_options['bef_hidden'] = t('Hidden');
}
// Alter the list of available display options for this filter.
drupal_alter('better_exposed_filters_display_options', $display_options, $filter);
$filter_key = $filter->options['is_grouped'] ? 'group_info' : 'expose';
$identifier = '"' . $filter->options[$filter_key]['identifier'] . '"';
if (!empty($filter->options[$filter_key]['label'])) {
$identifier .= ' ' . t('(Filter label: "@fl")', array(
'@fl' => $filter->options[$filter_key]['label'],
));
}
$bef_options[$label]['bef_format'] = array(
'#type' => 'select',
'#title' => t('Display @identifier exposed filter as', array(
'@identifier' => $identifier,
)),
'#default_value' => $existing[$label]['bef_format'],
'#options' => $display_options,
);
if ($bef_slider) {
// Fieldset for jQuery slider options.
$bef_options[$label]['slider_options'] = array(
'#type' => 'fieldset',
'#title' => t('Slider options for @identifier', array(
'@identifier' => $identifier,
)),
'#collapsible' => TRUE,
'#collapsed' => FALSE,
'#states' => array(
'visible' => array(
':input[name="exposed_form_options[bef][' . $label . '][bef_format]"]' => array(
'value' => 'bef_slider',
),
),
),
);
$bef_options[$label]['slider_options']['bef_slider_min'] = array(
'#type' => 'textfield',
'#title' => t('Range minimum'),
'#default_value' => $existing[$label]['slider_options']['bef_slider_min'],
'#bef_filter_id' => $label,
'#states' => array(
'required' => array(
':input[name="exposed_form_options[bef][' . $label . '][bef_format]"]' => array(
'value' => 'bef_slider',
),
),
),
'#description' => t('The minimum allowed value for the jQuery range slider. It can be positive, negative, or zero and have up to 11 decimal places.'),
'#element_validate' => array(
'element_validate_number',
'better_exposed_filters_element_validate_slider_required',
'better_exposed_filters_element_validate_slider_min_max',
),
);
$bef_options[$label]['slider_options']['bef_slider_max'] = array(
'#type' => 'textfield',
'#title' => t('Range maximum'),
'#default_value' => $existing[$label]['slider_options']['bef_slider_max'],
'#bef_filter_id' => $label,
'#states' => array(
'required' => array(
':input[name="exposed_form_options[bef][' . $label . '][bef_format]"]' => array(
'value' => 'bef_slider',
),
),
),
'#description' => t('The maximum allowed value for the jQuery range slider. It can be positive, negative, or zero and have up to 11 decimal places.'),
'#element_validate' => array(
'element_validate_number',
'better_exposed_filters_element_validate_slider_required',
'better_exposed_filters_element_validate_slider_min_max',
),
);
$bef_options[$label]['slider_options']['bef_slider_step'] = array(
'#type' => 'textfield',
'#title' => t('Step'),
'#default_value' => empty($existing[$label]['slider_options']['bef_slider_step']) ? 1 : $existing[$label]['slider_options']['bef_slider_step'],
'#bef_filter_id' => $label,
'#states' => array(
'required' => array(
':input[name="exposed_form_options[bef][' . $label . '][bef_format]"]' => array(
'value' => 'bef_slider',
),
),
),
'#description' => t('Determines the size or amount of each interval or step the slider takes between the min and max.') . '<br />' . t('The full specified value range of the slider (Range maximum - Range minimum) must be evenly divisible by the step.') . '<br />' . t('The step must be a positive number of up to 5 decimal places.'),
'#element_validate' => array(
'element_validate_number',
'better_exposed_filters_element_validate_slider_required',
'better_exposed_filters_element_validate_slider_step',
),
);
$bef_options[$label]['slider_options']['bef_slider_animate'] = array(
'#type' => 'textfield',
'#title' => t('Animate'),
'#default_value' => $existing[$label]['slider_options']['bef_slider_animate'],
'#bef_filter_id' => $label,
'#description' => t('Whether to slide handle smoothly when user click outside handle on the bar. Allowed values are "slow", "normal", "fast" or the number of milliseconds to run the animation (e.g. 1000). If left blank, there will be no animation, the slider will just jump to the new value instantly.'),
'#element_validate' => array(
'better_exposed_filters_element_validate_slider_animate',
),
);
$bef_options[$label]['slider_options']['bef_slider_orientation'] = array(
'#type' => 'select',
'#title' => t('Orientation'),
'#options' => array(
'horizontal' => t('Horizontal'),
'vertical' => t('Vertical'),
),
'#default_value' => $existing[$label]['slider_options']['bef_slider_orientation'],
'#bef_filter_id' => $label,
'#states' => array(
'required' => array(
':input[name="exposed_form_options[bef][' . $label . '][bef_format]"]' => array(
'value' => 'bef_slider',
),
),
),
'#description' => t('The orientation of the jQuery range slider.'),
);
}
// Fieldset to keep the UI from getting out of hand.
$bef_options[$label]['more_options'] = array(
'#type' => 'fieldset',
'#title' => t('More options for @identifier', array(
'@identifier' => $identifier,
)),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
// Select all checkbox.
if ($bef_standard) {
$bef_options[$label]['more_options']['bef_select_all_none'] = array(
'#type' => 'checkbox',
'#title' => t('Add select all/none links'),
'#default_value' => $existing[$label]['more_options']['bef_select_all_none'],
'#disabled' => !$filter->options['expose']['multiple'],
'#description' => t('Add a "Select All/None" link when rendering the exposed filter using
checkboxes. If this option is disabled, edit the filter and check the
"Allow multiple selections".'),
);
if ($bef_nested) {
$bef_options[$label]['more_options']['bef_select_all_none_nested'] = array(
'#type' => 'checkbox',
'#title' => t('Add nested all/none selection'),
'#default_value' => $existing[$label]['more_options']['bef_select_all_none_nested'],
'#disabled' => !$filter->options['expose']['multiple'] || !$filter->options['hierarchy'],
'#description' => t('When a parent checkbox is checked, check all its children. If this option
is disabled, edit the filter and check "Allow multiple selections" and
edit the filter settings and check "Show hierarchy in dropdown".'),
);
}
if ($bef_term_description) {
$bef_options[$label]['more_options']['bef_term_description'] = array(
'#type' => 'checkbox',
'#title' => t('Include the term description'),
'#default_value' => $existing[$label]['more_options']['bef_term_description'],
'#description' => t('For taxonomy term filters, includes the term description for each filter option.'),
'#states' => array(
'visible' => array(
':input[name="exposed_form_options[bef][' . $label . '][bef_format]"]' => array(
array(
'value' => 'bef',
),
array(
'value' => 'bef_ul',
),
),
),
),
);
}
// Put filter in collapsible fieldset option.
// TODO: expand to all exposed filters.
$bef_options[$label]['more_options']['bef_collapsible'] = array(
'#type' => 'checkbox',
'#title' => t('Make this filter collapsible'),
'#default_value' => $existing[$label]['more_options']['bef_collapsible'],
'#description' => t('Puts this filter in a collapsible fieldset'),
);
}
// Individual element autosubmit option.
$bef_options[$label]['more_options']['autosubmit'] = array(
'#type' => 'checkbox',
'#title' => t('Autosubmit'),
'#default_value' => $existing[$label]['more_options']['autosubmit'],
'#states' => array(
'disabled' => array(
':input[name="exposed_form_options[autosubmit]"]' => array(
'checked' => TRUE,
),
),
),
'#description' => t('Automatically submit the form once a filter element is changed. This option is not available if you enabled autosubmit option for the whole form.'),
);
// Allow any filter to be moved into the secondary options fieldset.
$bef_options[$label]['more_options']['is_secondary'] = array(
'#type' => 'checkbox',
'#title' => t('This is a secondary option'),
'#default_value' => $existing[$label]['more_options']['is_secondary'],
'#states' => array(
'visible' => array(
':input[name="exposed_form_options[bef][general][allow_secondary]"]' => array(
'checked' => TRUE,
),
),
),
'#description' => t('Places this element in the secondary options portion of the exposed form.'),
);
// Allow "Any" label to be overridden.
$bef_options[$label]['more_options']['any_label'] = array(
'#type' => 'textfield',
'#title' => t('Override "Any" option label'),
'#default_value' => $existing[$label]['more_options']['any_label'],
'#description' => t('Leave blank to use Views default value.'),
);
// Build a description option form element -- available to all exposed
// filters.
$bef_options[$label]['more_options']['bef_filter_description'] = array(
'#type' => 'textarea',
'#title' => t('Description'),
'#default_value' => $existing[$label]['more_options']['bef_filter_description'],
'#description' => t('Adds descriptive text to the exposed filter. This is usually rendered in smaller print under the label or the options. You may use tokens as specified below and in the "Global replacements values" section at the bottom of this page.'),
);
// Add token support to the description field.
$bef_options[$label]['more_options']['tokens'] = array(
'#title' => t('Replacement patterns'),
'#type' => 'fieldset',
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
if (!module_exists('token')) {
$bef_options[$label]['more_options']['tokens']['no_tokens'] = array(
'#markup' => '<p>' . t('Enable the !token module to use replacement values.', array(
'!token' => l(t('Token'), 'http://drupal.org/project/token'),
)) . '</p>',
);
}
else {
// Collect a list of token types that make sense for this filter.
$available = array(
'global_types',
);
if (!empty($filter->options['vocabulary'])) {
$available[] = 'vocabulary';
}
/* @TODO: Other token types? */
$filter_specific = array_diff($available, array(
'global_types',
));
if (empty($filter_specific)) {
$bef_options[$label]['more_options']['tokens']['nothing_specific'] = array(
'#markup' => '<p>' . t('There are no filter-specific tokens for this filter. See the "Global replacement tokens" at the bottom of this dialog for additional token replacement options.') . '<p>',
);
}
else {
$bef_options[$label]['more_options']['tokens']['list'] = array(
'#theme' => 'token_tree',
'#token_types' => $filter_specific,
'#global_types' => FALSE,
);
}
$bef_options[$label]['more_options']['tokens']['available'] = array(
// Save us from parsing available tokens again.
'#type' => 'value',
'#value' => $available,
);
}
// Allow rewriting of filter options for any filter.
$bef_options[$label]['more_options']['rewrite'] = array(
'#title' => t('Rewrite filter options'),
'#type' => 'fieldset',
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$bef_options[$label]['more_options']['rewrite']['filter_rewrite_values'] = array(
'#type' => 'textarea',
'#title' => t('Rewrite the text displayed'),
'#default_value' => $existing[$label]['more_options']['rewrite']['filter_rewrite_values'],
'#description' => t('
Use this field to rewrite the filter options displayed. Use the format
of current_text|replacement_text, one replacement per line. For
example: <pre>
Current|Replacement
On|Yes
Off|No
</pre> Leave the replacement text blank to remove an option altogether. If using hierarchical taxonomy filters, do not including leading hyphens in the current value.
'),
);
// Add an option to override defaults for the jQuery UI Datepicker.
if ($bef_datepicker) {
$bef_options[$label]['more_options']['datepicker_options'] = array(
'#type' => 'textarea',
'#title' => t('jQuery UI Datepicker option'),
'#default_value' => $existing[$label]['more_options']['datepicker_options'],
'#description' => t('Use this field to override the default options for the Datepicker widget. Options should be in the form of <code>option_name: option_value</code>, one setting per line. For example, to set the days of the week and date format to French: <pre>
dayNamesMin: [ "Di", "Lu", "Ma", "Me", "Je", "Ve", "Sa" ]
dateFormat: "dd-mm-yy"
</pre>More information about datepicker options can be found on the <a href="!link">jQuery UI website</a>. This field is translatable so you can specify different options for different languages. See the <a href="!docs_link">BEF localization documentation</a> for more details.', array(
'!link' => 'http://api.jqueryui.com/datepicker/',
'!docs_link' => 'https://www.drupal.org/node/2460797',
)),
);
}
}
/* Ends: foreach ($filters as $filter) { */
// Add global token replacements, if available.
if (module_exists('token')) {
$bef_options['global_replacement_tokens'] = array(
'#title' => t('Global replacement patterns'),
'#type' => 'fieldset',
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$bef_options['global_replacement_tokens']['list'] = array(
'#theme' => 'token_tree',
'#token_types' => array(
'global_types',
),
);
}
// Add BEF form elements to the exposed form options form.
$form['bef'] = $bef_options;
}
/**
* Tweak the exposed filter form to show Better Exposed Filter options.
*
* @param array $form
* Exposed form array.
* @param array $form_state
* Current state of form variables.
*/
function exposed_form_alter(&$form, &$form_state) {
parent::exposed_form_alter($form, $form_state);
// If we have no visible elements, we don't show the Apply button.
$show_apply = FALSE;
// Collect BEF's Javascript settings, add to Drupal.settings at the end.
// Historical note: We used to only add BEF's Javascript when absolutely
// needed. Eventually, much of that functionality worked its way into the
// normal usage of BEF so that we now turn those Jvaascript behaviors on
// by default. (See https://drupal.org/node/1807114).
$bef_add_js = TRUE;
$bef_js = array(
'datepicker' => FALSE,
'slider' => FALSE,
'settings' => array(),
'autosubmit' => FALSE,
);
// Some widgets will require additional CSS.
$bef_add_css = FALSE;
// Grab BEF settings.
$settings = $this
->_bef_get_settings();
// Allow modules/themes to alter BEF settings before they are passed to the
// exposed form widgets.
$context['view'] = $this->view;
$context['display'] = $this->display;
drupal_alter('better_exposed_filters_settings', $settings, $context);
// Adds view's arguments (if any) to the path to be used use for #bef_path.
$view_path = $this->view->args ? implode('/', array_merge(array(
$this->view
->get_path(),
), $this->view->args)) : $this->view
->get_path();
// Some elements may be placed in a secondary fieldset (eg: "Advanced
// search options"). Place this after the exposed filters and before the
// rest of the items in the exposed form.
if ($allow_secondary = $settings['general']['allow_secondary']) {
// If one of the secondary widgets has exposed input, do not collapse the
// secondary fieldset. Or is the "always open" or "always closed" option
// is selected, use that instead.
$secondary_collapse = TRUE;
if ($settings['general']['secondary_collapse_override']) {
$secondary_collapse = $settings['general']['secondary_collapse_override'] == 2;
}
else {
$exposed_input = $this->view
->get_exposed_input();
foreach ($this->display->handler
->get_handlers('filter') as $label => $filter) {
if (!$filter->options['exposed']) {
continue;
}
if (!empty($exposed_input[$filter->options['expose']['identifier']]) && $settings[$label]['more_options']['is_secondary']) {
$secondary_collapse = FALSE;
break;
}
}
}
$secondary = array(
'#type' => 'fieldset',
'#title' => filter_xss_admin(t($settings['general']['secondary_label'])),
'#collapsible' => TRUE,
'#collapsed' => $secondary_collapse,
'#theme' => 'secondary_exposed_elements',
);
}
/*
* Handle exposed sort elements.
*/
if (isset($settings['sort']) && !empty($form['sort_by']) && !empty($form['sort_order'])) {
$show_apply = TRUE;
// If selected, collect all sort-related form elements and put them
// in a collapsible fieldset.
$collapse = $settings['sort']['advanced']['collapsible'] && !empty($settings['sort']['advanced']['collapsible_label']);
$sort_elems = array();
// Check for combined sort_by and sort_order.
if ($settings['sort']['advanced']['combine']) {
$form_state['#combine_param'] = $settings['sort']['advanced']['combine_param'];
// Combine sort_by and sort_order into a single element.
$form[$settings['sort']['advanced']['combine_param']] = array(
'#type' => 'radios',
// Already sanitized by Views.
'#title' => $form['sort_by']['#title'],
);
$options = array();
// If using the bef_toggle_links format, determine which links should
// not be shown.
$hidden_options = array();
// Add reset sort option at the top of the list.
if ($settings['sort']['advanced']['reset']) {
$options[' '] = t($settings['sort']['advanced']['reset_label']);
}
else {
$form[$settings['sort']['advanced']['combine_param']]['#default_value'] = '';
}
$selected = '';
$used_sort_keys = array();
foreach ($form['sort_by']['#options'] as $by_key => $by_val) {
foreach ($form['sort_order']['#options'] as $order_key => $order_val) {
// Use a space to separate the two keys, we'll unpack them in our
// submit handler.
$options["{$by_key} {$order_key}"] = "{$by_val} {$order_val}";
if ($form['sort_order']['#default_value'] == $order_key && empty($selected)) {
// Respect default sort order set in Views. The default sort field
// will be the first one if there are multiple sort criteria.
$selected = "{$by_key} {$order_key}";
// If 'Remember the last selection' was selected, remember,
if (isset($_SESSION['views'][$this->view->name][$this->view->current_display])) {
$by_key = $_SESSION['views'][$this->view->name][$this->view->current_display]['sort_by'];
$order_key = $_SESSION['views'][$this->view->name][$this->view->current_display]['sort_order'];
$selected = "{$by_key} {$order_key}";
}
}
if ($settings['sort']['bef_format'] == 'bef_toggle_links') {
if (isset($used_sort_keys[$by_key]) || !empty($form_state['input'][$settings['sort']['advanced']['combine_param']]) && $form_state['input'][$settings['sort']['advanced']['combine_param']] == "{$by_key} {$order_key}" || empty($form_state['input'][$settings['sort']['advanced']['combine_param']]) && $selected == "{$by_key} {$order_key}") {
$hidden_options["{$by_key} {$order_key}"] = "{$by_val} {$order_val}";
}
else {
$used_sort_keys[$by_key] = $order_key;
}
}
}
}
// Rewrite the option values if any were specified.
if (!empty($settings['sort']['advanced']['combine_rewrite'])) {
$lines = explode("\n", trim($settings['sort']['advanced']['combine_rewrite']));
$rewrite = array();
foreach ($lines as $line) {
list($search, $replace) = explode('|', $line);
if (isset($search)) {
$rewrite[$search] = $replace;
}
}
// Create new options array, based on order set in the rewrite settings.
$rewritten_options = array();
foreach ($rewrite as $search => $replace) {
if ($index = array_search($search, $options)) {
if ('' == $replace) {
unset($options[$index]);
if ($selected == $index) {
// Avoid "Illegal choice" errors.
$selected = NULL;
}
}
else {
$rewritten_options[$index] = $replace;
}
}
}
// Append any remaining non-rewritten options.
$options = $rewritten_options + $options;
}
$form[$settings['sort']['advanced']['combine_param']] = array(
'#type' => 'radios',
'#options' => $options,
'#hidden_options' => $hidden_options,
'#settings' => array(
'toggle_links' => $settings['sort']['bef_format'] == 'bef_toggle_links',
'combine_param' => $settings['sort']['advanced']['combine_param'],
),
'#default_value' => $selected,
// Already sanitized by Views.
'#title' => $form['sort_by']['#title'],
);
// Handle display-specific details.
switch ($settings['sort']['bef_format']) {
case 'bef':
$form[$settings['sort']['advanced']['combine_param']]['#prefix'] = '<div class="bef-sort-combined bef-select-as-radios">';
$form[$settings['sort']['advanced']['combine_param']]['#suffix'] = '</div>';
break;
case 'bef_links':
case 'bef_toggle_links':
$bef_add_js = TRUE;
$form[$settings['sort']['advanced']['combine_param']]['#theme'] = 'select_as_links';
// Exposed form displayed as blocks can appear on pages other than
// the view results appear on. This can cause problems with
// select_as_links options as they will use the wrong path. We
// provide a hint for theme functions to correct this.
if (!empty($this->display->display_options['exposed_block'])) {
$form[$settings['sort']['advanced']['combine_param']]['#bef_path'] = $view_path;
}
break;
case 'default':
$form[$settings['sort']['advanced']['combine_param']]['#type'] = 'select';
break;
}
// Add our submit routine to process.
$form['#submit'][] = 'bef_sort_combine_submit';
// Pretend we're another exposed form widget.
$form['#info']['sort-sort_bef_combine'] = array(
'value' => $settings['sort']['advanced']['combine_param'],
);
// Remove the existing sort_by and sort_order elements.
unset($form['sort_by']);
unset($form['sort_order']);
if ($collapse) {
$sort_elems[] = $settings['sort']['advanced']['combine_param'];
}
}
else {
// Leave sort_by and sort_order as separate elements.
if ('bef' == $settings['sort']['bef_format']) {
$form['sort_by']['#type'] = 'radios';
if (empty($form['sort_by']['#process'])) {
$form['sort_by']['#process'] = array();
}
array_unshift($form['sort_by']['#process'], 'form_process_radios');
$form['sort_by']['#prefix'] = '<div class="bef-sortby bef-select-as-radios">';
$form['sort_by']['#suffix'] = '</div>';
$form['sort_order']['#type'] = 'radios';
if (empty($form['sort_order']['#process'])) {
$form['sort_order']['#process'] = array();
}
array_unshift($form['sort_order']['#process'], 'form_process_radios');
$form['sort_order']['#prefix'] = '<div class="bef-sortorder bef-select-as-radios">';
$form['sort_order']['#suffix'] = '</div>';
}
elseif ('bef_links' == $settings['sort']['bef_format']) {
$form['sort_by']['#theme'] = 'select_as_links';
$form['sort_order']['#theme'] = 'select_as_links';
// Exposed form displayed as blocks can appear on pages other than the
// view results appear on. This can cause problems with
// select_as_links options as they will use the wrong path. We provide
// a hint for theme functions to correct this.
if (!empty($this->display->display_options['exposed_block'])) {
$form['sort_by']['#bef_path'] = $form['sort_order']['#bef_path'] = $view_path;
}
}
if ($collapse) {
$sort_elems[] = 'sort_by';
$sort_elems[] = 'sort_order';
}
// Add reset sort option if selected.
if ($settings['sort']['advanced']['reset']) {
array_unshift($form['sort_by']['#options'], $settings['sort']['advanced']['reset_label']);
}
}
/* Ends: if ($settings['sort']['advanced']['combine']) { ... } else { */
if ($collapse) {
$form['bef_sort_options'] = array(
'#type' => 'fieldset',
'#collapsible' => TRUE,
'#collapsed' => TRUE,
'#title' => filter_xss_admin($settings['sort']['advanced']['collapsible_label']),
);
foreach ($sort_elems as $elem) {
$form['bef_sort_options'][$elem] = $form[$elem];
unset($form[$elem]);
}
}
// Check if this is a secondary form element.
if ($allow_secondary && $settings['sort']['advanced']['is_secondary']) {
foreach (array(
$settings['sort']['advanced']['combine_param'],
'sort_by',
'sort_order',
) as $elem) {
if (!empty($form[$elem])) {
$secondary[$elem] = $form[$elem];
unset($form[$elem]);
}
}
}
}
elseif (isset($settings['sort']) && !empty($form['sort_by'])) {
if ('bef_links' == $settings['sort']['bef_format']) {
$bef_add_js = TRUE;
$form['sort_by']['#theme'] = 'select_as_links';
// Exposed form displayed as blocks can appear on pages other than
// the view results appear on. This can cause problems with
// select_as_links options as they will use the wrong path. We
// provide a hint for theme functions to correct this.
if (!empty($this->display->display_options['exposed_block'])) {
$form['sort_by']['#bef_path'] = $view_path;
}
}
}
// Apply autosubmit sort values.
if (empty($this->options['autosubmit']) && !empty($settings['sort']['advanced']['autosubmit'])) {
$bef_js['autosubmit'] = TRUE;
foreach (array(
$settings['sort']['advanced']['combine_param'],
'sort_by',
'sort_order',
) as $elem) {
if (!empty($form[$elem])) {
$form[$elem] = array_merge_recursive($form[$elem], array(
'#attributes' => array(
'class' => array(
'ctools-auto-submit',
),
),
));
}
}
}
/* Ends: if (isset($settings['sort'])) { */
/*
* Handle exposed pager elements.
*/
if (isset($settings['pager'])) {
switch ($settings['pager']['bef_format']) {
case 'bef':
$show_apply = TRUE;
$form['items_per_page']['#type'] = 'radios';
if (empty($form['items_per_page']['#process'])) {
$form['items_per_page']['#process'] = array();
}
array_unshift($form['items_per_page']['#process'], 'form_process_radios');
$form['items_per_page']['#prefix'] = '<div class="bef-sortby bef-select-as-radios">';
$form['items_per_page']['#suffix'] = '</div>';
break;
case 'bef_links':
if (count($form['items_per_page']['#options']) > 1) {
$bef_add_js = TRUE;
$form['items_per_page']['#theme'] = 'select_as_links';
$form['items_per_page']['#items_per_page'] = max($form['items_per_page']['#default_value'], key($form['items_per_page']['#options']));
// Exposed form displayed as blocks can appear on pages other than
// the view results appear on. This can cause problems with
// select_as_links options as they will use the wrong path. We
// provide a hint for theme functions to correct this.
if (!empty($this->display->display_options['exposed_block'])) {
$form['items_per_page']['#bef_path'] = $view_path;
}
}
break;
}
// Check if this is a secondary form element.
if ($allow_secondary && $settings['pager']['is_secondary']) {
foreach (array(
'items_per_page',
'offset',
) as $elem) {
if (!empty($form[$elem])) {
$secondary[$elem] = $form[$elem];
unset($form[$elem]);
}
}
}
}
// Shorthand for all filters in this view.
$filters = $form_state['view']->display_handler->handlers['filter'];
// Get the order of all filters.
$filters_order = array_flip(array_keys($filters));
// Go through each saved option looking for Better Exposed Filter settings.
foreach ($settings as $label => $options) {
// Sanity check: Ensure this filter is an exposed filter.
if (empty($filters[$label]) || !$filters[$label]->options['exposed']) {
continue;
}
// Form element is designated by the element ID which is user-
// configurable.
$filter_key = 'filter-' . (!empty($filters[$label]->options['is_grouped']) ? $filters[$label]->options['group_info']['identifier'] : $label);
$filter_id = $form['#info'][$filter_key]['value'];
// Token replacement on BEF Description fields.
if (!empty($options['more_options']['bef_filter_description'])) {
// Collect replacement data.
$data = array();
$available = $options['more_options']['tokens']['available'];
if (in_array('vocabulary', $available) && isset($filters[$label]->definition['vocabulary'])) {
$data['vocabulary'] = taxonomy_vocabulary_machine_name_load($filters[$label]->definition['vocabulary']);
}
/* Others? */
// Replace tokens.
$options['more_options']['bef_filter_description'] = token_replace($options['more_options']['bef_filter_description'], $data);
$form[$filter_id]['#bef_description'] = $options['more_options']['bef_filter_description'];
}
// Handle filter value rewrites.
if (!empty($options['more_options']['rewrite']['filter_rewrite_values'])) {
$lines = explode("\n", trim($options['more_options']['rewrite']['filter_rewrite_values']));
$rewrite = array();
foreach ($lines as $line) {
list($search, $replace) = explode('|', $line);
if (isset($search)) {
$rewrite[$search] = $replace;
}
}
foreach ($form[$filter_id]['#options'] as $index => $option) {
$is_object = FALSE;
if (is_object($option)) {
// Taxonomy filters use objects instead of text.
$is_object = TRUE;
$option = reset($option->option);
// Hierarchical filters prepend hyphens to indicate depth. We need
// to remove them for comparison, but keep them after replacement to
// ensure nested options display correctly.
$option = ltrim($option, '-');
}
if (isset($rewrite[$option])) {
if ('' == $rewrite[$option]) {
unset($form[$filter_id]['#options'][$index]);
}
else {
if ($is_object) {
// Taxonomy term filters are stored as objects. Use str_replace
// to ensure that keep hyphens for hierarchical filters.
$tid = key($form[$filter_id]['#options'][$index]->option);
$original = current($form[$filter_id]['#options'][$index]->option);
$form[$filter_id]['#options'][$index]->option[$tid] = str_replace($option, $rewrite[$option], $original);
}
else {
$form[$filter_id]['#options'][$index] = $rewrite[$option];
}
}
}
}
}
// @TODO: Is this conditional needed anymore after the existing settings
// array default values were added?
if (!isset($options['bef_format'])) {
$options['bef_format'] = '';
}
// These BEF options require a set of given options to work (namely,
// $form[$filter_id]['#options'] needs to set). But it is possible to
// adjust settings elsewhere in the view that removes these options from
// the form (eg: changing a taxonomy term filter from dropdown to
// autocomplete). Check for that here and revert to Views' default filter
// in those cases.
$requires_options = array(
'bef',
'bef_ul',
'bef_links',
);
if (in_array($options['bef_format'], $requires_options) && !array_key_exists('#options', $form[$filter_id])) {
$options['bef_format'] = 'default';
}
switch ($options['bef_format']) {
case 'bef_datepicker':
$show_apply = TRUE;
$bef_add_js = TRUE;
$bef_js['datepicker'] = TRUE;
$bef_js['datepicker_options'] = array();
if (isset($form[$filter_id]['value']['#type']) && 'date_text' == $form[$filter_id]['value']['#type'] || isset($form[$filter_id]['min']) && isset($form[$filter_id]['max']) && 'date_text' == $form[$filter_id]['min']['#type'] && 'date_text' == $form[$filter_id]['max']['#type']) {
/*
* Convert Date API formatting to jQuery formatDate formatting.
*
* @TODO: To be honest, I'm not sure this is needed. Can you set a
* Date API field to accept anything other than Y-m-d? Well, better
* safe than sorry...
*
* @see http://us3.php.net/manual/en/function.date.php
* @see http://docs.jquery.com/UI/Datepicker/formatDate
*
* Array format: PHP date format => jQuery formatDate format
* (comments are for the PHP format, lines that are commented out do
* not have a jQuery formatDate equivalent, but maybe someday they
* will...)
*/
$convert = array(
/* Day */
// Day of the month, 2 digits with leading zeros 01 to 31.
'd' => 'dd',
// A textual representation of a day, three letters Mon through
// Sun.
'D' => 'D',
// Day of the month without leading zeros 1 to 31.
'j' => 'd',
// (lowercase 'L') A full textual representation of the day of the
// week Sunday through Saturday.
'l' => 'DD',
// ISO-8601 numeric representation of the day of the week (added
// in PHP 5.1.0) 1 (for Monday) through 7 (for Sunday).
// 'N' => ' ',
// English ordinal suffix for the day of the month, 2 characters
// st, nd, rd or th. Works well with j.
// 'S' => ' ',
// Numeric representation of the day of the week 0 (for Sunday)
// through 6 (for Saturday).
// 'w' => ' ',
// The day of the year (starting from 0) 0 through 365.
'z' => 'o',
/* Week */
// ISO-8601 week number of year, weeks starting on Monday (added
// in PHP 4.1.0) Example: 42 (the 42nd week in the year).
// 'W' => ' ',
//
/* Month */
// A full textual representation of a month, such as January or
// March January through December.
'F' => 'MM',
// Numeric representation of a month, with leading zeros 01
// through 12.
'm' => 'mm',
// A short textual representation of a month, three letters Jan
// through Dec.
'M' => 'M',
// Numeric representation of a month, without leading zeros 1
// through 12.
'n' => 'm',
// Number of days in the given month 28 through 31.
// 't' => ' ',
//
/* Year */
// Whether it's a leap year 1 if it is a leap year, 0 otherwise.
// 'L' => ' ',
// ISO-8601 year number. This has the same value as Y, except that
// if the ISO week number (W) belongs to the previous or next
// year, that year is used instead. (added in PHP 5.1.0).
// Examples: 1999 or 2003.
// 'o' => ' ',
// A full numeric representation of a year, 4 digits Examples:
// 1999 or 2003.
'Y' => 'yy',
// A two digit representation of a year Examples: 99 or 03.
'y' => 'y',
);
$format = '';
if (isset($form[$filter_id]['value'])) {
$format = $form[$filter_id]['value']['#date_format'];
$form[$filter_id]['value']['#attributes']['class'][] = 'bef-datepicker';
// This element renders via Drupal's FormAPI so we can use
// #description instead of passing the description along to BEF's
// theme functions.
if (!empty($form[$filter_id]['#bef_description'])) {
$form[$filter_id]['#description'] = $form[$filter_id]['#bef_description'];
}
}
else {
// Both min and max share the same format.
$format = $form[$filter_id]['min']['#date_format'];
$form[$filter_id]['min']['#attributes']['class'][] = 'bef-datepicker';
$form[$filter_id]['max']['#attributes']['class'][] = 'bef-datepicker';
// Description goes with the second field for in-between filters.
if (!empty($form[$filter_id]['#bef_description'])) {
$form[$filter_id]['max']['#description'] = $form[$filter_id]['#bef_description'];
}
}
$bef_js['datepicker_options']['dateFormat'] = json_encode(str_replace(array_keys($convert), array_values($convert), $format));
}
else {
$bef_js['datepicker_options']['dateFormat'] = '';
/*
* Standard Drupal date field. Depending on the settings, the field
* can be at $form[$filter_id] (single field) or
* $form[$filter_id][subfield] for two-value date fields or filters
* with exposed operators.
*/
$fields = array(
'min',
'max',
'value',
);
if (count(array_intersect($fields, array_keys($form[$filter_id])))) {
$final = '';
foreach ($fields as $field) {
if (isset($form[$filter_id][$field])) {
$form[$filter_id][$field]['#attributes']['class'][] = 'bef-datepicker';
$final = $field;
}
}
// Description goes with the second field for in-between filters.
if (!empty($form[$filter_id]['#bef_description'])) {
$form[$filter_id][$final]['#description'] = $form[$filter_id]['#bef_description'];
}
}
else {
$form[$filter_id]['#attributes']['class'][] = 'bef-datepicker';
// This element renders via Drupal's FormAPI so we can use
// #description instead of passing the description along to BEF's
// theme functions.
if (!empty($form[$filter_id]['#bef_description'])) {
$form[$filter_id]['#description'] = $form[$filter_id]['#bef_description'];
}
}
}
if (!empty($options['more_options']['datepicker_options'])) {
foreach (explode("\n", $options['more_options']['datepicker_options']) as $setting) {
list($key, $val) = explode(':', trim($setting), 2);
// No need to json_encode() this value like we do other datepicker
// options as it should already be entered in JSON format in the
// UI. While having an admin enter JSON in a text field is not
// ideal, it is how the jQueryUI widget documentation shows it in
// their examples.
$bef_js['datepicker_options'][$key] = $val;
}
}
break;
case 'bef_slider':
$show_apply = TRUE;
$bef_add_js = TRUE;
$bef_add_css = TRUE;
$bef_js['slider'] = TRUE;
// Add js options for the slider for this filter.
$bef_js['slider_options'][$filter_id] = array(
'min' => $options['slider_options']['bef_slider_min'],
'max' => $options['slider_options']['bef_slider_max'],
'step' => $options['slider_options']['bef_slider_step'],
'animate' => $options['slider_options']['bef_slider_animate'],
'orientation' => $options['slider_options']['bef_slider_orientation'],
'id' => drupal_html_id($filter_id),
'viewId' => $form['#id'],
);
// We need a wrapping element that covers all elements in the
// slider -- not just the text fields, but descriptions as well. When
// placed in the secondary fieldset, we lose what we usually get from
// the FormAPI.
if ($options['more_options']['is_secondary']) {
$form[$filter_id]['#prefix'] = '<div class="bef-slider-wrapper">';
$form[$filter_id]['#suffix'] = '</div>';
}
// This element renders via Drupal's FormAPI so we can use
// #description instead of passing the description along to BEF's
// theme functions.
if (!empty($form[$filter_id]['#bef_description'])) {
$children = element_children($form[$filter_id]);
if (count($children) > 1) {
// Put the description on the last child or this element.
$form[$filter_id][end($children)]['#description'] = $form[$filter_id]['#bef_description'];
}
else {
$form[$filter_id]['#description'] = $form[$filter_id]['#bef_description'];
}
}
break;
case 'bef_links':
$bef_add_js = TRUE;
$form[$filter_id]['#theme'] = 'select_as_links';
// Exposed form displayed as blocks can appear on pages other than
// the view results appear on. This can cause problems with
// select_as_links options as they will use the wrong path. We provide
// a hint for theme functions to correct this.
if (!empty($this->display->display_options['exposed_block'])) {
$form[$filter_id]['#bef_path'] = $view_path;
}
break;
case 'bef_single':
$show_apply = TRUE;
// Use filter label as checkbox label.
$form[$filter_id]['#title'] = $filters[$label]->options['expose']['label'];
$form[$filter_id]['#description'] = $options['more_options']['bef_filter_description'];
$form[$filter_id]['#return_value'] = 1;
$form[$filter_id]['#type'] = 'checkbox';
// Views populates missing values in $form_state['input'] with the
// defaults and a checkbox does not appear in $_GET (or $_POST) so it
// will appear to be missing when a user submits a form. Because of
// this, instead of unchecking the checkbox value will revert to the
// default. More, the default value for select values is reused which
// results in the checkbox always checked. So we need to add a form
// element to see whether the form is submitted or not and then we
// need to look at $_GET directly to see whether the checkbox is
// there. For security reasons, we must not copy the $_GET value.
// First, let's figure out a short name for the signal element and
// then add it.
if (empty($signal)) {
for ($signal = 'a'; isset($form[$signal]); $signal++) {
}
// This is all the signal element needs.
$form[$signal]['#type'] = 'hidden';
}
$checked = isset($form_state['input'][$signal]) ? isset($_GET[$filter_id]) : $form[$filter_id]['#default_value'];
// Now we know whether the checkbox is checked or not, set #value
// accordingly.
$form[$filter_id]['#value'] = $checked ? $form[$filter_id]['#return_value'] : 0;
// Handoff to the theme layer.
$form[$filter_id]['#theme'] = 'checkbox';
break;
case 'bef_ul':
$show_apply = TRUE;
$form[$filter_id]['#bef_nested'] = TRUE;
/* Intentionally falling through to case 'bef'. */
case 'bef':
$show_apply = TRUE;
if (empty($form[$filter_id]['#multiple'])) {
// Single-select -- display as radio buttons.
$form[$filter_id]['#type'] = 'radios';
if (empty($form[$filter_id]['#process'])) {
$form[$filter_id]['#process'] = array();
}
array_unshift($form[$filter_id]['#process'], 'form_process_radios');
// Add description.
if (!empty($form[$filter_id]['#bef_description'])) {
$form[$filter_id]['#description'] = $form[$filter_id]['#bef_description'];
}
// Clean up objects from the options array (happens for taxonomy-
// based filters).
$opts = $form[$filter_id]['#options'];
$form[$filter_id]['#options'] = array();
foreach ($opts as $index => $opt) {
if (is_object($opt)) {
reset($opt->option);
$key = key($opt->option);
$val = current($opt->option);
$form[$filter_id]['#options'][$key] = $val;
}
else {
$form[$filter_id]['#options'][$index] = $opt;
}
}
if (isset($form[$filter_id]['#options']['All'])) {
// @TODO: The terms 'All' and 'Any' are customizable in Views.
if ($filters[$label]->options['expose']['multiple']) {
// Some third-party filter handlers still add the "Any" option
// even if this is not an optional filter. Zap it here if they
// do.
unset($form[$filter_id]['#options']['All']);
}
else {
// Otherwise, make sure the "Any" text is clean.
$form[$filter_id]['#options']['All'] = check_plain($form[$filter_id]['#options']['All']);
}
}
// Render as radio buttons or radio buttons in a collapsible
// fieldset.
if (!empty($options['more_options']['bef_collapsible'])) {
// Pass the description and title along in a way such that it
// doesn't get rendered as part of the exposed form widget. We'll
// render them as part of the fieldset.
if (isset($form['#info'][$filter_key]['label'])) {
$form[$filter_id]['#bef_title'] = $form['#info'][$filter_key]['label'];
unset($form['#info'][$filter_key]['label']);
}
if (!empty($options['more_options']['bef_filter_description'])) {
$form[$filter_id]['#bef_description'] = $options['more_options']['bef_filter_description'];
if (isset($form[$filter_id]['#description'])) {
unset($form[$filter_id]['#description']);
}
}
// If the operator is exposed as well, put it inside the fieldset.
if ($filters[$label]->options['expose']['use_operator']) {
$operator_id = $filters[$label]->options['expose']['operator_id'];
$form[$filter_id]['#bef_operator'] = $form[$operator_id];
unset($form[$operator_id]);
}
// Add collapse/expand Javascript and BEF CSS to prevent collapsed
// fieldset from disappearing.
if (empty($form[$filter_id]['#attached']['js'])) {
$form[$filter_id]['#attached']['js'] = array();
}
$form[$filter_id]['#attached']['js'][] = 'misc/form.js';
$form[$filter_id]['#attached']['js'][] = 'misc/collapse.js';
if (empty($form[$filter_id]['#attached']['css'])) {
$form[$filter_id]['#attached']['css'] = array();
}
$form[$filter_id]['#attached']['css'][] = drupal_get_path('module', 'better_exposed_filters') . '/better_exposed_filters.css';
// Take care of adding the fieldset in the theme layer.
$form[$filter_id]['#theme'] = 'select_as_radios_fieldset';
}
else {
// Render select element as radio buttons.
$form[$filter_id]['#attributes']['class'][] = 'bef-select-as-radios';
$form[$filter_id]['#theme'] = 'select_as_radios';
}
}
else {
// Render as checkboxes or checkboxes enclosed in a collapsible
// fieldset.
if (!empty($options['more_options']['bef_collapsible'])) {
// Pass the description and title along in a way such that it
// doesn't get rendered as part of the exposed form widget. We'll
// render them as part of the fieldset.
if (isset($form['#info'][$filter_key]['label'])) {
$form[$filter_id]['#bef_title'] = $form['#info'][$filter_key]['label'];
unset($form['#info'][$filter_key]['label']);
}
if (!empty($options['more_options']['bef_filter_description'])) {
$form[$filter_id]['#bef_description'] = $options['more_options']['bef_filter_description'];
if (isset($form[$filter_id]['#description'])) {
unset($form[$filter_id]['#description']);
}
}
// If the operator is exposed as well, put it inside the fieldset.
if ($filters[$label]->options['expose']['use_operator']) {
$operator_id = $filters[$label]->options['expose']['operator_id'];
$form[$filter_id]['#bef_operator'] = $form[$operator_id];
unset($form[$operator_id]);
}
// Add collapse/expand Javascript and BEF CSS to prevent collapsed
// fieldset from disappearing.
if (empty($form[$filter_id]['#attached']['js'])) {
$form[$filter_id]['#attached']['js'] = array();
}
$form[$filter_id]['#attached']['js'][] = 'misc/form.js';
$form[$filter_id]['#attached']['js'][] = 'misc/collapse.js';
if (empty($form[$filter_id]['#attached']['css'])) {
$form[$filter_id]['#attached']['css'] = array();
}
$form[$filter_id]['#attached']['css'][] = drupal_get_path('module', 'better_exposed_filters') . '/better_exposed_filters.css';
// Take care of adding the fieldset in the theme layer.
$form[$filter_id]['#theme'] = 'select_as_checkboxes_fieldset';
}
else {
$form[$filter_id]['#theme'] = 'select_as_checkboxes';
}
if ($options['more_options']['bef_select_all_none'] || $options['more_options']['bef_select_all_none_nested']) {
$bef_add_js = TRUE;
if ($options['more_options']['bef_select_all_none']) {
$form[$filter_id]['#bef_select_all_none'] = TRUE;
}
if ($options['more_options']['bef_select_all_none_nested']) {
$form[$filter_id]['#bef_select_all_none_nested'] = TRUE;
}
}
}
/* Ends: if (empty($form[$filter_id]['#multiple'])) { ... } else { */
// Add term descriptions, if appropriate. Pass along to theme
// functions for rendering.
if ($options['more_options']['bef_term_description'] && $filters[$filter_id] instanceof views_handler_filter_term_node_tid) {
$tids = array();
foreach ($form[$filter_id]['#options'] as $tid => $option) {
if (is_object($option)) {
reset($option->option);
$tid = key($option->option);
}
$tids[] = $tid;
}
$terms = taxonomy_term_load_multiple($tids);
foreach ($terms as $tid => $term) {
$form[$filter_id]['#bef_term_descriptions'][$tid] = check_markup($term->description, $term->format, '', TRUE);
}
}
break;
case 'bef_hidden':
// Hide the label.
$form['#info'][$filter_key]['label'] = '';
if (empty($form[$filter_id]['#multiple'])) {
$form[$filter_id]['#type'] = 'hidden';
}
else {
$form[$filter_id]['#theme'] = 'select_as_hidden';
}
break;
default:
// Handles functionality for exposed filters that are not rendered
// using BEF.
$show_apply = TRUE;
// Add a description to the exposed filter.
if (!empty($options['more_options']['bef_filter_description'])) {
$children = element_children($form[$filter_id]);
if (count($children) > 1) {
// A filter may have multiple children if it's a in-between
// filter. In this case, put the description on the last item.
$form[$filter_id][end($children)]['#description'] = t($options['more_options']['bef_filter_description']);
}
else {
$form[$filter_id]['#description'] = t($options['more_options']['bef_filter_description']);
}
}
break;
}
/* Ends switch ($options['bef_format']) */
// Apply autosubmit filter values.
if (empty($this->options['autosubmit']) && !empty($options['more_options']['autosubmit'])) {
$bef_js['autosubmit'] = TRUE;
// Check type form element.
if (isset($form[$filter_id]['value'])) {
$form[$filter_id]['value'] = array_merge_recursive($form[$filter_id]['value'], array(
'#attributes' => array(
'class' => array(
'ctools-auto-submit',
),
),
));
}
else {
$form[$filter_id] = array_merge_recursive($form[$filter_id], array(
'#attributes' => array(
'class' => array(
'ctools-auto-submit',
),
),
));
}
}
// Override "Any" label, if applicable.
if (!empty($options['more_options']['any_label']) && !empty($form[$filter_id]['#options']['All'])) {
$form[$filter_id]['#options']['All'] = $options['more_options']['any_label'];
}
// Check if this is a secondary form element.
if ($allow_secondary && $settings[$label]['more_options']['is_secondary']) {
$identifier = $form['#info'][$filter_key]['value'];
if (!empty($form[$identifier])) {
// Move from the main form to the secondary options fieldset.
$children = element_children($form[$identifier]);
$secondary[$identifier] = $form[$identifier];
unset($form[$identifier]);
if (1 < count($children)) {
// Some elements can have multiple children, for example min/max
// fields on an in-between filter. In those cases Add the label
// to the first element.
$secondary[$identifier][$children[0]]['#title'] = isset($form['#info'][$filter_key]['label']) ? $form['#info'][$filter_key]['label'] : '';
unset($form['#info'][$filter_key]);
}
else {
$secondary[$identifier]['#title'] = isset($form['#info'][$filter_key]['label']) ? $form['#info'][$filter_key]['label'] : '';
unset($form['#info'][$filter_key]);
}
// Ensure secondary options respect ordering of filters. Pass this
// along to the theme function for rendering. Multiply existing
// position by 2 so that we have room to stick the exposed operator
// before the filter.
if (isset($filters[$label]->position)) {
$secondary[$identifier]['#bef_position'] = $filters[$label]->position * 2;
}
else {
$secondary[$identifier]['#bef_position'] = $filters_order[$label] * 2;
}
// Move exposed operators with exposed filters.
if (!empty($filters[$label]->options['expose']['use_operator'])) {
$op_id = $filters[$label]->options['expose']['operator_id'];
$secondary[$op_id] = $form[$op_id];
unset($form[$op_id]);
// Make sure operators appear just before the filter they are
// associated with.
if (isset($filters[$label]->position)) {
$secondary[$op_id]['#bef_position'] = $filters[$label]->position * 2 - 1;
}
else {
$secondary[$op_id]['#bef_position'] = $filters_order[$label] * 2 - 1;
}
}
}
}
}
// If our form has no visible filters, hide the submit button.
if (!$show_apply) {
if (isset($form['submit'])) {
$form['submit']['#attributes']['class'][] = 'element-hidden';
}
if (isset($form['reset'])) {
$form['reset']['#attributes']['class'][] = 'element-hidden';
}
}
// Add Javascript as needed.
if ($bef_add_js) {
// Add jQuery UI library code as needed.
if ($bef_js['datepicker']) {
drupal_add_library('system', 'ui.datepicker');
}
if ($bef_js['slider']) {
drupal_add_library('system', 'ui.slider');
}
if ($bef_js['autosubmit']) {
$form['submit']['#attributes']['class'][] = 'ctools-use-ajax';
$form['submit']['#attributes']['class'][] = 'ctools-auto-submit-click';
$form['#attached']['js'][] = drupal_get_path('module', 'ctools') . '/js/auto-submit.js';
}
drupal_add_js(array(
'better_exposed_filters' => $bef_js,
), 'setting');
drupal_add_js(drupal_get_path('module', 'better_exposed_filters') . '/better_exposed_filters.js');
}
if ($bef_add_css) {
drupal_add_css(drupal_get_path('module', 'better_exposed_filters') . '/better_exposed_filters.css');
}
// Check for secondary elements.
if ($allow_secondary && !empty($secondary)) {
// Add secondary elements after regular exposed filter elements.
$remaining = array_splice($form, count($form['#info']) + 1);
$form['secondary'] = $secondary;
$form = array_merge($form, $remaining);
$form['#info']['filter-secondary']['value'] = 'secondary';
}
}
/**
* Fills in missing settings with default values.
*
* Similar to array_merge_recursive, but later numeric keys overwrites earlier
* values. Use this to set defaults for missing values in a multi-dimensional
* array. Eg:
*
* $existing = $this->_bef_set_defaults($defaults, $existing);
*
* @return array
* The resulting settings array
*/
function _bef_set_defaults() {
$count = func_num_args();
if (!$count) {
return;
}
elseif (1 == $count) {
return func_get_arg(0);
}
// First array is the default values.
$params = func_get_args();
$return = array_shift($params);
// Merge the rest of the arrays onto the default array.
foreach ($params as $array) {
foreach ($array as $key => $value) {
// Numeric keyed values are added (unless already there).
if (is_numeric($key) && !in_array($value, $return)) {
if (is_array($value)) {
$return[] = $this
->_bef_set_defaults($return[$key], $value);
}
else {
$return[] = $value;
}
}
else {
if (isset($return[$key]) && is_array($value) && is_array($return[$key])) {
$return[$key] = $this
->_bef_set_defaults($return[$key], $value);
}
else {
$return[$key] = $value;
}
}
}
}
return $return;
}
/**
* Updates legacy settings to their current location.
*
* @param array $settings
* Array of BEF settings.
*/
function _bef_update_legacy_settings($settings) {
// There has got to be a better way... But for now, this works.
if (isset($settings['sort']['collapsible'])) {
$settings['sort']['advanced']['collapsible'] = $settings['sort']['collapsible'];
unset($settings['sort']['collapsible']);
}
if (isset($settings['sort']['collapsible_label'])) {
$settings['sort']['advanced']['collapsible_label'] = $settings['sort']['collapsible_label'];
unset($settings['sort']['collapsible_label']);
}
if (isset($settings['sort']['combine'])) {
$settings['sort']['advanced']['combine'] = $settings['sort']['combine'];
unset($settings['sort']['combine']);
}
if (isset($settings['sort']['reset'])) {
$settings['sort']['advanced']['reset'] = $settings['sort']['reset'];
unset($settings['sort']['reset']);
}
if (isset($settings['sort']['reset_label'])) {
$settings['sort']['advanced']['reset_label'] = $settings['sort']['reset_label'];
unset($settings['sort']['reset_label']);
}
// Input required was originally stored in Views' options, not in BEF's
// settings.
if (isset($this->options['input_required'])) {
$settings['general']['input_required'] = $this->options['input_required'];
}
if (isset($this->options['input_required']['text_input_required'])) {
$settings['general']['input_required']['text_input_required']['text_input_required'] = $this->options['text_input_required'];
}
if (isset($this->options['input_required']['text_input_required_format'])) {
$settings['general']['input_required']['text_input_required']['text_input_required_format'] = $this->options['text_input_required_format'];
}
return $settings;
}
/**
* Returns an array of default or current existing values for BEF settings.
*
* This helps us as we add new options and prevents a lot of.
* @code
* if (isset($settings['new_settings'])) { ... }
* @endcode
* as there will be a default value at all positions in the settings array.
* Also updates legacy settings to their new locations via
* _bef_update_legacy_settings().
*
* @return array
* Multi-dimensional settings array.
*/
function _bef_get_settings() {
// General, sort, pagers, etc.
$defaults = array(
'general' => array(
'input_required' => FALSE,
'text_input_required' => array(
'text_input_required' => array(
'value' => t('Select any filter and click on Apply to see results'),
'format' => filter_default_format(),
),
),
'allow_secondary' => FALSE,
'secondary_label' => t('Advanced options'),
'secondary_collapse_override' => 0,
),
'sort' => array(
'bef_format' => 'default',
'advanced' => array(
'collapsible' => FALSE,
'collapsible_label' => '',
'combine' => FALSE,
'combine_param' => 'sort_bef_combine',
'combine_rewrite' => '',
'reset' => FALSE,
'reset_label' => '',
'is_secondary' => FALSE,
'autosubmit' => FALSE,
),
),
'pager' => array(
'bef_format' => 'default',
'is_secondary' => FALSE,
),
);
// Update legacy settings in the exposed form settings form. This
// keep us from losing settings when an option is put into an
// 'advanced options' fieldset.
$current = $this
->_bef_update_legacy_settings($this->options['bef']);
// Collect existing values or use defaults.
$settings = $this
->_bef_set_defaults($defaults, $current);
// Filter default values.
$filter_defaults = array(
'bef_format' => 'default',
'more_options' => array(
'bef_select_all_none' => FALSE,
'bef_select_all_none_nested' => FALSE,
'bef_collapsible' => FALSE,
'is_secondary' => FALSE,
'bef_filter_description' => '',
'any_label' => '',
'bef_term_description' => FALSE,
'autosubmit' => FALSE,
'tokens' => array(
'list' => array(),
'available' => array(),
),
'rewrite' => array(
'filter_rewrite_values' => '',
),
'datepicker_options' => '',
),
'slider_options' => array(
'bef_slider_min' => 0,
'bef_slider_max' => 99999,
'bef_slider_step' => 1,
'bef_slider_animate' => '',
'bef_slider_orientation' => 'horizontal',
),
);
// Go through each exposed filter and collect settings.
foreach ($this->display->handler
->get_handlers('filter') as $label => $filter) {
if (!$filter->options['exposed']) {
continue;
}
// Get existing values or use defaults.
$filter_current = isset($this->options['bef'][$label]) ? $this->options['bef'][$label] : array();
$settings[$label] = $this
->_bef_set_defaults($filter_defaults, $filter_current);
}
return $settings;
}
/**
* Utility function to determine if any filters have been applied.
* Borrowed from views_plugin_exposed_form_input_required.
*/
function exposed_filter_applied() {
static $cache = NULL;
if (!isset($cache)) {
$view = $this->view;
if (is_array($view->filter) && count($view->filter)) {
foreach ($view->filter as $filter_id => $filter) {
if ($filter
->is_exposed()) {
$identifier = $filter->options['expose']['identifier'];
if (isset($view->exposed_input[$identifier])) {
if (!empty($view->exposed_input[$identifier])) {
$cache = TRUE;
return $cache;
}
}
}
}
}
$cache = FALSE;
}
return $cache;
}
/**
* Pre render callback to append the 'no values found' text if input required
* options is enabled.
*/
function pre_render($values) {
$bef_settings = $this
->_bef_get_settings();
if (!$this
->exposed_filter_applied() && !empty($bef_settings['general']['input_required'])) {
$options = array(
'id' => 'area',
'table' => 'views',
'field' => 'area',
'label' => '',
'relationship' => 'none',
'group_type' => 'group',
'content' => $bef_settings['general']['text_input_required']['text_input_required']['value'],
'format' => $bef_settings['general']['text_input_required']['text_input_required']['format'],
'empty' => TRUE,
);
$handler = views_get_handler('views', 'area', 'area');
$handler
->init($this->view, $options);
$this->display->handler->handlers['empty'] = array(
'area' => $handler,
);
$this->display->handler
->set_option('empty', array(
'text' => $options,
));
}
}
/**
* Query callback, intervenes if no filters are applied and input is required.
*/
function query() {
$bef_settings = $this
->_bef_get_settings();
if (!$this
->exposed_filter_applied() && !empty($bef_settings['general']['input_required'])) {
// We return with no query; this will force the empty text.
$this->view->built = TRUE;
$this->view->executed = TRUE;
$this->view->result = array();
}
else {
parent::query();
}
}
function unpack_translatable_options(&$translatable, $storage, $option, $definition, $parents) {
foreach ($this
->unpack_translatable_keys() as $key) {
$value = drupal_array_get_nested_value($this->options, $key);
if (!empty($value)) {
$translatable[] = array(
'value' => $value,
'keys' => $key,
'format' => NULL,
);
}
}
}
function unpack_translatable_keys() {
// Default options.
$keys = array(
// @TODO: Do we need to give this a better key so it makes more sense in
// the localization UI?
'value' => array(
'bef',
'general',
'text_input_required',
'text_input_required',
'value',
),
'general_secondary_label' => array(
'bef',
'general',
'secondary_label',
),
'sort_collapsible_label' => array(
'bef',
'sort',
'advanced',
'collapsible_label',
),
'sort_combine_rewrite' => array(
'bef',
'sort',
'advanced',
'combine_rewrite',
),
'sort_reset_label' => array(
'bef',
'sort',
'advanced',
'reset_label',
),
);
// Exposed filter options.
foreach ($this->display->handler
->get_handlers('filter') as $label => $filter) {
if (!$filter->options['exposed']) {
continue;
}
$keys[$label . '_filter_description'] = array(
'bef',
$label,
'more_options',
'bef_filter_description',
);
$keys[$label . '_any_label'] = array(
'bef',
$label,
'more_options',
'any_label',
);
$keys[$label . '_rewrite_values'] = array(
'bef',
$label,
'more_options',
'rewrite',
'filter_rewrite_values',
);
$keys[$label . '_datepicker_options'] = array(
'bef',
$label,
'more_options',
'datepicker_options',
);
}
return $keys;
}
function unpack_options(&$storage, $options, $definition = NULL, $all = TRUE, $check = TRUE, $localization_keys = array()) {
parent::unpack_options($storage, $options, $definition, $all, $check, $localization_keys);
// Override the values.
foreach ($this->localization_keys as $key => $parents) {
$parent = end($parents);
$value = isset($options[$parent]) ? $options[$parent] : NULL;
// Don't localize strings during editing. When editing, we need to work
// with the original data, not the translated version.
if (empty($this->view->editing) && !empty($value)) {
if (!empty($this->view) && $this->view
->is_translatable()) {
// Allow other modules to make changes to the string before it's
// sent for translation.
// The $keys array is built from the bef form array structure.
$format = NULL;
$translation_data = array(
'value' => $value,
'format' => $format,
'keys' => $parents,
);
$storage[$parent] = $this->view->localization_plugin
->translate($translation_data);
}
else {
$storage[$parent] = t($value);
}
}
elseif (!empty($value)) {
$storage[$parent] = $value;
}
}
}
}Members
Name |
Modifiers | Type | Description | Overrides |
|---|---|---|---|---|
|
better_exposed_filters_exposed_form_plugin:: |
function | Utility function to determine if any filters have been applied. Borrowed from views_plugin_exposed_form_input_required. | ||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Tweak the exposed filter form to show Better Exposed Filter options. Overrides views_plugin_exposed_form:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Initialize the plugin. Overrides views_plugin_exposed_form:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Provide a form to edit options for this plugin. Overrides views_plugin_exposed_form:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Information about options for all kinds of purposes will be held here. Overrides views_plugin_exposed_form:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Pre render callback to append the 'no values found' text if input required
options is enabled. Overrides views_plugin_exposed_form:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Query callback, intervenes if no filters are applied and input is required. Overrides views_plugin_exposed_form:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Returns the summary of the settings in the display. Overrides views_plugin:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function |
Unpack options over our existing defaults, drilling down into arrays so
that defaults don't get totally blown away. Overrides views_object:: |
||
|
better_exposed_filters_exposed_form_plugin:: |
function | |||
|
better_exposed_filters_exposed_form_plugin:: |
function | |||
|
better_exposed_filters_exposed_form_plugin:: |
function | Returns an array of default or current existing values for BEF settings. | ||
|
better_exposed_filters_exposed_form_plugin:: |
function | Fills in missing settings with default values. | ||
|
better_exposed_filters_exposed_form_plugin:: |
function | Updates legacy settings to their current location. | ||
|
views_object:: |
public | property | Handler's definition. | |
|
views_object:: |
public | property | Except for displays, options for the object will be held here. | 1 |
|
views_object:: |
function | Collect this handler's option definition and alter them, ready for use. | ||
|
views_object:: |
public | function | Views handlers use a special construct function. | 4 |
|
views_object:: |
public | function | Destructor. | 2 |
|
views_object:: |
public | function | 1 | |
|
views_object:: |
public | function | ||
|
views_object:: |
public | function | Always exports the option, regardless of the default value. | |
|
views_object:: |
public | function | Set default options on this object. | 1 |
|
views_object:: |
public | function | Set default options. | |
|
views_object:: |
public | function | Let the handler know what its full definition is. | |
|
views_object:: |
public | function | Unpack a single option definition. | |
|
views_object:: |
public | function | Unpacks each handler to store translatable texts. | |
|
views_object:: |
public | function | ||
|
views_plugin:: |
public | property | The current used views display. | |
|
views_plugin:: |
public | property | The plugin name of this plugin, for example table or full. | |
|
views_plugin:: |
public | property | The plugin type of this plugin, for example style or query. | |
|
views_plugin:: |
public | property |
The top object of a view. Overrides views_object:: |
1 |
|
views_plugin:: |
public | function | Provide a list of additional theme functions for the theme info page. | |
|
views_plugin:: |
public | function | Handle any special handling on the validate form. | 9 |
|
views_plugin:: |
public | function | Validate the options form. | 10 |
|
views_plugin:: |
public | function | Return the human readable name of the display. | |
|
views_plugin:: |
public | function | Provide a full list of possible theme templates used by this style. | |
|
views_plugin:: |
public | function | Validate that the plugin is correct and can be saved. | 3 |
|
views_plugin_exposed_form:: |
public | function | This function is executed when exposed form is submited. | |
|
views_plugin_exposed_form:: |
public | function | ||
|
views_plugin_exposed_form:: |
public | function | ||
|
views_plugin_exposed_form:: |
public | function | ||
|
views_plugin_exposed_form:: |
public | function | ||
|
views_plugin_exposed_form:: |
public | function | Render the exposed filter form. | |
|
views_plugin_exposed_form:: |
public | function |