【テーマ名 】 aipon4
【バージョン】 0.85
【作 成 者】 marine / mistgreen
【動作 環境】 XOOPS Cube Legacy 2.1x (HD1.04)、2.2
【ライセンス】 MIT
【公 開 日 】 2011-10-18
==========================================================
説明(概要)
==========================================================
iPhone 等のスマートフォン対応のXCL2.1x(HD1.04)・XCL2.2用テーマです。HTML5で作っています。
Xoops Cube Legacy 2.2 で動作確認しました。
iPhoneという名称のテーマが既に存在していたので、aiponなんてふざけたテーマ名になっていますが、結構頑張って作りました。
基本は1カラム構成のリキッドデザインで、iPhone等に対応するため、公開時点でもっとも注目されている「jQuery Mobile」を利用しています。
さらに、xugj_block プラグインにより同じページ内に各モジュールのコンテンツを自動で書き出しすことにより画面遷移を高速化したり、ヘッダー右側には、xugj_assign プラグインを利用してインストールされたモジュールに対応するメニューを自動表示するようにしています。
また、ユーザーメニュー項目も自動表示するので、xoopsの互換モジュールである「メインメニュー」「ユーザーメニュー」を利用しない運用が可能となっています。
「jQuery Mobile」が MIT と GPL のデュアルライセンスとなっているので、このテーマについては MIT ライセンスとさせていただきます。
2012.01.15 ファイル破損してたので差し替えました。
==========================================================
説明(詳細)
==========================================================
とりあえず、utf8とeucのlanguageファイルは用意しましたが、HTML5ということとスマートフォンでは utf8ベースで動作すると思いますので、eucでの動作は確認していません。
iPhone用テーマの切り替えについては、株式会社RYUS様作の「iPhone用テーマ切り替えプリロード」を利用し、プリロード内のテーマ名記述部分を変更することにより、このテーマを使うことができる・・・ような気がします。(まだ未確認)
http://ryus.co.jp/modules/d3downloads/index.php?page=singlefile&cid=2&lid=38 メニューは、Xoops Users Group Japan(XUGJ) で GIJOEさんが提唱された xugj_assign.php を利用したメニューを採用しています。
通常のメインメニューに表示されるのと同じ項目が自動で表示されるので、メニューの項目を編集する必要もありません。
http://www.xugj.org/modules/d3forum/index.php?topic_id=125 なお、同封しているものは、オリジナルの xugj_assign.php から少し変更しているので、xugj_assign_aipon4.php という名称に変更しています。
jQuery.js + jquery.jgrowlプラグインを利用して、画面遷移せずにリダイレクト表示できるので、スピーディーでセンスの良い表示が可能となっています。
なお、本テーマには、domifaraさん作成のphpファイルによるインクルード方法を用いております。
domifaraさん、ありがとうございます。
(javascriptオフ時には、リダイレクトの文字などがボックス表示されます。)
jQueryについては、domifaraさんによるXCL2.2対応措置がとられており、jQueryの二重読み込み防止や他のjavascriptとのバッティングを可能な限り避ける仕組みが用いられております。
(xugj_already_js.php をXCL2.1対応版に差し替えております。)
【画面表示について】
このテーマでは、基本、全てのコンテンツが横幅一杯に表示されるように設定しています。
表示順は画面上から次のとおりとなっています。
■ 中央中央カラム 表示順 0
■ モジュールコンテンツ($xoops_contents)・・・モジュールページの場合
■ 中央中央カラム 表示順 1~99
■■ 中央左カラム、中央右カラム (これのみ半分の幅で表示)
■ 中央中央カラム 表示順 100以上
■+ サブコンテンツ(クリックすると展開する)
■ 左右カラム
【メニューから選択したモジュールへの画面遷移について】
前述のとおり、このテーマでは xugj_assign.php プラグインを用いてメニュー項目を自動で作成しており、画面上のヘッダー右端部分に「menu」と表示されるボタンをクリックすることで、メニュー画面に切り替わります。
このメニュー画面において、各モジュールに対応するメニュー項目をクリックすると、それぞれのコンテンツが表示されますが、モジュールのタイプにより次の2とおりの表示があります。
●1 xugj_blockプラグイン によりブロックテンプレート情報が抽出できるモジュールの場合
トップページにデータが抽出、初期状態では非表示となっており、「jQuery Mobile」のページ内リンク表示機能により、あたかも次のページがスライドインするような表示を実現。これにより高速な画面遷移が可能となっています。
対応しているモジュールは次のとおりです。
bulletin、d3blog、d3forum、pico、webphoto、myalbum、d3dialy、weblinks、d3downloads、piCal
ただし、次のページを表示したのち、当該ページ内にリンクされている各モジュールの詳細ページ等に移動する場合は、通常のリンクと同様の動作となるため、表示するには一定の時間が必要となります。
●2 xugj_blockプラグイン に対応していないモジュールの場合
xugj_blockプラグイン によるブロックテンプレート情報が抽出できないため、通常のリンクとしてモジュールのトップ画面に移動します。そのため、表示するには一定の時間が必要となります。
なお、次のモジュールについてメニューへの表示・リンク設定を行っていますので、それ以外の非対応モジュールの場合、またはディレクトリ名を変更してモジュールした非対応モジュールの場合は、下記カスタマイズに従って設定変更してください。
モジュールをインストールしたディレクトリ名 wordpress、liaise、ccenter
==========================================================
インストール
==========================================================
インストールはテーマのアップロード+αが必要です。
まずは、解凍してできあがったフォルダ「aipon4」をFTPにてサイトのテーマ・ディレクトリへコピーしてください。
次に、xugj_block 等の smartyプラグイン 利用のための作業や各モジュールの表示をこのテーマに最適化するため、次の手順でテーマ下テンプレート利用のための作業行ってください。
完了したら通常のテーマと同様、管理画面の「互換モジュール」「テーマの管理」でこのテーマを使用する設定としてください。
【テーマ下テンプレートが利用可能な場合】
ご利用になっている xoops がテーマ下テンプレート利用可能な場合は、本テーマディレクトリ下にある 「templates」ディレクトリに収納されたカスタマイズ済みのテンプレートを利用するようになります。
この場合、xugj_date や xugj_block を利用しますので、本テーマ下の「up/plugin」フォルダに収納されている modifier.xugj_date.php と function.xugj_block.php をFTPにてサイトの「plugin」ディレクトリにコピーしてください。(既に存在する場合は不要)
「plugin」ディレクトリは、XCL2.1x と XCL2.2 では場所が違うのでご注意ください。
XCL2.1xの場合 /XOOPS_ROOT_PATH/class/smarty/plugins/
XCL2.2の場合 /XOOPS_TRUST_PATH/libs/smarty/plugins/ または
/XOOPS_TRUST_PATH/libs/smartyplugins/ (preload「HdXoopsTplHook.class.php」を使っている場合)
【テーマ下テンプレートが利用できない場合】
もし、テーマ下テンプレートを利用できない環境の場合、本テーマ下の「up/preload」フォルダにある HdXoopsTplHook.class.php をFTPにてサイトの「preload」ディレクトリに、本テーマ下の「up/plugin」フォルダにある resource.db.php をサイトの「plugin」ディレクトリにそれぞれコピーしてください。
詳細はこちらを参照して下さい。
http://xoops.peak.ne.jp/md/news/index.php?page=article&storyid=450【テーマ下テンプレート利用可能だが、本テーマのテーマ下テンプレートを使いたくない場合】
逆に、ご利用になっている xoops がテーマ下テンプレート利用可能な状態であって、本テーマ下のテンプレートを使いたくない場合は、テーマ下にある「templates」ディレクトリを削除してください。(当該ディレクトリ内の個別のテンプレートを削除するのも良いでしょう。)
■理由:テーマ下テンプレート利用可能なxoops(HDなど)では、次の優先順位でテンプレートを読み込むため
1 テーマ下テンプレート
2 現在ActiveなDBテンプレート
3 Default(DB)テンプレート
つまり、テンプレートを変更しようとして、Altsysで「現在ActiveなDBテンプレート」をいくら修正しても、テーマ下テンプレートがある場合はそちらが優先されてしまうのです。
==========================================================
カスタマイズ
==========================================================
【メニュー表示項目の変更】
このテーマでは、xugj_assign_phpを用いたメニュー表示を行いますが、インストールして初回表示した時に、メインメニュー表示する設定となっているメニュー項目を自動で引用してきます。(表示用のキャッシュファイルを自動作成して利用)
従って、モジュールの管理にてモジュールの表示名を変えたり、並び順を「0」として非表示指定した場合でも、テーマのメニュー表示は以前作成したキャッシュファイルを利用することから、変更した表示となりません。
そのような場合、FTPソフトを使って、cacheディレクトリ内の theme_aipon4_menus_****.php を削除してください。
再度、サイトを表示した際に、新しくメニュー用のキャッシュファイルが自動生成されます。
なお、domifaraさん作成の「xugjメニューキャッシュリフレシュ 管理画面モジュール」を利用すると、FTPソフトを使わずにキャッシュファイルの削除ができるので、便利だと思います。(domifaraさん、ありがとうございます。)
http://xodomifara.lolipop.jp/doxo/modules/d3downloads/index.php?cid=2【メニューに対応するリンク設定など】
xugj_block 非対応モジュールの場合、iPhne_menu.html 内の記述を編集してください。
もし、wordpressMe(XPress)を blog というディレクトリでインストールした場合、同html内の wordpress というディレクトリ名記述部分を変更してください。
xugj_block 対応モジュールの場合、iPhone_contents.html 内の記述を編集してください。
インストールしたディレクトリ名が異なる場合は、上記と同様にディレクトリ名に対応する部分を編集してください。
その他、xugj_block による抽出やテーマ下テンプレートを変更したい場合は・・・google先生にお尋ねください。