整合:Drupal:安装

Gallery 2

[下载]Gallery2并按照资料所述进行安装。确保你用的是'完整'安装包，因为'最小化'及'典型'安装包不包含需要的'ImageBlock'（和'ImageFrame'）插件。Gallery2应当按照在Drupal根目录中（或之下），这样才能在同一个站点中进行访问。如果你想/需要将Gallery2安装到其他地方（如Drupal代码库同级的位置）的话，就应当从Drupal文件夹内创建一个至G2的符号链接，如

cd /var/www/drupaldir
ln -s /path/to/gallery2

警告- 请勿将你的Gallery2代码库置于"/drupaldir/gallery"中。通常我们会建议你将其置于"/drupaldir/gallery2"之中，当然你可以将其置于除"/drupaldir/gallery"之外的任何位置，因为如果不这样的话，它就会与Drupal gallery模块路径冲突，Drupal就会认为http://www.drupalsite.com/gallery引用Drupal模块（而不是G2代码库）。

FYI：原则上说你甚至可以将G2置于Drupal根目录之外，而仍能正常运行。然而我们强烈建议你将G2置于Drupal dir之下的原因就是Drupal API的限制，而某些高级特点需要如此配置才能得以运用。drupal_add_js/css()函数不支持外部路径。没有了这些函数，我们就无法为结果页面中的js/css include维持应有次序了。这对某些目标的达成具有重要意义，即lightbox整合，jquery用法等。

如果你希望/需要Gallery2多站点，我们推荐你将单个站点置于"/drupaldir/sites/yoursite/gallery2"下。

确保你安装了"Image Block"插件（Gallery:Modules:imageblock）并在继续嵌入式安装之前在G2中启用了它。你还应对独立Gallery2中的"URL Rewrite"进行配置并将"Rules"设定为

Show Item: "gallery/v/%path%"

请参阅URL Rewrite的相关教程以进行详细了解。

如果你打算创建一个多语言站点（如在Drupal中使用i18n模块）的话，请勿在路径前加上"%language%"前缀。

Drupal

登出独立Gallery2以防止嵌入式安装过程中碰上会话相关的问题。

从drupal.org下载最新的gallery模块（[1]）。将下载下来的文件包解压到"/modules"（或"/sites/all/modules"或"/sites/yoursite/modules"）目录下。 除非明确地提醒你Drupal gallery模块有新版本，通常情况下都能跟最新版本的Gallery2兼容。

在Administer > Site building > Modules (admin/build/modules)中启用gallery模块（以及整合包中的其他模块）。要按照嵌入式gallery的话，你还需要对G2的细节方面做一些设置。浏览Administer > Site configuration > Gallery settings (admin/settings/gallery)来启动gallery模块所提供的安装向导。 你总是可以稍后返回到"Install"标签(admin/settings/gallery/install)来获取一份有关嵌入式G2及其插件的配置和状态报告。

安装向导应当很直观很容易完成。请阅读各步骤的帮助文字，这些指导已经足够详细了。

第一步：PHP内存测试

通常这一步没有什么需要做的。只是确保在你的服务器上php内存至少有24MB。根据你的配置不同（主要取决于活动Drupal模块和G2插件的数量），可能需要更多的内存以保证Gallery2在嵌入状态下也能正常运行。

第二步：Gallery2位置设定

明确Gallery2的位置是在Drupal中成功嵌入G2的关键。对于大多数用户来说"自动配置"就足够了，但对于特殊的托管配置，你可能就需要进行"手动配置"来完成此步骤了。

假设以下为单个站点G2的目录结构布局

WebPath to Drupal:       "/drupal5/"
ServerPath to Drupal:    "/var/www/drupal5/"
ServerPath to Gallery2:  "/var/www/drupal5/gallery2/"

而对于多站点

ServerPath to Gallery2: "/var/www/drupal5/sites/yoursite/gallery2/"
(ServerPath to Gallery codebase = ServerPath of single-site G2)

如果你的域直接指向Drupal的话，就可能需要移除样例URL中（而不是文件系统路径）的"/drupal5/"。后文中的例子就跟以上的配置有关。

自动配置

默认情况下，安装向导会尝试从你在此输入的"Gallery2 URL或URI"处产生文件系统路径，如：

single-site: "/drupal5/gallery2/"
multi-site:  "/drupal5/sites/yoursite/gallery2/"

(或者是Gallery2的完整URL，如http://www.example.com/drupal5/gallery2/；如果你的域直接指向Drupal，则如http://www.example.com/gallery2/)

如果你确信路径无误，但模块仍无法检测到Gallery2的话，确保G2文件夹没有受到你服务器管理系统的保护（即cPanel, Plesk, VHCS2, ...)。 如果出于某种原因自动检测完全无效的话，就来看看下面的"手动配置"吧。

手动配置

"手动配置"模式允许你手动输入任何值（并且不依赖自动检测机制）。"Gallery2 URL或URI"的值应当与上面的例子中的一致，"Gallery2文件系统路径"则指你服务器文件系统路径中G2的绝对位置（包括web根目录的基础路径）。

单个站点：

Gallery2 URL or URI:       "/drupal5/gallery2/"
Gallery2 filesystem path:  "/var/www/drupal5/gallery2/"
Embed URI:                 "/drupal5/index.php?q=gallery"

或多站点：

Gallery2 URL or URI:       "/drupal5/sites/yoursite/gallery2/"
Gallery2 filesystem path:  "/var/www/drupal5/sites/yoursite/gallery2/"
Embed URI:                 "/drupal5/index.php?q=gallery"

如果你打算为多语言站点使用i18n模块的话，请确保语言前缀没有被包括在"Embed URI"的值当中。

第三步：Drupal模块/Gallery2插件

某些Gallery2插件需要嵌入式的操作，而某些则应当卸载掉以防与Drupal产生冲突。此步骤就要让你了解如何取舍Gallery2的插件以及Drupal模块。

第四步：简洁URL/URL重写

此步骤需要启用"URL Rewrite"插件并在独立Gallery2中做过了配置。通常向导程序能够自动检测Drupal的.htaccess文件的路径。不然的话你就必须在此指定。这之所以必要是因为，如果不这样的话G2会将其自身的重写规则添加到Drupal短URL的处理之中。如果你不希望/不需要嵌入gallery的短URL的话，还可以跳过此步骤。

请参阅URL Rewrite的相关教程以进行详细了解。

第五步：初始用户同步

嵌入的Gallery能够正常工作是必要的，这样Drupal用户/组才能与它们的对应组分正确同步。用户/组映射缺失会导致嵌入操作中出现严重问题。因此，我们极力推荐你在安装期间就对所有用户/组进行同步。

然而，如果你在Gallery2中已经有大量用户，而且想将它们导入Drupal中的话，你可跳过此步骤并使用"高级同步" (admin/user/gallery/advanced) 的选项。

安装后的任务

此时你的gallery已经可以开始执行嵌入操作了。你可能想继续对gallery模块的选项进行配置以自定义嵌入式gallery (参见配置)。

大多数用户希望至少启用"Gallery Navigation"区块和/或"Gallery Image/Grid"区块。你可以在Drupal Administer > Site building > Blocks (admin/build/block)中的"Blocks"管理中达到此目的。

访问控制

另外确保你允许用户访问嵌入式gallery。浏览Administer > User management > Access control并进行权限的配置

• 访问gallery
• 访问独立的g2image
• 管理gallery设定

感谢你阅读此份教程。我们希望它能帮助你了解gallery模块和安装。欢迎对此教程进行修改和改进。