ARTISAN PROJECT download | documentation | license



CCDB デザインカスタマイズ

CCDBskinでのデザインカスタマイズ

CCDB デザインカスタマイズ

カスタマイズは…
ここでは掲示板のデザインを自分でカスタマイズしたい方への説明をします。

HTMLエディタ等のアプリを使ってももちろん作成できますが、多少のHTML知識が必要です。
初めての方は、まずサンプルスキンやテンプレートのカスタマイズからスタートして、構造を理解してからオリジナルに挑戦してみてください。(カスタマイズにはスタイルシートの知識が必要ですが・・・)

カスタマイズについては、基本的にskin配布者による規定に従ってください。なお、skinやテンプレートのカスタマイズのご質問にはお答えしかねますのでご了承ください。
デザインの種類と方法
CCDBのデザインカスタマイズは以下の3種類の方法ですることが出来ます。
  • CCDBskin
  • CCDBtemplate
  • apeskin
CCDBskinとCCDBtemplateはオリジナルのSmartyのタグを活用してデザインを行い、apeskinに関しては、apeboard+のために作られているskinを活用してデザインします。
Smartyとは…
CCDBのskinやtemplateを作るにあたり、Smartyの存在を無視することは出来ません。
Smartyとは一体なんなのでしょうか?

SmartyとはPHPのためのテンプレートエンジンです。HTMLの中にタグを組み込むことで、PHPで書かれたプログラムを呼び出すことが出来ます。
CCDBでは、<%〜>〜</%〜>で囲われたSmartyの独自タグを使用します。


CCDBskinでのデザインカスタマイズ

CCDBskinでデザイン出来ること。
CCDBskinではtemplateよりも簡単に設定できるようなっています。
いわばtemplateの簡略版です。ですからtemplateと違い、出来ないことが何点かあります。
templateではエラーページや書き込み確認画面などもデザインに応じて作ることも出来ますが、skinでは次項で説明するファイル内に含まれている項目以外は基本的にカスタマイズすることが出来ません。
より高度なデザインを行いたいときには、templateを作るとよいでしょう。
必要ファイル
CCDBskinでは以下のファイルが必要です。
  • ccdb_configure.cgi
  • index.html
  • res.html
最低限としてこの3つが必ず必要ですが、デザインにより他にhtmlファイルを用意することも考えられます。
ccdb_configure.cgiの設定
ccdb_configure.cgiは内容を読んで指定された書き方で設定変更を行ってください。
注意しなくてはいけない点は、このファイル上でオフにした機能は、index.htmlやres.htmlで表示の設定をしても、空の値が返ってくるため、何も表示されません。
また、逆にccdb_configure.cgiで設定した内容をCCDBtemplateの記述様式でhtml内に書き込むと、どちらも反映されるので注意してください。
index.html&res.htmlの設定
index.htmlとres.htmlはhtmlタグと前項で説明した独自タグを組合せて構成します。
独自タグに関しては
bbs/lib/bbsRegisterfunction.php
の中に記載があります。(もうちょっとしたら、コレもマニュアルかリファレンス作ります)
それ以外にもSmartyの関数も使えます。
Smartyの関数に関しては
http://php.five-foxes.com/man/artisansmarty/
に記載があります。
ただし、CCDBでは
<%〜>〜</%〜>で囲われたタグが有効ですので、(〜)にSmartyマニュアルはなっているので書き換えましょう。
独自タグの利用に関してはソースを参照してください。
説明に「試みます」と書かれているタグや「宣誓します」と書かれているタグはは、templateで機能を使うことを宣言するタグなのでskinでは必要ありません。
しかし、内容の表示させるタグに関してはその部分を利用して表示させるので必要に応じて活用してください。

© Copyright 2004-2009 ARTISAN PROJECT All rights reserved.