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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(07:17, 5 April 2012 MTanriverdi 版 を反映。一部未翻訳です。)
(関連)
 
(3人の利用者による、間の6版が非表示)
1行目: 1行目:
{{NeedTrans|一部}}
 
 
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==
Displays information about your blog, mostly gathered from the information you supply in your '''User Profile''' and '''General Options''' from the WordPress '''Administration''' panels (Settings &rarr; General). It can be used anywhere within a page template. This always prints a result to the browser.  If you need the values for use in PHP, use [[テンプレートタグ/get_bloginfo|<tt>get_bloginfo()</tt>]].
+
サイトの情報を表示させる関数です。情報の殆どは、[[Administration_Panels#Your Profile|プロフィール]]や[[Administration_Panels#General|一般設定]]などの、WordPress [[Administration Screens|管理画面]]で入力されたものです。この関数はテンプレートファイルの至るところで使うことができ、その結果は常にブラウザーに表示されます。PHP の中でこれらの値を使う必要がある場合は、[[Function Reference/get_bloginfo|get_bloginfo()]] を用いてください。
 
</div>
 
</div>
  
13行目: 11行目:
 
<div id="Parameters">
 
<div id="Parameters">
 
== パラメータ ==
 
== パラメータ ==
Note that <strong>directory URLs are missing trailing slashes</strong>. If using  child-theme, that has parent-theme as the parent. Using <tt>bloginfo()</tt> without a parameter will default to <tt>bloginfo('name')</tt>.
+
</div>
 
+
<pre>
+
name                = Testpilot
+
description          = Just another WordPress blog
+
admin_email          = admin@example
+
 
+
url                  = http://example/home    [use home_url('/') instead]
+
wpurl                = http://example/home/wp [use site_url('/') instead]
+
  
stylesheet_directory = http://example/home/wp/wp-content/themes/child-theme
+
{{Parameter|$show|string|所望する情報のキーワード名|Optional|name}}
stylesheet_url      = http://example/home/wp/wp-content/themes/child-theme/style.css
+
template_directory  = http://example/home/wp/wp-content/themes/parent-theme
+
template_url        = http://example/home/wp/wp-content/themes/parent-theme
+
  
atom_url            = http://example/home/feed/atom
+
:* ''''name'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「サイトのタイトル」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "blogname" レコードから取得されるものです。
rss2_url            = http://example/home/feed
+
:* ''''description'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「キャッチフレーズ」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "blogdescription" レコードから取得されるものです。
rss_url              = http://example/home/feed/rss
+
:* ''''wpurl'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「WordPress アドレス (URL)」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "siteurl" レコードから取得されるものです。この関数はサブサイトではなく WordPress がインストールされているルートサイトの URL を返すため、マルチサイト構成で、サブドメインの代わりにパスを用いている場合等は特に [[Function_Reference/site_url | site_url()]] 関数の出力を用いることを推奨します。
pingback_url        = http://example/home/wp/xmlrpc.php
+
:* ''''url'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「サイトアドレス (URL)」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "home" レコードから取得されるものです。[[Function_Reference/home_url | home_url()]] 関数の出力を用いることをお奨めします。
rdf_url              = http://example/home/feed/rdf
+
:* ''''admin_email'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「メールアドレス」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "admin_email" レコードから取得されるものです。
 
+
:* ''''charset'''' - [[Version 3.5|Version 3.5.0]] 以降は "<tt>UTF-8</tt>"を常に返します。その前のバージョンでは、管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|表示設定]]」で設定された「ページとフィードのエンコーディング」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "blog_charset" レコードから取得されるものです。
comments_atom_url    = http://example/home/comments/feed/atom
+
:* ''''version'''' - 使用中の WordPress バージョンを表示します。このデータは {{Trac|wp-includes/version.php}} の <tt>$wp_version</tt> 変数から取得されるものです。
comments_rss2_url   = http://example/home/comments/feed
+
:* ''''html_type'''' - HTML ページの Content-Type (デフォルトは "text/html") を表示します。このデータは、[[Database Description#Table:_wp_options|wp_options テーブル]]の "html_type" レコードから取得されるものです。テーマとプラグインは <tt>[[Plugin_API/Filter_Reference|pre_option_html_type]]</tt> フィルターを用いることで、初期値を上書きすることができます。
 
+
:* ''''text_direction'''' - HTML ページの文字の向きを表示します。[[Function_Reference/is_rtl | is_rtl()]] 関数の出力を用いることを推奨します。
charset              = UTF-8
+
:* ''''language'''' - WordPress の言語を表示します。
html_type            = text/html
+
:* ''''stylesheet_url'''' - プライマリーな [[Glossary#CSS|CSS]] (usually ''style.css'') ファイルの URL を表示します。[[Function_Reference/get_stylesheet_uri | get_stylesheet_uri()]] 関数の出力を用いることを推奨します。
language            = en-US
+
:* ''''stylesheet_directory'''' - アクティブなテーマディレクトリーの URL を表示します。 [[Function_Reference/get_stylesheet_directory_uri | get_stylesheet_directory_uri()]] 関数の出力を用いることを推奨します。
text_direction      = ltr
+
:* ''''template_url'''' / ''''template_directory'''' - アクティブなテーマのディレクトリー URL を表示します。 ('template_directory' は [[Version 2.6]] 以前ではローカルパスを表示していました。ハック的な代替策は [[Function_Reference/get_theme_root|get_theme_root()]] と [[Function_Reference/get_template|get_template()]] を参照してください)。 子テーマの中では、 get_bloginfo('template_url') と get_template() はどちらも<em>親</em>テーマのディレクトリーを返します。そのため、親テーマでは[[Function_Reference/get_template_directory_uri | get_template_directory_uri()]] を、子テーマでは [[Function_Reference/get_stylesheet_directory_uri | get_stylesheet_directory_uri()]] を使うよう考慮してください。
version              = 3.1
+
:* ''''pingback_url'''' - Pingback XML-RPC ファイルの URL (''xmlrpc.php'') を表示します。
</pre>
+
:* ''''atom_url'''' - Atom feed URL (''/feed/atom'') を表示します。
</div>
+
:* ''''rdf_url'''' - RDF/RSS 1.0 feed URL (''/feed/rfd'') を表示します。
 +
:* ''''rss_url'''' - RSS 0.92 feed URL (''/feed/rss'') を表示します。
 +
:* ''''rss2_url'''' - RSS 2.0 feed URL (''/feed'') を表示します。
 +
:* ''''comments_atom_url'''' - Atom feed URL (''/comments/feed'') を表示します。
 +
:* ''''comments_rss2_url'''' - RSS 2.0 feed URL (''/comments/feed'') を表示します。
 +
:* ''''siteurl'''' - Version 2.2 にて廃止されました。[[Function_Reference/home_url | home_url()]] あるいは bloginfo('url') を使ってください。
 +
:* ''''home'''' - Version 2.2 にて廃止されました。[[Function_Reference/home_url | home_url()]] あるいは use bloginfo('url') を使ってください。
  
 
<div id="Examples">
 
<div id="Examples">
63行目: 56行目:
 
ブログで使われている文字コードの表示 (例: utf-8)
 
ブログで使われている文字コードの表示 (例: utf-8)
  
 +
'''注''': [[Version 3.5]] 以降では UTF-8 がデフォルトとなっており、管理画面での設定ができなくなっています。
 
  &lt;p&gt;Character set: <?php bloginfo('charset'); ?> &lt;/p&gt;
 
  &lt;p&gt;Character set: <?php bloginfo('charset'); ?> &lt;/p&gt;
  
70行目: 64行目:
 
  &lt;p&gt;<?php bloginfo('description'); ?> &lt;/p&gt;
 
  &lt;p&gt;<?php bloginfo('description'); ?> &lt;/p&gt;
 
</div>
 
</div>
 +
 +
<div id="Example output">
 +
=== 出力例 ===
 +
</div>
 +
Version 2.7 以降、<tt>example.com</tt> の場合、[[Settings_General_SubPanel|サイトアドレス (URL)]] は <tt>http://www.example.com/home</tt> と表示され、[[Settings_General_SubPanel|WordPress アドレス (URL)]] は <tt>http://www.example.com/home/wp</tt> にインストールされます。
 +
 +
ディレクトリーの URL は最後のスラッシュがないことに注意してください。
 +
 +
<pre>
 +
admin_email          = admin@example.com
 +
atom_url            = http://www.example.com/home/feed/atom
 +
charset              = UTF-8
 +
comments_atom_url    = http://www.example.com/home/comments/feed/atom
 +
comments_rss2_url    = http://www.example.com/home/comments/feed
 +
description          = Just another WordPress blog
 +
home                = http://www.example.com/home (DEPRECATED! use url option instead)
 +
html_type            = text/html
 +
language            = en-US
 +
name                = Testpilot
 +
pingback_url        = http://www.example.com/home/wp/xmlrpc.php
 +
rdf_url              = http://www.example.com/home/feed/rdf
 +
rss2_url            = http://www.example.com/home/feed
 +
rss_url              = http://www.example.com/home/feed/rss
 +
siteurl              = http://www.example.com/home (DEPRECATED! use url option instead)
 +
stylesheet_directory = http://www.example.com/home/wp/wp-content/themes/largo
 +
stylesheet_url      = http://www.example.com/home/wp/wp-content/themes/largo/style.css
 +
template_directory  = http://www.example.com/home/wp/wp-content/themes/largo
 +
template_url        = http://www.example.com/home/wp/wp-content/themes/largo
 +
text_direction      = ltr
 +
url                  = http://www.example.com/home
 +
version              = 3.5
 +
wpurl                = http://www.example.com/home/wp
 +
</pre>
  
 
<div id="Notes">
 
<div id="Notes">
 +
 
== 注 ==
 
== 注 ==
 
* [[テンプレートタグ/get_bloginfo|<tt>get_bloginfo()</tt>]] を使用。
 
* [[テンプレートタグ/get_bloginfo|<tt>get_bloginfo()</tt>]] を使用。
84行目: 112行目:
 
== ソースファイル ==
 
== ソースファイル ==
 
<tt>bloginfo()</tt> は {{Trac|wp-includes/general-template.php}} にあります。
 
<tt>bloginfo()</tt> は {{Trac|wp-includes/general-template.php}} にあります。
 
{{原文|Function Reference/bloginfo|115544}}<!-- 07:17, 5 April 2012 MTanriverdi 版 -->
 
 
 
</div>
 
</div>
  
 
<div id="Related">
 
<div id="Related">
 
== 関連 ==
 
== 関連 ==
* [[テンプレートタグ/get_bloginfo|<tt>get_bloginfo()</tt>]]
 
 
 
</div>
 
</div>
 +
 +
* [[Function_Reference/get_template_directory_uri|get_template_directory_uri]]
 +
* [[Function_Reference/get_stylesheet_directory_uri|get_stylesheet_directory_uri]]
 +
 +
* [[テンプレートタグ/get_bloginfo|get_bloginfo()]]
 +
 +
 +
{{Directory URL Tags}}
  
 
{{Tag Footer}}
 
{{Tag Footer}}
  
 
[[Category:テンプレートタグ]]
 
[[Category:テンプレートタグ]]
 +
 +
{{原文|Function Reference/bloginfo|136100}}<!-- 13:37, September 23, 2013 Djkaz 版 -->

2015年6月6日 (土) 09:13時点における最新版

説明

サイトの情報を表示させる関数です。情報の殆どは、プロフィール一般設定などの、WordPress 管理画面で入力されたものです。この関数はテンプレートファイルの至るところで使うことができ、その結果は常にブラウザーに表示されます。PHP の中でこれらの値を使う必要がある場合は、get_bloginfo() を用いてください。

使い方

<?php bloginfo( $show ); ?>

パラメータ

$show
string) (Optional) 所望する情報のキーワード名
初期値: name
  • 'name' - 管理画面の「設定 > 一般」で設定された「サイトのタイトル」を表示するものです。このデータは wp_options テーブルの "blogname" レコードから取得されるものです。
  • 'description' - 管理画面の「設定 > 一般」で設定された「キャッチフレーズ」を表示するものです。このデータは wp_options テーブルの "blogdescription" レコードから取得されるものです。
  • 'wpurl' - 管理画面の「設定 > 一般」で設定された「WordPress アドレス (URL)」を表示するものです。このデータは wp_options テーブルの "siteurl" レコードから取得されるものです。この関数はサブサイトではなく WordPress がインストールされているルートサイトの URL を返すため、マルチサイト構成で、サブドメインの代わりにパスを用いている場合等は特に site_url() 関数の出力を用いることを推奨します。
  • 'url' - 管理画面の「設定 > 一般」で設定された「サイトアドレス (URL)」を表示するものです。このデータは wp_options テーブルの "home" レコードから取得されるものです。 home_url() 関数の出力を用いることをお奨めします。
  • 'admin_email' - 管理画面の「設定 > 一般」で設定された「メールアドレス」を表示するものです。このデータは wp_options テーブルの "admin_email" レコードから取得されるものです。
  • 'charset' - Version 3.5.0 以降は "UTF-8"を常に返します。その前のバージョンでは、管理画面の「設定 > 表示設定」で設定された「ページとフィードのエンコーディング」を表示するものです。このデータは wp_options テーブルの "blog_charset" レコードから取得されるものです。
  • 'version' - 使用中の WordPress バージョンを表示します。このデータは wp-includes/version.php$wp_version 変数から取得されるものです。
  • 'html_type' - HTML ページの Content-Type (デフォルトは "text/html") を表示します。このデータは、wp_options テーブルの "html_type" レコードから取得されるものです。テーマとプラグインは pre_option_html_type フィルターを用いることで、初期値を上書きすることができます。
  • 'text_direction' - HTML ページの文字の向きを表示します。 is_rtl() 関数の出力を用いることを推奨します。
  • 'language' - WordPress の言語を表示します。
  • 'stylesheet_url' - プライマリーな CSS (usually style.css) ファイルの URL を表示します。 get_stylesheet_uri() 関数の出力を用いることを推奨します。
  • 'stylesheet_directory' - アクティブなテーマディレクトリーの URL を表示します。 get_stylesheet_directory_uri() 関数の出力を用いることを推奨します。
  • 'template_url' / 'template_directory' - アクティブなテーマのディレクトリー URL を表示します。 ('template_directory' は Version 2.6 以前ではローカルパスを表示していました。ハック的な代替策は get_theme_root()get_template() を参照してください)。 子テーマの中では、 get_bloginfo('template_url') と get_template() はどちらもテーマのディレクトリーを返します。そのため、親テーマでは get_template_directory_uri() を、子テーマでは get_stylesheet_directory_uri() を使うよう考慮してください。
  • 'pingback_url' - Pingback XML-RPC ファイルの URL (xmlrpc.php) を表示します。
  • 'atom_url' - Atom feed URL (/feed/atom) を表示します。
  • 'rdf_url' - RDF/RSS 1.0 feed URL (/feed/rfd) を表示します。
  • 'rss_url' - RSS 0.92 feed URL (/feed/rss) を表示します。
  • 'rss2_url' - RSS 2.0 feed URL (/feed) を表示します。
  • 'comments_atom_url' - Atom feed URL (/comments/feed) を表示します。
  • 'comments_rss2_url' - RSS 2.0 feed URL (/comments/feed) を表示します。
  • 'siteurl' - Version 2.2 にて廃止されました。 home_url() あるいは bloginfo('url') を使ってください。
  • 'home' - Version 2.2 にて廃止されました。 home_url() あるいは use bloginfo('url') を使ってください。

用例

ブログのタイトルを表示

ブログのタイトルを<h1>タグで囲んで表示。

<h1><?php bloginfo('name'); ?></h1>

リンク内でブログのタイトルを表示

ブログのタイトルをリンク内で表示。

<a href="<?php bloginfo('url'); ?>" title="<?php bloginfo('name'); ?>"><?php bloginfo('name'); ?></a>

文字コードの表示

ブログで使われている文字コードの表示 (例: utf-8)

: Version 3.5 以降では UTF-8 がデフォルトとなっており、管理画面での設定ができなくなっています。

<p>Character set: <?php bloginfo('charset'); ?> </p>

ブログの概要(キャッチフレーズ)を表示

ダッシュボードの「設定」>「一般設定」で入力したキャッチフレーズを表示。

<p><?php bloginfo('description'); ?> </p>

出力例

Version 2.7 以降、example.com の場合、サイトアドレス (URL)http://www.example.com/home と表示され、WordPress アドレス (URL)http://www.example.com/home/wp にインストールされます。

ディレクトリーの URL は最後のスラッシュがないことに注意してください。

admin_email          = admin@example.com
atom_url             = http://www.example.com/home/feed/atom
charset              = UTF-8
comments_atom_url    = http://www.example.com/home/comments/feed/atom
comments_rss2_url    = http://www.example.com/home/comments/feed
description          = Just another WordPress blog
home                 = http://www.example.com/home (DEPRECATED! use url option instead)
html_type            = text/html
language             = en-US
name                 = Testpilot
pingback_url         = http://www.example.com/home/wp/xmlrpc.php
rdf_url              = http://www.example.com/home/feed/rdf
rss2_url             = http://www.example.com/home/feed
rss_url              = http://www.example.com/home/feed/rss
siteurl              = http://www.example.com/home (DEPRECATED! use url option instead)
stylesheet_directory = http://www.example.com/home/wp/wp-content/themes/largo
stylesheet_url       = http://www.example.com/home/wp/wp-content/themes/largo/style.css
template_directory   = http://www.example.com/home/wp/wp-content/themes/largo
template_url         = http://www.example.com/home/wp/wp-content/themes/largo
text_direction       = ltr
url                  = http://www.example.com/home
version              = 3.5
wpurl                = http://www.example.com/home/wp

変更履歴

  • Since: 0.71

ソースファイル

bloginfo()wp-includes/general-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/bloginfo最新版との差分