#contents *xpWiki のXOOPSへのインストール ([[english>Install;en]]) [#hfe869a0] ** XOOPS 側の準備 [#qdfa8a1e] -XOOPS_TRUST_PATH の準備 ++まずは、XOOPS_TRUST_PATH について理解をしてください。以下の記事が秀逸で参考になると思います。 ---[[文系のためのXOOPS入門:http://xoops.kudok.com/]] > [[XOOPSの新型モジュールシステム「D3」の説明:http://xoops.kudok.com/d3.htm]] ++XOOPS_ROOT_PATH/mainfile.php にて XOOPS_TRUST_PATH を設定する。設定済みなら、もちろん何もしないでOK。~ XOOPS_ROOT_PATH の define 行の下に同じく define で設定してください。~ できれば、ドキュメントルートの外に設置できればベストです。~ [例] define('XOOPS_TRUST_PATH', '/home/yourhome/xoops_trust'); *** 他モジュールとの依存関係 [#ee89db55] - ブロックの複製機能を利用したい場合は、[[altsys モジュール:http://xoops.peak.ne.jp/search.php?query=altsys&andor=AND&mids%5B%5D=7&action=results&submit=Search]]をインストールしてください。 - [[protector モジュール:http://xoops.peak.ne.jp/search.php?query=protector&andor=AND&mids%5B%5D=7&action=results&submit=Search]]を使用する場合はできる限り、protector 3.02 以降を使用してください。 -- 3.02 未満の場合、ref プラグインで画像を多数張った場合や付箋の移動などで、DoS/crawlerチェックに引っ掛かる可能性があります。(xpWiki 3.55 以降で対応) ** xpWiki のインストール [#x4676a1a] +xpWiki*.zip を解凍する +必要なファイルをWebサーバーへアップロードする --html ディレクトリ以下をすべて XOOPS_ROOT_PATH ディレクトリへアップロードする。 ---html側のモジュールディレクトリ名'xpwiki'は自由に変えてもOKです。 --trust ディレクトリ以下をすべて XOOPS_TRUST_PATH ディレクトリへアップロードする。 +XOOPS_ROOT_PATH/modules/xpwiki/admin/setup.cgi に実行権限を与える(パーミッション 705, 755 etc) +XOOPS_URL/modules/xpwiki/admin/setup.cgi へブラウザでアクセスする。 --すべてのメッセージが'OK'であればパーミッションの設定は完了しています。~ 'NG'があった場合や正常にアクセスできない場合((サーバーの設定により setup.cgi が使用できない場合もあります。))は、以下を参考にパーミッションの設定を行ってください。 --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 +XOOPS のモジュール管理にてインストールを行う。 +XOOPS管理画面にて、xpWiki管理メニュー > 管理ツール一覧 > データーベースシンクロ を実行する。 *** XOOPS Cube Legacy 上での注意点 [#jf27e348] html/preload ディレクトリに HypCommonPreLoad.class.php が含まれています。これは、HypCommonPreLoad をサイトに適用するファイルです。 HypCommonPreLoad は、デフォルトで、スパム投稿防止フィルターなどの各種フィルターが有効になっています。それらのフィルターがまったく必要ないのであれば、HypCommonPreLoad.class.php を削除しても構いません。また、設定値を変更して運用したい場合は、HypCommonPreLoad のページを参考にサイト運営ポリシーに合わせて、適宜調整してください。 ** オリジナル設定の行い方 [#q24e37ed] *** 各種設定 [#eec4e765] -各種設定は、ini ディレクトリにある *.ini.php ファイルを編集して行います。 --各 *.ini.php ファイルの雛形(規定値)は、XOOPS_TRUST_PATH/modules/xpwiki/ini にあります。それらのファイルから必要な部分を切り出して、XOOPS_ROOT_PATH/modules/xpwiki/private/ini ディレクトリ内の同名ファイルに追加記述してください。 *** プラグイン [#u32a1c57] xpWiki のプラグインは、クラスオブジェクトになっています。XOOPS_ROOT_PATH/modules/xpwiki/private/plugin に派生クラスを置くことで、各プラグインを上書きすることができます。 派生クラス名は、元のクラス名にインストールディレクトリ名を加えた名称にします。 例えば、amazon プラグインの場合、元のクラス名が xpwiki_plugin_amazon なので、モジュールインストールディレクトリが 'xpwiki' の場合、xpwiki_&font(Red,b){xpwiki};_plugin_amazon になり、モジュールインストールディレクトリが 'mywiki' の場合、xpwiki_&font(Red,b){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 #code(php){{ <?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'; } } ?> }} *** プロキシ設定 [#rb3fe3b7] 外部へ接続する場合に、プロキシ設定が必要であれば、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 形式となっています。 ** モジュールの複製 [#l1a988fb] xpWiki は GIJOE氏が提唱している [[D3(Duplicatable V3):http://xoops.peak.ne.jp/md/news/index.php?page=article&storyid=100]] に準拠しています。XOOPS_ROOT_PATH 側に置く xpwiki ディレクトリの名称を好きなように変えて、アップロードすることでいくつでもインストールすることができます。 ** PukiWiki 用プラグインの取り込み [#ufe64a18] PukiWiki プラグインを xpWiki プラグインに自動変換することができます。ただし、すべてのプラグインが問題なくできるとは限りません。 変換ツールは、xpWiki管理画面のプラグイン変換ツールから 'Plugin converter from PukiWiki 1.4 to xpWiki' をお使いください。 変換したプラグインは、XOOPS_&font(Red,b){TRUST};_PATH/modules/xpwiki/plugin ディレクトリに置いてください。 上手く変換できなかった場合は、サーバーにアップロードした時点や、プラグインを呼び出した時にPHPの実行が止まって画面が真っ白になることがあります。もし、そのような状態になった時には、サーバーから削除して変換されたプラグインの内容のデバグを行ってください。
(This host) = https://xoops.hypweb.net