function _views_create_handler

3.x handlers.inc	`_views_create_handler($definition, $type = 'handler', $handler_type = NULL)`
2.x handlers.inc	`_views_create_handler($definition, $type = 'handler')`

Instantiate and construct a new handler

3 calls to _views_create_handler()

views_get_handler in ./views.module: Fetch a handler from the data cache.
views_get_plugin in ./views.module: Get a handler for a plugin
_views_prepare_handler in includes/handlers.inc: Prepare a handler's data by checking defaults and such.

File

includes/handlers.inc, line 11: Defines the various handler objects to help build and display views.

Code

function _views_create_handler($definition, $type = 'handler', $handler_type = NULL) {
  //  debug('Instantiating handler ' . $definition['handler']);
  if (empty($definition['handler'])) {
    vpr('_views_create_handler - type: @type - failed: handler has not been provided.', 
    array('@type' => isset($handler_type) ? ($type . '(handler type: ' . $handler_type . ')') : $type)
    );
    return;
  }

  // class_exists will automatically load the code file.
  if (!empty($definition['override handler']) && 
    !class_exists($definition['override handler'])) {
    vpr(
    '_views_create_handler - loading override handler @type failed: class @override_handler could not be loaded. ' .
      'Verify the class file has been registered in the corresponding .info-file (files[]).', 
    array(
      '@type' => isset($handler_type) ? ($type . '(handler type: ' . $handler_type . ')') : $type,
      '@override_handler' => $definition['override handler']
    )
    );
    return;
  }

  if (!class_exists($definition['handler'])) {
    vpr(
    '_views_create_handler - loading handler @type failed: class @handler could not be loaded. ' .
      'Verify the class file has been registered in the corresponding .info-file (files[]).', 
    array(
      '@type' => isset($handler_type) ? ($type . '(handler type: ' . $handler_type . ')') : $type,
      '@handler' => $definition['handler']
    )
    );
    return;
  }

  if (!empty($definition['override handler'])) {
    $handler = new $definition['override handler'];
  }
  else {
    $handler = new $definition['handler'];
  }

  $handler->set_definition($definition);
  if ($type == 'handler') {
    $handler->is_handler = TRUE;
    $handler->handler_type = $handler_type;
  }
  else {
    $handler->is_plugin = TRUE;
    $handler->plugin_type = $type;
    $handler->plugin_name = $definition['name'];
  }

  // let the handler have something like a constructor.
  $handler->construct();

  return $handler;
}