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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連項目)
(最新版のマージ)
1行目: 1行目:
{{CheckTrans}}
 
 
{{テンプレートタグガイド|PHP}}
 
{{テンプレートタグガイド|PHP}}
  
5行目: 4行目:
 
<!-- == 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()]] を使います。
17行目: 15行目:
 
<!-- === Default Usage === -->
 
<!-- === Default Usage === -->
  
  <?php echo home_url(); ?>
+
  <?php echo esc_url( home_url( '/' ) ); ?>
  
 
== 引数<span id="Parameters"></span> ==
 
== 引数<span id="Parameters"></span> ==
41行目: 39行目:
  
 
<pre>
 
<pre>
$url = home_url('/');
+
$url = home_url( '/' );
 
echo $url;
 
echo $url;
 
</pre>
 
</pre>
48行目: 46行目:
  
 
<pre>
 
<pre>
$url = home_url($path = '/', $scheme = https);
+
$url = home_url( $path = '/', $scheme = https );
 
echo $url;
 
echo $url;
 
</pre>
 
</pre>
55行目: 53行目:
  
 
<pre>
 
<pre>
$url = home_url($path = 'example', $scheme = relative);
+
$url = home_url( $path = 'example', $scheme = relative );
 
echo $url;
 
echo $url;
 
</pre>
 
</pre>
85行目: 83行目:
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function Reference/home url|140477}}<!-- 22:21, 14 January 2014 Netweb 版 -->
+
{{原文|Function Reference/home url|146534}}<!--06:33, 9 September 2014‎ Brainfestation 版 -->
  
 
[[Category:wp3.0]]
 
[[Category:wp3.0]]
  
 
[[en:Template Tags/home_url]]
 
[[en:Template Tags/home_url]]

2015年8月10日 (月) 12:51時点における版

説明

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最新版との差分