XOOPS 側の準備

• XOOPS_TRUST_PATH の準備 (XCL 2.1 以前)
  1. まずは、XOOPS_TRUST_PATH について理解をしてください。以下の記事が秀逸で参考になると思います。
     • 文系のためのXOOPS入門 > XOOPSの新型モジュールシステム「D3」の説明
  2. XOOPS_ROOT_PATH/mainfile.php にて XOOPS_TRUST_PATH を設定する。設定済みなら、もちろん何もしないでOK。
     
     XOOPS_ROOT_PATH の define 行の下に同じく define で設定してください。
     
     できれば、ドキュメントルートの外に設置できればベストです。
     
     [例]

     define('XOOPS_TRUST_PATH', '/home/yourhome/xoops_trust');

xpWiki のインストール

1. サーバーへの設置とパーミッション設定
   • 簡単インストーラー xpwiki_installer.cgi を使用する方法
     1. xpwiki_installer.cgi を XOOPS_ROOT_PATH/ へアップロードする
     2. XOOPS_ROOT_PATH/xpwiki_installer.cgi に実行権限を与える (755など)
     3. XOOPS_URL/xpwiki_installer.cgi にブラウザでアクセスし、画面の指示に従う。
   • アーカイブを解凍してFTPでアップロードする方法
     1. xpWiki*.zip を解凍する (ダウンロード)
     2. 必要なファイルをWebサーバーへアップロードする
        • html ディレクトリの中身をすべて XOOPS_ROOT_PATH ディレクトリへアップロードする。
          • html側のモジュールディレクトリ名'xpwiki'は自由に変えてもOKです。
        • xoops_trust_path ディレクトリの中身をすべて XOOPS_TRUST_PATH ディレクトリへアップロードする。
        • 携帯対応レンダーをXOOPSに適用する場合で、XOOPS 2.0.16aJPを使用している場合のみ、core_addons/html_2.0.16aJP ディレクトリの中身を XOOPS_ROOT_PATH へアップロードする。
          (XOOPS Cube Legacy の場合は、このディレクトリは必要ありません。)
     3. XOOPS_TRUST_PATH/cache ディレクトリがなければ作成して、パーミッションを 707 などにして、ファイル作成権限を与える。
     4. XOOPS_TRUST_PATH/class/hyp_common/favicon/cache ディレクトリのパーミッションを 707 などにして、ファイル作成権限を与える。
     5. XOOPS_TRUST_PATH/class/hyp_common/ini/http_request.ini.dist は、http通信をする Hyp_HTTP_Request クラスの設定ファイルの雛形です。プロキシ設定などサーバー固有の設定をしたい場合は、ファイル名を "http_request.ini" として設定保存してください。
        設定書式は、ini 形式です。
     6. XOOPS_ROOT_PATH/class/hyp_common/cache ディレクトリのパーミッションを 707 などにして、ファイル作成権限を与える。
     7. XOOPS_ROOT_PATH/modules/xpwiki/admin/setup.cgi に実行権限を与える(パーミッション 705, 755 etc)
     8. XOOPS_URL/modules/xpwiki/admin/setup.cgi へブラウザでアクセスする。
        • すべてのメッセージが'OK'であればパーミッションの設定は完了しています。
          'NG'があった場合や正常にアクセスできない場合*3は、以下を参考にパーミッションの設定を行ってください。
        • XOOPS_ROOT_PATH/modules/xpwiki 以下のパーミッションを設定する(例)

          attach                 707
          attach/s               707
          private/backup         707
          private/cache          707
          private/cache/page     707
          private/cache/plugin   707
          private/counter        707
          private/diff           707
          private/trackback      707
          private/wiki           707

2. XOOPSのモジュールインストールを行う
   1. XOOPS のモジュール管理にてインストールを行う。
   2. XOOPS管理画面にて、xpWiki管理メニュー > 管理ツール一覧 > データーベースシンクロ を実行する。

オリジナル設定の行い方

モジュールの複製

xpWiki は GIJOE氏が提唱している D3(Duplicatable V3) に準拠しています。XOOPS_ROOT_PATH 側に置く xpwiki ディレクトリの名称を好きなように変えて、アップロードすることでいくつでもインストールすることができます。

PukiWiki 用プラグインの取り込み

PukiWiki プラグインを xpWiki プラグインに自動変換することができます。ただし、すべてのプラグインが問題なくできるとは限りません。

変換ツールは、xpWiki管理画面のプラグイン変換ツールから 'Plugin converter from PukiWiki 1.4 to xpWiki' をお使いください。

変換したプラグインは、XOOPS_TRUST_PATH/modules/xpwiki/plugin ディレクトリに置いてください。

上手く変換できなかった場合は、サーバーにアップロードした時点や、プラグインを呼び出した時にPHPの実行が止まって画面が真っ白になることがあります。もし、そのような状態になった時には、サーバーから削除して変換されたプラグインの内容のデバグを行ってください。