カスタムフィールドの基本的な使い方（前編）

カスタムフィールドの基本的な使い方

カスタムフィールドって何？

機能紹介：カスタムフィールド機能

カスタムフィールドはエントリーや、カテゴリー・ブログ・ユーザーに対してメタデータを追加することができる機能です。追加したメタデータは表示や検索用のキーとして利用されます。機能面の紹介は、上記の機能紹介をご覧ください。

メタデータとは？

---

エントリーのメタデータを例に説明します。1つのエントリーを商品情報とした場合、商品がもつ属性的な情報として「色」や「サイズ」、「値段」、「大きさ」などの要素が挙げられます。これらのデータがその商品を説明する情報としてエントリーに添付されます。このようなデータを説明するデータを、メタデータと言います。

a-blog cmsではこのようなメタデータを、カスタムフィールドという機能を使って追加していきます。それを踏まえ、このチュートリアル中では、メタデータという言葉を使わず「カスタムフィールドの情報」と表現します。

カスタムフィールドの追加方法

カスタムフィールドの追加は、入力系の管理テンプレートに入力項目を追加することで行えます。

ファイルのコピー

---

ブログ・カテゴリー・エントリーそれぞれの場合で、カスタムフィールドを追加するときには、お使いのテーマにsystemテーマからファイルをコピーしてくる必要があります。（※ここでsystemテーマを直接編集すると、アップデート時に上書きされてしまいます）

• /admin/entry/edit.html
• /admin/category/edit.html
• /admin/user/edit.html
• /admin/blog/edit.html

systemテーマから上記のファイルを/admin/entry/などのディレクトリ構造を維持しつつお使いのテーマの中にコピーします。今回はエントリーのカスタムフィールドを中心に進めるので、/admin/entry/edit.htmlだけコピーします。

---

フォームの追加

/admin/entry/edit.html

<!--  121~127行目付近 -->
<tr class="detail-fade-body">
<th>トラックバック</th>
<td><textarea name="trackback_url" cols="30"></textarea>
<input type="hidden" name="entry[]" value="trackback_url" /></td>
</tr>
</table>
</div>

<!-- 272~278行目付近 -->
<tr class="detail-fade-body">
<th>トラックバック</th>
<td><textarea name="trackback_url" cols="30">{trackback_url}</textarea>
<input type="hidden" name="entry[]" value="trackback_url" /></td>
</tr>
</table>
</div>

この2カ所が、それぞれエントリー投稿時と、エントリー編集時の設定項目の末尾になります。ここはtable要素でつくられているので、tr要素を加える形でカスタムフィールドを追加してみましょう。

<!-- 272~278行目付近 -->
<tr class="detail-fade-body">
<th>トラックバック</th>
<td><textarea name="trackback_url" cols="30">{trackback_url}</textarea>
<input type="hidden" name="entry[]" value="trackback_url" /></td>
</tr>
<tr>
<th>今聴いている音楽</th>
<td><input type="text" name="listening" value="{listening}" />
<input type="hidden" name="field[]" value="listening" /></td>
</tr>

ここではブログ的に「今聴いている音楽」という項目をつけました。上の例でlisteingという文字列を、自分の作った項目にあわせて編集してみてください。ここで増やしたカスタムフィールドを、テンプレート上部の投稿時の設定項目にも追加してください。

カスタムフィールドの入力項目が追加されましたか？

---

追加し終わったら実際にエントリーをカスタムフィールドにも情報を入力して投稿してみてください。

エントリーの変更時の入力欄に、投稿時に登録したカスタムフィールドの情報が入っていれば成功です。

---

後編に続きます

カスタムフィールドの基本的な使い方（後編）では、今追加したカスタムフィールドの情報を表示・出力に利用する方法について説明していきます。

関連情報

• フォームのチュートリアル：基礎編 第3回 入力項目を追加してみよう
• ケータイのチュートリアル：第7回 カスタムフィールドを使ってみる

---