function views_arg_load
3.x views.module | views_arg_load($value, $name, $display_id, $index) |
2.x views.module | views_arg_load($value, $name, $display_id, $index) |
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 467 - 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();
}
}