function views_arg_load in Views (for Drupal 7) 6.2

Same name and namespace in other branches

1. 8.3 views.module \views_arg_load()
2. 6.3 views.module \views_arg_load()
3. 7.3 views.module \views_arg_load()

Helper function for menu loading. This will automatically be called in order to 'load' a views argument; primarily it will be used to perform validation.

Parameters

$value: The actual value passed.

$name: The name of the view. This needs to be specified in the 'load function' of the menu entry.

$display_id: The display id that will be loaded for this menu item.

$index: The menu argument index. This counts from 1.

File

./views.module, line 258

Primarily Drupal hooks and global API functions to manipulate views.

Code

function views_arg_load($value, $name, $display_id, $index) {
  static $views = array();

  // Make sure we haven't already loaded this views argument for a similar menu
  // item elsewhere.
  $key = $name . ':' . $display_id . ':' . $value . ':' . $index;
  if (isset($views[$key])) {
    return $views[$key];
  }
  if ($view = views_get_view($name)) {
    $view
      ->set_display($display_id);
    $view
      ->init_handlers();
    $ids = array_keys($view->argument);
    $indexes = array();
    $path = explode('/', $view
      ->get_path());
    foreach ($path as $id => $piece) {
      if ($piece == '%' && !empty($ids)) {
        $indexes[$id] = array_shift($ids);
      }
    }
    if (isset($indexes[$index])) {
      if (isset($view->argument[$indexes[$index]])) {
        $arg = $view->argument[$indexes[$index]]
          ->validate_argument($value) ? $value : FALSE;
        $view
          ->destroy();

        // Store the output in case we load this same menu item again.
        $views[$key] = $arg;
        return $arg;
      }
    }
    $view
      ->destroy();
  }
}