RecentChanges Last 60

postcommon_post_register_moratorium.php

スパム対策用。

登録ユーザにしか投稿を許可していないサイトにも関わらず、手動で新規アカウントを取ってまでSPAMを投稿しようとしている相手が対象です。*1

これを有効にすると、ユーザ登録してから一定時間(デフォルトでは60分)、URLを含んだPOST動作が禁止されます。POST動作が阻害されたケースでは、後何分で解除されるかが表示されます。

ただし、まともなユーザの投稿も阻害してしまう可能性がある点には注意が必要です。（新規ユーザがなんらかの投稿しようとする場合は、ユーザ登録直後に投稿するのが普通であるため）

ゲストからPOSTされた内容のうち一定の長さ(32byte)以上のテキストすべてを、HTMLPurifierで検査/強制書き換えします。

postcommon_post_htmlpurify4everyone.php

Script Insertion (HTML Injection) 対策。 ゲスト/登録ユーザ問わず、POSTされた内容のすべてを、POSTされた内容のうち一定の長さ以上のテキストすべてを、HTMLPurifierで検査/強制書き換えします。

投稿先がHTML許可・不許可かどうかは認識しないので、ソースコードの記述を頻繁に行う様なサイトには向きません。

HTMLによる投稿がほとんどで、そのHTMLの質に問題がある、といった状況には役立つかも知れません。

基本知識

まずはこのサイトのベーシックマニュアルなどで、XOOPSのテンプレートの原理について理解すること。

特に以下の違いの理解は重要

テンプレート

モジュールの出力で使われる必要な個々の雛形。HTMLが多いが、XMLやCSS、メールの雛形を提供するものもある。

テンプレートセット

実際に利用される雛形を決定するために、テンプレートをまとめたもの。defaultテンプレートセットのみが特別で、全種類のテンプレートを持っている。default以外のテンプレートセットは任意のテンプレートのみを持つことができる。

テンプレートの分類

XOOPS_ROOT_PATH/modules/(dirname)/templa​tes/に置かれたファイル群

実ファイル。 FTPなどでも確認可能。

あくまで、モジュール作者が提供するデフォルトテンプレートであり、これが直接、テンプレートとして利用されるわけではない。（オリジナルのX2およびXCL2.1）。

ただし、本家版2.0.14以降および、そこからフォークしたImpressCMSでは、一般設定において「defaultテンプレートセット」を選択したままだと、ここに置かれたファイルが、テンプレートとして直接利用されてしまう。

この場所のファイルを書き換えても、モジュールのバージョンアップで上書きアップロードすれば、当然、書き換え結果は消されてしまう。

これは、X2テンプレートの仕組み・意義を理解していない開発者による改悪だと思われる。

defaultテンプレートセット内のテンプレート

DBテンプレート。ファイルとしては確認できない。 altsysやテンプレート管理などから確認可能。

モジュール管理から、モジュールをアップデートすると、「XOOPS_ROOT_PATH/modules/(dirname)/templa​tes/に置かれたファイル群」から、データベース内にコピーされる。（すでにあった、defaultテンプレートセットのテンプレート内容は上書きされる）

オリジナルのX2およびXCL2.1では、この動作を経てはじめて、上記ファイル群の更新されたテンプレートが反映されることになる。

カスタムテンプレートセット内のテンプレート

DBテンプレート。ファイルとしては確認できない。 altsysやテンプレート管理などから確認可能。

ここでテンプレートセットごと「複製」してしまうと、カスタマイズする予定のないテンプレートまで複製されてしまい、モジュールを上書きアップデートしても、一向に反映されないことになる。 altsysのテンプレート管理画面、一番下にある「新規にテンプレートセットを作成する」から、ベースに「(空)」を選んで、セット名を入力し、「新規作成」する。 altsysの「テンプレートの高度な操作」に入り、「テンプレートを枠で囲う」をクリック。 再度、公開側を表示すれば、テンプレート単位で枠が囲ってあるので、編集したい枠内にある "Edit:" リンクをクリックして編集する。 ただしこの場合、defaultテンプレートを直接編集していることになるので*1)、編集終了後に、忘れずに編集したテンプレートについて、defaultからcustomテンプレートにコピーしておくこと。 それを忘れたままでいると、後でモジュールアップデートした時に変更内容が失われて泣くことになる。 これはモジュール作者がデフォルトテンプレートを更新する時に使う手段である。 モジュールユーザがこの手段を使うと、やはりモジュール更新時に泣くことになる。

テーマ下テンプレート

そのほか、普通のチェックボックスの作り方の例

現在は main_content_form.html にいろいろな extra_fields の書例がありますが、補足として、上記例以外のチェックボックスの記述例を書いておきます。

<{assign var="fruits" value=","|explode:"Apple,Grape,Orange"}>
<{foreach from=$fruits item="fruit"}>
	<label><input type="checkbox" name="ef_fruits[]" value="<{$fruit}>"<{if @in_array( $fruit,$content.ef.fruits )}> checked="checked"<{/if}> /> <{$fruit}></label><br />
<{/foreach}>

ユーザーグループの削除

rsync が使える場合

もし rsync コマンドが使える環境だったら、バージョンアップはかなり楽になるかもしれません。下記のようなコマンド一発でファイルを転送してしまい、あとはコントロールパネルからモジュールのアップデートをかけていく、ということになります（コマンドの内容は適宜編集が必要です）。

rsync -auv --exclude="mainfile.php" /ローカルのXCL/xoops_trust_path/ ユーザ名@ホスト:xoops_trust_path
rsync -auv --exclude="mainfile.php" /ローカルのXCL/html/ ユーザ名@ホスト:public_html

アップデートモジュールのアップロード

インストール時と同様に、各モジュールのマニュアル、ダウンロードサイトの説明にしたがって、新しいモジュールのファイル群をFTP等にてサーバへアップロードします。基本的には、モジュールファイル群を上書きする形になります。

D3モジュールのように、アップロードに注意するモジュール等がありますので、モジュールの説明をよく確認しておきましょう。

管理画面よりアップデート

アップロードが完了したら、管理画面の互換モジュール->モジュールの管理の画面のバージョン欄を確認します。

アップデートするモジュールのバージョン番号の横に、アップデートのアイコンが出ているので、これをクリックします。モジュールアップデートの確認という画面が出ますので、内容を確認後、アップデートのボタンをクリックしてください。

モジュールアップデートの終了という画面が出て、エラーが出ていなければアップデート完了です。

インストール時のトラブルの例

1. アップロードしたモジュールのアイコンが表示されない →modulesディレクトリにモジュールファイルが配置されていない →何らかの理由でxoops_version.phpが配置されていない

1. Fatal error: require() [function.require]: Failed opening required '/....../xoops_trust_path/modules/pico/x​oops_version.php' (include_path='.:/usr/local/lib/php') in /....../public_html/modules/pico/xoops_v​ersion.php on line 9 などと表示される →XOOPS_TRUST_PATHに適切にファイルが配置されていない

基本テンプレート

ブロックのテンプレート