デザイナーのためのCakePHP入門

5月 2nd, 2008 admin Posted in CakePHP |

対象

プログラマがCakePHP(1.2)を押し付けてきてひどい目に遭っているコーディング担当用
PHPが< ?phpで始まり、?>で終わるということぐらいは知っているということにします。

拡張子

CakePHPで使われるデザインが書かれたファイル（以下テンプレート）の拡張子は.thtmlと.ctpがあります。.htmlだったら便利なんですけどね。プログラマからの嫌がらせだと思ってください。
Dreamweaver CS3で.thtml(CakePHP)の拡張子を編集できるようにするTIPS (what a bringdown)
STUDIO KINGDOM Blog � DreamWeaverでCakePHP開発を行う際の設定(.thtml)

編集すべきファイルの場所

ファイルは/app/viewsとかにあります。さすがにこの場所はプログラマに教えてもらいましょう。(プロジェクトによっては場所が違いますので）

テンプレート・・・/app/views/*
スタイルシート･･･/app/webroot/css
画像・・・/app/webroot/img
Javascript・・・/app/webroot/js

webrootにおいては上記の4つのディレクトリ以外は基本的に自由にファイルを配置したりディレクトリを作っても大丈夫です。ただし画像やスタイルシートを上記の4つ以外に入れたいという場合はプログラマに相談してください。

テンプレートの編集

ここからは/app/views以下のテンプレートの編集の話です。CakePHPでは１つのページをいくつかのテンプレートを組み合わせて表示させています。
使われるのは「レイアウト」「メインのテンプレート（コンテント）」「エレメント」の３つです。
DreamWeaver使いの人なら
・レイアウト = テンプレートファイル
・コンテント = 普通のファイル
・エレメント = ユーティリティー
と考えてもらっていいと思います。

レイアウト

/app/views/layoutというディレクトリがあると思います。ここにはレイアウトファイルといってテンプレートの大枠部分が入っています。ヘッダやフッタ部分ですね。

エレメント

/app/views/elementsというディレクトリには各ページで共通のパーツが入っています。メインメニューや、カレンダーなどの表示部分をココに入れておくことが多いです。

helpers,scaffolds,errors

この３つは最初から用意されているディレクトリですので無視して大丈夫です。

それ以外

普通のページ用のテンプレートです。ブログでいうなら記事の表示部分に相当します。

どのファイルを編集すればいいのか

どのページがどのファイルかわからない場合は、編集したいページのURLをみてみてください。
http://example.com/users/edit/1
だった場合は
http://example.com/フォルダ名/ファイル名.ctp/1
ということになります。今回の場合は
/app/views/users/edit.ctp(もしくはedit.thtml)を編集するということです。
たまに違う場合もありますが、フォルダも違うということは滅多にないと思うので同じフォルダのそれっぽい名前のファイルを開いてみてください。

まとめ

これでCakePHPを使った開発の概要がわかってもらえたかと思います。なんだか素朴にPHPを編集していたときと比べるとかなり違っていますが、レイアウトやエレメントは使いこなすことでデザイナーの人にもメリットがある仕組みだと思います。次回は具体的なソースの編集Tipsなどを書く予定です。