当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連項目)
(テンプレートタグ/home_url 2018年3月2日 (金) 12:28 Gblsm 版の変更内容をマージ。)
 
1行目: 1行目:
== 説明 ==
+
== 説明<span id="Description"></span> ==
  
'''network_home_url''' テンプレートタグは、現在のサイトネットワークのホームURLを返します。
+
'''network_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> による判定は無視されます。
この関数は適切はプロトコルを判断し、[[Function Reference/is_ssl|is_ssl()]]が有効な場合は'https'、それ以外の場合は'http'です。
+
[[#Parameters|scheme]] で 'http' 'https'を指定すると、is_ssl() は無効になります。
+
  
ネットワークの作成をしていない場合は、[[Function Reference/home_url|home_url()]] を使います。
+
[[Create_A_Network|ネットワークの作成]] をしていない場合は、代わりに [[テンプレートタグ/home_url|home_url()]] を使ってください。
  
== 使い方 ==
+
== 使い方<span id="Usage"></span> ==
  
<pre>
+
<?php network_home_url( $path, $scheme ); ?>
<?php network_home_url( $path, $scheme ); ?>
+
</pre>
+
  
== 引数 ==
+
== パラメータ<span id="Parameters"></span> ==
  
{{Parameter|$path|string| ホームURLからの相対パス。|省略可|なし}}
+
{{Parameter|$path|文字列|ホーム URL からの相対パス。|オプション}}
{{Parameter|$scheme|string|ホームURLに使うスキーム。現在利用できるのは 'http''https'。|省略可|なし}}
+
{{Parameter|$scheme|文字列|ホーム URL にコンテキストを与えるスキーム。現在利用できるのは <tt>"http"</tt> <tt>"https"</tt> と <tt>"relative"</tt>(相対パス)。|オプション|null}}
  
== 戻り値 ==
+
== 戻り値<span id="Return"></span> ==
  
; (string) : オプションとして追加されたパスを含むホームURL。
+
; (文字列) : オプションの引数 $path の値を付加したホーム URL。
  
== 用例 ==
+
== 用例<span id="Examples"></span> ==
  
 
<pre>
 
<pre>
 
$url = network_home_url();
 
$url = network_home_url();
echo $url;
+
echo esc_url( $url );
 
</pre>
 
</pre>
  
出力: http://www.example.com  
+
出力: http://www.example.com
  
 
(最後のスラッシュがないことに注意してください)
 
(最後のスラッシュがないことに注意してください)
  
== 注 ==
+
<pre>
 +
$url = network_home_url( '/' );
 +
echo esc_url( $url );
 +
</pre>
  
* [[Function Reference/home_url | home_url()]] を使用。
+
出力: http://www.example.com/
  
== 更新履歴 ==
+
<pre>
 +
$url = network_home_url( '/', 'https' );
 +
echo esc_url( $url );
 +
</pre>
  
* [[Version 3.0|3.0.0]]:テンプレートタグとして新規追加。
+
出力: https://www.example.com/
  
== ソースコード  ==
+
<pre>
 +
$url = network_home_url( 'example', 'relative' );
 +
echo esc_url( $url );
 +
</pre>
  
<code>network_home_url()</code> は、{{Trac|wp-includes/link-template.php}}にあります。
+
出力: /example
  
== 関連項目 ==
+
== 参考<span id="Notes"></span> ==
  
{{Directory URL Tags}}
+
* [[テンプレートタグ/get_home_url | get_home_url()]] を使用。
  
{{原文|Function Reference/network home url|107337}}
+
== 変更履歴<span id="Changelog"></span> ==
  
 +
* [[Version 3.0|3.0.0]] : 新規導入。
 +
 +
== ソースファイル<span id="Source_Code"></span> ==
 +
 +
<code>network_home_url()</code> は {{Trac|wp-includes/link-template.php}} にあります。
 +
 +
== 関連項目<span id="Related"></span> ==
 +
 +
{{Directory URL Tags}}
 
{{Tag Footer}}
 
{{Tag Footer}}
 +
 +
{{原文|Function Reference/network_home_url|107337}} <!-- 13:22, 12 July 2011 Ramiy 版 -->
 +
 +
{{DEFAULTSORT:Network_home_url}}
 +
[[Category:テンプレートタグ]]
 +
[[Category:関数]]
  
 
[[Category:wp3.0]]
 
[[Category:wp3.0]]
  
 
[[en:Template Tags/network_home_url]]
 
[[en:Template Tags/network_home_url]]

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

説明

network_home_url テンプレートタグは、現在のサイトネットワークのホーム URL を返します。オプションで引数 $path の内容を付加して返すこともできます。この関数は適切なプロトコルを判定します。is_ssl() /en が有効な場合は "https"、それ以外の場合は "http" です。引数 $scheme"http""https" を指定すると、is_ssl() による判定は無視されます。

ネットワークの作成 をしていない場合は、代わりに home_url() を使ってください。

使い方

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

パラメータ

$path
文字列) (オプション) ホーム URL からの相対パス。
初期値: なし
$scheme
文字列) (オプション) ホーム URL にコンテキストを与えるスキーム。現在利用できるのは "http""https""relative"(相対パス)。
初期値: null

戻り値

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

用例

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

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

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

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

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

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

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

$url = network_home_url( 'example', 'relative' );
echo esc_url( $url );

出力: /example

参考

変更履歴

  • 3.0.0 : 新規導入。

ソースファイル

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