「テンプレートタグ/home url」の版間の差分

2014年5月17日 (土) 15:08時点における版

説明

home_url テンプレートタグは、現在のブログのホームURLを返し、任意の$pathを追加出来る引数を持ちます。この関数は適切はプロトコルを判断し、is_ssl()/en が有効な場合は https、それ以外の場合は http です。scheme で "http" か "https" を指定すると is_ssl() は無効になります。

WordPressで ネットワークの作成 をしている場合は、 network_home_url() を使います。

使い方

<?php home_url( $path, $scheme ); ?>

デフォルトの使い方

<?php echo home_url(); ?>

引数

$path

（string） （省略可） ホームURLからの相対パス。

初期値： なし

$scheme

（string） （省略可） ホームURLに使うスキーム。現在利用できるのは http と https と relative（相対パス）。

初期値： null

戻り値

(string) 

引数 $path を含む ホームURL。

用例

$url = home_url();
echo $url;

出力: http://www.example.com

(最後のスラッシュがないことに注意してください)

$url = home_url('/');
echo $url;

出力: http://www.example.com/

$url = home_url($path = '/', $scheme = https);
echo $url;

出力: https://www.example.com/

$url = home_url($path = 'example', $scheme = relative);
echo $url;

出力: /example

注

• get_home_url() を使用。
• 'home' option を使用。

変更履歴

• 3.0.0 : テンプレートタグとして新規追加。

ソースコード

home_url() は、wp-includes/link-template.php にあります。

関連項目

最新英語版： WordPress Codex » Function Reference/home url （最新版との差分）