编辑“Joomla/Joomla!1.5与Dokuwiki的完全整合方案”

{{Joomla top}}
在[[Joomla!]]网站上搭建[[Wiki]]知识库，实现多人在线联编（译）功能是无法回避的一个实际需求。本条目演示Joomla! 1.5.10与[[Dokuwiki]]版本之间的整合过程。

==安装前准备工作==
整合所需软件：
*Joomla! 1.5.10 中文版
*Dokuwiki 中文版
*Dokuwiki Bridge 桥接器

本教程演示的安装环境：
*服务器：[[XAMPP]] 1.7
*Joomla 1.5 安装在 http://localhost/1510
*Dokuwiki 安装在 http://localhost/1510/dokuwiki

==详细安装步骤==
===安装Dokuwiki===
在xampp\htdocs\1510 目录下新建一个子目录名为 dokuwiki，把 Dokuwiki 的安装包文件解压进去。然后通过[[浏览器]]访问如下地址：
 http://localhost/1510/dokuwiki/install.php
就能看到 Dokuwiki 的安装画面。在右上角选择语言为 zh，就切换为简体中文安装界面（直接访问 <nowiki>http://localhost/1510/dokuwiki/install.php?l=zh</nowiki> 这个地址作用相同）：

[[Image:Joomla dokuwiki 1.png]]

由于 Dokuwiki 是基于纯文本的 wiki 程序，不需要任何[[数据库]]支持。因此我们简单填写一下管理员帐号就能完成安装过程。为了与 Joomla 的用户帐号区别开，我们在安装 Dokuwiki 时创建的管理员帐号为 joomlagate，密码为 000000，将 wiki 类型选择为第二种：公开的维基（只有注册会员才能编辑）：

[[Image:Joomla dokuwiki 2.png]]

填写了上述信息后，点击左下角的“保存”按钮，就完成了 Dokuwiki 的安装过程，接下来看到如下画面：

[[Image:Joomla dokuwiki 3.png]]

请按照屏幕提示，及时删除 install.php （在 dokuwiki 根目录下）。然后点击给出的链接就能看到安装好的 Dokuwiki 前台：

[[Image:Joomla dokuwiki 4.png]]

到这里就完成了 Dokuwiki 的安装。从安装路径可以看出来，我们是将 Dokuwiki 安装在 Joomla 根目录下，如果你的安装路径关系与此不同，请注意在后面的描述中不要照搬本文的设置，而需要按照你真实的安装路径来修改相关[[代码]]。

===安装、设置Dokuwiki桥接器===
1.用文本编辑器打开 dokuwiki/conf/dokuwiki.php 这个文件，在大约第69行，找到如下代码：
 $conf['authtype']    = 'plain';
修改为：
 $conf['authtype']    = 'joomla'; 

2.打开 Dokuwiki 桥接器，选择针对 Joomla 1.5 的压缩包，里面只有一个文件 joomla.class.php ，将这个文件解压到 xampp\htdocs\1510\dokuwiki\inc\auth 目录下。不要修改这个文件的名称。 

3.接下来要对桥接器文件进行修改，主要是输入 Joomla 的管理员帐号和安装路径。用文本编辑器打开 joomla.class.php 这个文件，在大约第12行，可以看到如下代码：
 $conf['superuser'] = "admin";
如果你的 Joomla 管理员帐号正好是 admin，就不用修改了；如果你的 Joomla 管理员用户名不是 admin，请修改这一行代码中的 admin 为你的真实帐号。在这一行代码下方大约第14行，可以看到如下代码：
 include_once("../configuration.php");
这个指的是 Joomla 根木下的 configuration.php 文件的路径。表示的方法是 joomla/configuration.php 相对于 dokuwiki/index.php 文件的路径。请根据你安装 Joomla 和 Dokuwiki 的相对关系来设置这一项。

到此，Dokuwiki 桥接器的设置已经完成了。

===进阶设置===
现在请访问 <nowiki>http://localhost/1510/dokuwiki/doku.php</nowiki> 打开 Dokuwiki 的前台首页，点击右下角的“登录”按钮，可以看到如下的登录表单：

[[Image:Joomla dokuwiki 5.png]]

现在我们用 Dokuwiki 的管理员帐号 joomlagate 来登录，你会发现无法登录！这是因为桥接器已经生效了，Dokuwiki 现在认证会员身份的根据是 Joomla 的用户表，而不是 Dokuwiki 自身的用户表。

请再看上面的截图，在 Dokuwiki 的登录表单上仍然有“注册”链接，很显然这个链接将使用 Dokuwiki 的注册功能来创建新用户，而桥接之后 Dokuwiki 只“认”Joomla 里面的用户。因此，我们必须禁用 Dokuwiki 自身的注册功能。

====禁用Dokuwiki自身的注册功能====
[[Image:Joomla dokuwiki 6.png]]

我们使用 Joomla 的管理员帐号 admin 及密码 000000 登录，现在可以顺利登入 Dokuwiki（这足以证明已经桥接成功）。登入之后点击右下角的“管理”按钮（如上图所示），然后点击“配置设置”，可以看到比较长的一个页面，有很多参数。我们找到“停用 DokuWiki 功能”这一节（如下图所示），将“注册”勾选，然后点击页面左下角的“保存”。现在点击页面右下角的“退出”按钮，退出登录后再次点击“登录”按钮，就会发现在登录表单上不再显示“注册”链接了。

[[Image:Joomla dokuwiki 7.png]]

那么，我们在安装 Dokuwiki 时所创建的那个管理员帐号 joomlagate 岂不是作废了？也未必。你现在可以在 Joomla 后台的“用户管理”中手动创建一个新用户，用户名就是 joomlagate，密码还是原来的 000000，这样就可以让 joomlagate 这个帐号能够继续登录 Dokuwiki。

==参考来源==
http://www.joomlagate.com/article/joomla15-tutorial/login-dokuwiki-with-joomla-user-account/

{{Joomla 1.5}}

[[category:Joomla|J]]