$block_number))
: format_plural(count($filter_names), 'Global filter @filters', 'Global filters: @filters', array(
'@filters' => implode(' + ', $filter_names)));
$blocks[GLOBAL_FILTER_BLOCK_ID_PREFIX . $block_number] = array(
'info' => $info,
'cache' => DRUPAL_NO_CACHE
);
}
// For the case that the number of blocks is reduced, remove the filters as
// without a block they have no home.
while ($block_number <= 10) {
foreach (global_filter_get_filters_for_block($block_number) as $key => $filter) {
if (!empty($filter['name'])) {
global_filter_remove_default_filter_from_views($filter['name']);
}
// Delete the filter
global_filter_set_parameter($key, NULL, NULL);
}
$block_number++;
}
return $blocks;
}
/**
* Implements hook_block_configure().
*
* Note that this hook cannot easily be used with dynamic forms adding
* additional fields at the press of a button, because form_state is not passed
* as its argument. See drupal.org/node/690828.
* Therefore the actions of adding or removing a fieldset (filter) is not easily
* communicated back to this function, unless we use the $_SESSION.
* I've left the code to do this in here, commented out, as it kind of works.
* However, I prefer the current functionality anyway. It always puts an extra
* optional filter fieldset at the bottom of the existing ones, without the
* need to explicitly having to add, remove and all the admin that comes with
* that.
*
* $param $delta, e.g. 'global_filter_2'
*/
function global_filter_block_configure($delta) {
// Container for the table, its id is used in the AJAX callback
$form['all-filters'] = array(
'#title' => t('Global filters in this block'),
'#type' => 'fieldset',
'#collapsible' => FALSE,
'#collapsed' => FALSE,
'#prefix' => '',
'#suffix' => '
',
);
$block_number = empty($delta) ? 1 : drupal_substr($delta, -1);
$filter_parameters = global_filter_get_parameter(NULL);
// Generate forms for existing filters
$fieldset = 0;
$keys = array();
for ($key = 1; $key < 10; $key++) {
if (empty($filter_parameters[$key])) {
if (!isset($first_free_key)) {
$first_free_key = $key;
}
}
elseif (drupal_substr($filter_parameters[$key]['block'], -1) == $block_number) {
$form['all-filters'][$key] = _global_filter_configure_form($block_number, $key);
$keys[] = $key;
$fieldset++;
}
}
// Generate empty form for optional extra filter
if (isset($first_free_key)) {
$form['all-filters'][$first_free_key] = _global_filter_configure_form($block_number, $first_free_key);
$keys[] = $first_free_key;
}
/*
$num_fieldsets = global_filter_get_num_fieldsets();
if (isset($num_fieldsets)) {
// Generate empty form(s)
while ($fieldset < $num_fieldsets) {
$form['all-filters'][$key] = _global_filter_configure_form($block_number, $key);
$fieldset++;
$key++
}
}
else {
global_filter_set_num_fieldsets($fieldset);
}
$form['all-filters']['add-another'] = array(
'#type' => 'submit',
'#value' => $fieldset == 0 ? t('Add a global filter to this block') : t('Add another global filter to this block'),
'#weight' => 1,
'#submit' => array('_global_filter_add_another_filter_submit'),
'#ajax' => array(
'callback' => '_global_filter_update_form_js',
'wrapper' => 'all-filters',
'effect' => 'slide'
)
);
if ($fieldset > 0) {
$form['all-filters']['remove'] = array(
'#type' => 'submit',
'#value' => t('Remove bottom filter'),
'#weight' => 2,
'#submit' => array('_global_filter_remove_bottom_filter_submit'),
'#ajax' => array(
'callback' => '_global_filter_update_form_js',
'wrapper' => 'all-filters',
'effect' => 'fade'
)
);
}
*/
return $form;
}
/**
* Submit handler for the "Add another fieldset" button.
*
* Increments the counter and forces a form rebuild.
*
function _global_filter_add_another_filter_submit($form, &$form_state) {
global_filter_increment_num_fieldsets();
$form_state['rebuild'] = TRUE;
}
/**
* Submit handler for the "Remove" button.
*
* Decrements the counter and forces a form rebuild.
*
function _global_filter_remove_bottom_filter_submit($form, &$form_state) {
global_filter_decrement_num_fieldsets();
$form_state['rebuild'] = TRUE;
}
/**
* Ajax callback in response to fieldsets being added or removed.
*
* At this point the $form has already been rebuilt. All we have to do here is
* tell AJAX what part of the browser form needs to be updated.
*
function _global_filter_update_form_js($form, &$form_state) {
// Return the updated fieldsets, so that ajax.inc can issue commands to the
// browser to update only the targeted sections of the page.
return $form['settings']['all-filters'];
}
function global_filter_set_num_fieldsets($num) {
$num_fieldsets = $num > 0 ? $num : 0;
session_cache_set('global_filter_fieldsets', $num_fieldsets);
return $num_fieldsets;
}
function global_filter_get_num_fieldsets() {
return session_cache_get('global_filter_fieldsets');
}
function global_filter_decrement_num_fieldsets() {
return global_filter_set_num_fieldsets(global_filter_get_num_fieldsets() - 1);
}
function global_filter_increment_num_fieldsets() {
return global_filter_set_num_fieldsets(global_filter_get_num_fieldsets() + 1);
}
*/
/**
* Generates the filter configuration form for filters in a block.
*
* @param int $block_number
* @param int $filter_key
* @return type
*/
function _global_filter_configure_form($block_number, $filter_key) {
$num_filters = count(global_filter_get_filters_for_block($block_number));
$name = ($num_filters == 0) ? '' : global_filter_get_parameter($filter_key, 'name');
$form = array();
$delta = GLOBAL_FILTER_FILTER_KEY_PREFIX . $filter_key;
$form[$delta] = array(
'#title' => isset($name)
? t('Settings for global filter %name', array('%name' => $name))
: t('Optional additional global filter (currently not configured)'),
'#type' => 'fieldset',
'#collapsible' => TRUE,
'#collapsed' => TRUE
);
$form[$delta]['driver'] = array(
'#title' => t('Filter driver'),
'#type' => 'fieldset',
'#collapsible' => FALSE,
'#attributes' => array('id' => drupal_html_class('global-filter-driver-' . $filter_key))
//'#description' => t('Select the field or view that drives the global filter options')
);
$radios_name = $delta . '_uses_view';
$form[$delta]['driver'][$radios_name] = array(
'#title' => t('Select whether this global filter is to be populated by a field or by a view'),
'#type' => 'radios',
'#options' => array(
0 => module_exists('location')
? t('field, node property, location proximity or search term(s)')
: t('field, node property or search term(s)'),
1 => t('view')
),
'#default_value' => (int)global_filter_get_parameter($filter_key, 'uses_view')
);
$selector_radios = ':input[name="'. $radios_name . '"]'; // same name for both buttons
$field_options = global_filter_get_usable_fields();
$form[$delta]['driver'][$delta . '_field'] = array(
'#title' => t('Choose the field to be used as a global filter'),
'#type' => 'select',
'#default_value' => global_filter_get_parameter($filter_key, 'field'),
'#options' => $field_options,
'#description' => t('The field or node property employed to populate the widget used to filter one or more views.'),
'#states' => array('visible' => array($selector_radios => array('value' => 0)))
);
$view_options = array_merge(
array('' => t('- None -')),
global_filter_get_view_names()
);
asort($view_options);
$form[$delta]['driver'][$delta . '_view'] = array(
'#title' => t('Choose the view to be used as a global filter'),
'#type' => 'select',
'#default_value' => global_filter_get_parameter($filter_key, 'view'),
'#options' => $view_options,
'#description' => t('The view employed to populate the widget used to filter one or more other views.'),
'#states' => array('visible' => array($selector_radios => array('value' => 1)))
);
$widget_default = global_filter_get_parameter($filter_key, 'widget');
if (global_filter_get_parameter($filter_key, 'uses_view')) {
if (empty($widget_default) || strpos($widget_default, 'default_') === 0) {
$widget_default = 'default';
}
$widget_options = array('default' => 'Default');
}
else {
$instances = global_filter_get_field_instances($name);
if (empty($instances)) {
$widget_options = array('default' => t('Default, i.e. inherit from field, if field-driven'));
}
else {
foreach ($instances as $instance) {
$widget_type = $instance['widget']['type'];
$widget_options['default_' . $widget_type] = t('Inherit %widget widget from field @label (on %bundle)', array(
'%widget' => $widget_type, '@label' => $instance['label'], '%bundle' => $instance['bundle']
));
}
if (empty($widget_default) || $widget_default == 'default') {
// If not set inherit widget from last field instance
$widget_default = 'default_' . $widget_type;
}
}
}
$range_option = module_exists('contextual_range_filter')
? t('Range')
: t('Range (requires Contextual Range Filter)', array(
'!url' => url('http://drupal.org/project/contextual_range_filter')
));
$widget_options += array(
'select' => t('Single choice drop-down'),
'radios' => t('Single choice radio buttons'),
'multiselect' => t('Multi choice select box'),
'checkboxes' => t('Multi choice check boxes'),
'links' => t('List of hyperlinks'),
'textfield' => t('Text field'),
'range' => $range_option
);
$form[$delta]['widget'] = array(
'#title' => 'Widget to render the global filter',
'#type' => 'fieldset',
'#collapsible' => TRUE,
'#description' => t('Not all options apply in all cases, e.g. when the field is natively rendered as a textfield or date picker widget.')
);
$form[$delta]['widget'][$delta . '_widget'] = array(
'#title' => t('Widget'),
'#type' => 'radios',
'#default_value' => $widget_default,
'#options' => $widget_options,
'#description' => t("If you tick one of the multi choice widgets, make sure to tick the Allow multiple values box in the More section of the view's contextual filter. Views does not support multi choice widgets that have non-numeric keys."),
);
$description = t('Should be ticked for inherited slider widgets of type float. Optional for slider widgets of type integer and list. Has no effect on any other widget.');
$note1 = module_exists('slide_with_style')
? ''
: t('Requires Slide with Style or similar. ', array(
'!url' => url('http://drupal.org/project/select_with_style')));
$note2 = module_exists('contextual_range_filter')
? ''
: t('Requires Contextual Range Filter.', array(
'!url' => url('http://drupal.org/project/contextual_range_filter')));
$form[$delta]['widget'][$delta . '_convert_to_range'] = array(
'#title' => t('Convert slider to range slider'),
'#type' => 'checkbox',
'#default_value' => global_filter_get_parameter($filter_key, 'convert_to_range'),
'#description' => $description . '
' . $note1 . $note2
);
$form[$delta]['widget'][$delta . '_label'] = array(
'#title' => t('Widget label override'),
'#type' => 'textfield',
'#default_value' => global_filter_get_parameter($filter_key, 'label'),
'#description' => t("If omitted the widget's native label will be used, which may be blank. Use <none> if you want to suppress the label."),
);
$option_all_text = global_filter_get_parameter($filter_key, 'option_all_text');
$form[$delta]['widget'][$delta . '_option_all_text'] = array(
'#title' => t('Text to appear as the "all" option (non-field widgets only)'),
'#type' => 'textfield',
'#default_value' => $option_all_text,
'#description' => t('Inherited field widgets always use core defaults. Remaining widgets default to @all, if left blank.
Enter <none> to omit the "all" option from the widget. <none> is recommended for multi choice widgets.',
array('@all' => GLOBAL_FILTER_DEF_OPTION_ALL_TEXT))
);
$form[$delta]['widget'][$delta . '_confirm_question'] = array(
'#title' => t('Prompt the user to confirm their selection'),
'#type' => 'textfield',
'#default_value' => global_filter_get_parameter($filter_key, 'confirm_question'),
'#description' => t('The text you enter here will pop up as an alert box with Cancel and OK buttons, for example: Are you sure you want to change this filter ? If you leave this field blank, there will be no prompt.')
);
$form[$delta]['widget'][$delta . '_set_on_select'] = array(
'#title' => t('Autosubmit: invoke widget immediately upon select'),
'#type' => 'checkbox',
'#default_value' => global_filter_get_parameter($filter_key, 'set_on_select'),
'#description' => t('When ticked this does away with the Set button next to the widget. May not work on certain inherited widgets. When using the "List of hyperlinks" this option is ticked intrinsically.')
);
$form[$delta]['global_defaults'] = array(
'#title' => 'Global filter defaults',
'#type' => 'fieldset',
'#collapsible' => TRUE,
);
$field_or_view_options = array('' => ' - ' . t('No default ("all")') . ' - ');
if (global_filter_get_parameter($filter_key, 'uses_view')) {
// Execute View to present possible default values.
$view_name = drupal_substr(global_filter_get_parameter($filter_key, 'view'), 5);
global_filter_add_view_results($field_or_view_options, $view_name);
}
else {
// Retrieve field values
$field_name = global_filter_get_parameter($filter_key, 'field');
$field = field_info_field($field_name);
if ($field['type'] == 'taxonomy_term_reference') {
$vocabulary_name = $field['settings']['allowed_values'][0]['vocabulary'];
_global_filter_add_terms($field_or_view_options, $vocabulary_name);
}
elseif (!empty($field['settings']['allowed_values'])) {
foreach (list_allowed_values($field) as $key => $value) {
$field_or_view_options[$key] = $value;
}
}
else {
// Handle Location:Country.
// Final case: free text field?
}
}
$global_default = global_filter_get_parameter($filter_key, 'global_field_or_view_default');
if (empty($global_default)) {
$keys = array_keys($field_or_view_options);
$first_option = next($keys);
$global_default = $option_all_text == '' ? $first_option : NULL;
}
$form[$delta]['global_defaults'][$delta . '_global_field_or_view_default'] = array(
'#title' => t('Default value for the field or view selected above'),
'#type' => 'select',
'#multiple' => in_array(global_filter_get_parameter($filter_key, 'widget'), array('multiselect', 'checkboxes', 'default')),
'#options' => $field_or_view_options,
'#size' => 1,
'#description' => t('Optionally select default value(s) for the field or view above. These values will be active until the user selects another global filter value. If your widget does not have an "all" option, then you probably don\'t want to set "all" as the default.'),
'#default_value' => $global_default
);
$description = t("Enclose in PHP 'brackets'. Examples:
<?php return 'Beatles'; ?>
<?php return '2013-01-01--2013-12-31'; ?> (date range, note the double hyphen)
If the selected widget allows multiple choices, then return either an array or a string with choices delimited by plus signs.");
if (!module_exists('php')) {
$description .= t('
Enable the core PHP filter module for this setting to take effect.');
}
$form[$delta]['global_defaults'][$delta . '_global_php_default'] = array(
'#title' => t('Alternatively specify a default through PHP code'),
'#type' => 'textarea',
'#default_value' => global_filter_get_parameter($filter_key, 'global_php_default'),
'#description' => $description
);
return $form;
}
/**
* Implements hook_block_view().
*
* $param $delta, index into the array $blocks defined in
* global_filter_block_info)(), e.g. 'global_filter_2'
*/
function global_filter_block_view($delta) {
// In order to make sure that that the filter settings submitted via this
// little block are received by the depending views before they're executed
// this block may end up being requested twice: once in global_filter_init()
// and once whenever core feels like it. Hence the caching.
$blocks = &drupal_static(__FUNCTION__, array());
if (empty($blocks[$delta])) {
$usable_views = global_filter_get_view_names();
$usable_fields = global_filter_get_usable_fields();
$block_number = empty($delta) ? 1 : drupal_substr($delta, -1);
// Set the block title, aka 'subject'.
$blocks[$delta]['subject'] = '';
foreach (global_filter_get_filters_for_block($block_number) as $filter) {
$filter_name = $filter['name'];
if ($filter['uses_view'] && isset($usable_views[$filter_name])) {
$blocks[$delta]['subject'] .= drupal_substr($usable_views[$filter_name], 6);
}
elseif (isset($usable_fields[$filter_name])) {
$label = $usable_fields[$filter_name];
$pos_colon = strpos($label, ':');
$pos_bracket = strrpos($label, '(');
$blocks[$delta]['subject'] .= drupal_substr($label, $pos_colon + 2, $pos_bracket > $pos_colon ? $pos_bracket - $pos_colon - 3 : NULL);
}
$blocks[$delta]['subject'] .= ' ';
}
// With the block title set, now add all the filters for this block
$blocks[$delta]['content'] = drupal_get_form($delta);
}
return $blocks[$delta];
}
/**
* Implements hook_block_save().
*
* $param $delta, e.g. 'global_filter_2'
* $param $edit, tcontents of the block form
*/
function global_filter_block_save($delta, $edit = array()) {
foreach (_global_filter_extract_filters_from_form($edit) as $key => $filter) {
$old_name = global_filter_get_parameter($key, 'name');
$new_name = $filter['uses_view'] ? $filter['view'] : $filter['field'];
global_filter_set_parameter($key, 'name', $new_name);
global_filter_set_parameter($key, 'block', empty($new_name) ? NULL : $delta);
if (empty($old_name) || $old_name != $new_name) {
if (!empty($old_name)) {
global_filter_remove_default_filter_from_views($old_name);
}
if (!empty($new_name)) {
drupal_set_message(t('As you changed the global filter driver to %new, please check that the Global Filter defaults are correct. If not, make a selection and press Save block.',
array('%new' => $new_name)));
$reload_page = TRUE;
}
}
if ($filter['widget'] == 'links') {
$filter['set_on_select'] = TRUE;
}
foreach ($filter as $parameter_name => $value) {
global_filter_set_parameter($key, $parameter_name, empty($new_name) ? NULL : $value);
}
}
if (isset($reload_page)) {
drupal_goto($_GET['q']);
}
}
/**
* Extracts parameter values for all filters on the block when saved.
*
* @param type $form, a one-dimensional array containg filter parameters with
* keys formatted like "global_filter_#_name"
* @return 2-dimenional array indexed by filter key and parameter name
*/
function _global_filter_extract_filters_from_form($form) {
$filter_parameters = array();
foreach ($form as $form_key => $value) {
// consider reg_split
if (strpos($form_key, GLOBAL_FILTER_FILTER_KEY_PREFIX) === 0) {
$l = drupal_strlen(GLOBAL_FILTER_FILTER_KEY_PREFIX);
$key = drupal_substr($form_key, $l , 1);
if (is_numeric($key)) {
$parameter_name = drupal_substr($form_key, $l + 2);
$filter_parameters[$key][$parameter_name] = $value;
}
}
}
return $filter_parameters;
}
/**
* Get a list of labels of fields of the supplied type, or all fields if type if
* omitted.
*
* @param string $field_type, e.g. 'text'; for all lists use 'list'.
* @return array of labels indexed by field machine names
*/
function global_filter_get_field_labels($field_type = NULL) {
$field_names = &drupal_static(__FUNCTION__, array());
if (empty($field_names)) {
$prefix = t('Field');
foreach (field_info_instances() as $type_bundles) {
foreach ($type_bundles as $bundle_instances) {
foreach ($bundle_instances as $field_name => $instance) {
$field = field_info_field($field_name);
if (empty($field_type) || $field_type == $field['type'] || ($field_type == 'list' && strpos($field['type'], 'list') === 0)) {
$field_names[$field_name] = $prefix . ': ' . $instance['label'] . " ($field_name)";
}
}
}
}
}
return $field_names;
}
/**
* Retunrs a list of all field filters, indexed by their machine_name.
*/
function global_filter_get_usable_fields() {
$fields = array('' => t('- None -'));
$fields[GLOBAL_FILTER_VIEWS_COUNTRY_FIELD] = t('Location: Country');
$fields[GLOBAL_FILTER_VIEWS_SEARCH_TERMS_FIELD] = t('Search: Search terms'); // as in Views
if (module_exists('location')) {
$fields[GLOBAL_FILTER_VIEWS_PROXIMITY_FIELD] = t('Location: Distance/Proximity');
}
if (module_exists('search_api')) {
$fields[GLOBAL_FILTER_VIEWS_SEARCH_API_FULLTEXT] = t('Search API: Fulltext Search');
}
$fields = array_merge(
$fields,
global_filter_get_node_properties(),
global_filter_get_field_labels()
);
asort($fields);
return $fields;
}
/**
* Return an array of names of the filters inside the block by the given id.
*
* @param int $block_number, a positive integer: 1, 2, 3...
* @return array of filter names
*/
function global_filter_get_filters_for_block($block_number) {
$filter_parameters = global_filter_get_parameter(NULL);
foreach ($filter_parameters as $key => $filter) {
if (drupal_substr($filter['block'], -1) != $block_number) {
unset($filter_parameters[$key]);
}
}
return $filter_parameters;
}