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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連項目)
 
(4人の利用者による、間の5版が非表示)
1行目: 1行目:
{{CheckTrans}}
+
== 説明<span id="Description"></span> ==
{{テンプレートタグガイド|PHP}}
+
  
== 説明 ==
+
'''home_url''' テンプレートタグは、現在のブログのホーム URL を返します。オプションで引数 <tt>$path</tt> の内容を付加して返すこともできます。この関数は適切なプロトコルを判定します。[[関数リファレンス/is_ssl|is_ssl()]] /[[:en:Function Reference/is_ssl|en]] が有効な場合は <tt>"https"</tt>、それ以外の場合は <tt>"http"</tt> です。引数 <tt>$scheme</tt> <tt>"http"</tt> <tt>"https"</tt> を指定すると、<tt>is_ssl()</tt> による判定は無視されます。
<!-- == 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> は無効になります。
+
  
 +
WordPressで [[Create_A_Network|ネットワークの作成]] をしている場合は、代わりに [[テンプレートタグ/network_home_url|network_home_url()]] を使ってください。
  
WordPressで [[Create_A_Network|ネットワークの作成]] をしている場合は、 [[関数/network_home_url|network_home_url()]] を使います。
+
== 使い方<span id="Usage"></span> ==
 
+
== 使い方 ==
+
<!-- == Usage == -->
+
  
 
  <?php home_url( $path, $scheme ); ?>
 
  <?php home_url( $path, $scheme ); ?>
  
=== デフォルトの使い方 ===
+
=== デフォルトの使い方<span id="Default_Usage"></span> ===
<!-- === Default Usage === -->
+
  
  <?php echo home_url(); ?>
+
  <?php echo esc_url( home_url( '/' ) ); ?>
  
== 引数<span id="Parameters"></span> ==
+
== パラメータ<span id="Parameters"></span> ==
<!-- == Parameters <span id="Parameters"></span>== -->
+
{{Parameter|$path|string|ホームURLからの相対パス。|省略可}}
+
{{Parameter|$scheme|string|ホームURLに使うスキーム。現在利用できるのは ''http'' と ''https'' と ''relative''(相対パス)。|省略可|null}}
+
  
== 戻り値 ==
+
{{Parameter|$path|文字列|ホーム URL からの相対パス。|オプション}}
<!-- == Return == -->
+
{{Parameter|$scheme|文字列|ホーム URL に使うスキーム。現在利用できるのは <tt>"http"</tt> と <tt>"https"</tt> と <tt>"relative"</tt>(相対パス)。|オプション|null}}
  
; (string) : 引数 $path を含む ホームURL。
+
== 戻り値<span id="Return"></span> ==
 +
 
 +
; (文字列) : オプションの引数 $path の値を付加したホーム URL。
 +
 
 +
== 用例<span id="Examples"></span> ==
  
== 用例 ==
 
<!-- == Examples == -->
 
 
<pre>
 
<pre>
 
$url = home_url();
 
$url = home_url();
echo $url;
+
echo esc_url( $url );
 
</pre>
 
</pre>
  
41行目: 34行目:
  
 
<pre>
 
<pre>
$url = home_url('/');
+
$url = home_url( '/' );
echo $url;
+
echo esc_url( $url );
 
</pre>
 
</pre>
  
48行目: 41行目:
  
 
<pre>
 
<pre>
$url = home_url($path = '/', $scheme = https);
+
$url = home_url( '/', 'https' );
echo $url;
+
echo esc_url( $url );
 
</pre>
 
</pre>
  
55行目: 48行目:
  
 
<pre>
 
<pre>
$url = home_url($path = 'example', $scheme = relative);
+
$url = home_url( 'example', 'relative' );
echo $url;
+
echo esc_url( $url );
 
</pre>
 
</pre>
  
 
出力: /example
 
出力: /example
  
== ==
+
== 参考<span id="Notes"></span> ==
 +
 
 
* [[テンプレートタグ/get_home_url | get_home_url()]] を使用。
 
* [[テンプレートタグ/get_home_url | get_home_url()]] を使用。
* 'home' [[Option Reference|option]] を使用。
+
* [[Option Reference|オプション]] の <tt>'home'</tt> を使用。
  
== 変更履歴 ==
+
== 変更履歴<span id="Changelog"></span> ==
<!-- == Changelog == -->
+
  
* [[Version 3.0|3.0.0]] : テンプレートタグとして新規追加。
+
* [[Version 3.0|3.0.0]] : 新規導入。
<!--
+
* Since: [[Version 3.0|3.0.0]]
+
-->
+
  
== ソースコード ==
+
== ソースファイル<span id="Source_Code"></span> ==
<!-- == Source Code == -->
+
  
<code>home_url()</code> は、{{Trac|wp-includes/link-template.php}} にあります。
+
<code>home_url()</code> {{Trac|wp-includes/link-template.php}} にあります。
  
== 関連項目 ==
+
== 関連項目<span id="Related"></span> ==
<!-- == Related == -->
+
  
 
{{Directory URL Tags}}
 
{{Directory URL Tags}}
 +
{{Tag Footer}}
  
{{原文|Function Reference/home url|140477}}<!-- 22:21, 14 January 2014 Netweb 版 -->
+
{{原文|Function Reference/home url|155959}} <!-- 13:33, 8 March 2016 BrianLayman 版 -->
  
{{Tag Footer}}
+
{{DEFAULTSORT:Home_url}}
 +
[[Category:テンプレートタグ]]
 +
[[Category:関数]]
  
[[Category:Template Tags]][[Category:Functions]]
 
 
[[Category:wp3.0]]
 
[[Category:wp3.0]]
  
 
[[en:Template Tags/home_url]]
 
[[en:Template Tags/home_url]]

2018年3月2日 (金) 21:28時点における最新版

説明

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
文字列) (オプション) ホーム URL からの相対パス。
初期値: なし
$scheme
文字列) (オプション) ホーム URL に使うスキーム。現在利用できるのは "http""https""relative"(相対パス)。
初期値: null

戻り値

(文字列) 
オプションの引数 $path の値を付加したホーム URL。

用例

$url = home_url();
echo esc_url( $url );

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

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

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

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

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

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

$url = home_url( 'example', 'relative' );
echo esc_url( $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最新版との差分