xpWiki のXOOPSへのインストール

他モジュールとの依存関係

• ブロックの複製機能を利用したい場合は、altsys モジュールをインストールしてください。
• protector モジュールを使用する場合はできる限り、protector 3.02 以降を使用してください。
  • 3.02 未満の場合、ref プラグインで画像を多数張った場合や付箋の移動などで、DoS/crawlerチェックに引っ掛かる可能性があります。(xpWiki 3.55 以降で対応)

XOOPS Cube Legacy 上での注意点

html/preload ディレクトリに HypCommonPreLoad.class.php が含まれています。これは、HypCommonPreLoad をサイトに適用するファイルです。

HypCommonPreLoad は、デフォルトで、スパム投稿防止フィルターなどの各種フィルターは無効になっています。設定値を変更して運用したい場合は、HypCommonPreLoad のページを参考にサイト運営ポリシーに合わせて、適宜調整してください。

各種設定

• 各種設定は、ini ディレクトリにある *.ini.php ファイルを編集して行います。
  • 各 *.ini.php ファイルの雛形(規定値)は、XOOPS_TRUST_PATH/modules/xpwiki/ini にあります。それらのファイルから必要な部分を切り出して、XOOPS_ROOT_PATH/modules/xpwiki/private/ini ディレクトリ内の同名ファイルに追加記述してください。

プラグイン

xpWiki のプラグインは、クラスオブジェクトになっています。XOOPS_ROOT_PATH/modules/xpwiki/private/plugin に派生クラスを置くことで、各プラグインを上書きすることができます。

派生クラス名は、元のクラス名にインストールディレクトリ名を加えた名称にします。

例えば、amazon プラグインの場合、元のクラス名が xpwiki_plugin_amazon なので、モジュールインストールディレクトリが 'xpwiki' の場合、xpwiki_xpwiki_plugin_amazon になり、モジュールインストールディレクトリが 'mywiki' の場合、xpwiki_mywiki_plugin_amazon となります。

派生プラグインは、自分で書いてもよいですが、既存の xpWiki 用プラグインを変換するツールを用意してあります。

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

各プラグイン内の設定は plugin_NAME_init() 内に記述されていますので、その部分のみ書いておくことで、プラグインのバージョンアップ時にも柔軟に対応できます。

例えば、モジュールディレクトリ名が xpwiki の場合の amazon プラグインで associate ID のみを 'hogehoge-22' に変更したい場合は、次のようになります。

• XOOPS_ROOT_PATH/modules/xpwiki/private/plugin/amazon.inc.php

  1 2 3 4 5 6 7 8 9 10 11 12 13 14

  <?php class xpwiki_xpwiki_plugin_amazon extends xpwiki_plugin_amazon { function plugin_amazon_init() { parent::plugin_amazon_init(); // Amazon associate ID $this->cont['PLUGIN_AMAZON_AID'] = 'hogehoge-22'; } } ?>

言語ファイル

表示されるメッセージや文言などを独自に変更したい場合は、html 側のモジュールディレクトリに上書きする文言を記載した言語ファイルを作成することで対応できます。 それぞれの雛形は、xoops_trust_path/modules/xpwiki/language/xpwiki 以下にあります。それぞれのファイルの中で変更したい部分を切り出して、html 側のファイルに記載します。

例えば、次のようにします。(保存時の文字コードを使用言語に合わせて下さい)

• 独自言語ファイルの配置先
  • メイン用
    • html/modules/[xpWikiモジュールディレクトリ]/language/xpwiki/[言語(ja とか ja_utf8 など)]/lng.php
  • プラグイン用
    • html/modules/[xpWikiモジュールディレクトリ]/language/xpwiki/[言語(ja とか ja_utf8 など)]/plugin/[プラグイン名].lng.php
• 独自言語ファイルのファイル内容の例
  • メイン用 (例: 「絵文字パッド」を「絵文字入力」に)

    1 2	<?php $root->_btn_emojipad = '絵文字入力';

  • プラグイン用 (例: areaedit)

    1 2 3 4

    <?php $msg = array( 'title_error' => 'エリア編集エラー', );

プロキシ設定

外部へ接続する場合に、プロキシ設定が必要であれば、pukiwiki.ini.php に設定項目がありますが、HypCommonFunc Ver. 20080516 以降を利用している場合、実際に外部接続に使う Hyp_HTTP_Request クラスの設定ファイル http_request.ini を設定することで、一元的に設定することができます。

http_request.ini は、XOOPS_TRUST_PATH/class/hyp_common/ini/http_request.ini.dist が雛形となっていますので、そのファイルを編集設定し XOOPS_TRUST_PATH/class/hyp_common/ini/http_request.ini として保存してください。

http_request.ini の書式は、ini 形式となっています。