Functions

Views ajax library

Functions

 views_ajax ()
 Menu callback to load a view via AJAX.
 views_ajax_command_set_form ($output, $title, $url=NULL)
 Creates a Drupal AJAX 'viewsSetForm' command.
 views_ajax_command_dismiss_form ()
 Creates a Drupal AJAX 'viewsDismissForm' command.
 views_ajax_command_hilite ($selector)
 Creates a Drupal AJAX 'viewsHilite' command.
 views_ajax_command_add_tab ($id, $title, $body)
 Creates a Drupal AJAX 'addTab' command.
 views_ajax_command_scroll_top ($selector)
 Scroll to top of the current view.
 views_ajax_command_show_buttons ()
 Shows Save and Cancel buttons.
 views_ajax_command_trigger_preview ()
 Trigger the Views live preview.
 views_ajax_command_replace_title ($title)
 Replace the page title.
 views_ajax_error ($message)
 Return an AJAX error.
 views_ajax_form_wrapper ($form_id, &$form_state)
 Wrapper around drupal_build_form to handle some AJAX stuff automatically.
 views_ajax_autocomplete_user ($string= '')
 Page callback for views user autocomplete.
 views_ajax_autocomplete_taxonomy ($vid, $tags_typed= '')
 Page callback for views taxonomy autocomplete.

Function Documentation

views_ajax (  ) 

Menu callback to load a view via AJAX.

Definition at line 15 of file ajax.inc.

References views_ajax_command_scroll_top(), and views_get_view().

                      {
  if (isset($_REQUEST['view_name']) && isset($_REQUEST['view_display_id'])) {
    $name = $_REQUEST['view_name'];
    $display_id = $_REQUEST['view_display_id'];
    $args = isset($_REQUEST['view_args']) && $_REQUEST['view_args'] !== '' ? explode('/', $_REQUEST['view_args']) : array();
    $path = isset($_REQUEST['view_path']) ? $_REQUEST['view_path'] : NULL;
    $dom_id = isset($_REQUEST['view_dom_id']) ? preg_replace('/[^a-zA-Z0-9_-]+/', '-', $_REQUEST['view_dom_id']) : NULL;
    $pager_element = isset($_REQUEST['pager_element']) ? intval($_REQUEST['pager_element']) : NULL;

    $commands = array();

    $arg = explode('/', $_REQUEST['view_path']);

    // Remove all of this stuff from $_GET so it doesn't end up in pagers and tablesort URLs.
    foreach (array('view_name', 'view_display_id', 'view_args', 'view_path', 'view_dom_id', 'pager_element', 'view_base_path', 'ajax_html_ids', 'ajax_page_state') as $key) {
      if (isset($_GET[$key])) {
        unset($_GET[$key]);
      }
      if (isset($_REQUEST[$key])) {
        unset($_REQUEST[$key]);
      }
      if (isset($_POST[$key])) {
        unset($_POST[$key]);
      }
    }

    // Load the view.
    $view = views_get_view($name);
    if ($view && $view->access($display_id)) {
      // Fix 'q' for paging.
      if (!empty($path)) {
        $_GET['q'] = $path;
      }

      // Add all $_POST data, because AJAX is always a post and many things,
      // such as tablesorts, exposed filters and paging assume $_GET.
      $_GET += $_POST;

      // Overwrite the destination.
      // @see drupal_get_destination()
      $origin_destination = $path;
      $query = drupal_http_build_query($_REQUEST);
      if ($query != '') {
        $origin_destination .= '?' . $query;
      }
      $destination = &drupal_static('drupal_get_destination');
      $destination = array('destination' => $origin_destination);

      // Override the display's pager_element with the one actually used.
      if (isset($pager_element)) {
        $commands[] = views_ajax_command_scroll_top('.view-dom-id-' . $dom_id);
        $view->display[$display_id]->handler->set_option('pager_element', $pager_element);
      }
      // Reuse the same DOM id so it matches that in Drupal.settings.
      $view->dom_id = $dom_id;

      $commands[] = ajax_command_replace('.view-dom-id-' . $dom_id, $view->preview($display_id, $args));
    }
    drupal_alter('views_ajax_data', $commands, $view);
    return array('#type' => 'ajax', '#commands' => $commands);
  }
}

views_ajax_autocomplete_taxonomy ( vid,
tags_typed = '' 
)

Page callback for views taxonomy autocomplete.

Parameters:
$vid The vocabulary id of the tags which should be returned.
$tags_typed The typed string of the user.
See also:
taxonomy_autocomplete()

Definition at line 332 of file ajax.inc.

                                                                  {
  // The user enters a comma-separated list of tags. We only autocomplete the last tag.
  $tags_typed = drupal_explode_tags($tags_typed);
  $tag_last = drupal_strtolower(array_pop($tags_typed));

  $matches = array();
  if ($tag_last != '') {

    $query = db_select('taxonomy_term_data', 't');
    $query->addTag('translatable');
    $query->addTag('term_access');

    // Do not select already entered terms.
    if (!empty($tags_typed)) {
      $query->condition('t.name', $tags_typed, 'NOT IN');
    }
    // Select rows that match by term name.
    $tags_return = $query
      ->fields('t', array('tid', 'name'))
      ->condition('t.vid', $vid)
      ->condition('t.name', '%' . db_like($tag_last) . '%', 'LIKE')
      ->range(0, 10)
      ->execute()
      ->fetchAllKeyed();

    $prefix = count($tags_typed) ? drupal_implode_tags($tags_typed) . ', ' : '';

    $term_matches = array();
    foreach ($tags_return as $tid => $name) {
      $n = $name;
      // Term names containing commas or quotes must be wrapped in quotes.
      if (strpos($name, ',') !== FALSE || strpos($name, '"') !== FALSE) {
        $n = '"' . str_replace('"', '""', $name) . '"';
      }
      // Add term name to list of matches.
      $term_matches[$prefix . $n] = check_plain($name);
    }
  }

  drupal_json_output($term_matches);
}

views_ajax_autocomplete_user ( string = ''  ) 

Page callback for views user autocomplete.

Definition at line 287 of file ajax.inc.

                                                    {
  // The user enters a comma-separated list of user name. We only autocomplete the last name.
  $array = drupal_explode_tags($string);

  // Fetch last name
  $last_string = trim(array_pop($array));
  $matches = array();
  if ($last_string != '') {
    $prefix = count($array) ? implode(', ', $array) . ', ' : '';

    if (strpos('anonymous', strtolower($last_string)) !== FALSE) {
      $matches[$prefix . 'Anonymous'] = 'Anonymous';
    }

    $result = db_select('users', 'u')
      ->fields('u', array('uid', 'name'))
      ->condition('u.name', db_like($last_string) . '%', 'LIKE')
      ->range(0, 10)
      ->execute()
      ->fetchAllKeyed();

    foreach ($result as $account) {
      $n = $account;
      // Commas and quotes in terms are special cases, so encode 'em.
      if (strpos($account, ',') !== FALSE || strpos($account, '"') !== FALSE) {
        $n = '"' . str_replace('"', '""', $account) . '"';
      }
      $matches[$prefix . $n] = check_plain($account);
    }
  }

  drupal_json_output($matches);
}

views_ajax_command_add_tab ( id,
title,
body 
)

Creates a Drupal AJAX 'addTab' command.

Parameters:
$id The DOM ID.
$title The title.
$body The body.
Returns:
An array suitable for use with the ajax_render() function.

Definition at line 145 of file ajax.inc.

                                                        {
  $command = array(
    'command' => 'viewsAddTab',
    'id' => $id,
    'title' => $title,
    'body' => $body,
  );
  return $command;
}

views_ajax_command_dismiss_form (  ) 

Creates a Drupal AJAX 'viewsDismissForm' command.

Returns:
An array suitable for use with the ajax_render() function.

Definition at line 109 of file ajax.inc.

Referenced by views_ui_ajax_form().

                                           {
  $command = array(
    'command' => 'viewsDismissForm',
  );
  return $command;
}

views_ajax_command_hilite ( selector  ) 

Creates a Drupal AJAX 'viewsHilite' command.

Parameters:
$selector The selector to highlight
Returns:
An array suitable for use with the ajax_render() function.

Definition at line 125 of file ajax.inc.

Referenced by views_ajax_form_wrapper().

                                              {
  return array(
    'command' => 'viewsHilite',
    'selector' => $selector,
  );
}

views_ajax_command_replace_title ( title  ) 

Replace the page title.

Returns:
An array suitable for use with the ajax_render() function.

Definition at line 201 of file ajax.inc.

Referenced by views_ui_ajax_form().

                                                  {
  $command = array(
    'command' => 'viewsReplaceTitle',
    'title' => $title,
    'siteName' => variable_get('site_name', 'Drupal'),
  );
  return $command;
}

views_ajax_command_scroll_top ( selector  ) 

Scroll to top of the current view.

Returns:
An array suitable for use with the ajax_render() function.

Definition at line 161 of file ajax.inc.

Referenced by views_ajax().

                                                  {
  $command = array(
    'command' => 'viewsScrollTop',
    'selector' => $selector,
  );
  return $command;
}

views_ajax_command_set_form ( output,
title,
url = NULL 
)

Creates a Drupal AJAX 'viewsSetForm' command.

Parameters:
$output The form to display in the modal.
$title The title.
$url An optional URL.
Returns:
An array suitable for use with the ajax_render() function.

Definition at line 91 of file ajax.inc.

Referenced by views_ajax_error(), and views_ajax_form_wrapper().

                                                                   {
  $command = array(
    'command' => 'viewsSetForm',
    'output' => $output,
    'title' => $title,
  );
  if (isset($url)) {
    $command['url'] = $url;
  }
  return $command;
}

views_ajax_command_show_buttons (  ) 

Shows Save and Cancel buttons.

Returns:
An array suitable for use with the ajax_render() function.

Definition at line 175 of file ajax.inc.

Referenced by views_ui_ajax_form().

                                           {
  $command = array(
    'command' => 'viewsShowButtons',
  );
  return $command;
}

views_ajax_command_trigger_preview (  ) 

Trigger the Views live preview.

Returns:
An array suitable for use with the ajax_render() function.

Definition at line 188 of file ajax.inc.

Referenced by views_ui_ajax_form().

                                              {
  $command = array(
    'command' => 'viewsTriggerPreview',
  );
  return $command;
}

views_ajax_error ( message  ) 

Return an AJAX error.

Definition at line 213 of file ajax.inc.

References views_ajax_command_set_form().

Referenced by views_ui_add_item_form(), views_ui_config_item_extra_form(), views_ui_config_item_form(), views_ui_config_style_form(), views_ui_config_type_form(), views_ui_edit_display_form(), and views_ui_rearrange_form().

                                    {
  $commands = array();
  $commands[] = views_ajax_command_set_form($message, t('Error'));
  return $commands;
}

views_ajax_form_wrapper ( form_id,
&$  form_state 
)

Wrapper around drupal_build_form to handle some AJAX stuff automatically.

This makes some assumptions about the client.

Definition at line 223 of file ajax.inc.

References views_ajax_command_hilite(), and views_ajax_command_set_form().

Referenced by views_ui_ajax_form().

                                                         {
  ctools_include('dependent');

  // This won't override settings already in.
  $form_state += array(
    'rerender' => FALSE,
    'no_redirect' => !empty($form_state['ajax']),
    'no_cache' => TRUE,
    'build_info' => array(
      'args' => array(),
    ),
  );

  $form = drupal_build_form($form_id, $form_state);
  $output = drupal_render($form);

  // These forms have the title built in, so set the title here:
  if (empty($form_state['ajax']) && !empty($form_state['title'])) {
    drupal_set_title($form_state['title']);
    drupal_add_css(drupal_get_path('module', 'views_ui') . '/css/views-admin.css');
  }

  if (!empty($form_state['ajax']) && (empty($form_state['executed']) || !empty($form_state['rerender']))) {
    // If the form didn't execute and we're using ajax, build up a
    // Ajax command list to execute.
    $commands = array();

    $display = '';
    if ($messages = theme('status_messages')) {
      $display = '<div class="views-messages">' . $messages . '</div>';
    }
    $display .= $output;

    $title = empty($form_state['title']) ? '' : $form_state['title'];
    if (!empty($form_state['help_topic'])) {
      $module = !empty($form_state['help_module']) ? $form_state['help_module'] : 'views';
      if (module_exists('advanced_help')) {
        $title = theme('advanced_help_topic', array('module' => $module, 'topic' => $form_state['help_topic'])) . $title;
      }
    }

    $url = empty($form_state['url']) ? url($_GET['q'], array('absolute' => TRUE)) : $form_state['url'];

    $commands[] = views_ajax_command_set_form($display, $title, $url);

    if (!empty($form_state['#section'])) {
      $commands[] = views_ajax_command_hilite('.' . drupal_clean_css_identifier($form_state['#section']));
    }

    return $commands;
  }

  // These forms have the title built in, so set the title here:
  if (empty($form_state['ajax']) && !empty($form_state['title'])) {
    drupal_set_title($form_state['title']);
  }

  return $output;
}