新しい PC が欲しいぞ。

新しい PC が欲しいぞ。

現在の私のPCは、Core2 Duo の メモリ 2G の WindowsXP なのですが、そろそろ 新しいPCが欲しくなってきやした。
なんせ、趣味の範囲ですが、ソフト開発なぞしちょりますと、PCが強ければトライ＆エラーの効率が違うのでし。

本来は、設計と机上デバックがしっかりできれば豪華なPC環境は必要無いのでしょうが、
私にはそんな事はできませんですハイ。

特に SSD が手の届く価格になってきたので、SSD RAID の PC が欲しい。
できれば、メモリ 8G くらいで、Windows7 のやつ。

BTO PC 検索サイト

wp_enqueue_script() 関数

はい、今日は is_singular() 関数を調べたときに放置しておいた wp_enqueue_script() 関数を見てみます。
header.php 内のコードは ↓ の通り。

<?php if ( is_singular() ) wp_enqueue_script( 'comment-reply' ); ?>

既に is_singular() の時に wp_enqueue_script() 関数は ＪａｖａＳｃｒｉｐｔを滞りなく読み込む関数というのは判明しているので、
とりあえず ソースコードだけ見ておきます。

wp_enqueue_script() ソースコード

wp_enqueue_script() 関数のソースコードは以下の通り
/wp-includes/functions.wp-scripts.php 82行-103行 (WordPress version 2.9.2)

/**
 * Enqueues script.
 *
 * Registers the script if src provided (does NOT overwrite) and enqueues.
 *
 * @since r16
 * @see WP_Script::add(), WP_Script::enqueue()
*/
function wp_enqueue_script( $handle, $src = false, $deps = array(), $ver = false, $in_footer = false ) {
	global $wp_scripts;
	if ( !is_a($wp_scripts, 'WP_Scripts') )
		$wp_scripts = new WP_Scripts();

	if ( $src ) {
		$_handle = explode('?', $handle);
		$wp_scripts->add( $_handle[0], $src, $deps, $ver );
		if ( $in_footer )
			$wp_scripts->add_data( $_handle[0], 'group', 1 );
	}
	$wp_scripts->enqueue( $handle );
}

おおまかな流れは ↓ のようになるでしょうか。

• グローバルで定義されている WP_Scripts クラス変数($wp_scripts) を確認
  (無い場合生成)

• ソースファイルパス($src) が設定されている場合には、ファイルを登録する

• WP_Scripts($wp_scripts) のキューにスクリプト識別名($handle) を追加する

WP_Scripts は /wp-includes/class.wp-scripts.php
基底クラス WP_Dependencies は /wp-includes/class.wp-dependencies.php

テーマを作りたいだけなので、WP_Scripts に関しては今は詳しく調べませんが、とりあえず動作としては

wp_head() が実行されるより前に
wp_enqueue_script(‘登録されているスクリプト識別名’) を実行すれば
対応するスクリプトを順番を考慮して重複無く読み込むための コード が出力される 。

ということで理解しておきます。

header.php での動作

<?php if ( is_singular() ) wp_enqueue_script( 'comment-reply' ); ?>

$scripts->add( 'comment-reply', "/wp-includes/js/comment-reply$suffix.js", false, '20090102');

is_singular() 関数

さて、続きまして～は、次の一文の is_singular() 関数

<?php if ( is_singular() ) wp_enqueue_script( 'comment-reply' ); ?>

WordPress 2.9.2 の themes/default/header.php だと、31行目に記述されています。

WordPress Codex の解説では、

ですと。

つまり、WordPress には、is_ 系の関数が沢山あって、
その内 is_single(),is_page(),is_attachment() 関数のどれかが true を戻す場合には is_singlar() も true を戻す。

ほいでは、シングルページ、固定ページ、個別投稿ページとは何なんか？ってところ。
色々調べた結果、

という事らしい。
なので、is_singlar()関数は、特定の投稿、固定ページ、メディアが表示される場合に true を戻すことになる。

へむ。了解っす。
ほいでは、実際のコードをみていくかな。

is_singlar() 関数のコード

/**
 * Whether is single post, is a page, or is an attachment.
 *
 * @since 1.5.0
 * @uses $wp_query
 *
 * @return bool
 */
function is_singular() {
	global $wp_query;

	return $wp_query->is_singular;
}

bloginfo() 関数

今日は、header.php で２番目に出てきた関数 bloginfo() を勉強してみやす。
オイラは不器用やけん。

↓ はちょいと改行してるけど、header.php の８行目くらいに出てきているコードの抜粋で、bloginfo() 関数が２回使われていやす。

<meta http-equiv="Content-Type"
	content="<?php bloginfo('html_type'); ?>;
	charset=<?php bloginfo('charset'); ?>" />

この bloginfo() 関数は WordPress プロジェクト中の PHPファイルに数十箇所使われているので、
WordPressのごく基本的な関数の１つで bloginfo って関数名からも分かるけど、WordPress のブログ設定の値や文字列を取得する関数だな。多分。

ほいじゃ、実際のコードを見てみるか。
function bloginfo() も general-template.php に定義されていた。

/**
 * Display information about the blog.
 *
 * @see get_bloginfo() For possible values for the parameter.
 * @since 0.71
 *
 * @param string $show What to display.
 */
function bloginfo($show='') {
	echo get_bloginfo($show, 'display');
}

グゲッ。。。
get_bloginfo() を ‘display’ って指定して呼び出してからの～ 表示っすか。。。
ではそちらを、 general-template.php にありんす。

/**
 * Retrieve information about the blog.
 *
 * Some show parameter values are deprecated and will be removed in future
 * versions. Care should be taken to check the function contents and know what
 * the deprecated blog info options are. Options without "// DEPRECATED" are
 * the preferred and recommended ways to get the information.
 *
 * The possible values for the 'show' parameter are listed below.
 * <ol>
 * <li><strong>url<strong> - Blog URI to homepage.</li>
 * <li><strong>wpurl</strong> - Blog URI path to WordPress.</li>
 * <li><strong>description</strong> - Secondary title</li>
 * </ol>
 *
 * The feed URL options can be retrieved from 'rdf_url' (RSS 0.91),
 * 'rss_url' (RSS 1.0), 'rss2_url' (RSS 2.0), or 'atom_url' (Atom feed). The
 * comment feeds can be retrieved from the 'comments_atom_url' (Atom comment
 * feed) or 'comments_rss2_url' (RSS 2.0 comment feed).
 *
 * There are many other options and you should check the function contents:
 * {@source 32 37}
 *
 * @since 0.71
 *
 * @param string $show Blog info to retrieve.
 * @param string $filter How to filter what is retrieved.
 * @return string Mostly string values, might be empty.
 */
function get_bloginfo($show = '', $filter = 'raw') {

	switch($show) {
		case 'url' :
		case 'home' : // DEPRECATED
		case 'siteurl' : // DEPRECATED
			$output = get_option('home');
			break;
		case 'wpurl' :
			$output = get_option('siteurl');
			break;
		case 'description':
			$output = get_option('blogdescription');
			break;
		case 'rdf_url':
			$output = get_feed_link('rdf');
			break;
		case 'rss_url':
			$output = get_feed_link('rss');
			break;
		case 'rss2_url':
			$output = get_feed_link('rss2');
			break;
		case 'atom_url':
			$output = get_feed_link('atom');
			break;
		case 'comments_atom_url':
			$output = get_feed_link('comments_atom');
			break;
		case 'comments_rss2_url':
			$output = get_feed_link('comments_rss2');
			break;
		case 'pingback_url':
			$output = get_option('siteurl') .'/xmlrpc.php';
			break;
		case 'stylesheet_url':
			$output = get_stylesheet_uri();
			break;
		case 'stylesheet_directory':
			$output = get_stylesheet_directory_uri();
			break;
		case 'template_directory':
		case 'template_url':
			$output = get_template_directory_uri();
			break;
		case 'admin_email':
			$output = get_option('admin_email');
			break;
		case 'charset':
			$output = get_option('blog_charset');
			if ('' == $output) $output = 'UTF-8';
			break;
		case 'html_type' :
			$output = get_option('html_type');
			break;
		case 'version':
			global $wp_version;
			$output = $wp_version;
			break;
		case 'language':
			$output = get_locale();
			$output = str_replace('_', '-', $output);
			break;
		case 'text_direction':
			global $wp_locale;
			$output = $wp_locale->text_direction;
			break;
		case 'name':
		default:
			$output = get_option('blogname');
			break;
	}

	$url = true;
	if (strpos($show, 'url') === false &&
		strpos($show, 'directory') === false &&
		strpos($show, 'home') === false)
		$url = false;

	if ( 'display' == $filter ) {
		if ( $url )
			$output = apply_filters('bloginfo_url', $output, $show);
		else
			$output = apply_filters('bloginfo', $output, $show);
	}

	return $output;
}

結構長ひ。

bloginfo $site 引数

コードとしては、引数 $show の文字列によって case 分けしちょるが、使っている関数はまだわからんので、
WordPress本家の日本語ドキュメントから記述してみた。

$show で指定される情報を取得した後、
$filter が ‘display’ である場合には、なにがしかの フィルターを適用し、その結果を戻している。

bloginfo() 関数は get_bloginfo() を $filter = ‘display’ で呼び出しているため、フィルターは必ず適用されていることになる。

まぁ、get_bloginfo() で取得した文字列を表示する関数なので、

一応 bloginfo() を試してみる

こんなんで、テストコードもなんなんだけど、一応やってみやした。

テストコード

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Word Press bloginfo()関数のテスト</title>
</head>
<body>
    <div>
    <?php
	bloginfo('url');		echo	"<br />\n";
	bloginfo('home');		echo	"<br />\n";
	bloginfo('siteurl');		echo	"<br />\n";
	bloginfo('wpurl');		echo	"<br />\n";
	bloginfo('description');	echo	"<br />\n";
	bloginfo('rdf_url');		echo	"<br />\n";
	bloginfo('rss_url');		echo	"<br />\n";
	bloginfo('rss2_url');		echo	"<br />\n";
	bloginfo('atom_rul');		echo	"<br />\n";
	bloginfo('comments_atom_url');	echo	"<br />\n";
	bloginfo('comments_rss2_url');	echo	"<br />\n";
	bloginfo('pingback_url');	echo	"<br />\n";
	bloginfo('stylesheet_url');	echo	"<br />\n";
	bloginfo('stylesheet_directory');echo	"<br />\n";
	bloginfo('template_directory');	echo	"<br />\n";
	bloginfo('template_url');	echo	"<br />\n";
	bloginfo('admin_email');	echo	"<br />\n";
	bloginfo('charset');		echo	"<br />\n";
	bloginfo('html_type');		echo	"<br />\n";
	bloginfo('version');		echo	"<br />\n";
	bloginfo('language');		echo	"<br />\n";
	bloginfo('text_direction');	echo	"<br />\n";
	bloginfo('name');		echo	"<br />\n";
	bloginfo();			echo	"<br />\n";
    ?>
    </div>
</body>
</html>

結果

http://127.0.0.1/wordpress

http://127.0.0.1/wordpress

http://127.0.0.1/wordpress

http://127.0.0.1/wordpress

ブログの説明を入力していません。

http://127.0.0.1/wordpress/?feed=rdf

http://127.0.0.1/wordpress/?feed=rss

http://127.0.0.1/wordpress/?feed=rss2

WPテーマ作成用

http://127.0.0.1/wordpress/?feed=comments-atom

http://127.0.0.1/wordpress/?feed=comments-rss2

http://127.0.0.1/wordpress/xmlrpc.php

http://127.0.0.1/wordpress/wp-content/themes/wpt01/style.css

http://127.0.0.1/wordpress/wp-content/themes/wpt01

http://127.0.0.1/wordpress/wp-content/themes/wpt01

http://127.0.0.1/wordpress/wp-content/themes/wpt01

test@test.com
UTF-8
text/html
2.9.2
ja
ltr
WPテーマ作成用
WPテーマ作成用

ヘッダーPHPの中身を見てみる

Word Press のテーマ、テンプレートに関する情報は結構少ないし、
しかたないので、Word Press の基本テーマ（デフォルトテーマ）の中身をお勉強していることにする。

wp-content/default/ 配下にある ファイル群から探してみたら、ヘッダーを出力する header.php が手頃そうなんで今回は header.php を見てみることにした。

header.php

<?php
/**
 * @package WordPress
 * @subpackage Default_Theme
 */
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" <?php language_attributes(); ?>>

<head profile="http://gmpg.org/xfn/11">
<meta http-equiv="Content-Type" content="<?php bloginfo('html_type'); ?>; charset=<?php bloginfo('charset'); ?>" />

<title><?php wp_title('«', true, 'right'); ?> <?php bloginfo('name'); ?></title>

<link rel="stylesheet" href="<?php bloginfo('stylesheet_url'); ?>" type="text/css" media="screen" />
<link rel="pingback" href="<?php bloginfo('pingback_url'); ?>" />

<style type="text/css" media="screen">

<?php
// Checks to see whether it needs a sidebar or not
if ( empty($withcomments) && !is_single() ) {
?>
	#page { background: url("<?php bloginfo('stylesheet_directory'); ?>/images/kubrickbg-<?php bloginfo('text_direction'); ?>.jpg") repeat-y top; border: none; }
<?php } else { // No sidebar ?>
	#page { background: url("<?php bloginfo('stylesheet_directory'); ?>/images/kubrickbgwide.jpg") repeat-y top; border: none; }
<?php } ?>

</style>

<?php if ( is_singular() ) wp_enqueue_script( 'comment-reply' ); ?> 

<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<div id="page">

<div id="header" role="banner">
	<div id="headerimg">
		<h1><a href="<?php echo get_option('home'); ?>/"><?php bloginfo('name'); ?></a></h1>
		<div class="description"><?php bloginfo('description'); ?></div>
	</div>
</div>
<hr />

header.php の役割

ファイル名でそのままでしょうが、ページのヘッダー部分の出力を担ってる様子。

ヘッダーなんだから単純に <head>～</head> にしてもらいたい所だが、オイラみたいな凡人のWP初心者には計り知れない部分があるのやろう。。。

is_singular() ？, wp_enqueue_script() ？ とかとか、分からない部分も満載だけど、とりあえず

header.php は DOCTYPE、<head>～</head>、<body> 開始タグ、トップタイトルとその背景も出力していると。

ふぅ疲れた。。。今日はこの辺にしといたらぁー！！

ちっとも進まんなぁ。

Word Press をローカルに用意する

なにはともあれ、Word Press をローカル環境に用意しなければならない。

自信があれば、テーマ作成＆テストをレンタルサーバーでやれるかもしれないが、
Word Press テーマはPHPも含むので、バグを出したら責任問題になってまう。（おーコワ）

ＸＡＭＰＰインストール

おいらはWindows環境なんで、云わずと知れた XAMPP 様をインストール。

できるだけ PHPとMySQLのバージョンを借りているサーバー環境に合わせておきたいが、
特別な事しなければ、メジャーバージョンだけ一致で大丈夫でしょうな。

Windows版インストーラ を使ってインストールするなら
XAMPP インストーラを使ってインストール
のページにしたがって実行すればOK。

あとは、

1. Apache の admin ページを表示してセキュリティの設定して
2. MySQL の admin ページを表示してパスワードの設定して
   

   XAMPP コントロールパネル

3. C:\xampp\htdocs\.htaccess を localhost だけ許可で作成して

   
   Order deny,allow
   Deny from All
   Allow from localhost 127.0.0.1
   

4. Word Press が使う MySQL のデータベースを作成して
   

   MySQL Word Press 用データベース作成

これで一応準備は良いかな。

Word Press インストール

hoi、続いて Word Press のインストール

Word Press ダウンロード

Word Press ホームページから 「 使わせてもらいま～す！ 」 と叫びながら
[ WordPress 2.9.2 をダウンロード ] ボタンを押してダウンロード。

（2010.3.6 の最新版は WordPress 2.9.2 でした。）

ZIPで圧縮されているので、解凍ソフトで展開します。