Table of contents

• 携帯対応レンダラー
  • 概要
  • インストール
    • HypCommonFuncのアップロード
      • 簡単導入パック
      • 簡単導入パックのアップロード方法
    • パーミッション設定など
    • HypCommonPreLoad
      • XOOPS Cube Legacy の場合
      • XOOPS 2 の場合
      • HypCommonPreLoadの設定
  • アップデート
  • アンインストール
  • 知っておくべき事
  • 設定 (hyp_preload.conf.php)
    • 携帯対応レンダラーを有効に
    • サイトごとの設定
      • 各設定値のキー名に #[XOOPS_URL] を付加する方法
      • XOOPS_ROOT_PATH(html側)/class/hyp_common/hyp_preload.conf.php にて設定する方法
    • 携帯端末判定用 UA 正規表現
    • 携帯用テーマセット名
    • 携帯用XOOPSテンプレートセット名
    • 使用テンプレート名
    • ブロックのコントロール
    • インラインイメージのリサイズ最大ピクセル
    • インラインイメージを表示するホスト名
    • リダイレクトスクリプトを経由しないホスト名
    • 簡単ログイン設定
  • XOOPS のテーマ調整
    • HTML 再構成用タグの説明
  • 使用方法
  • 管理画面
  • ブロック
  • イベント通知の種類
  • Tips
  • よくある質問
    • XCLサイトのWizMobileで使用しているテーマ下テンプレートは、X2やXCLサイトの携帯対応レンダラーで共用できますか？
    • d3forumで、ゲスト書き込みができません
  • ライセンス
  • 関連モジュール

携帯対応レンダラー

　XCLだけでなく、X2サイト丸ごと携帯対応してくれるレンダリングシステム。HypCommonFuncの中の１機能として提供される。

機能

携帯アクセスのための、レンダリング、簡単ログイン、不要タグ削除、外部サイトリンク用リダイレクト、テーマ下テンプレートの利用、携帯絵文字入力と表示、など

種別

ユーティリティ　（非モジュール）

作者

nao-pon

バージョン

HypCommonFunc(XOOPSマニア) Ver 20090125

動作環境

XOOPS2.0 (XOOPS2.0.16a-JP以外未検証？)
XOOPS Cube Legacy 2.1
HypCommonFunc使用、HypCommonPreLoad適用

配布元

XOOPSマニア

複製

概要

　X2、XCLどちらのサイトも、同じ形式で携帯対応が可能となるレンダラーシステム。　X2サイトを携帯レンダラーで運用していて、XCLサイトの操作性も統一しておきたい場合にも有効。 　XOOPS2の場合、プリロードのインストールと設定に一手間かかります。

インストール

HypCommonFuncのアップロード

簡単導入パック

CVS からダウンロードする最新版は解凍後のディレクトリ構造が異なっているため、アップロード作業が煩雑になりますので、ディレクトリ構造を整理した簡単導入パックが用意されています。（ただし、バージョンが若干古い場合があります。）

簡単導入パックのアップロード方法

サーバーにアップロードする場合は以下のように行ってください。

1. html ディレクトリの中身を XOOPS_ROOT_PATH へアップロード。
2. xoops_trust_path ディレクトリの中身を XOOPS_TRUST_PATH へアップロード。
3. XOOPS 2 系のみ、core_addons/html_2.0.16aJP ディレクトリの中身を XOOPS_ROOT_PATH へアップロード。
   (XOOPS Cube Legacy の場合は、このディレクトリは必要ありません。)
4. パーミッション設定などを参照して適切に設定する。
5. 必要に応じて、K-tai_emoji.zip を解凍後、html ディレクトリの中身を XOOPS_ROOT_PATH へアップロード。

パーミッション設定など

• ファイル作成権限が必要なディレクトリ (例: 707 など。ディレクトリがなければ作成する。)
• [html側]
  • XOOPS_ROOT_PATH/class/hyp_common/cache
• [trust側]
  • XOOPS_TRUST_PATH/cache (簡単ログイン機能で使用します)
  • XOOPS_TRUST_PATH/class/hyp_common/favico​n/cache

HypCommonPreLoad

HypCommonFuncを導入します。

1. Ver 20080604 以降では、すべての機能が無効になっていますので、必要に応じて各機能を有効にしてください。

XOOPS Cube Legacy の場合

1. Cube の XOOPS_ROOT_PATH/preload ディレクトリに アーカイブの html/preload/HypCommonPreLoad.class.php をアップロードされていることを確認してください。
   

XOOPS 2 の場合

1. 以前に HypCommonFunc, 検索語マーカー, BBQあらしお断りシステム などを 組み込んでいた場合は、common.php を元の状態に戻します。
2. 検索語マーカー を組み込んでいた場合は、XOOPS_ROOT_PATH/footer.php を元の状態に戻します。
3. XOOPS_ROOT_PATH/include/common.php を編集します。

   // ############## Include common functions file ##############
   include_once XOOPS_ROOT_PATH.'/include/functions.php';
   

   の下に

   // ############# Set Query Words & Load HypCommonFunction Class #############
   include_once XOOPS_TRUST_PATH . '/class/hyp_common/preload/hyp_preload.php';
   $HypCommonPreLoad = @ new HypCommonPreLoad();
   $HypCommonPreLoad->preFilter();
   

   を挿入。

   if (file_exists('./xoops_version.php')) {
   

   の上に

   // ############# POST Filter with HypCommonPreLoad #############
   $HypCommonPreLoad->postFilter();
   

   を挿入。 面倒な人のために、ハック済み版のcommon.phpが用意されています。

HypCommonPreLoadの設定

• • HypCommonPreLoad の設定を行ってください。
    
    

アップデート

アップロード済のHypCommonFunc各ファイルを更新するだけで完了です。（設定が追加されていれば、編集します。）

アンインストール

1. XCLの場合　アップロード済のHypCommonFunc各ファイルを削除すれば完了です。
2. X2の場合　更に、xoops_root_path/common.phpを元に戻す必要があります。

知っておくべき事

（使用方法を説明する前に知っておくべき概念や用語などの説明）

設定 (hyp_preload.conf.php)

• "XOOPS_TRUST_PATH/class/hyp_common/prelo​ad/hyp_preload.conf.php" を編集して設定をします。該当ファイルがない場合は、同じディレクトリに含まれている "hyp_preload.conf.php.rename" をリネームしてください。
• 複数のサイトを１つのtrust_pathで運用している場合は、"XOOPS_ROOT_PATH/class/hyp_common/hyp_pr​eload.conf.php" を編集してサイト毎に設定を変えることができます。該当ファイルがない場合は、上記trust側ディレクトリに含まれている "hyp_preload.conf.php.rename" をリネームしてください。
  

以下、携帯対応レンダラー関連の設定項目

携帯対応レンダラーを有効に

• • 有効にするには、「1」とします。

     // 各機能のメインスイッチ (On = 1, Off = 0)
     $this->use_k_tai_render      = 0; // 携帯対応レンダラーを有効にする
    

サイトごとの設定

$this->k_tai_conf の各設定は、サイトごとに行う必要がある場合がありますので、サイトごとの設定方法を説明します。

方法は、2種類あります。

各設定値のキー名に #[XOOPS_URL] を付加する方法

この方法では、XOOPS_TRUST_PATH 側 (XOOPS_TRUST_PATH/class/hyp_common/prelo​ad/hyp_preload.conf.php) で各サイトごとに設定できます。

例えば、$this->k_tai_conf['disabledBlockIds'] の設定を http://www.xugj.org に対して行いたい場合は、

1

$this->k_tai_conf['disabledBlockIds#http://www.xugj.org'] = array('55','63','154','67','106','34');

のように設定します。

※ trust側で設定する場合は、XOOPS_ROOT_PATH/class/hyp_common/hyp_pre​load.conf.php を設置してはいけません。

XOOPS_ROOT_PATH(html側)/class/hyp_common/hyp_preload.conf.php にて設定する方法

各サイトの XOOPS_ROOT_PATH/class/hyp_common に hyp_preload.conf.php に設置して設定を行います。

XOOPS_ROOT_PATH/class/hyp_common/hyp_pre​load.conf.php を設置すると、XOOPS_TRUST_PATH/class/hyp_common/preloa​d/hyp_preload.conf.php は読み込まれなくなります。

携帯端末判定用 UA 正規表現

• • この部分は変更なしで大丈夫ですが、３大キャリア以外も同様に携帯対応レンダラーを通したい場合は、「携帯端末判定用 UA 正規表現」に追加が必要です。

    // 携帯端末判定用 UA 正規表現
    $this->k_tai_conf['ua_regex'] = '#(?:SoftBank|Vodafone|J-PHONE|DoCoMo|UP\.Browser)#';
    

携帯用テーマセット名

• • /html/themes/ディレクトリ内に配置する、携帯用のテーマセット名です。　デフォルトではXOOPS_ROOT_PATH/themes/ktai_default/にモバイル用テーマセットがあります。 このテーマセットは通常のテーマセットと同様に複製したり改変することもできますが、"ktai_default"の部分を変更した場合は設定を変更する必要があります。

    // 携帯用テーマセット
    $this->k_tai_conf['themeSet'] = 'ktai_default';
    

携帯用XOOPSテンプレートセット名

• • ver20080818より、携帯用XOOPSテンプレートセットが使えるようになりました。　DBテンプレートに携帯用テンプレートを入れて使用する場合、ここにテンプレートセット名を記載します。

    // 携帯用XOOPSテンプレートセット
    $this->k_tai_conf['templateSet'] = '';
    

    　このとき、テンプレートセットの読み込み順は

    1. テーマ下テンプレート
    2. 上記設定による携帯用DBテンプレート
    3. 通常のDBテンプレート

　となります。

使用テンプレート名

• • xoopsのDBテーマセットの「default」を差すのではなく、XOOPS_TRUST_PATH/class/hyp_common/ktaire​nder/templates/default ディレクトリを指していて、このディレクトリには、携帯対応レンダラーで最終的に使うテンプレート header.html, body.html, footer.html が含まれています。

    // 使用テンプレート
    $this->k_tai_conf['template'] = 'default';
    

ブロックのコントロール

HypCoomoFunc Ver 20090111 以降(ktai_defaultテーマ)で、ブロックはサブメニューとしてタイトルを一覧表示するようになっています。

また、特定のブロックを常に表示したり、ブロックを無効にすることもできます。

• 特定のブロックを常に表示したい

  特定のブロックを、メインコンテンツと共に常に表示することができます。

  メインメニューやユーザーメニューは常に表示させておくと便利でしょう。

  設定は、

  // 常に表示するブロックの bid (Block Id) (メインメニューなど)
  $this->k_tai_conf['showBlockIds'] = array();
  

  で行います。

• 特定のブロックを無効にしたい

  特定のブロックを無効にすることができます。

  設定は、

  // 非表示にするブロックの bid (Block Id)
  $this->k_tai_conf['disabledBlockIds'] = array();
  

  で行います。

ブロックの設定を行う場合は、その性格上、必ずサイトごとの設定で行う必要があります。

設定方法は、ブロックIDを配列で指定します。例えば、ブロックID 3, 5, 10 を非表示にしたい場合は、次のようになります。

// 非表示にするブロックの bid (Block Id)
$this->k_tai_conf['disabledBlockIds'] = array(3, 5, 10);

XOOPS 2.0.16a JP での注意事項

XOOPS 2.0.16a JP で運用している場合は、HypCommonFunc Ver. 20080916 以降に含まれる header.phpのハック版 ( core_addons/html_2.0.16aJP/header.php ) を忘れずに XOOPS_ROOT_PATH へアップロードする必要があります。

インラインイメージのリサイズ最大ピクセル

• • HypCommonFunc Ver. 20080820.1以降、携帯対応レンダラーで大きなサイズのインラインイメージをリサイズし、リサイズ後の画像を出力するようになりました。　リサイズ後のサイズは、規定値で Width:200px, Height:200px の範囲に収まるようになっていますが、下記設定値の書き換えで変更できます。

// インラインイメージのリサイズ最大ピクセル
$this->k_tai_conf['pictSizeMax'] = '200';

インラインイメージを表示するホスト名

• 外部サイトのイメージを埋め込んで表示するには、そのサイトのURLをここで指定する必要があります。
  • 閲覧端末から外部サイトへ直接アクセスさせない場合
  • ここで指定したホストの画像はサーバー上にキャッシュしたファイルを参照しますので、閲覧端末から外部サイトへのアクセスはありません。

    // インラインイメージを表示するホスト名(後方一致)
    $this->k_tai_conf['showImgHosts'] = array('amazon.com', 'yimg.jp', 'yimg.com', 'ad.jp.ap.valuecommerce.com', 'ba.afl.rakuten.co.jp', 'assoc-amazon.jp', 'ad.linksynergy.com');
    

  • 閲覧端末から外部サイトへ直接アクセスさせる場合
  • ここで指定したホストの画像は、閲覧端末から直接外部サイトにアクセスします。閲覧者を保護するため信頼できるサイトのみ指定してください。

    // 直接画像を表示するホスト名(後方一致)
    $this->k_tai_conf['directImgHosts'] = array('google-analytics.com');
    

リダイレクトスクリプトを経由しないホスト名

• • リダイレクトスクリプトを経由せずに直接ジャンプさせるには、そのサイトのURLをここで指定する必要があります。

    // リダイレクトスクリプトを経由しないホスト名(後方一致)
    $this->k_tai_conf['directLinkHosts'] = array('amazon.co.jp', 'ck.jp.ap.valuecommerce.com');
    

    // 外部リンク用リダイレクトスクリプト
    $this->k_tai_conf['redirect'] = XOOPS_URL . '/class/hyp_common/redirect.php?l=';
    

簡単ログイン設定

• • 簡単ログインを使用するには、ここで設定します。

    // Easy login を有効にする
    $this->k_tai_conf['easyLogin'] = 1;
    // Easy login で IP アドレス帯域をチェックしない
    $this->k_tai_conf['noCheckIpRange'] = 0;
    // リンクメッセージ
    $this->k_tai_conf['msg']['easylogin'] = '簡単ログイン';
    $this->k_tai_conf['msg']['logout'] = 'ログアウト';
    

XOOPS のテーマ調整

HypCommonFunc Ver 20080717 以降では、デフォルトで携帯対応レンダラー専用のテーマセット(ktai_default)を使用し、各モジュールのテーマ下テンプレートに対応しています。

• • 携帯対応レンダラー専用のテーマセットを使用しない場合は、設定で

    // 携帯用テーマセット
    $this->k_tai_conf['themeSet'] = '';
    

    とします。その場合は、通常のテーマセットが使用されます。）

通常使用するテーマセットが DIVレイアウトの場合は、そのままでもある程度、携帯で見やすい形で表示されますが、TABLE レイアウトの theme では、コンテンツ部分を先に表示したりと、HTMLの再構成をしないと、実用的でない場合があります。

HTML の再構成をする場合は、携帯対応レンダラーが適切に部分抽出できるように、簡単なタグを仕込む必要があります。

HTML 再構成用タグの説明

使用できるタグは、設定項目にある「HTML再構築用タグ設定」のキーワードを利用したタグなります。規定値では、次のタグが使えます。

"<!--HypKTaiIgnore-->" 以外のそれぞれのタグで囲まれた範囲が、XOOPS_TRUST_PATH/class/Hyp_common/ktaire​nder/templates/default ディレクトリ内にある

• header.html [ページヘッダ]
• body.html [コンテンツ部分(必要に応じて分割され、ページナビゲーションが付加されます)]
• footer.html [ページフッタ]

各ファイルの該当キーワードタグと置換され、「HTML再構築用タグ設定」の 各キーの 'above' の内容が前方に、'below' の内容が後方に挿入されます。

例外として、"<!--HypKTaiIgnore-->" と "<!--/HypKTaiIgnore-->" で囲まれた範囲は、出力から除去されます。*1

例えば、XOOPS Cube Legasy の "cube_default" テーマにおいて、"leftcolumn" を設定する場合は、theme.html に、次のような箇所があると思います

<{if $xoops_showlblock == 1}> <td id="leftcolumn" class="leftcolumn"> <!-- Start left blocks loop --> <{foreach item=block from=$xoops_lblocks}> <div class="leftblockTitle"><{$block.title}></div> <div class="leftblockContent"><{$block.content}></div> <{/foreach}> <!-- End left blocks loop --> </td> <{/if}>

これを次のようにします。

<{if $xoops_showlblock == 1}> <td id="leftcolumn" class="leftcolumn"> <!-- Start left blocks loop --> <!--leftcolumn--> <{foreach item=block from=$xoops_lblocks}> <div class="leftblockTitle"><{$block.title}></div> <div class="leftblockContent"><{$block.content}></div> <{/foreach}> <!--/leftcolumn--> <!-- End left blocks loop --> </td> <{/if}>

注意すべき点は、<{foreach ... }> ～ <{/foreach}> を崩さないようにすることです。

また、携帯対応レンダラーを使っている場合は、Smarty変数の $smarty.const.HYP_K_TAI_RENDER が TRUE になりますので、この値で、場合分けができます。

このようにして、携帯対応レンダラー用タグを仕込んだ "cube_default" テーマの theme.html が提供されています。

使用方法

1. 携帯電話から、PCと同じURLにアクセスします。
2. ページ上部の[簡単ログイン]のリンクからログインをすると、次回からは[簡単ログイン]からアクセスするだけでログインできます。
   • アカウント情報のページで、簡単ログインの設定・解除を行うことができます。
   • 一つのアカウントに複数の端末を登録することができます。
   • 一台の端末に複数のアカウントを設定することはできません。

管理画面

今のところありません。

ブロック

ありません。

イベント通知の種類

ありません。

Tips

よくある質問

XCLサイトのWizMobileで使用しているテーマ下テンプレートは、X2やXCLサイトの携帯対応レンダラーで共用できますか？

　モバイルテンプハウスで配布中の単純に簡素化しただけのテンプレートであれば、基本的には問題なく共用できるはずです。　mbxoopsさん配布のテーマ下テンプレートは、そのままでは動かないこともあるかも知れません。（未検証）

d3forumで、ゲスト書き込みができません

　d3forum では、スパム対策のデフォルトフィルターで、ゲスト投稿時に JavaScript を利用してフィルタリングを行っていますが、このフィルターが有効になっていると、ゲストが携帯で投稿することができません。 　これを回避するには、ここに書かれた方法でd3forum側の手立てが必要です。

ライセンス

GPL

関連モジュール

XOOPS Module Manuals

• モジュールマニュアル雛形

動的コンテンツ用モジュール

• Bulletin1
• Bulletin2
• xediter
• d3blog
• d3diary
• d3forum
• d3pipes
• myAlbum-P
• mydownloads
• d3downloads
• cinemaru
• mylinks
• cubookmarken
• FlatData
• newbb1.0
• news1.1
• piCal
• opCal
• xhld
• xhnewbb
• xoopsfaq
• xoopsheadline
• xoopspoll
• hdpoll
• Xwords
• xpwiki
• QuickCART

静的コンテンツ用モジュール

• TinyD
• pico
• wraps
• none
• D3none
• sections

その他コンテンツ用モジュール

• InquirySP（お問合せスペシャル）
• contact
• liaise
• sitemap
• admanage

システム補助モジュール

• tplsadmin
• multimenu
• blocksadmin
• altsys
• dbtheme
• XOOPS検索
• xanhte
• WizMobile
• HypCommonFunc

ユーティリティ系モジュール

• protector(旧バージョン用)
• protectorV3
• XOOPS_Analyzer3
• xoopsmembers
• xoopspartners
• waiting
• CubeUtils

WizMobile(ウィズモバイル)

機能

携帯対応

種別

ユーティリティ

作者

gusagi

バージョン

0.52

動作環境

XOOPS Cube Legacy 2.1 (2.2動作不可）

配布元

http://www.gusagi.com/

複製

メニュー

概要

モジュールをインストールするだけで、XOOPS Cube Legacyで構築したサイトを携帯でも利用可能にするモジュールです。

• XOOPS Cube Legacyで構築したサイトを携帯でも利用可能
• 日本の携帯キャリアごとに、出力するエンコーディングを変換
• ブロックを含め、PCとほぼ同じ内容を携帯でも操作可能（Java Scriptは対象外）
• 簡単ログイン
• 非表示ブロックの設定
• 携帯のみ表示するブロックの設定(0.40以降)
• ページ分割 (PHP5以上のみ有効、0.25以降有効・無効設定)
• 画像リサイズ (GDライブラリが存在する環境のみ有効)
• Google、Yahooの携帯用検索エンジン対応
• 送出するコンテンツタイプの設定(0.25以降)
• 通常であれば /modules/mobile/ となりますが、mobile というフォルダ名を，重複しない任意のフォルダ名に変更することが可能です。ただし複製して利用することはできません。(必要ありません)
• X2非対応なので、[Duplicatable V3]ではありません。
• cssファイルの読込も可能(0.27以降ただしdocomo端末では非対応)
• モジュール制御機能(0.30以降)
• 携帯用テンプレートセットの設定(0.30以降)
• png画像をgif画像に変換(0.30以降)
• 絵文字対応（PCの場合は絵文字画像を表示・0.40以降）
• 絵文字入力支援(0.41以降)
• テーマ制御機能
• Google Adsense Mobile対応(0.40以降)
• 外部CSS対応(0.43以降)
  • 外部CSS用のフィルター有効/無効設定(0.51以降)
• ブロック表示方法の設定(タイトルのみ表示/全て表示/非表示)

なお、このモジュールですべての機能が携帯で利用できるわけではありません。

インストール

XOOPS_TRUST_PATHの設定が必要です。

旧バージョンファイル(0.1x)の削除

「ホダ塾ディストリビューション」には最初からWizmobileが準備されているので、旧バージョンは削除する。

※0.2xの場合は必要ありません ※XCL2.1xは旧バージョンファイルはないはずです。

1. 1. XOOPS_ROOT_PATH/modules/mobileを削除
   2. XOOPS_TRUST_PATH/modules/wizmobileを削除
   3. XOOPS_TRUST_PATH/modules/wizxcを削除
   4. XOOPS_TRUST_PATH/wizinを削除
      

新しいパッケージのアップロード

1. 1. 新しいパッケージのxoops_trust_path配下をXOOPS_TRUST_PATHにアップロード
   2. 新しいパッケージのhtml配下をXOOPS_ROOT_PATHにアップロード

※HD-1.0.1b以下のバージョンをご利用の方は、こちらのファイルを上書きアップロードする必要があります。

パーミッションの変更

1. 1. XOOPS_TRUST_PATH/cacheのパーミッションを777に変更
   2. XOOPS_ROOT_PATH/uploads/wizmobileのパーミッションを777に変更

※XOOPS_ROOT_PATH/uploadsのパーミッションが777からアップロードで変更されたら777戻しておく

設定ファイルのコピー

※「ホダ塾ディストリビューション」の場合はこの設定は不要です。

1. 1. XOOPS_TRUST_PATH/modules/wizmobile/site_​custom.ini.phpをXOOPS_ROOT_PATH/settingsにコピーする。

既にsite_custom.ini.phpが存在する場合は、[RenderSystems][Legacy][Legacy_Controlle​r][Legacy_WizMobileRenderSystem]に関する記述を追記して下さい。

管理画面からモジュールインストール

管理画面からモジュールのインストールをしてください。

picoのURL書き換え

picoモジュールを利用していて".htaccess.rewrite_normal"によるURL書き換えを行っている場合は下記の追加設定が必要となる。

1. 1. XOOPS_TRUST_PATH/modules/wizmobile/.htac​cess.rewrite_normalをXOOPS_ROOT_PATH/modules/{pico名}/.htaccessに上書きコピーする。

※picoモジュールを複数設置している場合は、すべて同様にコピーする。

アップデート

0.1xからもしくは0.20からのアップグレードは一部方法が違います。

旧バージョンファイルの削除

※0.21以降の場合は必要ありません

1. 1. XOOPS_ROOT_PATH/modules/mobileを削除(0.1xからの場合)
   2. XOOPS_TRUST_PATH/modules/wizmobileを削除(0.1xからの場合)
   3. XOOPS_TRUST_PATH/modules/wizxcを削除(0.1xからの場合)
   4. XOOPS_TRUST_PATH/wizinを削除(0.1x、0.20からの場合)
      

新しいパッケージのアップロード

1. 1. 新しいパッケージのxoops_trust_path配下をXOOPS_TRUST_PATHにアップロード
   2. 新しいパッケージのhtml配下をXOOPS_ROOT_PATHにアップロード

※0.22以前からのバージョンアップする場合は、こちらのファイルを上書きアップロードする必要があります。

パーミッションの変更

1. 1. XOOPS_TRUST_PATH/cacheのパーミッションを777に変更
   2. XOOPS_ROOT_PATH/uploads/wizmobileのパーミッションを777に変更

※XOOPS_ROOT_PATH/uploadsのパーミッションが777からアップロードで変更されたら777戻しておく

管理画面からモジュールアップデート

管理画面からモジュールのアップデートをしてください。

アンインストール

通常通り、モジュール管理よりアンインストールします。

ファイルをサーバから削除するときは、XOOPS_ROOT_PATH側だけ消します。

XOOPS_TRUST_PATH側をフォルダ削除(wizin,modules/wizmobile,modules/wizxc)を削除すると、真っ白になる現象があった事を追記しておきます。こちらを削除する場合は注意が必要です。もし、真っ白になった場合はアップロードし直す事で復帰します。こちらを消す方法については更なる調査が必要です。

知っておくべき事

• 現時点では開発版とされています。
• このモジュールを使用することで何らかの問題が発生した場合、開発者は責任を負いかねます。 使用する上でのリスクについては利用者自身で判断してください。
• WizMobileのアイコンは、Argon氏が作成して下さいました。
• WizMobileで利用しているテーマ下テンプレート、並びにGチケットはGIJOE氏が開発したものを利用しています。
  

使用方法

基本的にインストールすれば携帯からアクセスできるようになります。

管理画面

Wizmobile0.20以降は管理画面より各種設定や状況確認が行えるようになりました。

※0.1xでは管理画面はなかったので設定ファイルにて設定をするようになっていました。

ここでは0.2xを対象としてWizmobileの管理画面について説明する。

システム状況

Wizmobileに関するシステム状況を確認できます。 有効/無効でステータスが表示されます。

ここで無効と表示されているとその機能が利用できないことになります。

【コントローラの換装】

この項目が無効になっていたらWizmobileが機能しないと思います。(違っていたらゴメンナサイ)

無効になっているようならWizmobileの動作環境があっているか再確認して下さい。

動作環境に問題ないようでしたら、インストール手順に間違いがなかったか確認してください。

【画像のリサイズ】

この項目が無効になっていたらWizmobileの自動画像リサイズ機能が利用できません。

この機能はGDを利用しているようなので、サーバ側の設定によりステータスが変わります。

有効にするにはサーバ設定を変更する必要があります。

【ページ分割】

この項目が無効になっていたらWizmobileのページ分割機能が利用できません。

有効にするにはサーバ設定を変更する必要があります。

ブロック制御（非表示ブロックの設定）

0.20より追加された機能です。

携帯でアクセスした場合にブロックの表示/非表示が設定できます。

「非表示」チェックボックスをチェックすると対象のブロックは携帯でアクセスした場合に表示されなくなります。

モジュール制御

0.30より追加された機能です。

携帯でアクセスした場合にモジュールの表示/非表示が設定できます。

「除外」チェックボックスをチェックすると対象のモジュールは携帯でアクセスした場合にアクセスできなくなります。
(メインメニューブロックにも表示されなくなります。)

一般設定

Wizmobileの一般設定画面です。 各種基本的な設定をすることができます。

テンプレートセット

（ブロックと基本の区別は不要）

Tips

モバイル(携帯)用のテーマセット

携帯電話からアクセスしたときのテーマセットは、管理者メニューの「全般設定」で設定したテーマセットと異なります。

デフォルトではXOOPS_ROOT_PATH/themes/mobile/にモバイル用テーマセットがあります。

このテーマセットは通常のテーマセットと同様に複製したり改変することもできますが、"mobile"の部分を変更した場合はWizMobileの管理者画面(一般設定)から設定する必要があります。

テーマセットの構成

モバイル用テーマセットの基本構成は下記のようになっています。

テーマ下テンプレート

例えば、ユーザーモジュールのテンプレートをカスタマイズした場合はWizMobileで、wmb_defaultを携帯用テーマとして使っていた場合は、wmb_default/templatesにもテーマ下テンプレートを用意して訂正する必要があります。

システムや他のモジュールもPCとテンプレートを分けて表示したい場合はこちらにファイルを作って行けば別画面で出力できます。d3moduleの場合は以下の様な配置に作る必要があります。

/xoops_root_path/themes/(theme名)/templates/(trustdirname)/(tpl_name)

作り置きの物は、モバイル テンプハウスさんMBXOOPSさんがある程度用意してありますのでそちらからダウンロードする事が可能です。以下、現存する携帯専用テンプレート一覧です。

現存する携帯専用テンプレート一覧

モバイル テンプハウス

   Templates/モジュール間適応表
   Templates/cubeutils
   Templates/d3blog
   Templates/d3diary
   Templates/d3forum
   Templates/d3pipes
   Templates/Legacy
   Templates/logcounterx
   Templates/message
   Templates/minidiary
   Templates/myalbum
   Templates/pical
   Templates/pico
   Templates/PM
   Templates/system
   Templates/user
   Templates/XSNS
   Templates/xwords

よくある質問

Q:一般設定で「テーマ」を選択できない。テーマが反映されない

A:サーバーへアップロードする際に　XOOPS_ROOT_PATH/themes/mobile/ の中にある 　「.legacy_wizmobilerendersystem」というファイルが正しくアップされているか確認してください。

Q:セッションが頻繁に切断されてしまう。

A:基本的には15分間レスポンスがない場合はセッションは破棄されてしまいます。 　また携帯からアクセスすると頻繁にIPアドレスが変わってしまうためprotectorモジュールを利用している場合は、 　「IP変動を禁止するグループ」のユーザの場合は15分以内であってもIPアドレスが変更されるとセッションが切断されてしまいます。 　(protectorの初期設定では管理者グループは「IP変動を禁止するグループ」になっています。)

Q:wizmobileをセットするとXOOPSのMySQLデバグポップアップが開かない(ver.WizMobile 0.52)

A:携帯検索クローラのための

 <link rel="alternate" media="handheld" type="text/html" href="<{$xoops_url}>/" />

をテーマのhead部に自動挿入されます。この　"　が　デバグポップアップが開かなくなる原因です。
(シングルコーテイションで書いてよと、バグだと言いたいけど)
テーマにあらかじめ上記の記述されていると、自動挿入されません、テーマに上記の記述を入れておくとMySQLデバグポップアップは開きます。

ライセンス

本モジュール自体のライセンスはGPL2ですが、修正BSDライセンスのフレームワーク"Wizin"に依存しています。

関連モジュール

XUGJプロジェクト一覧

作業中

QuickReference
CustomizeManual
ModuleManuals
Smarty小ネタ
多言語化資料
ホダ塾ディストリビューション
XCl2.2 PACK 201X ディストリビューション
XCLBasicManual
携帯対応

終了

BasicManual目次

XCl PACK 201X ディストリビューション

XCl PACK 2011

Pack2011 は XOOPS Cube の 2011年におけるトレンドを凝縮したディストリビューションです。このパッケージをインストールするとサンプルサイトがセットアップされ、有志により厳選されたモジュールが日本語(UTF-8)/英語環境で稼働します。

仕様概要

• XOOPS Cube 2.2.1 最新Branch Rev（Core URL参照）を基準とします。
• コアの言語は英語と日本語がインストールフォルダ等に存在し、日本語でインストールが可能です。他の言語はextrasフォルダに存在します。
• モジュールの言語は最低限英語と日本語がインストールフォルダ等に存在し、その他の言語も場合によってはモジュールフォルダに存在します。extrasフォルダにもモジュールファイルは配置されますがas-isで予備的なものです。
• 2012年は自動ダウンロード・インストールの起点サイト整備を目指します。(現段階では未実装)
• 以下のモジュールがモジュールフォルダに存在しブラウザだけで利用可能です。

システム系

1. altsys（システムモジュール）
2. Protector（セキュリティ）
3. MultiMenu（メニュー）
4. CubeUtils（ユーティリティ）
5. HypCommonFunc（携帯・スマホ対応：非モジュール）
6. hypconf（HypCommonFuncの設定用モジュール）
7. openid（OpenID認証）

コンテンツ作成

1. pico（静的ページ作成）
2. Bulletin（ニュース）
3. D3forum（フォーラム）
4. Xpress（ブログ）
5. xpWiki（Wiki）
6. d3pipes（RSSリーダー）
7. GnaviD3（マップ）

• Responsive Web Designベースのデフォルト・テンプレートが存在し、スマートフォン、Android/iPad,Mac/Windowsの全デバイスで最適なサイズで表示されます。

Developer's Document

パッケージ開発者用のドキュメント

• • Packaging Docs

InquirySP（お問合せスペシャル）

機能：メールフォーム
種別：その他コンテンツ
作者：Marijuana
バージョン：1.02 (本文は0.92時点のものです）
動作環境：XOOPS2.0〜、俺的XOOPS
配布元：配布終了
複数設置：モジュール単位、フォーム単位いずれも可能

メニュー

概要

必須項目の設定ができ、入力内容の確認画面を持つフォームを作成できます。フォームごとに送信先を設定でき、複数の送信先も設定できます。また自動返信機能もあります。
XOOPS のテンプレートシステムを使わずに、モジュール内の「templates」フォルダにある設定ファイルを編集することで、フォームを作ります。ここにあるテンプレートファイルを複製することで、いくつでもフォームを作成することができます。
また、フォルダの名前を自由に設定でき、複製を作ることで、いくつでもモジュール単位での複数設置ができます。これによりほぼ無限にメールフォームが増やせます。

インストール

インストールは通常の方法ですが、これだけではデフォルト状態のフォームしか利用できません。管理画面というものが一切存在しないので、希望するフォームに変更するにはテンプレートファイルを直接編集しなければなりません。

使用方法

インストールの項で述べたように、このモジュールには管理画面が存在しません。
思い通りにフォームを変更するにはテンプレートファイル（デフォルトの場合はinquiry_form_0.html）を直接編集します。
これにはHTMLタグの知識と多少のPHPコードへの理解が必要です。先ずサンプル（inquiry_form_0.html）を参考に編集します。
※0.70以前と以後ではテンプレートの仕様が異なっています。0.70以前で作成したテンプレートをそれ以後のバージョンに組み込むと問題が起こる場合があります。
[最近のテンプレートにおける重要な変更点]
テンプレート上部のphpソース内に「自動返信時のテンプレート埋め込み設定」が追加されています。さらにセッションへの代入値に$inq_req->set_session_vars($req_r,'inqr'​);が追加されています。

HTML内の変更

が

に変更になっています。

フォーム項目の追加・編集

template/inquiry_form_0.htmlのソースを見ると上部に「/* * フォームの設定 * */」という部分があります。ここで最初に必要となるフォーム項目を設定します。
書式は「$inqtmp[エレメント名] = array(項目名,型,必須)」という形式で、いくつかサンプルとして最初から入っていますが、これを変更することも可能です。また、エレメント名が重複しなければいくつでも増やすことが出来ます。

メールの送信先

ソース上部の「メールの送信先」を編集します。メールを受け取る人が一人であれば、$req_m = に、ソース中にある例にならってメールアドレスをひとつ入れておきます。
空欄時は XOOPS の管理画面で設定したサイト管理者がメールの受取人になります。
複数の人にメールを配信したい場合は、これもソース上にある例をコピーして、$req_m = array(); のなかに、シングルクォーテーションで囲んだメールアドレスをカンマ区切りで複数並べます。

メールの件名

ソース上部の「メールの件名」を編集します。デフォルトでは「お問合せ」となっているので、これを書き換えます。

自動返信時のテンプレート埋め込み設定

デフォルト状態では'name','note','mail','sex','job'の値になっています。
上部の「フォームの設定」で追加や変更をした場合、ここを同じ値に変更します。
もし自動返信時に入力値を埋め込まない場合は、例文に従って値をfalse;にして下さい。

フォーム項目のHTMLソース部での書き方

通常のテキストフィールド

ソース上部「/* * フォームの設定 * */」で、

$inqtmp['furigana'] = array('ふりがな','text','0');

とした場合。

<label for="furigana">ふりがな</label>
<input id="furigana" type="text" name="inqv[furigana]" value="<{$furigana}>" />

value の値を入れておくことで、確認画面から入力ミスで戻ってきたときに、値が保存されます。

テキストエリア（長文）

ソース上部「/* * フォームの設定 * */」で、

 $inqtmp['addrs'] = array('住所','tarea','0');

とした場合。

<label for="adrs">住所</label>
<textarea id="adrs" name="inqv[addrs]" cols="36" rows="3"><{$addrs}></textarea>

col と rows で入力領域のサイズを指定します。textarea の内容を入れておくことで、確認画面から入力ミスで戻ってきたときに、値が保存されます。

ラジオボタン

ソース上部「/* * フォームの設定 * */」で、

$inqtmp['sex'] = array('性別','option','0',array('男','女','無回答'));

とした場合。

性別

<label><input name="inqv[sex]" type="radio" value="0"<{if $sex==0}> checked="checked"<{/if}> /> 男</label>
<label><input name="inqv[sex]" type="radio" value="1"<{if $sex==1}> checked="checked"<{/if}> /> 女</label>
<label><input name="inqv[sex]" type="radio" value="2"<{if $sex==2}> checked="checked"<{/if}> /> 無回答</label>

checked="checked" を value の値と同じもので囲むことで、確認画面から入力ミスで戻ってきたときに、値が保存されます。

チェックボックス

ソース上部「/* * フォームの設定 * */」で、

$inqtmp['job'] = array('職業','array','0',array('プログラマ','ニート','建築関係'));

とした場合。

HTML部分は

職業

<label><input id="job1" name="inqv[job][]" type="checkbox" value="0"<{if $job[0]==1}> checked="checked"<{/if}> /><label for="job1">プログラマ</label>
<label><input id="job2" name="inqv[job][]" type="checkbox" value="1"<{if $job[1]==1}> checked="checked"<{/if}> /><label for="job2">ニート</label>
<label><input id="job3" name="inqv[job][]" type="checkbox" value="2"<{if $job[2]==1}> checked="checked"<{/if}> /><label for="job3">建築関係</label>

のようにします。

inqv[エレメント名][]と、配列になっていることに注意してください。
これで、確認画面から入力ミスで戻ってきたときに、値が保存されます。
※チェックボックスの場合は、type を checkbox にします。

ドロップダウン

ソース上部「/* * フォームの設定 * */」で、

$inqtmp['sample'] = array('サンプル','option','0',array('サンプル１','サンプル２','サンプル３','サンプル４','その他'));

とした場合、フォームの側は下記のような記述になります。

<select name="inqv[sample]">
    <option value="0"<{if $sample==0}> selected="selected"<{/if}>>サンプル１</option>
    <option value="1"<{if $sample==1}> selected="selected"<{/if}>>サンプル２</option>
    <option value="2"<{if $sample==2}> selected="selected"<{/if}>>サンプル３</option>
    <option value="3"<{if $sample==3}> selected="selected"<{/if}>>サンプル４</option>
    <option value="4"<{if $sample==4}> selected="selected"<{/if}>>その他</option>
</select>

selected="selected" を value の値と同じもので囲むことで、確認画面から入力ミスで戻ってきたときに、値が保存されます。

自動返信メール

include フォルダに retmess_0.inc というファイルがあるので、これを編集します。EUC 形式で保存するようにしてください。
デフォルトでテンプレート（inquiry_form_0.html）の「自動返信時のテンプレート埋め込み設定」で設定済みの'name','note','mail','sex','job'が使用できるようになっています。（さらに言うとそれらの値はテンプレートで「エレメント名」として定義されています）
それぞれ{name}等と記述することにより値が代入できます。
注文フォームなどに使用する場合はテンプレート側の変更に従って、こちらも書き換えて下さい。

※0.97以下の自動返信メールのcheckbox項目についてちょっとしたバグがあります。
参考及び解決策：
http://www.xugj.org/modules/QandA/index.​php?post_id=2640

フォームの増やし方

モジュール単位で増やす場合

/modules/ フォルダ以下にある inquirysp フォルダを内容ごと複製し、XOOPS にインストールします。フォルダの名称は自由です。

テンプレートで増やす場合

1. inquiry_form_*.html のアスタリスクの部分に任意の数字を入れてファイルを複製します。
2. 増やしたファイルのフォームと問い合わせ内容を編集し、アップロードします。
3. /modules/contact/inquirysp/index.php?op=​* にアクセスすることでフォームが機能します。

?op= が省略されると ?op=0 となり、inquiry_form_0.html を読み込みます。
自動返信と確認画面は、それぞれ数字をあわせて「retmess_*.inc」と「inquiry_check_form_*.html」を作成します。それぞれ対応するものがない場合は、デフォルトのファイルを使用します。

ブロック

よくある質問

フォームを増やしてもメニューに追加されません

InquirySP でひとつのモジュール内にテンプレートを複製してフォームを追加しても、XOOPS のメニューには追加されません。なんらかの方法（MultiMenu等）で、フォームへのリンクを別途作ってください。 モジュール自体を複製して増やす場合は、メインメニューに自動的に追加されます。

メールアドレスは必須項目からはずせません

たとえ「フォームの設定」で、email を入力必須項目としなくても、この値は必須項目からはずせない仕様になっています。メールアドレスを持たない人からのお問い合せには、ダミーのアドレスを入力するように促してください。
readme の更新履歴によると，0.71 で， email は必須でなくすことができる仕様になっている様子です。

確認画面の送信ボタンのテキストを変更するには？

0.71より前のバージョンでは、送信判定を submit の値で確認していましたが、hidden の name="cmd" で確認するようになったので、送信ボタンの値が自由になりました。しかし、このinput を忘れないで入れるようにしてください。0.71以前は下記のとおり。

0.71

テンプレートファイル（inquiry_check_form_*.html）の当該箇所を編集します。

<input type="submit" name="cmd" value="送信" /> 

をたとえば、

<input type="submit" name="cmd" value="Submit" /> 

にします。
index.php の 154行目の値を、テンプレートファイルで設定したものにあわせます。
※デフォルトでは、「送信」になっています。

受信したメッセージが文字化けしてしまいます

こちら（xoops wiki）を参考にしてください。

Tips

• InquirySP のテンプレート内では、Smarty が使えますが、Tom_G3X さんの TinyD Smaryプラグイン（function.tinyD.php）も使えます。これを使うことで、フォーム自体は FTP を経由しないと編集できませんが、フォームに付帯する説明文などは TinyD で管理できます。

• hodaka氏がブログでInquirySPテンプレートのCSS化について記述しています。
  元になっているバージョンは古いのですが、参考にするには十分でしょう。
  http://www.kuri3.net/modules/weblog/deta​ils.php?blog_id=51
• InquirySP専用フォーム作成支援ツール
  1）banc氏がなんとInquirySPのフォーム用HTMLを自動生成できる秀丸マクロを公開しています。
  http://digicomfort.net/modules/mydownloa​ds/
  2）Mirijuana氏純正（？）フォーム作成ツール（Microsoft .NET Framework, Version 2.0が必要）
  http://marijuana.ddo.jp/~oreteki/modules​/mydownloads/singlefile.php?cid=1&lid=5
  3）jidaikobo氏作InquirySP フォーム作成支援 Applescript for Jedit X
  MacOSX Jedit X用
  http://www.jidaikobo.com/xoops/InquirySP​.scpt（参考スレッド）

ライセンス

Marijuana氏のモジュールはいつも少しひねったライセンスになっているのでご注意ください。
以前はクリエイティブ・コモンズでしたが、現在はGPL（一部非GPLファイルを含む）のようです。

このモジュールに限らず、個人作成のソフトウェアにはその作者の「想い」が詰まっています。インストールの前に同梱の「ライセンス」ファイルを事前に必ずお読みください。

はじめに

Smarty を使う上で知っておくと便利な小ネタ集です。
ここにあるものはとても便利ですが、でも、ここを読む前に、Smarty - コンパイリング PHP テンプレートエンジンを一読されることを強くおすすめします。

コンテンツ一覧

• テンプレートに他のテンプレートをインクルードしているときの処理分けSmarty小ネタ/​caller

基本的な文法

変数

基本的に <{$vars}> のように表記。<{ }> で囲むとsmarty変数処理になる。 PHP定数であれば、<{$smarty.const.MY_CONST_VAL}> のように参照も可能。

条件分岐 if/elseif/else文

変数の値によって処理を変えたい時に利用。

<{if $country eq "JPN"}>
	Japan
<{elseif $country eq "USA"}>
	United States of Ameria
<{else}>
	Welcome
<{/if}>

eqは==と同じ。neは!=と同じ。他は>や<=など。

ループ処理(section)

以下の場合だと$linksにassignされた配列で連続処理するので、section内では $link.xxx で参照が可能。

     <{section name=i loop=$links}>
       <{include file="db:main_link.html" link=$links[i]}>
     <{/section}>

なお、include fileで別のテンプレート呼び出しも可能。

ループ処理(foreatch)

sectionとほぼ同様。sectionよりもこちらを推奨。

<{foreach item=subcat from=$subcategories}>
<{$subcat.title}>
<{/foreach}>

現在のページ・モジュールを知る方法

主にテーマ(theme.html)で利用します。

トップページかどうか？

<{if $xoops_requesturi == '/index.php' or $xoops_requesturi == '/'}>

user.php などを見ているときに判定からはずせます。
※XOOPSをドキュメントルート以外にインストールしている場合（たとえば /html/ など）は，

<{if $xoops_requesturi == '/html/index.php' or $xoops_requesturi == '/html/'}>

とする。

また XCL だったら、

<{if ! $legacy_module}>

とすると、トップページ判定に近いことができるようです。
ただし、InquirySPモジュールには対応できないようです。 また、 カスタムブロックで{xoopsform}関連をphpコードで書いて表示すると、トップページでも{legacy_module}に legacy　の値が入ります。

XCLでも上記の例の$xoops_requesturiを使用した判定をするかですが /html/の部分がサイトにより異なるので、配布テーマとかには使えません。
XCLの場合、SCRIPT_FILENAMEをLegacy_Controllerも出来るだけセットしてくれるようなので、
案としては、同じ判定を

<{if $smarty.server.SCRIPT_FILENAME|basename == "index.php" and $smarty.server.SCRIPT_FILENAME|dirname|basename == $smarty.const.XOOPS_ROOT_PATH|basename}>

とすれば、サイト深さにかかわらず判定出来そうですが、どうでしょうね。

ルートコントローラかどうか？

トップページだけでなく、/user.php /userinfo.php /register.php なども含まれます。

<{if $xoops_dirname == false}>.....<{/if}> あるいは <{if !$xoops_dirname}>.....<{/if}>

なお、XCL以降はルートコントローラでもXCL必須モジュールが機能を受け持つものがあるため、/user.phpにはuser、/notifications.phpにはlegacy、/viewpmsg.phpにはpmなどとdirnameが付いてしまう物があります。

特定のページかどうか？

<{if $xoops_requesturi == '/modules/(modulename)/index.php'}>

など。
クエリストリングスを含むときは、＆記号を＆amp;にすることを忘れずに。

ある特定のモジュールだけの処理

<{if $xoops_modulename == "pico"}>
<{/if}>

XCLでは$xoops_modulenameが機能しないので

<{if $legacy_module == "pico"}>
<{/if}>

とする。

閲覧者が誰であるかを知る方法

テーマでもテンプレートでも利用される、ほぼ必須のテクニックです。

管理者かどうか？

<{if $xoops_isadmin}>
  (管理者だけに表示する部分)
<{/if}>

ログインしている時のみ表示

<{if $xoops_isuser}>
  (ログインユーザだけに表示する部分)
<{/if}>

ログインユーザ以外にユーザ情報を見せない（応用１）

テンプレート system_userinfo.html (XCL2.1であれば user_userinfo.html) のカスタマイズ(altsysでの編集を推奨)

<{if $xoops_isuser}>
  (元の内容)
<{else}>
  <p>個人情報保護のため、ログインユーザ以外は閲覧できません</p>
<{/if}>

なぜかルートコントローラuserinfo.phpをHackする、なんて方法ばかりが出回っているが、断然こっちの方が優れている。

一般ユーザ（管理者でもゲストでもないユーザ）のみ表示

<{if $xoops_isuser and $xoops_isadmin == false}>
  (一般ユーザだけに表示する部分)
<{/if}>

使いどころは不明

ゲストにのみ表示

<{if ! $xoops_isuser}>
  (ゲストだけに表示する部分)
<{/if}>

特定のユーザにのみ表示

<{if $xoops_uname == humptyDumpty}>
  (ユーザ名humptyDumptyだけに表示する部分)
<{/if}>

特定のグループにのみ表示

所属グループはアサインされていないので、テーマの先頭等で自力でアサインしておく必要がある。

<{php}>
	$this->assign( 'xoops_user_groups' , is_object($GLOBALS['xoopsUser']) ? $GLOBALS['xoopsUser']->getGroups() : array(XOOPS_GROUP_ANONYMOUS) ) ;
<{/php}>

これをtheme.htmlの先頭付近に挿入した上で、以下のような判断が利用できる。

<{if in_array(2,$xoops_user_groups)}>
   (「登録ユーザ」に所属するユーザだけに表示する部分)
<{/if}>

もちろん、上の2が目的とするグループ番号であり、XOOPS初期状態では、「登録ユーザ」に該当する。

ユーザIDから得られる様々な情報

<{1|xoops_user:'uname'}>

この場合は、ユーザID が 1 のユーザの uname を表示できます。
この他に

<{1|xoops_user:'name'}>

<{if 1|xoops_user:'user_viewemail' == 1 || $xoops_isadmin == true }>
  <{mailto address=1|xoops_user:'email' encode="javascript"}>
<{/if}>

<{1|xoops_user:'url'}>
<{1|xoops_user:'user_sig'}>

　 PMボタン

      <{if $xoops_isuser == true }>
           <a href="<{$xoops_url}>/modules/message/index.php?action=new&amp;to_userid=1">
           <img src="<{$smarty.const.XOOPS_URL}>/images/icons/pm.gif" alt="<{1|xoops_user:'uname'}>さんにプライベートメッセージを送る。" title="<{1|xoops_user:'uname'}>さんにプライベートメッセージを送る。" /></a>
     <{/if}>

ただし、このxoops_user modifierプラグインを使えるのは、XCL2.1.XCL2.2のみです。X2では利用できません。XCL2.1,XCL2.2依存のプラグインであるため、単純にファイルをX2にコピーしても動きません。

これと同様の機能を持つSmartyプラグインとして、modifier.xoops_userinfo.php などがありますが、それらはX2でも動作します。 　

XCL2.2ではプロファイルデータも取得出来ます

<{1|xoops_user:$key}>

と思ったら、エラーになりますね(XCL2.2ではバグで動かないです)

ユーザーアバターの表示

ユーザID が 1 のユーザーの場合

XCL2,1では

<img title="Avatar" alt="Avatar" src="<1|xoops_user_avatarize}>">

XCl2,2では、第1引数:uid ,第2引数:true=HTMLタグ付き ,第3引数:アバターをクリックしたときのリンク先url

　function smarty_modifier_xoops_user_avatarize($ui​d, $tag=false, $url=null)

• 第1引数:uidのみ指定

  <img src="<1|xoops_user_avatarize}>" title="Avatar" alt="Avatar" >

• 第2引数:true=HTMLタグ付きの出力

  <{1|xoops_user_avatarize:true}>
  これの出力は次の様なものになります
  <img src="アバターのurl" width="幅" height="高さ" alt="ユーザー名" >
  ただし、アバターが未登録のとき幅,高さが0になる?(バグなのでは)
  

• 第2引数:true 第3引数:アバターをクリックしたときのリンク先urlの例

  <{1|xoops_user_avatarize:true:"`$xoops_url`/userinfo.php?uid=1"}>

Cycle 関数によるカスタマイズ Tips

この関数は繰り返し処理するために使用します。主にtheme.html内で使用します。
使用できる属性名には name values print advance delimiter assign がありますが、XOOPS で使用するのは values です。
<{cycle values="a,b,c"}>の様に記述します。この場合は a b c a b c ... と循環されます。

theme.html 内で記述し style.css で利用する

例えば、 theme.html 内にある左ブロックタイトル部と、左ブロックコンテンツ部を囲っている<div>タグの class へ記述します。
そのクラスを style.css 内でそれぞれ指定。　背景色を赤、青、緑の繰り返しで表示させます。

theme.html 記述例

<td id="leftcolumn">
 <{foreach item=block from=$xoops_lblocks}>
  <div class="blockTitle_<{cycle values="a,b,c"}>"><{$block.title}></div>
  <div class="blockContent_<{cycle values="a,b,c"}>"><{$block.content}></div>
 <{/foreach}>
</td>

style.css 記述例

#leftcolumn .blockTitle_a,
#leftcolumn .blockTitle_b,
#leftcolumn .blockTitle_c {
	padding:3px 5px;
	color:#000000;
	font-weight:bold;
}
#leftcolumn .blockTitle_a {
       background: #f00;
}
#leftcolumn .blockTitle_b {
       background: #00f;        
}
#leftcolumn .blockTitle_c {
       background: #0f0;
}
#leftcolumn .blockContent_a,
#leftcolumn .blockContent_b,
#leftcolumn .blockContent_c {
	padding:5px;
}
#leftcolumn .blockContent_a {
       background: #fcc;
}
#leftcolumn .blockContent_b {
       background: #ccf;
}
#leftcolumn .blockContent_c {
       background: #cfc;
}

特定モジュール用テクニック

他のモジュールには利用できない点に要注意。

TinyD モジュールの id （コンテンツ番号）を取得

<{if $xoops_modulename == "tinyd0"}>
	<{if $id == 5}>
	5
	<{elseif $id == 2}>
	2
	<{else}>
	other
	<{/if}>
<{/if}>

※ TinyD でしか利用できません

pico のテンプレートで親カテゴリごとに処理を分ける

<{if 'hoge'|in_array:$category.paths_raw}>
hoge カテゴリにぶら下がるページを表示しているときの処理
<{/if}>

※ pico でしか利用できません

数値の表記

カンマ区切りで表示する方法

<{$value|number_format}>

カンマ区切りで、小数２位まで表示する方法

<{$value|number_format:2}>

日付の表記

「○年○月○日」と表示する方法１

date_format（日付のフォーマットを変える）という modifier をつかいます。

<{$story.posttime|date_format:"%Y年%m月%d日"}>

小ネタですが，音声環境ではスラッシュ区切りの日付が把握しにくくなっています。たとえば2006/9/1だと「いちぶんのきゅう，にせんろく」と読んだりします。ので，日本語環境だったら，なるべく年月日表記にしたほうがよいです。横文字環境であれば（横文字の場合によって，表記仕方自体ちがう場合もありますが）ハイフンでつなげるといいとおもいます。

さらに余談になりますが、date_formatは、すでにフォーマット済の年月日形式を、いったんUNIXタイムスタンプ形式に戻してから別のフォーマットに変更する修正子です。つまり、最初から年月日でしかアサインされていなければ、そこから時分秒を取り出すのは不可能です。

ある程度設計の新しいモジュールであれば、フォーマット済の年月日形式だけでなく、UNIXタイムスタンプ形式でもアサインしてくれているので、それを利用するのがベストです。
例えばこのような形になります。

<{"Y年n月j日"|date:$content.created_time}>

「○年○月○日」と表示する方法２

xugj_dateというsmartyプラグインを追加する、という手もあります。

xugj_date

これを使う場合、上の例は以下のように表記できます。

<{$story.posttime|xugj_date:"Y年m月d日"}>

xugj_dateであれば、01月の0を消すことも可能で、以下のように表記します。

<{$story.posttime|xugj_date:"Y年n月j日"}>

デフォルトだとNewマークが出ますので、それを避けるのであれば、以下のようにしてください。

<{$story.posttime|xugj_date:"Y年n月j日":"":""}>

タイムスタンプ形式を利用する場合でもxugj_dateがそのまま利用できます。

<{$content.created_time|xugj_date:"n月j日 H時i分":"最新":"新着":false}>

など。

新着に new 表示をする

Smartyプラグインxugj_dateを使いましょう。

xugj_date

xugj_dateを XOOPS_ROOT_PATH/class/smarty/plugins/ にコピーした上で、以下のように記述します。

<{$story.posttime|xugj_date:""}>

この場合、Newマークだけが表示されます。

文字列処理

メールアドレス収集bot対策

テンプレート system_userinfo.html (XCL2.1であれば user_userinfo.html)

<td class="odd"><{$user_email}></td>

この部分を見つけて、

<td class="odd"><{$user_email|replace:"@":" at "}></td>

と書き換える。
（もうちょっと凝ったパターンの方が良いかも）
以下の

javascriptでわかりづらくする方法もある

smartyのマニュアルより

<{mailto address=$EmailAddress encode="javascript" subject="Hello"}> に問い合わせを送る

大文字にする(index⇒INDEX)

<meta name="robots" content="<{$xoops_meta_robots|upper}>" />

文字列の置き換え

例：西暦四桁とハイフン(xxxx-)を消す。

<{$topic.time|regex_replace:"/^\d{4}-/":""}>

（参考）もうちょっと軽いやり方

<{$topic.time|substr:5}>

例2：ボタンの名前を"表示"に変える。

<{$commentsnav|replace:"送信":"表示"}>

テキストボックスに改行を入力

例：入力画面で[:return:]等と入力後、該当する変数に

<{$title|replace:"[:return:]":"<br />"}>

どうしてもテキストボックスで改行したいときがあれば…

日本語文字列を丸めたい(mb_truncate)

通常のtruncateでは英数字でカウントするため、2バイト文字列の場合は途中で切れてしまう場合がありますので、2バイト文字列対応のsmarty plugin「mb_truncate」を利用する方法です。

以下の内容を class/smarty/plugins/modifier.mb_truncat​e.php として保存します。

<?php
/*
 * Smarty plugin
 * -------------------------------------------------------------
 * Type:     modifier
 * Name:     mb_truncate
 * Purpose:  Truncate a string to a certain length if necessary,
 *           optionally splitting in the middle of a word, and 
 *           appending the $etc string.
 * -------------------------------------------------------------
 */
function smarty_modifier_mb_truncate($string, $length = 80, $etc = '...', $break_words = false)
{
    if ($length == 0)
        return '';

    if (strlen($string) > $length) {
        $length -= strlen($etc);	
        if (!$break_words)
	    $string = preg_replace('/\s+?(\S+)?$/', '', mb_strcut($string, 0, $length+1));
      
        return mb_strcut($string, 0, $length).$etc;
    } else
        return $string;
}
?>

例えばd3pipesの rssprint_block_sync.html であれば

<a href="<{$entry.link|escape}>"><{$entry_headline4disp}></a>

の丸めたい部分($entry_headline4disp)に

<a href="<{$entry.link|escape}>"><{$entry_headline4disp|mb_truncate:60}></a>

とすれば、60 文字以上ある場合には文字列を丸めて表示します。

参考）xoopscube.jp 旧フォーラム「MyAlbumのcat_listの説明文に関して。」
http://xoopscube.jp/modules/newbb/viewto​pic.php?topic_id=4440&forum=17&post_id=2​3846

その他特殊テクニック

表示されないコメントアウト

<{*
  
*}>

とすることで <{* *}> 内はHTML上へ実際に反映されることはありません。通常の<!-- --> は見た目は表示されませんが、HTML上へは反映されます。

部分的にsmartyデバグモード

このテンプレートで使われているSmarty変数を知りたい! という時は、テンプレートの最初の行に

<{debug}>

と書くと、そのページで利用されている全ての編集がポップアップ・ウィンドウで表示されます。 ※ローカル推奨

配列変数が何を持っているのか知りたい

変数$photoが

<{$photo.title}>

とかで使われていると、$photo変数の他のキーも知りたくなる場合。

<{$photo|var_dump}>

で$photo.descriptionとか$photo.createdがあれば、一覧で出ます。無ければあきらめて。;)

…というのは、実はあまり良くないやり方。modifierプラグインの特殊ルール*1のおかげで、肝心の配列インデックスが表示されない。
つまり、ここでの最善の解はこうなる。

<{""|var_dump:$photo}>

<{$photo|@var_dump}>
<{$photo|@debug_print_var}>

というのが解ですね……と重箱の隅をつつくようなことを書きます^^；- suin

smarty変数の内容による処理分け

たとえば system_block_siteinfo.html (XCL2.1では legacy_block_siteinfo.html) などで、アバター画像のファイル名として blank.gif が渡されているときは、この部分を表示しない……というような場合。

<{if ! strstr($user.avatar,"blank.gif")}>
  <img src="<{$user.avatar}>" alt="" width="32" />
<{/if}>

XOOPSCube Legacy

XOOPS Cube とは

特徴

http://xoopscube.sourceforge.net/ja/lega​cy/feature.html

http://xoopscube.sourceforge.net/ja/xoop​scube/index.html

よりの引用

簡単なサイト構築

1. サイトオーナーは XOOPS Cube コアに "BASE" と呼ばれる基本的なパッケージを合体させ、好みのモジュールを追加してサイトの基本形を構築します。
2. さらにその基本形にプラスアルファの要素を加える "プリロード" ファイルを追加して、基本機能だけでは実現できないユニークな設定や動作変更、モジュールのコンビネーション動作を施すことができます。
3. 最後に外観を一発で変更する "テーマ" を適用してサイトの完成です

XOOPS Cube コア

XOOPS Cube コアは、このサイト構築手順を一つのモデルケースとして、構築活動や素材の作成・頒布といった活動が楽しく行えるように、様々な特徴や機能を提供して活動を支援するコア・プログラムです。

特徴的なコア設計ポリシー

1. 自由で柔軟なサイト構築というユーザー体験に追加プログラムや追加テーマといった追加素材を提供し、共に練り上げていったり、別バージョンの登場に驚いたりする活動はとても楽しいものです！
2. 一方で、スクラッチアプリケーションと異なり、"素材"としての対応のために開発に一手間二手間が必要だったり、 Web に関する専門的な知識や技術が要求されることも少なくありません。
3. XOOPS Cube コアは、この楽しい活動が短時間で気楽に行えるように、追加プログラムの守備範囲と、ユーザーの素材応用のやり方を整備しています。XOOPS Cube コアが "Mod" 的活動のプラットフォームとなるように各機能を設計し、提供を行っています。
4. Web の専門的プログラマかどうかに関係なく、 XOOPS Cube の活動に楽しく参加できるよう工夫をしています。

XOOPS Cube コアを活用した拡張性と交換性。

交換可能なサブシステム

1. XOOPS Cube コアは、設定ファイルを元に Root がサブシステムを初期化し、基本環境をセットアップします。サブシステムは交換可能であり、設定ファイルを変更するだけで自動的に組み込まれます。

1. 1. 設定ファイルはパッケージ単位にデフォルトの推奨設定をユーザーに配布できるほか、別ファイルにオーバーライド設定を行って、ユーザーにアドバイスしたり、ユーザーが友達に設定例を直接渡すことができます。

選択できる BASE パッケージ

1. XOOPS Cube コアは CMS や SNS の機能を直接持っていません。そういった機能は Package_Legacy のような BASE パッケージによって提供されます。BASE パッケージは交換したり、拡張することができるため、最初に自分の目的に合った BASE パッケージを選んだり、自分だけのオリジナルサイトを作る時に BASE パッケージをちょっと拡張するといったことが簡単にできます。もちろん、拡張した BASE を再頒布してネットで共有するといったことも自由です。

XOOPS Cube コアのプリロードポリシーを使用して、簡単なプラグインファイルで様々なカスタマイズを可能にします。カスタマイズにおけるソースコードの直接改変を防ぎ、再頒布を容易にします。デリゲートを効果的に使用しており、プリロードによるカスタマイズやモジュール間の連携が可能になっています。

1. 1. デリゲート
      1. デリゲートとは、プログラマ向けに用意された「統一的なコールバック手続き」の機能です。PHP 標準で用意された「オーバーライド」とは異なるスタイルで仮想関数を疑似的に作ることができます。
      2. デリゲートを使えば、自作のプログラムの一部分をわずかな時間でカンタンに拡張対象へと変更することができるため、他の開発者やハイエンドユーザーの要望にすばやく応じることができます。その作成したデリゲートに対応したユニークなプリロードが作られ、ネットで共有されるようになるかもしれません。

1. 1. プリロード
      1. ばらばらに集めてきた追加プログラム素材（追加モジュール）を使ってサイトを作り上げるとき、環境設定では設定できない細かい追加の設定や、連携動作を実現したい場合があります。
      2. そういった用途のために、 XOOPS Cube は追加モジュールより更に小さい追加プログラムとして "プリロード" という概念を持っています。コミュニティにはさまざまなプリロードファイルが公開されていますので、面白そうなものをダウンロードして使ってみましょう。
      3. また、上級者であれば自分の目的に併せてプリロードを調整して再頒布することもできますし、初心者のサイト構築をアドバイスするために、プリロードファイルを作ってプレゼントすることもできます。
      4. プリロードによる機能調整は、ソースコード Hack （プログラムの直接改造）と異なり、プログラムのバージョンアップ時にプログラムが書き戻り、ゼロからやり直しになってしまうといったトラブルを起こしません。

1. 1. 仮想サービス
      1. 異なるプログラム間の連係動作に疑似的な XML Web サービスを使うことができます。 XOOPS Cube の機能は本物の XML Web サービスと疑似的な XML Web サービスの二つを透過的に扱う方法を定義しています。一度サービスを書けば、それを XML Web サービスとして公開する（サイト間通信）ことも、プログラムモジュール間通信として公開する（サイト内通信）こともできます。
      2. 同様に、サービスに接続する時は、サイト間通信とサイト内通信を透過的に扱うことができます。

安全性

1. XOOPS Cube コアの型安全性ポリシー、入力値検査を実施。
2. XOOPS2 コード部でも後方互換性に問題の生じない範囲内でポリシーを実施。

使い易さ

1. 管理画面に大量の Tip メッセージを導入しています。操作のヒントが与えられます。
2. 管理画面より、オンラインマニュアルとファーストステップガイドを閲覧できます。
3. ヘルプや管理操作をキーワードで検索するアクションサーチ。
4. 管理画面のルック＆フィールをカスタマイズできます。
5. 管理専用モジュールをインストールして、さらに使い勝手を向上させることができます。

XOOPS2 との互換性

1. 海外版 XOOPS2 バージョン 2.0.10 との互換性。
2. 日本版ブランチ XOOPS2 JP バージョン 2.0.16 との互換性。

モジュールの互換性

テーマ

1. 「互換レンダーシステム」 (legacy_render) により、XOOPS2 専用テーマを利用できます。

最新版

2011-04-23 リリース
XOOPS Cube Legacy version2.2.0

XOOPS2.0からの移行

XUGJ wiki 「XCLBasicManual/​XOOPS2.0からの移行」

XCL2.1からの移行

xoopscube wiki 「XCL2.1.* から XCL2.2 へのアップグレード」

用途・使い道

単なる静的サイトの代用から、大規模ポータルのベースシステムまで、使用者の発想と運用方法によって用途を問いませんが、デフォルトでユーザ登録・管理システムが用意されているため、数人で管理する小～中規模のコミュニティサイトが一番向いているでしょう。 例えば： クラブ・サークルなどのメンバー用サイト、同好の趣味の人々が集まるファンサイト、掲示板・フォーラムモジュールを生かしたコミュニケーションサイトやQ&Aサイトなどなど。

参考 サードパーティ製ディストリビューション

• ホダ塾ディストリビューション(http://www.hodajuku.org/modules/distribu​tion/)

• 更新サムライ(http://xlab.jp/)

• XOOPS九州ユーザー会xoops9ディストリビューション(http://sourceforge.jp/projects/xoops9/)

• Tokai:ベーシック(http://jp.xoopsdev.com/recipe/1)

XOOPS2.0からXCL2.1への移行

STEP 1 準備

1. サーバーのPHPのバージョンを調べましょう。 (PHP >= 4.3.11)
2. まず、お使いのXOOPS 2.0.x JPを最新版(XOOPS 2.0.16a JP)にアップデートしてください。
3. お使いのモジュールがXOOPS Cube Legacyと互換かどうかをこちらなどで調べ、モジュールの最新版もしくはパッチをダウンロードします。
4. お使いのモジュールが互換性のためのシステムモジュールを必要とするかを調べます。もし必要なときはこちらから最新版をダウンロードしてください。

STEP 2 サイトを閉じる

1. defaultテーマを選択し、他の選択できるテーマを無効にします。
2. サイトをクローズします。
3. デバッグモードをPHP debug modeに変更します。
4. PHPコンテンツを含むカスタムブロックを停止します。 （プロックがXOOPS2のグローバル変数を使っている場合、XOOPS Cube Legacyでは完全には動作しないかもしれません。）
5. さらに、より安全に作業をすすめるため、全てのブロック、とくにシステムプロックを停止してください。
6. スタートモジュールの設定をリセットします。（スタートモジュールがXOOPS Cube Legacyと互換性がないなど、アップデート後に問題が出る場合があります。）
7. キャッシュの設定をすべて外します。XOOPS Cube LegacyではXOOPS2とは異なったキャッシュ方式を採用しています。

STEP 3 ファイルの置換

1. mainfile.phpと下記のディレクトリを除いて、 全てのフォルダ・ファイルを消去します。

    html/images/
    html/themes/
    html/uploads/
    html/modules/
    html/favicon.ico
    html/robots.txt
    html/common/
    XOOPS_TRUST_PATH

1. XOOPS Cube Legacyのパッケージで上書きします。ただし、次のフォルダ・ファイルは上書きする必要はありません。

    html/install/
    html/uploads/
    html/mainfile.php
    html/favicon.ico
    html/robots.txt

1. 使用している全てのモジュールを、STEP1で入手しておいた最新版もしくはパッチをあてたバージョンに置き換えてください。
2. XOOPS_TRUST_PATHのファイルを消去する必要はありません。 D3方式のモジュールを最新版にアップデートしておくだけです。
3. Legacyモジュールをご自分のモジュールフォルダにコピーするのをお忘れないように！
4. コメント統合を利用している場合は、d3forumのアーカイブの"html/class/smarty/plugins"フォルダにある Smarty プラグインを忘れずにコピーしておいくてださい。

STEP 4 アップグレード

1. mainfile.phpにパッチをあてます。

修正前:

if (!isset($xoopsOption['nocommon']) && XOOPS_ROOT_PATH != '') {
  include XOOPS_ROOT_PATH."/include/common.php";
}

修正後:

if (!defined('_LEGACY_PREVENT_LOAD_CORE_') && XOOPS_ROOT_PATH != '') {
  @include_once XOOPS_ROOT_PATH."/include/cubecore_init.php";
  if (!isset($xoopsOption['nocommon']) && !defined('_LEGACY_PREVENT_EXEC_COMMON_')) {
    include XOOPS_ROOT_PATH."/include/common.php";
  }
}

1. 上記の例はコードの命令単位で書かれています。閉じ括弧の数に注意してください。XUGJのフォーラムに以下のような質問と回答が出ていました。 http://www.xugj.org/modules/QandA/index.​php?topic_id=311

1. もしXOOPS Protectorをお使いの場合、mainfile.phpをもう少し修正する必要があります。

(Protector V3の例)：

if (!defined('_LEGACY_PREVENT_LOAD_CORE_') && XOOPS_ROOT_PATH != '') {
  include XOOPS_TRUST_PATH.'/modules/protector/include/precheck.inc.php';
  @include_once XOOPS_ROOT_PATH."/include/cubecore_init.php";
  if (!isset($xoopsOption['nocommon']) && !defined('_LEGACY_PREVENT_EXEC_COMMON_')) {
    include XOOPS_ROOT_PATH."/include/common.php";
  }
  include XOOPS_TRUST_PATH.'/modules/protector/include/postcheck.inc.php';
}

1. templates_cとcacheフォルダーのパーミッションを777に設定します（uploadsはすでに設定済みです）。
2. ブラウザの再読み込みボタンをクリックします。
3. 2番目のインストーラーにある必要なモジュールをインストールします。
4. モジュール管理で、すべてのモジュールをアップデートします。
5. アーカイブ内の/extras/XUpgradeというディレクトリをまるごとサーバのmodules/下にコピーして、モジュール管理から「X UPGRADE」をインストールします。これによって、システムモジュールの一般設定などがレガシーパッケージに引き継がれます。（このモジュールは特殊で、インストールするだけですべての移行処理を片付けます。つまり、インストール後、すぐにアンインストールしてかまいません。）

 　　　
XUpgrade(X UPGRADE)のモジュールインストール ログの例
■設定とテンプレートの移行作業を開始します...
■全体設定の 'maxuname' コンフィグ値を 'user' モジュールへ移行しました。
■全体設定から 'maxuname' コンフィグを削除しました。
■全体設定の 'avatar_minposts' コンフィグ値を 'user' モジュールへ移行しました。
■全体設定から 'avatar_minposts' コンフィグを削除しました。
■全体設定の 'use_ssl' コンフィグ値を 'user' モジュールへ移行しました。
■全体設定から 'use_ssl' コンフィグを削除しました。
■全体設定の 'sslpost_name' コンフィグ値を 'user' モジュールへ移行しました。
■全体設定から 'sslpost_name' コンフィグを削除しました。
■全体設定の 'sslloginlink' コンフィグ値を 'user' モジュールへ移行しました。
■全体設定から 'sslloginlink' コンフィグを削除しました。
■X UPGRADE モジュールのインストールに成功しました

STEP 5 サイトを開く

1. 全てのモジュールをアップデートして、正しく動くかをチェックします。
2. もしシステムモジュールが不要ならアンインストールしてください。ディレクトリもサーバーから消去します。
3. カスタムブロック以外のブロックをインストールします。
4. カスタムブロックのインストールには2つのウインドウをあけておきます。一つはホームページを見てカスタムブロックが正しく動作するかチェックするためで、もう一つはコントロールパネルを表示して問題があるカスタムブロックをアンインストールするためです。
5. プリファレンスの設定をもとに戻します。
6. サイトをオープンします。
7. サイトの設定を確認したら、デバックモードをOFFにします。

「XOOPS2.0からの移行」でのわかっている問題

システム関連のテーブルでテーブル構造が変更に(桁数の変更など)なっているものがあります。

XUpgrade(X UPGRADE)のモジュールでも変更されません。どんな影響がでるか未知です。
(以下に変更箇所をあげておきます)

bannerclient

old
 email varchar(60) NOT NULL default '',

new
 email varchar(255) NOT NULL default '',

• 桁数の変更

config

old
 conf_title varchar(30) NOT NULL default '',
 conf_desc varchar(30) NOT NULL default '',

new
 conf_title varchar(255) NOT NULL default '',
 conf_desc varchar(255) NOT NULL default '',

• これは、XCL用のモジュールの言語ファイルの定数の文字数の制限が30桁から255桁に変わったということを意味します。
• そのため、30桁のままだと、XCL用の30桁を超える新しいモジュールは、モジュールをインストールをするときに失敗します。

groups_users_link

old
  KEY groupid_uid (groupid,uid)

new
 UNIQUE KEY uid_groupid (uid,groupid)

• キーの順序が変わっています。

modules

old
  ) TYPE=MyISAM;

new
 ) TYPE=MyISAM AUTO_INCREMENT=2 ;

• idの追加時のカウント増加数が2づつに変わっています。

users

old
  email varchar(60) NOT NULL default '',

new
 email varchar(255) NOT NULL default '',

• 桁数の変更

Tubson オリジナルはここ

http://sourceforge.jp/projects/mulab/rel​eases/?package_id=9608

ウェブ版はココ

http://xoopsdev.com/

2.2対応に改造したのがこちら（factory）

http://jp.xoopsdev.com/

テーマカスタマイズの実例

テーマのカスタマイズに関しては、これまでのXOOPSの歴史において考案された「定番」の方法がいくつかあります。 それらをここにまとめます。 なお、基本的にtheme.htmlの構造はXOOPS2.0.xもXCL2.1.xも同一です。

ブロックタイトルの画像化

ほとんどのXOOPS用テーマではブロックタイトルはテキスト表示になっています。これは、管理画面でブロックタイトルを変更することが出来るので、システム上テキストでないと都合が悪いのですが、これをデザインの都合で画像化したいという場合もあるでしょう。その方法はいくつかあります。

ブロックタイトルをテーマに持たせずブロックテンプレートに持たせる。

汎用性を全く考えなくとも良いのであれば、この方法が一番簡単です。 theme.htmlにあるブロックタイトル部分の記述を削除してしまえば、デフォルトのブロックタイトルは表示されません。その代わりに画像をテンプレートに埋め込んでしまえば良いのです。カスタムブロックの場合は、タイプをHTMLにしてやはりそこに画像を埋め込みます。画像を置く位置は、ルートからのパスで指定すればどこにでも置けます。該当テーマ内に置きたければ$xoops_imageurlを使えば良いでしょう。 ただし、この方法の場合、同位置にあるブロックはすべて同じようになりますので、デフォルトのテキストブロックタイトルと画像タイトルを混在させることは出来ません。

PHPを利用してブロックタイトルの表示・非表示をする

同じ位置にある（例えば右カラム）ブロックで、ブロック毎にデフォルトのテキスト表示にしたり、画像タイトルにしたい場合、PHPを使ってタイトルの表示・非表示を切り替えることが出来ます。

有名な方法はWervive氏が「XOOPSをリデザインする」で数年前に発表した方法です。 ブロックタイトルの表示・非表示をコントロールしたい位置のブロック記述部分を次のように書き換えます。

<div class="block">
<{if $block.title|regex_replace:"/.*none/":"none" ne "none"}>//この行を加える
<div class="blockTitle"><{$block.title}></div>
<{/if}>/この行を加える
<div class="blockContent"><{$block.content}></div>
</div>

これで、管理画面においてブロックタイトルの最後にnone（必ず半角）を付ければ、そのブロックタイトルだけ非表示になります。そこを画像化するにはやはりテンプレートに直に埋め込みます。

これはちょっと冗長ではないかと言うことでGIJOE氏が考えたのが以下のコードです。

<div class="block">
<{if ! $block.title|strstr:"none"}> //この行を加える
<div class="blockTitle"><{$block.title}></div>
<{/if}>//この行を加える
<div class="blockContent"><{$block.content}></div>
</div>

これも同様にブロックタイトル末尾にnoneを付ければ非表示になります。

PHPを利用してブロックタイトルを画像に置き替える

こちらはPHPロジックを利用して、タイトルのテキスト自体を直接画像のパスに置き換えてしまうと言う技です。新たに画像を埋め込むためのテンプレートの修正などの手間が無い代わりに、ブロックタイトルのテキストにかかっているスタイルシート（class="blockTitle"）に影響されてしまうため、テキスト・画像共に破綻のない見栄えを作るには工夫が必要かも知れません。

これもwervive氏の案がオリジナルと思われます。

<div class="block">
<{if $block.title|regex_replace:"/.*\[\[.*/":"Picture True" eq "Picture True"}>//この行を追加
<div class="blockTitle">
<img src="<{$block.title|regex_replace:"/.*\[\[/":""}>" alt="<{$block.title|regex_replace:"/\[\[.*/":""}>">//この行を追加
</div>
<{else}>//この行を追加
<div class="blockTitle"><{$block.title}></div>
<{/if}>//この行を追加
<div class="blockContent"><{$block.content}></div>
</div>

管理画面のブロックタイトルの指定欄で「タイトル[[画像のパス」を入力すればタイトル部分が画像に置き換わります。パスは$xoops_url等の変数は使えないので、サイトルート相対パスかフルパスにして下さい。例）「ニュース[[/images_block/news_blk_title.gif」

また、これに対してもGIJOE氏が代案を出しています。

ブロックタイトル部はすべて下記の記述に変更

<div class="blockTitle"><{$block.title|xoops_blocktitleimage}></div>

プラグインをclass/smarty/plugin/modifier.xoops_block​titleimage.phpとして作成する

<?php
function smarty_modifier_xoops_blocktitleimage( $string , $width = null , $height = null )
{
	list( $title , $imgsrc ) = @explode( '[[' , $string ) ;
	if( empty( $imgsrc ) ) return $title ;
	$width_desc = isset( $width ) ? 'width="'.$width.'" ' : '' ;
	$height_desc = isset( $height ) ? 'height="'.$height.'" ' : '' ;
	return '<img src="'.XOOPS_URL.$imgsrc.'" alt="'.$title.'" '.$width_desc.$height_desc.' />' ;
}
?>

これらの技術に関するトピックは下記です。ご参考に。

http://www.xugj.org/modules/d3forum/inde​x.php?topic_id=193

CSSでブロックタイトルの画像化

単にタイトル文字を画像に置き換えるのではなく、CSSにて画像を背景として表示させた上で、タイトル文字はテキストインデントにより非表示とする方法です。 ブロックタイトルを画像にするには、テーマ内のブロックタイトルの記述を全て次の様にします。

 <{if ! $block.title|strstr:"none"}>
 <div<{if $block.title|strstr:"image"}> class="<{$block.title|regex_replace:"/<.+?>/":""}>"<{/if}>>
 <h3><{$block.title|regex_replace:"/image/":""}></h3></div>
 <{/if}>
 <div><{$block.content}></div>

または

<{if ! $block.title|strstr:"none"}>
<{if $block.title|strstr:"image"}><div class="<{$block.title|regex_replace:"/<.+?>/":""}>"><{/if}>
<h3><{$block.title|regex_replace:"/image/":""}></h3>
<{if $block.title|strstr:"image"}></div><{/if}>
<{/if}>
<div><{$block.content}></div>

上記の設定は、none技も使っており、ブロックタイトルの末尾に none がある場合は、ブロックタイトルを表示しないというのはnone技そのものですが、もうひとつブロックタイトルの末尾に image がある場合には、divにブロックタイトル名のclassを付加するというものです。

上の方のサンプルは常にdivを表示するもの、下の方は条件に合致した時にdivを表示するもので、多分どちらも同じ動作をすると思います。

あとは、cssにて次の様な記述を行います。

.welcome {
	width:60px;
	height:60px;
	background:url(images/hogehoge.jpg) no-repeat;
}
.image h3 {
	text-indent:-9999px;
	border:none;
}

そして、管理画面のブロック管理にて、画像を使いたいブロックのタイトルを次のようにします。

	welcome image

（タイトルをclass名として利用するため、日本語はだめ。半角英数とハイフン、アンダーバーに限ります。画像を使わずタイトルをそのまま表示する場合は、もちろん日本語でもＯＫ！）

そうすると、望み通りタイトル部分が hogehoge.jpg に置き換わります。 cssで幅や高さも調整できますので、かなり自由度の高い表現が可能となるでしょう。

なお、ここではclass名として「.welcome」を単独で書きましたが、場合によっては上位要素のセレクタ名を前に書いてやらないと背景画像が上手く表示できないかもしれません。例えば、こんな感じに。

.grid09 div div.welcome {
	width:60px;
	height:60px;
	background:url(images/hogehoge.jpg);
}

CSSでブロックタイトルの背景画像を自在にコントロールする

ブロックタイトルの背景を画像にするには、テーマ内のブロックタイトルの記述を全て次の様にする。

<{if ! $block.title|strstr:"none"}>
<div<{if $block.title|strstr:"image01"}> class="image01"<{elseif $block.title|strstr:"image02"}> class="image02"<{elseif $block.title|strstr:"image03"}> class="image03"<{/if}>><h3><{$block.title|regex_replace="/image..$/",""}></h3></div>
<{/if}>
<div><{$block.content}></div>

cssは次のようにします。

.image01 {
	width:400px;
	height:200px;
	background:url(images/hoge01.jpg) no-repeat;
}
.image01 h3 {
	text-indent:-9999px;
	border:none;
}
.image02 {
	width:600px;
	height:30px;
	background:url(images/hoge02.jpg) no-repeat;
}
.image02 h3 {
	border:none;
}
.image03 {
	width:600px;
	height:60px;
	background:url(images/hoge03.jpg) no-repeat;
}
.image03 h3 {
	font-size:36px;
	border:none;
}

あとは、ブロック管理にて、タイトルの末尾に image01 から image03 までの記述を加える。

そうすると、image01の場合は幅400px高さ200pxの hoge01.jpg が表示されてタイトル文字は表示されない。 image02の場合は、hoge02.jpg を背景として、タイトル文字が表示される。 image03の場合は、hoge03.jpg を背景として、36pxのタイトル文字が表示されるようになります。

その他にも、ここで書かれている方法を複合的に使うことにより、色々な表現ができると思います。

ブロック構成の改造（複雑な配置に対応させる）

テーマを作成するに当たって、ブロックの話は避けて通れません。 xoopsでは、情報掲載はブロック単位で行っており、XCLであれば管理画面の「互換モジュール」「ブロックの管理」で表示をコントロールするようになっています。

「表示サイド」欄に「左」「中央」「右」と書かれているのが、いわゆる左カラム、センターカラム、右カラムへの表示を選択する箇所で、中央カラムについてはさらに、「中央左」「中央-中央」「中央右」と３つの選択肢があり、「中央-中央」を選ぶと中央カラムの横一杯に、「中央左」「中央右」の場合は中央カラムの横幅半分ずつ表示するというのが基本的な考え方です。

また、「並び順」欄がブロックのweight、つまり表示順とか表示の重要度の順番を決める箇所となっています。 基本的に、各表示サイドについて、数字が小さいものから順番に表示されるようになっています。

Cube_defaultなどのいわゆる３カラム表示のテーマの場合は、ブロックの管理画面で選択したとおりの表示になります。

でも、３カラムだけでは「いかにも的なデザインとなる」ことから、左側に中央カラムを配置した「大小」の２カラムや逆の「小大」の２カラムのテーマも良く見受けます。 また、中央カラムだけの「思い切った」１カラムデザインもありますが、いずれの場合も左カラムの下に右カラムのデータを表示させたり、中央カラムの下に左右カラムのデータを表示させるといった工夫により、管理画面の「表示サイド」とはちょっと異なりますが、ブロック管理で設定したブロックが表示されるように作られているものが殆どです。

さらに、ホダ塾ディストリビューションに入っているテーマ hd_default などは、「表示サイド」の設定で中央カラムしかない場合は１カラム表示、左（または右）カラムと中央カラムの場合は２カラム表示、全てのカラムが表示される設定の場合は３カラム表示するといった設定がなされていることから、利用するモジュール（ページ）に応じた柔軟な運用が可能となっています。

ちなみに、hd_defaultでは、下記のような記述により、body にclassを設定するようにされています。 つまり、ブロック管理にて左カラムを表示する設定の場合は、ShowBlockL1R0 というクラスが、右カラムの場合は ShowBlockL0R1 というクラスが、左右カラム両方が表示される場合は ShowBlockL1R1、そして左右カラムとも表示しない場合は ShowBlockL0R0 というクラスが設定されることにより、１カラムから３カラムまでの表示をコントロールしている訳です。 hd_defaultでは、さらに管理者としてログインした時のクラスやディレクトリ名によるidの設定も行うようになっており、非常に勉強になるテーマです。

<body class="ShowBlockL<{$xoops_showlblock}>R<{$xoops_showrblock}><{if $xoops_runs_admin_side}> AdminMode<{/if}>" id="<{if $xoops_dirname ne ""}><{$xoops_dirname}><{else}>home<{/if}>">

しかし、これらの工夫を行ったとしても、縦長の各カラムにweight順に表示するということには変わりはなく、特に各モジュールを表示している時など、中央カラムにはモジュールコンテンツが一番上となり、さらにその上にカスタムブロック等を表示するということができないのです。 また、横一列にブロックを４つとか５つ並べたり、３カラムの上、ヘッダとの間にカスタムブロック等を配置するというのは、通常のテーマでは出来ません。

その辺りを打開する方法のひとつが、ブロックのweight技なのです。

例えば、中央カラムに次のような表示をしたい場合の説明をしましょう。

　１　カスタムブロック 　２　モジュールコンテンツ 　３　カスタムブロック 　　（またはモジュールのブロック）

この場合、テーマで次の様な記述をするとweightを使ったコントロールが出来ます。

	<{if $xoops_showcblock == 1}><!-- ■ 中央中央ブロック判定　-->
	<div>
		<{if $xoops_ccblocks}><!-- ■ 中央中央ブロックの場合 -->
			<{foreach item=block from=$xoops_ccblocks name=ccloop}><!-- ■ 表示ブロックの数だけループ -->
				<{if $block.weight == 0 }><!-- ■ もしも weightが0の場合に表示 -->
				<{if ! $block.title|strstr:"none"}><h2 class="BlockTitle"><{$block.title}></h2><{/if}>
				<div class="BlockContents"><{$block.content}></div>
				<{/if}><!-- ■ weightによる条件文終わり-->
			<{/foreach}><!-- ■ ループ終わり -->
		<{/if}><!-- ■ 中央中央ブロック判定終わり　-->
	</div>
	<{/if}><!-- ■ 中央ブロック判定終わり　-->

	<!-- ■ モジュールコンテンツ-->
	<{if $xoops_contents}><div id="ModuleContents"><{$xoops_contents}></div><{/if}>

	<{if $xoops_showcblock == 1}><!-- ■ 中央中央ブロック判定　-->
	<div>
		<{if $xoops_ccblocks}><!-- ■ 中央中央ブロックの場合 -->
			<{foreach item=block from=$xoops_ccblocks name=ccloop}><!-- ■ 表示ブロックの数だけループ -->
				<{if $block.weight > 0 }><!-- ■ もしも weightが0より大きい場合に表示  -->
				<{if ! $block.title|strstr:"none"}><h2 class="BlockTitle"><{$block.title}></h2><{/if}>
				<div class="BlockContents"><{$block.content}></div>
				<{/if}><!-- ■ weightによる条件文終わり-->
			<{/foreach}><!-- ■ ループ終わり -->
		<{/if}><!-- ■ 中央中央ブロック判定終わり　-->
	</div>
	<{/if}>

これは、まさにSmarty小ネタに書かれているweight技を使ったもので、上記の場合、管理画面「ブロックの管理」にて「並び順」つまりweightを 0 とした中央カラムのブロックが一番上となり、次にモジュールコンテンツ、weightが0より大きい、つまり１以上の中央カラムのブロックがその下に表示されるという設定になっています。 （CustomizeManual/​テーマカスタマイズTips　を参照ください。 ）

別の実例として、ヘッダー下に240pxの正方形のブロックを横並びにする設定の説明をしましょう。 ここでは、横幅960pxのテーマのヘッダーの下に横幅一杯のdivを用意して、そこにweight技を使った記述をしてみます・・・

	<div id="container"><!-- Start container -->
	<div id="header">ヘッダーの内容を記述</div>
	<div id="TopColumn">
	<{if $xoops_showcblock == 1}>
	<div>
		<{if $xoops_ccblocks}>
			<{foreach item=block from=$xoops_ccblocks name=ccloop}>
				<{if $block.weight == 0 }><!-- ■ weightが 0 の場合に表示する -->
				<{if ! $block.title|strstr:"none"}><h2 class="BlockTitle"><{$block.title}></h2><{/if}>
				<div class="BlockContents"><{$block.content}></div>
				<{/if}><!-- ■ -->
			<{/foreach}>
		<{/if}>
	</div>
	<{/if}>
	</div>
	<div id="wrapper">
	<!-- ■ モジュールコンテンツ-->
	<{if $xoops_contents}><div id="ModuleContents"><{$xoops_contents}></div><{/if}>
	<{if $xoops_showcblock == 1}>
	<div>
		<{if $xoops_ccblocks}>
			<{foreach item=block from=$xoops_ccblocks name=ccloop}>
				<{if $block.weight > 0 }><!-- ■  weightが 0 より大きい場合に表示する -->
				<{if ! $block.title|strstr:"none"}><h2 class="BlockTitle"><{$block.title}></h2><{/if}>
				<div class="BlockContents"><{$block.content}></div>
				<{/if}><!-- ■ -->
			<{/foreach}>
		<{/if}>
	</div>
	<{/if}>
	</div>
	</div><!-- End container -->

そして、cssに次の様な記述を行うと・・・

#container {
	width:960px;
}
#TopColumn div {
	float:left;
	width:240px;
	height:240px;
}

ヘッダー下に240pxの正方形のブロックが横並びに並びます。

もちろん、実際のテーマを作る際には必要に応じてdivを追加したり、classなどのCSSセレクタを設定したりと色々な調整が必要となりますが・・・ 下に５つ横並びにブロックを並べたり、右上に１個だけブロックを表示したりと、weight技を使うと思い通りのデザインのテーマを作ることが出来るので、より一層楽しめることと思います。

モジュールごとに異なる表示をさせる

テーマ hd_default のような、bodyに設定したディレクトリ名によるclassなどのCSSセレクタを利用する（大きく表示を変える場合には、この方法が良いと考えられます。） 異なる表示をさせたい箇所にディレクトリ名によるclass付加の設定を行って表示の分岐をさせる（ページごとに違う画像を表示させる場合など）

CustomizeManual/​テーマカスタマイズTipsを参照

xugj_block を使って、他のモジュールの任意ブロックを表示する

　この場合、テーマ内にxugj_blockを使った記述をする必要があり、ページごと（モジュールごと）に表示や非表示のコントロールする設定を加える等が必要となることから、若干敷居は高くなると思います。 （その際は、テーマ hd_default のような、bodyに設定したディレクトリ名によるclassなどのCSSセレクタを利用すると良いでしょう。）

picoとxugj_block を使って、他のモジュールの任意ブロックを表示する

　この場合、picoのブロック内にxugj_blockを使った記述を行うので、ブロック管理画面にてブロックの配置ができることから、運用しやすい方法と思います。

テーマカスタマイズTips

テーマのカスタマイズにphpの基礎的な知識が有ると、「できること」の幅が非常に広がります。別にプログラマーになるほど専門的な知識を実に付けなくとも（もちろんそういったものが有った方がより高度なことができますが)、基礎的な知識が有るだけで実にさまざまなことができるようになります。

phpの演算子を覚えよう

よく使われる演算子を覚えておきましょう。これと数値やSmarty変数を組み合わせるだけでも、複雑な処理が可能です。

例1）<{$xoops_dirname}> == d3forum・・・dirnameがd3forumである。

dirnameを使ってモジュールごとに異なるCSSセレクタを割り当てる

xoops_dirname変数を利用して、ページ全体にモジュールごとに異なるIDを仕掛けるなどの利用法があります。

 <div id="<{$xoops_dirname}>"></div>

この場合例えばd3forumにいるときはid="d3forum"が入ります。トップページなどdirnameが無いページでは空欄になってid=""となってしまうのが玉に瑕です。（html_lintなどで原点対象になります） もし、それを解消したいのなら下にあるif文で、dirnameが存在するページにのみこの処理をさせることもできます。

具体的には、テーマ hd_default で使われている次のような記述を使って、dirnameが存在しない場合は専用のcssセレクタ（ここでは home）を付与する方法

 <body id="<{if $xoops_dirname ne ""}><{$xoops_dirname}><{else}>home<{/if}>">

とか、次のようなif文の書き方で、dirnameが存在する場合のみcssセレクタを表示する方法なども考えられます。

 <body<{if !$xoops_dirname == ""}> id="<{$xoops_dirname}>"<{/if}> >

例）style.cssでモジュールごとにリンク色を変える。

#d3forum a {color: #000000;}
#bulletin a {color: #111111;}
#d3blog a {color: #333333;}

if elseを使いこなす

if = もし〇〇であるならば。 else = そうでないならば。 と、条件式を使って処理を分けることができます。

例1）モジュールページごとに表示を分ける。

<{if $xoops_dirname == "d3forum"}>
d3forum時のHTMLソース
<{elseif $xoops_dirname == "bulletin"}>
bulletin時のHTMLソース
<{else}>
それ以外の時のHTMLソース
<{/if}>

例2）登録ユーザとゲストで処理を分ける。

<{if !$xoops_isuser}>//!は否定
ゲスト時の処理
<{else}>
登録ユーザ（上記の条件式で言うと「ゲスト以外」）のための処理
<{/if}>

この時に括弧やif文の閉じ忘れがあると真っ白になってしまうので注意してください。

また、if/else処理は「入れ子」ができます。条件式の中にさらに条件式を入れることができますので覚えて置いてください。

テンプレート改造で出来ること・出来ないこと?

概要

XOOPSにおいて、テーマがサイトデザインの外枠を担当するのに対して、テンプレートは実質上のコンテンツ部分を担当します。たとえば、フォーラムモジュールでの「見出し」「題名」「投稿日時」の配置やそこにどのようなデザイン要素を絡めるかなどです。

XOOPSでは各モジュールごとに数枚から数十枚のテンプレートファイルを持っています。それらは「小分け」にされたHTMLの形式で記述され、ページ出力時にテーマ内に組み込まれることにより、ページ全体で1枚のHTMLとして成立するようになっています。そのため<head></head>や<body></body>などは無く、いきなり通常のタグで始まっています。

また、名称からその使用場所を判断でき、blockが名称に入っている場合、それはblock用テンプレートであることが想像できます。

システム用テンプレートはXOOPS2.0ではシステムモジュール内に、XOOPS Cube Legacy2.1では互換(legacy)モジュールやユーザーモジュール内にこれを持ちます。

これらの編集は管理画面から行うのが普通ですが、ローカルPC内で編集した物をアップロードするやり方も選択できます。XOOPS2.0ではシステム管理＞テンプレートマネージャー、XCLでは互換レンダーシステム＞テンプレート管理から編集できますが、altsysなどのテンプレート・ブロック編集に特化した管理モジュールを利用する方が使いやすくお勧めです。

テンプレート編集の進め方

XOOPS2.0.xの場合

【直接ブラウザ上で編集】
1）管理画面「システム管理」＞「テンプレート（セット）・マネジャー」を開きます。最初は「default」テンプレートセットしかない筈ですが、これは直接変更はできません。まず、右にある「複製」をクリックしてテンプレートセットを複製し、適当な名前をつけておきます。
そのあと、一度「システム管理」＞「一般設定」に行き新しく作成したテンプレートセットを「デフォルトのテンプレート・セット」に設定してください。これで準備が整いました。

2）再度「テンプレート・マネジャー」に戻ってください。複製した方のテンプレートセットに現在インストール済みのモジュールのリストが表示されていると思います。ためしにその中の「システム管理」右にある「一覧」をクリックしてください。上段にフルページ用テンプレート、下段にブロック用テンプレートが並びます。実際に編集するには、該当テンプレートの「アクション」欄にある「編集」をクリックします。すると編集フォーム画面になりますので、そのソースを書き換えた後に「送信」ボタンを押すと適用されます。実際に書き換わったかどうかはブラウザでそのページを表示して確かめてください。

【ローカルで編集後サーバ上に適用】
直接ブラウザで編集するのは結構しんどいことも多いです。また、Dreamweaverなどの作成ツールも使用できませんし、いざ送信しようとしたらタイムオーバーで勝手にログアウトされていたという泣くに泣けない場合もあります。そういった場合はローカルPCで編集してから該当ソースをサーバーアップするという方法があります。
1）テンプレートセットを複製後、「テンプレート・マネジャー」に行きテンプレートをローカルPCにダウンロードします。テンプレートセット全体をダウンロードすることもできますし、モジュール別画面に行って単体のテンプレートを1枚だけダウンロードすることもできます。
セット全体をダウンロードした場合、.tar.gzという形式で圧縮されていますので、それに対応したツールを使ってください。
※ここで勘違いしてはいけないのですが、XOOPSの場合テンプレートはモジュールインストール時にデータベースに格納されます。即ちFTPでアップロードしたモジュールディレクトリ内にある「ファイル」としてのテンプレートと、実際にXOOPSに適用されているテンプレートは別の物です。テンプレートマネージャー上で編集しても、それがモジュールディレクトリ内にあるテンプレートファイルにも適用されている訳ではないので注意が必要です。あくまでも現在適用中のテンプレートをファイルとして落とすにはテンプレートマネージャー（またはAltsys）から行ってください。

2）ローカルに落としたテンプレートファイルはお好みのツールで編集してください。ただしEUC-JPに対応していることが条件です。よってWindowsのメモ帳は使えません。また、初心者向けホームページ制作ソフトによっては勝手に色んなHTMLタグを補完してしまう物がありますので注意してください（Smarty変数の部分を書き換えてしまう場合があります）。予めそれらの機能は切っておいてからファイルを開いてください。
Dreamweaverの場合はMyXoopsExtensionsなどXOOPS用に便利なエクステンションがあります。
また、ホームページ作成ソフトのWYSIWYG機能（実際にブラウザで表示されているように見せながら編集できる機能）はCSSや画像リンクが切れるため、ほとんど使えないと思っていいでしょう。

3）編集が終わったら（その前にローカルなどに置いたテスト環境で適用させてみることが望ましいです）、サーバ上のXOOPSに適用します。テンプレートセット丸ごとをアップしたい場合は事前に.tar.gz形式に圧縮しておいてください。
セットの場合、サイト上の「テンプレート・マネジャー」トップにある「テンプレートセットをアップロードする」から、単体の場合はモジュール別画面の該当テンプレート右にある「アクション」欄の「参照」で適用ファイルを選択し、最下部の「アップロード」ボタンで適用します。
また、ローカル上で開いたファイルのソースを、直接テンプレート編集画面のフォーム内にペーストしても大丈夫です。

XOOPS Cube Legacy 2.1.xの場合

【直接ブラウザ上で編集】
【ローカルで編集後サーバ上に適用】

Altsysを利用の場合

Altsysでテンプレート編集を行う場合、テンプレート編集は、「テンプレート管理」画面で行います。

まず最初に現状のテンプレートセットの状態を確認しましょう。 「オリジナルファイル」と「DB-default」だけの状態なら、新規にテンプレートセットを作成することから始めます。 （オリジナルファイルとは、文字通り各モジュールのディレクトリ配下にある「実態のあるファイル」のことです。

「DB-default」とは、オリジナルファイルを読み込んでデータベースに収納されたもので、Xoopsでは「DB-default」が実際の表示に利用されると考えてください。 （いや、実際の表示は、「DB-default」のテンプレート情報を元にコンパイルされたキャッシュファイルということになりますが・・・）

いずれにしても、各モジュールのディレクトリ配下にあるテンプレートファイルを編集しても、そのままでは、実際の表示には反映されないということになります。

そこで、Altsysを使って編集を行う訳ですが、「DB-default」を編集せずに新規テンプレートセットを作成して、そこに目的とするテンプレートデータをコピーの上、編集を行うという方法が推奨されます。 これは、もし何かあっても新規テンプレートセットにコピー・編集したテンプレート情報を削除するだけで、簡単に元に戻るからです。

では、作業を始めましょう。 まずは、新規テンプレートセットの作成です。

多分、「テンプレート管理」を開くと、最初は「テンプレート操作対象モジュール : ALTSYS」の一覧が表示されていることでしょう。 その一覧の左下に「新規にテンプレートセットを作成する」という項目がありますので 　　ベース：（空）を選び 　　セット名：半角英数で任意の名前を入力　　（例：　DB-mydata　　など） して、「新規作成」ボタンを押してください。 （ここでは、新しいテンプレートセットを DB-mydata という名称で作成したとの前提で話を進めます。）

「DB-default」の右側に、新しく「DB-mydata」の欄が出来たことと思います。

次に、テンプレートを編集したいモジュール名を上部の一覧から選ぶと、そのモジュールのテンプレート一覧が表示されますので、テンプレート一覧から編集対象となるテンプレート名の「DB-default」欄の□にチェックを入れて、一番下にある「行先」のプルダウンからDB-mydata」を選び、「コピー実行」ボタンを押してください。 右横の「DB-mydata」の欄にテンプレートがコピーされたことと思います。

次に、「DB-mydata」にコピーされたテンプレート欄の「編集」をクリックすることで、テンプレート編集画面になります。

あとは、テンプレートを編集して、「更新して編集継続」または「更新して編集終了」ボタンを押すと編集内容が反映されます。 なお、初期表示される編集画面は、編集領域（ウィンドウサイズ）が結構狭くなっていますが、編集領域の右下部分をドラッグすることで任意のウィンドウサイズに広げることが可能です。

しかし、お奨めは、編集ウィンドウに表示されているソースを全コピーしてエディターに貼り付け、エディターでじっくりと編集する方法です。 特に、最近のエディターはソースをカラー表示してくれるものもあることから、分かりやすくて便利です。

Altsysを使ってテンプレートの編集を行うコツは、空のテンプレートセットを新規作成して、編集対象となるテンプレートだけを新規作成したセットにコピー・編集するということで、新たに作成したテンプレートセットには、編集したテンプレートだけが存在するというのが正解です。 （このようにしておくと、編集したテンプレートだけをダウンロードして取得するということも可能。また、編集したテンプレートがどれであるのかも一目瞭然です。でも、ローカルのエディターで編集するなら、そこでバックアップを取る方法も簡単かと。）

どのテンプレートを編集したら良いか分からない場合

Altsysの「テンプレートの高度な操作」にて、テンプレート名をコメントとして埋め込むの「送信」ボタンを押して見てください。 暫くすると完了の通知が出ると思いますが、これは Altsys が 「コンパイル済テンプレートキャッシュ」にテンプレート名をhtmlコメントとして書き込んでくれるもので、htmlのソース内容を見ることで、利用されているテンプレート名を知ることが可能となります。

htmlのソースを見る方法はご存じかと思いますが、ブラウザの画面で右クリックして「ソースを表示」を選ぶか、メニューから「表示 ＞ ソースの表示」 などにより確認することが出来ると思います。 ソースを確認する場合、そのまま見ても結構ですが、ソースをエディタに貼り付けて見た方が見やすいでしょう。

ソースを見ると、

<!-- begin altsys_tplsadmin db:d3downloads_main_viewcontent.html -->

などという begin altsys_tplsadmin から始まるコメントが埋め込まれています。

これは、d3downloads の main_viewcontent.html というテンプレートが使われている部分になります。 つまり、Altsys でそのテンプレートを編集すると、望む表示コントロールが出来るという訳です。 もちろん、そのモジュールが独自CSSを持っているなら、CSSの編集も必要となることは言うまでもありませんが。

テーマ下テンプレートを利用の場合

ホダ塾ディストリビューションに実装された プリロード HdXoopsTplHook.class.php を使うことにより、テーマ下テンプレートの実現およびSmartyプラグインフォルダの追加が可能となります。

テーマ下テンプレートとは、通常、各モジュールのディレクトリ配下にあるテンプレートを、テーマ下に作成した templates フォルダにコピーすると、HdXoopsTplHook.class.php プリロードによってテーマ下にあるテンプレートが最優先となり、これを編集することで、そのテーマ用のモジュールテンプレートとして利用できるという優れものです。 （テーマ下テンプレートは、XCLデフォルトのテンプレート編集やAltsysによるDBテンプレート編集よりも優先されるとのこと。）

Altsys等によるDBテンプレートの編集を行うと、テーマを変更した場合でも同じテンプレートが使われるため、色彩や表示サイズ等々がテーマと合わなくなることが往々にしてあります。

その場合、プリロード HdXoopsTplHook.class.php を使ってテーマ下テンプレート機能を追加し、テーマ下に templates フォルダを作成のうえ、各モジュールのテンプレートのうち、変更したいテンプレートファイル（実ファイル）をコピーして編集することにより、そのテーマを利用している時だけの表示コントロールを行うことが可能となります。 （もし、モジュールが専用の独自CSSを利用している場合、CSSの記述内容をテーマの style.css に取り込んで編集するか、モジュール用のCSSファイルを作ってテーマに合わせた編集を行ったうえで、テーマで読み込ませる記述をする必要があります。

利用に際しては、各モジュールの「編集したい」テンプレートを templates フォルダにコピーして編集するだけですが、実際のサイトで行うことは現実的ではありません。 xammp や WARP のようなローカル環境を利用して、自分のパソコンのローカル環境下で行うことが必須です。

d3モジュールの場合は、「公開側ディレクトリ名」＋ 「テンプレートファイル名」 のテンプレートとなりますので、 templates フォルダにコピーしたテンプレートファイル名の頭に「公開側ディレクトリ名」と _ を付ける必要があります。

ただし、この方法の場合、同じd3モジュールを複製して利用している場合、「公開側ディレクトリ名」ごとのテンプレートファイルが必要となってしまうことから、もしもそのd3モジュールでの表示を同じものとする場合、テーマ下 templates フォルダの下にd3モジュールの「trust」側のディレクトリ名（例えば、d3forum であれば d3forum）と同じフォルダを作成し、そこにテンプレートファイルをコピーすることで、複製して利用している各モジュール共通のテンプレートとすることが可能となります。

テンプレート編集でできること

テンプレートにはデータベースから数値や文言を読み込むためのSmarty変数やPHP関数なども組み込まれていて、それらの位置を変更することにより出力時のレイアウトを変化させることができます。また新たなCSSセレクタを組み込んだり、テンプレートに直接画像を配置したりすることにより、よりデザイン方向に振ったカスタマイズが可能です。
既にテンプレートに組み込まれているCSSセレクタは、多くの場合他のモジュールと共通でテーマのstyle.cssに記述されている場合が多いですが（メニュー関連やテーブルセルに適用される.outer .head .even .oddなど）、モジュール独自のCSSをモジュールディレクトリ内に持つものもあります。
また、新たにCSSセレクタを作る場合は、プロパティはstyle.cssに書き込むのが一般的です。

テンプレート編集でできないこと

特に標準モジュールなど古いモジュールなどではテンプレートを持たずにPHPファイルにHTMLごと直書きしている場合があります。その場合は、テンプレートマネージャーによる編集はできません。また、ひとつのページのHTML要素が1枚のPHPファイルにまとまっているとは限らないため（むしろそのケースは少ない）、PHPプログラムの知識を持たないユーザが変更を加えることは非常に困難です。

XOOPS2.0においてはコメント入力フォームや標準の投稿フォーム、そしてユーザ登録フォームなどはシステム側で持ち、モジュールはそれを呼び出す形で表示されます。これらはPHPで書かれており、テンプレート編集はできません。

テーマ改造で出来ること・出来ないこと

テーマ改造はXOOPSカスタマイズの基本

XOOPSにおいて、テーマセット（以下テーマ）とはXOOPSの見え方の大部分を受け持つ重要なパーツです。そしてこれは基本的にXOOPS2.0も新しいXOOPS Cube Legacy2.1でも同じものが使用できます。

テーマによって管理できる部分は、まず全体の外枠部分。簡単に言うとXOOPSのインストール直後はモジュールをひとつもインストールしていない状態になっていますが、あの状態での「ログインブロック」と「メインメニュー」「ユーザメニュー」を除いたHTMLがテーマに書き込まれています。（各ブロックやコンテンツ部分は、テンプレートでHTMLを管理しています）

次にほとんどの共用部分のCSSがテーマによって管理されています。これは外枠部分に限らず、各ブロックの外観、ブロックタイトルの部分、メニューの外観、基本フォントの設定、表組みにした場合の外観、コメント欄やそれに付随する外観、フォームの設定など、特定のモジュールに依存しない共通の外観を持たせる部分は全てテーマ内のstyle.cssが受け持っています。（各モジュール固有のパーツに関しては、そのモジュール内にあるCSSで受け持ちます）

XOOPSをインストールして、多くのユーザが最初に手をつけるのがこのテーマの変更でしょう。

テーマ改造でできること

XOOPSにおいてテーマが司っているのは、全てのページで共通している部分です。デザイン的要素においては、その範囲内でならほとんどの事ができます。

theme.htmlでできること

theme.htmlでは各ブロックやコンテンツ位置のレイアウトを受け持っています。CSSに依存しない部分の変更が可能です。HTML属性はstyle.cssでの記述と競合しない限り使用できますがほとんどの場合競合してしまうようです。

• XOOPSのブロック部分、およびコンテンツ埋め込み部分以外の外観の変更
• 全体のレイアウトの変更
• ブロックの配置の変更、およびブロック配置ロジックの埋め込み
• PHPスクリプト埋め込みにより、モジュールまたはページ単位でのオブジェクトの表示/非表示
• PHPスクリプト埋め込みにより、権限グループ単位でのオブジェクトの表示/非表示
• ブロックタイトル表示/非表示ロジックの埋め込みなどなど・・・

style.cssでできること

XOOPSは現代的なCSSレイアウトではありませんが、それでもかなりの部分がCSSによってコントロールされています。また、モジュールコンテンツでも、投稿フォームや表組みなど、外観の統一感のためにテーマ内のCSSに委ねられているパーツも多いです。
但し、モジュールによっては独自のCSSを持っている場合もありますので、それらとの摺り合わせは必要です。

• 文字サイズ・行間・フォントファミリーなど
• 各部分の空き、マージンなど
• 背景画像などCSSによって画像がコントロールされているものの変更
• 表組みの罫線、セルの色などなど・・・
• その他CSSでコントロールできるもの全て

テーマ下テンプレート機能とモジュール用CSSファイルを使いモジュールの表示もコントロール

ホダ塾ディストリビューションに実装された プリロード HdXoopsTplHook.class.php を使うことにより、テーマ下テンプレートの実現およびSmartyプラグインフォルダの追加が可能となります。 テーマ下テンプレートの記述を参照ください。

テーマ下テンプレートとは、通常、各モジュールのディレクトリ配下にあるテンプレートを、テーマ下に作成した templates フォルダにコピーすると、HdXoopsTplHook.class.php プリロードによってテーマ下にあるテンプレートが最優先となり、これを編集することで、そのテーマ用のテンプレートとして利用できるという優れものです。 （テーマ下テンプレートは、XCLデフォルトのテンプレート編集やAltsysによるDBテンプレート編集よりも優先されるそうです。）

そして、各モジュールが持っているCSSの記述をテーマに取り込むことで、モジュールのデザインも含めた総合的なサイトデザインを行うことが可能となります。

テンプレート編集については、別途 テンプレート改造で出来ること・出来ないこと? を参照ください。

テーマ改造でできないこと

全てのページで共通している部分の修正がテーマ改造で可能なことであるならば、「できないこと」はその反対、「各ページで異なる部分」です。これらは主にシステム用テンプレート、および各モジュール用テンプレートに依存しています。モジュールやシステム部の「コンテンツ」として表示される部分のレイアウトはテーマでは動かすことができません。

デフォルトテーマを改造する

準備

エディタについて

最初は theme.html をいじっていきますが、編集するエティタに気をつけてください。サイトが EUC の文字コードで作られていれば EUC が編集できるエディタ。UTF で作られている場合は、UTF の編集に対応したエディタが必要です。編集している最中に文字化けなどがおこったら、まずエディタやファイル保存時の文字コードを疑ってみてください。

テスト環境

ベーシックマニュアルのサーバ環境準備から「ローカルテスト環境の整備」をよく読んでください。基本的にテーマ改造などはこのローカルテスト環境で行うクセをつけた方がよいです。

デフォルトテーマの複製

XOOPS Cube Legacy であれば、cube_default XOOPS2 系だったら default というフォルダのセットがあるので、まずはこれを複製して別の名前をつけてみましょう。
これでテーマをいじっている最中に、もし真っ白とかに遭遇しても、もともとあったテーマフォルダの名前を改造中のフォルダの名前に変えるなどすれば、問題の切り分けにも役立ちますし、安全です。

加えて、XOOPS Cube Legacy用テーマの場合、フォルダ内に manifesto.ini.php という設定ファイルがあって、この中にテーマの名前が記載されているのですが、複製した方の Name="Default theme of Cube"　と書かれている箇所を任意の名称に替えましょう。（例 Name="My Theme "　）

これを行っておかないと、「互換モジュール　＞　テーマ管理」で表示される一覧に 「Default theme of Cube」 が二つ並んでしまい、どちらがどちらか分からなくなってしまいます。

XOOPS の環境設定

XOOPS にログインして、管理画面に入ります。
XCL だったら「互換モジュール > 全般設定」、X2 だったら、「システム管理モジュール > 一般設定 > 編集」に入ります。
デフォルトテーマを複製したあとであれば、「デフォルト・サイトテーマ」や「選択可能なテーマ」に、追加したフォルダ名が追加されていると思います（追加されてなければ、もう一度複製作業を確認してください）。
これからいじるテーマを「デフォルト・サイトテーマ」にして、「themes/ ディレクトリからの自動アップデートを有効にする」を「はい」にしておいてください。
これで編集準備完了です。

開始 - 変更の反映のされ方に慣れてみる

文字を足してみる

theme.html をテキストエディタで開くと、div やら table やらが並んでいると思います。まずはどこでもいいので、何か文字を──「X」などと入れて保存してみましょう。
＃ポイントは「加える」動作からはじめてみることです。「削る」のは、慣れてきてからにしましょう。
ブラウザでページをリロードすると、追加した X が、表示されたでしょうか？　これがとにかく最初の一歩です。

画像を足してみる

文字を表示できるということは、画像も表示できるということです。
テーマディレクトリに画像ファイルを置いて、<img>タグで呼び出してみてください。多分最初はこんな表記になると思います。

<img src="YOURHOST/themes/YOURTHEME/sample.jpg" alt="" />

YOUR...の部分や画像ファイル名は適宜入れ替えてください。
デフォルトテーマでは左上に表示されているロゴマークを変えてみるのも楽しいかと思います。

ロゴ画像を変更してみる

デフォルトテーマの見た目を変更するなら、ロゴとして使われている画像や背景画像などの変更を行うのがとても簡単。 テーマフォルダの下に images というフォルダがあり、そこにテーマで使われている各種画像が納められています。

とっかかりとしては、ロゴを変更するのが一番簡単でしょう。 cube_default の場合、ロゴ画像は logo.gif という 200×100px のGIF画像が使われています。 この画像を自分のサイト名などを入れたオリジナル画像に替えると、それだけで自分用のテーマになった気分になります。

同じサイズ（ 200×100px ）で同じファイル名の画像なら、どこも書き換えることなく見た目の変更が可能です。

もし、違うファイル名なら、３６行目にある

<td class="headerlogo"><a href="<{$xoops_url}>/"><img src="<{$xoops_imageurl}>images/logo.gif" width="200" height="100" alt="<{$xoops_sitename}>" title="<{$xoops_sitename}>" /></a></td>

の logo.gif という名称を書き換えてください。もちろん、JPGファイルやPNGファイルも使えます。

その他、base.gif や cube.gif 、poweredby.gif をオリジナルのものに変えると、ガラッと雰囲気を変えることができます。 コツというほどではありませんが、最初のうちは元のファイルと同じ大きさで、同じファイル名にしておくと簡単です。 もし違うファイル名の画像を使うなら、style.css の中に記述されている該当部分のファイル名を変更してください。

消してはいけないもの - Smarty変数

いろいろと足せることが分かったら、こんどは削ってみましょう。
基本的に html のタグは消したところでそれほど致命傷になることは少ないでしょう。ただ、山括弧（<>）とブレース（{}）に囲まれた要素── Smarty 変数には気をつけてください。「$を忘れた」「括弧が不完全だった」というだけで真っ白になり得ます。

Smarty 変数／書式の例

<{$xoops_url}>
<{foreach .....}>

しかし真っ白になったところで、ローカルのテキストエディタでいじっている分には、Undo を繰り返せばよいだけでそれほど恐れる必要はありません。
しっちゃかめっちゃかにしても、複製したファイルをいじっている分には、フォルダの名前をちょっと戻してやれば、すぐに元に戻ることができます。
慣れてきたら、Smarty 変数も消したりしてみましょう。XOOPS の中で、どの変数がどんな仕事をしているかが分かってくるはずです。
ただし条件分岐文には気をつけてください。<{if ...}>...<{/if}>というようなつがいになっているものがその代表格ですが、このペアはきちんと相方がいないと、たいがい真っ白をかえしてきます。ここを消すときは、つがいで消すようにしてください。

調子に乗ってみる

あとはどんどんのめり込んでいってください。
CSS をいじるのも table をとりさって div に置き換えるのも自由自在です