编辑“Gallery:模块:multiroot”

= Multiroot 模块 =
生成不同的入口点至Gallery，提供Gallery不同部位的视图。

== 描述 ==
此模块可协助Gallery备用的游客视图的创建。

Multiroot允许你创建一个备用URL来对Gallery的一部分进行查看。此配置页面将协助此备用URL的安装及PHP文件的创建。此模块从不激活而且使用multiroot也不会用到它。有两个选项：

=== 虚拟的根目录相册 ===
此选项为视图定义一个默认相册并对导航链接进行调整以使得默认相册之上无父族相册被显示出来。游客及登录用户访问此备用URL都会看到此效果。然而Gallery的权限并没有被修改。因此类似imageblock和search的模块或手动输入的URL会将访问者引导至默认相册外的项目中去。此选项的安装更为简便，因为它使用的游客权限已为Gallery定义过了。

=== 备用游客用户 ===
此选项定义一个新的游客视图，并且该视图的权限已被精确且适当地定义过了。通过任何模块或URL进行浏览，使用该备用URL的游客无法看到权限允许之外的项目。无论是访问一般的或是备用的URL，登录后的用户可以看到任何权限允许范围内的内容。此选项提供对备用视图更好的访问权限控制，但是需要额外地对权限进行设置。

== 特点 ==
* 配置辅助Gallery某部分新视图的生成
* 两种模式：
** 引导你的访问者至一个'''虚拟的根目录相册'''，在此他们仍能通过使用imageblock或search功能来查看Gallery的其他部分。
** 创建一个'''备用游客用户'''来限制访问者对Gallery的查看，即将他们限制在一个新建的根目录相册之下的内容之中。
* 与[[Gallery:Multisite|多站点]]相比较，管理员可以在单个Gallery中对所有相册进行管理。

== 用法 ==
# 安装'''multiroot'''模块。参见[[Gallery:Installing Additional Components|额外组件的安装]]。
# multiroot模块不会激活。这就是该模块的特殊之处。
# 为你的Gallery新建一个根目录或入口点：
** 打开''站点管理（Site Admin）'' -> ''插件（Plugins）''
** 点击multiroot -> ''配置（configure）''
*** 为字段"''URI for new guest view''"给予的用于举例的数值：
**** (())
**** (())
** 按照创建''虚拟根目录''或''备用游客用户''的相关指导进行操作并让辅助功能协助生成结果代码。
** 将生成的代码复制到一个.php文件（如'myphotos.php'）中去并将该文件放到你的gallery2文件夹下。

=== 高级 ===
你可以通过生成的.php文件中的这些设定手动调整新建入口点的设定（这些均为可选的）：
  $gallery->setConfig('login', true); /*定义是否显示一个登录链接（默认为true）*/
  $gallery->setConfig('defaultAlbumId', 7682); /*定义该视图根目录相册的相册ID（默认为一般根目录）*/
  $gallery->setConfig('anonymousUserId', 11270); /*定义备用游客用户（默认为一般游客）*/
  $gallery->setConfig('breadcrumbRootId', 7682); /*定义导航信标（breadcrumb）的根目录相册*/

[[Category:Gallery 2:Modules]]