views_embed_view的详细说明

views_embed_view，我在drupal_abc的首页制作中，使用这个函数，详细地说明一下：

views_embed_view('news','default',$tid)，是Views2下面的函数，这里我装了views模块，这个模块你经常用，并自己创建了一个view，它的名字为news，它有一个默认的显示就是default，这个view还有一个参数，就是可以向它传递的参数$tid。这个函数里面的属性是规定了的。第一个为view的名字，第2个为view的类型，后面是传递给它的参数。

下面是这个函数的API

views_embed_view
描述:
使用PHP代码嵌入一个视图(view).
这个函数是在PHP代码中调用的,可以在一个节点中或者其它东西中嵌入一个视图.这个函数只提供了最简单的解决方案,它没有给出太多的配置选项,所以这个函数也非常容易理解,一小会儿就可以搞懂它是干什么的了.

注意这个函数没有显示视图的标题,如果你需要显示它的标题的话,那么你需要手工的实现,加载视图,获取预览,接着使用 $view->get_title()得到标题.

参数
$name 要嵌入的视图的名字.
$display_id 要嵌入的显示id.如果不确定的话,可以使用 'default',这个总是有效的.这里也可以使用'page'或者'block'.
而其它的附加参数则作为一个变量传递过来。

下面是这个函数的代码：
<?php
function views_embed_view($name, $display_id = 'default') {
  $args = func_get_args();
  array_shift($args); // remove $name
  if (count($args)) {
    array_shift($args); // remove $display_id
  }

  $view = views_get_view($name);
  if (!$view) {
    return;
  }

  return $view->preview($display_id, $args);
}
?>