• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(最新版のマージ)
(軽微な助詞の誤りを修正)
3行目: 3行目:
 
== 説明 ==
 
== 説明 ==
 
<!-- == Description == -->
 
<!-- == Description == -->
''home_url'' テンプレートタグは、現在のブログのホームURLを返し、任意の<tt>$path</tt>を追加出来る引数を持ちます。この関数は適切はプロトコルを判断し、[[関数リファレンス/is_ssl|is_ssl()]]/[[:en:Function Reference/is_ssl|en]] が有効な場合は ''https''、それ以外の場合は ''http'' です。[[#Parameters|scheme]] で "http" か "https" を指定すると <tt>is_ssl()</tt> は無効になります。
+
''home_url'' テンプレートタグは、現在のブログのホームURLを返し、任意の<tt>$path</tt>を追加出来る引数を持ちます。この関数は適切なプロトコルを判断し、[[関数リファレンス/is_ssl|is_ssl()]]/[[:en:Function Reference/is_ssl|en]] が有効な場合は ''https''、それ以外の場合は ''http'' です。[[#Parameters|scheme]] で "http" か "https" を指定すると <tt>is_ssl()</tt> は無効になります。
  
 
WordPressで [[Create_A_Network|ネットワークの作成]] をしている場合は、 [[テンプレートタグ/network_home_url|network_home_url()]] を使います。
 
WordPressで [[Create_A_Network|ネットワークの作成]] をしている場合は、 [[テンプレートタグ/network_home_url|network_home_url()]] を使います。

2018年2月27日 (火) 15:58時点における版

説明

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 esc_url( home_url( '/' ) ); ?>

引数

$path
string) (省略可) ホームURLからの相対パス。
初期値: なし
$scheme
string) (省略可) ホームURLに使うスキーム。現在利用できるのは httphttpsrelative(相対パス)。
初期値: 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

変更履歴

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

ソースコード

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

関連項目

WordPress ディレクトリ:
home_url() ホーム URL http://www.example.com
site_url() サイトディレクトリ URL http://www.example.com または http://www.example.com/wordpress
admin_url() 管理画面ディレクトリ URL http://www.example.com/wp-admin
includes_url() /en インクルードディレクトリ URL http://www.example.com/wp-includes
content_url() /en コンテンツディレクトリ URL http://www.example.com/wp-content
plugins_url() /en プラグインディレクトリ URL http://www.example.com/wp-content/plugins
wp_upload_dir() /en アップロードディレクトリ URL (配列を返す) http://www.example.com/wp-content/uploads



関数リファレンステンプレートタグ目次もご覧ください。


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