Home > Reference > [WP]テンプレートファイルの仕様と構成

[WP]テンプレートファイルの仕様と構成

テンプレートファイルの役割やら構成なんかについてのまとめ。そこそこ初心者向け。

Wordpressテーマ概要

Wordpressのデザインはテーマと呼ばれてます。テーマを構成するファイル群がテンプレートファイルです。
他のブログのようにテーマをテンプレートと呼んでも通じるけど、検索するときはテーマ(Theme)を使う方が良いかも。

ダウンロードしたばかりだと"Classic" と "Default"の２つがプリインストールされてますが、
テーマ新しく追加する場合は、ダウンロードして解凍したテーマのフォルダをWordpressのwp-content/themes/にアップロードするだけ。
デザイン（表示）に並ぶテーマのスクリーンショットをクリックすれば即座に変更されます。
テーマ変更で再構築が必要ない、というのがWordpressの良いところ。

Wordpressは1.x系、2.0.x系、2.1.x系、2.2以降と2.5以上では内部仕様が違ってるので、テーマやプラグインはバージョンにあったものを選ばないとエラーが出たりするので注意。
特に2.7は最新とあって対応してるテーマやプラグインもまだ少ないようです。
公式のリスト»
WordPress 2.7 Theme Compatibility List
WordPress 2.7 Plugin Compatibility List
ver2.5→ver2.7に修正

Wordpressはコアファイル・プラグイン等全てPHPなので、PHPとmySQLに通じていればかなり色々なことができます。
テーマを構成するテンプレートファイルは、XHTMLとPHPのテンプレートタグで作成されてます。
XHTMLとUTF-8で記述するのがベターですが、HTMLでも文字コードさえ合ってれば問題はないです。
文字コードはWordpress2.5ではUTF-8のみになりました。
テキストエディタはBOM無しのUTF-8で保存できるものを選ぶ必要があります。(メモ帳はダメ！絶対）

テンプレートに記述するWordpress独自のPHPコードはテンプレートタグの他、ループやファンクションなどかなり色々使えます。
PHPの関数や変数なんかも使えます。

特別なファイル

テンプレートファイル群の中に特別重要なものが２つあります。style.cssとfunctions.phpです。
style.cssにはただのphpファイルの集まりに過ぎないフォルダを、Wordpressにテーマと認識させる重要なコメントが入ります。
functions.phpはテーマで使う関数や初期設定、ウィジェットなどのソースコードが入ります。（無くても動きます）

style.cssを開くと、冒頭にコメントが入ってます。
このコメントがないとテーマと認識されません。

PLAIN TEXT
CSS:
  1. /*   
  2. Theme Name: テーマの名前
  3. Theme URI: テーマのホームページＵＲI
  4. Description: テーマの概要
  5. Author: 作者の名前
  6. Author URI: 作者のサイト
  7. Template: テンプレートファイルを使用するテーマの名前
  8. Version: バージョン
  9. Tags:タグ
  10. .
  11. General comments/License Statement if any.
  12. ライセンスとか
  13. .
  14. */

プラグインやページテンプレートでもそうですが、この冒頭のコメントで判断するのでコレを忘れると認識されません。
Templateはオプションで、ここに他のテーマの名前を入れるとその名前を書いたテーマのテンプレートファイル（index.php等）にスタイルシートだけ適用させることが出来ます。

functions.phpは名前の通りテーマで使う関数を入れるファイルです。
オリジナルのサイドバーウィジェットや、オプション設定などもここに記述できます。
このファイルを使えるようになってくるとカスタマイズが楽しくなること請け合い。

テンプレートファイルリスト

見てる人と表示に使われるテンプレートファイルの関係はこの画像が分かりやすいです。
Template Hierarchy»Visual Overview（新しいタブで開くした方がいいかも）

基本テンプレート一覧

style.css(必須)
テーマのメインとなるスタイルシートファイル。上で書いたコメントが必要。@importで他のＣＳＳを読み込む事が出来ます
index.php
メインテンプレート。カテゴリやページ、シングルページにそれぞれテンプレートファイルがある場合はそちらが優先して使用されます。最低これとcomments.phpがあれば動く。
comments.php
コメントエリア表示用テンプレート。コメントフォームとコメントのリスト表示を担当します。Defaultのテンプレートを流用するのがベター。
comments-popup.php
ポップアップのコメントエリア表示用テンプレート。Defaultのテンプレートを流用するのがベター。
headにcomments_popup_script();、ループ内にcomments_popup_link();があると表示される。
テーマ内にテンプレートが見つからない場合は、Deafaultのテンプレートが使用される。
home.php
ホームページ用のテンプレート。固定ページに設定しない場合にこのテンプレートファイルがあると、トップだけこのテンプレートが使われます。
single.php
投稿記事用テンプレート。時事系列に沿わないページには適用されない。
page.php
ページ用テンプレート。ページは１ページずつ独自のテンプレートを設定することも出来ますが、それが設定されてない場合に使用される。
paged.php
archive.phpやsearch.phpで２ページ目以降がある場合に使われる。category.php・date.php・author.phpがある場合はそちらが優先されるので使用されない。
category.php
カテゴリー用テンプレート。カテゴリー一覧を表示する際に使用される。
author.php
投稿者用テンプレート。投稿者情報を表示する際に使用される。
date.php
日時クエリで表示する際に使用されるテンプレート。アーカイブと似てる
archive.php
アーカイブ表示用テンプレート。表示優先順位はcategory.php、author.php、date.phpより下。
search.php
検索結果用テンプレート。無い場合はindex.phpが使われる。
404.php
404 Not Found用のテンプレート。無い場合はindex.php。
image.php
画像表示用テンプレート。[gallary]の画像ファイル単体表示（v2.5～）
attachment.php
画像表示用テンプレート。「ページにリンク」を選択した時の画像表示用
tag.php
タグ用テンプレート。タグのアーカイブ表示

パーツテンプレート
呼び出しタグが用意されているパーツテンプレートは次の通り。

header.php（get_header();)
ヘッダ出力用のテンプレート。
footer.php(get_footer();)
フッター出力用のテンプレート。
sidebar.php(get_sidebar();)
サイドバー出力用のテンプレート

関数がなくてもincludeなどで取得して表示することが出来ます。
たとえば検索フォームだけのテンプレートを作ったら▼

PLAIN TEXT
PHP:
  1. <?php include (TEMPLATEPATH . '/searchform.php'); ?>

searchform.phpには検索フォームのソースだけ記述すればおｋ。

Dreamweaverのライブラリみたいな感じです。

Page　Templates

ページには、各ページごとにそれぞれ独自のテンプレートを使うことが出来ます。
作成方法は、任意の名前.phpでファイルを作成して、冒頭に次のコメントを入れるだけ。

PLAIN TEXT
PHP:
  1. <?php
  2. /*
  3. Template Name: Snarfer
  4. */
  5. ?>

ページ作成の際にテンプレートを選ぶオプションが増えるので、そこから使うテンプレートを選べば適用されます。

Category　Templates

カテゴリーを表示するテンプレートはいくつかあります。優先順位は次の通り。

  1. category-6.php
  2. category.php
  3. archive.php
  4. index.php

category-6.phpのように英数をつけたテンプレートを作ると、英数と同じIDのカテゴリーを表示するときだけ使用されます。

Author Templates

投稿者ページを表示するには、まず次のリンクをループ内に記述します。

PLAIN TEXT
PHP:
  1. <p>投稿者: <?php the_author_posts_link(); ?></p>

投稿者のリストも表示出来ます

PLAIN TEXT
PHP:
  1. <h2>List of authors:</h2>
  2. <ul>
  3. <?php wp_list_authors(); ?>
  4. </ul>

表示の優先順位

  1. author.php
  2. archive.php
  3. index.php

投稿者情報の設定

▼このソースを書いて

PLAIN TEXT
PHP:
  1. <?php
  2. if(isset($_GET['author_name'])) :
  3. $curauth = get_userdatabylogin($author_name); // NOTE: 2.0 bug requires get_userdatabylogin(get_the_author_login());
  4. else :
  5. $curauth = get_userdata(intval($author));
  6. endif;
  7. ?>

失敗するならこちらで▼

PLAIN TEXT
PHP:
  1. <?php
  2. global $wp_query;
  3. $curauth = $wp_query->get_queried_object();
  4. ?>

▼こう書くと

PLAIN TEXT
PHP:
  1. <p>作者情報：<?php echo $curauth->nickname; ?></p>

作者情報：admin　という感じで出力されます。

使えるものは次の通り。出力される値はプロフィールで設定したものです。

  • $curauth->aim; » 連絡先のAIM
  • $curauth->description; » 経歴
  • $curauth->display_name; » ブログ上の表示名
  • $curauth->first_name; » 名前
  • $curauth->ID; » ＩＤ
  • $curauth->jabber; » Jabber / Google Talk
  • $curauth->last_name; » 姓
  • $curauth->nickname; » ニックネーム
  • $curauth->user_email; » E-mail
  • $curauth->user_login; » ログイン名
  • $curauth->user_nicename; » ユーザ名
  • $curauth->user_registered; » 登録日
  • $curauth->user_url; » URL
  • $curauth->yim; » Yahoo IM

サンプルソース（ほんのり日本仕様）

PLAIN TEXT
PHP:
  1. <?php get_header(); ?>
  2.    <div id="content" class="narrowcolumn">
  3.       <!-- This sets the $curauth variable -->
  4. <?php
  5. if(isset($_GET['author_name'])) :
  6. $curauth = get_userdatabylogin($author_name);
  7. else :
  8. $curauth = get_userdata(intval($author));
  9. endif;
  10. ?>
  11.  
  12. <h2><?php echo $curauth->nickname; ?>について</h2>
  13. <dl>
  14. <dt>ウェブサイト</dt>
  15. <dd><a href="<?php echo $curauth->user_url; ?>"><?php echo $curauth->user_url; ?></a></dd>
  16. <dt>プロフィール</dt>
  17. <dd><?php echo $curauth->user_description; ?></dd>
  18. </dl>
  19.  
  20. <h2><?php echo $curauth->nickname; ?>の記事:</h2>
  21.  
  22. <ul>
  23. <!-- The Loop -->
  24. <?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
  25.   <li><?php the_category('&');?> &raquo; <a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link: <?php the_title(); ?>">
  26. <?php the_title(); ?></a>　（<?php the_time('Y/m/j'); ?>）
  27.   </li>
  28.  
  29.   <?php endwhile; else: ?>
  30.      <p><?php _e('投稿はまだありません'); ?></p>
  31.  
  32.     <?php endif; ?>
  33. <!-- End Loop -->
  34. </ul>
  35. </div>
  36. <?php get_sidebar(); ?>
  37. <?php get_footer(); ?>

＜参考＞

このエントリをはてなブックマークに追加このエントリをdel.icio.usに追加このエントリをLivedoor Clipに追加このエントリをYahoo!ブックマークに追加このエントリをFC2ブックマークに追加このエントリをNifty Clipに追加このエントリをPOOKMARK. Airlinesに追加このエントリをBuzzurl（バザール）に追加このエントリをChoixに追加このエントリをnewsingに追加

Comments:0

Comment Form
Remember personal info

Trackbacks:3

Trackback URL for this entry
http://tenderfeel.xsrv.jp/wordpress/reference/154/trackback/
Listed below are links to weblogs that reference
[WP]テンプレートファイルの仕様と構成 from WebTecNote
pingback from WordPress テンプレートファイル構成 | インターネット入口「まなび」 08-05-14 (水) 12:06

[...] [WP]テンプレートファイルの仕様と構成 [...]

pingback from 花風Milk-Tea* - WPサイトを始めました 09-01-06 (火) 20:30

[...] わーどぷれすっ！>> Wordpressのヒント * power source* » WordPress * WebTecNote » WordPress Archive * WordPress Plugins/JSeries * de-sign.log » WordPress Archive * camcam» WordPress Archive * [...]

pingback from 花風Milk-tea* - WPサイトを始めました 09-01-07 (水) 12:08

[...] * わーどぷれすっ！>> Wordpressのヒント * power source* ? WordPress * WebTecNote ? WordPress Archive * WordPress Plugins/JSeries * de-sign.log ? WordPress Archive * camcam? WordPress Archive * [...]

Home > Reference > [WP]テンプレートファイルの仕様と構成

Scripts
カテゴリー
Recent Reactions
最近の投稿
最近の修正
  • そしてこのSQLはわれながらよく書いたと思う 2010-11-15
  • CSVの列っていう方がいいのかな…118項目だった 2010-11-15
  • 楽天のCSVの項目が116個もあった衝撃 2010-11-15
  • オフィスで香水臭振りまくのは迷惑だと知れ 2010-11-15
  • ぐあー　フレグランステロやー 2010-11-15
  • More updates...

Powered by Twitter Tools

Tag Cloud
おすすめサーバー・他

メタ情報

Return to page top