编辑“整合:Drupal:安装”

== Gallery 2 ==

[[http://gallery.menalto.com/downloads 下载]]Gallery2并按照资料所述进行[[Gallery:How_do_I_Install_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就会认为''<nowiki>http://www.drupalsite.com/gallery</nowiki>''引用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%"

请参阅[[Integration:Drupal:Installation:URL Rewrite|URL Rewrite]]的相关教程以进行详细了解。
 
如果你打算创建一个多语言站点（如在Drupal中使用i18n模块）的话，请勿在路径前加上"%language%"前缀。

== Drupal ==

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

从drupal.org下载最新的gallery模块（[http://drupal.org/project/gallery]）。将下载下来的文件包解压到"/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，如''<nowiki>http://www.example.com/drupal5/gallery2/</nowiki>''；如果你的域直接指向Drupal，则如''<nowiki>http://www.example.com/gallery2/</nowiki>'')

如果你确信路径无误，但模块仍无法检测到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的话，还可以跳过此步骤。

请参阅[[Integration:Drupal:Installation:URL Rewrite|URL Rewrite]]的相关教程以进行详细了解。

==== 第五步：初始用户同步 ====

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

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

== 安装后的任务 ==

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

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

==== 访问控制 ====

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

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


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

[[Category:Integration|Drupal]]
[[Category:Integration:Drupal]]