XCL 管理画面テーマの仕組み :: xoops123

admin テーマは次のフォルダに置かれる。

modules/legacy/admin/theme/

管理画面全体のテーマファイル

admin_theme.html

管理画面で使われるスタイルシート (ファイル名は admin_theme.html 内に記述)

stylesheets/style.css
modules/{dirname}/admin/templates/stylesheets/module.css

ファイルのフォルダ探索優先順位 (dirname は現在の選択モジュール)

1) themes/admin/modules/{dirname}/
2) themes/admin/
3) modules/{dirname}/admin/templates/
4) modules/legacy/admin/theme/

管理画面用の smarty 関数・モディファイア

<{stylesheet file=xxxx.css static=true}> 関数

stylesheets/xxxx.css を上記のパス上から探して存在すれば次のように展開する。
<link rel="stylesheet" type="text/css" media="all" href="..." />
static=true は、trunk[1076] での拡張で、ファイルを smarty テンプレートではなく静的なファイルとして扱う。
スクリプトを経由しないので処理が高速軽量になる。

theme モデファイア -- 文字列にテーマの URL を付加する

<{"images/xxxx.png"|theme}> のように使い、指定のファイルが存在するテーマの URL に変換する。


static=true を使って読み込む場合、対象ファイルは smarty のテンプレートでない点に注意すること。当然 theme モディファイアは使えない。

それぞれの管理画面に対応するテンプレート

modules/{dirname}/admin/templates/ 以下のファイルを使う。
フォルダ探索優先順位に従いファイル探索を行うので、themes/admin フォルダにファイルを置くと置換えができる。