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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(説明: 和訳しました。)
(全体を 09:16, September 23, 2013 Djkaz版に合わせました。翻訳はパラメーターまで完了しました。)
7行目: 7行目:
  
 
<div id="Usage">
 
<div id="Usage">
 
 
== 使い方 ==
 
== 使い方 ==
 
<pre><?php bloginfo( $show ); ?></pre>
 
<pre><?php bloginfo( $show ); ?></pre>
14行目: 13行目:
 
<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>
+
{{Parameter|$show|string|所望する情報のキーワード名|Optional|name}}
name                 = Testpilot
+
description          = Just another WordPress blog
+
admin_email          = admin@example
+
  
url                  = http://example/home    [use home_url('/') instead]
+
:* ''''name'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「サイトのタイトル」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "blogname" レコードから取得されるものです。
wpurl               = http://example/home/wp [use site_url('/') instead]
+
:* ''''description'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「キャッチフレーズ」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "blogdescription" レコードから取得されるものです。
 
+
:* ''''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()]] 関数の出力を用いることを推奨します。
stylesheet_directory = http://example/home/wp/wp-content/themes/child-theme
+
:* ''''url'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「サイトアドレス (URL)」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "home" レコードから取得されるものです。[[Function_Reference/home_url | home_url()]] 関数の出力を用いることをお奨めします。
stylesheet_url      = http://example/home/wp/wp-content/themes/child-theme/style.css
+
:* ''''admin_email'''' - 管理画面の「[[Administration_Panels#General|設定]] > [[Settings_General_SubPanel|一般]]」で設定された「メールアドレス」を表示するものです。このデータは [[Database Description#Table:_wp_options|wp_options テーブル]]の "admin_email" レコードから取得されるものです。
template_directory  = http://example/home/wp/wp-content/themes/parent-theme
+
:* ''''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" レコードから取得されるものです。
template_url        = http://example/home/wp/wp-content/themes/parent-theme
+
:* ''''version'''' - 使用中の WordPress バージョンを表示します。このデータは {{Trac|wp-includes/version.php}} の <tt>$wp_version</tt> 変数から取得されるものです。
 
+
:* ''''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> フィルターを用いることで、初期値を上書きすることができます。
atom_url            = http://example/home/feed/atom
+
:* ''''text_direction'''' - HTML ページの文字の向きを表示します。[[Function_Reference/is_rtl | is_rtl()]] 関数の出力を用いることを推奨します。
rss2_url            = http://example/home/feed
+
:* ''''language'''' - WordPress の言語を表示します。
rss_url              = http://example/home/feed/rss
+
:* ''''stylesheet_url'''' - プライマリーな [[Glossary#CSS|CSS]] (usually ''style.css'') ファイルの URL を表示します。[[Function_Reference/get_stylesheet_uri | get_stylesheet_uri()]] 関数の出力を用いることを推奨します。
pingback_url        = http://example/home/wp/xmlrpc.php
+
:* ''''stylesheet_directory'''' - アクティブなテーマディレクトリーの URL を表示します。 [[Function_Reference/get_stylesheet_directory_uri | get_stylesheet_directory_uri()]] 関数の出力を用いることを推奨します。
rdf_url              = http://example/home/feed/rdf
+
:* ''''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()]] を使うよう考慮してください。
 
+
:* ''''pingback_url'''' - Pingback XML-RPC ファイルの URL (''xmlrpc.php'') を表示します。
comments_atom_url    = http://example/home/comments/feed/atom
+
:* ''''atom_url'''' - Atom feed URL (''/feed/atom'') を表示します。
comments_rss2_url    = http://example/home/comments/feed
+
:* ''''rdf_url'''' - RDF/RSS 1.0 feed URL (''/feed/rfd'') を表示します。
 
+
:* ''''rss_url'''' - RSS 0.92 feed URL (''/feed/rss'') を表示します。
charset              = UTF-8
+
:* ''''rss2_url'''' - RSS 2.0 feed URL (''/feed'') を表示します。
html_type            = text/html
+
:* ''''comments_atom_url'''' - Atom feed URL (''/comments/feed'') を表示します。
language            = en-US
+
:* ''''comments_rss2_url'''' - RSS 2.0 feed URL (''/comments/feed'') を表示します。
text_direction      = ltr
+
:* ''''siteurl'''' - Version 2.2 にて廃止されました。[[Function_Reference/home_url | home_url()]] あるいは bloginfo('url') を使ってください。
version              = 3.1
+
:* ''''home'''' - Version 2.2 にて廃止されました。[[Function_Reference/home_url | home_url()]] あるいは use bloginfo('url') を使ってください。
</pre>
+
</div>
+
  
 
<div id="Examples">
 
<div id="Examples">
64行目: 58行目:
 
ブログで使われている文字コードの表示 (例: 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;
  
71行目: 66行目:
 
  &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>
 +
From version 2.7. On host <tt>example</tt>, the [[Settings_General_SubPanel|Blog address (URL)]] is shown at <tt>http://www.example.com/home</tt>, and the [[Settings_General_SubPanel|WordPress address (URL)]] is installed at <tt>http://www.example.com/home/wp</tt>.
 +
 +
Note that directory URLs are missing trailing slashes.
 +
 +
<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">
85行目: 113行目:
 
== ソースファイル ==
 
== ソースファイル ==
 
<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>
  
93行目: 118行目:
 
== 関連 ==
 
== 関連 ==
 
* [[テンプレートタグ/get_bloginfo|<tt>get_bloginfo()</tt>]]
 
* [[テンプレートタグ/get_bloginfo|<tt>get_bloginfo()</tt>]]
 +
</div>
 +
 +
{{原文|Function Reference/bloginfo|136071}}<!--  09:16, September 23, 2013 Djkaz 版 -->
  
 +
<div id="Directory URL Tags">
 +
=== Directory URL Tags ===
 
</div>
 
</div>
 +
{{Directory URL Tags}}
  
 
{{Tag Footer}}
 
{{Tag Footer}}
  
 
[[Category:テンプレートタグ]]
 
[[Category:テンプレートタグ]]

2013年9月23日 (月) 09:37時点における版

このページ「テンプレートタグ/bloginfo」は一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

サイトの情報を表示させる関数です。情報の殆どは、プロフィール一般設定などの、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>

出力例

From version 2.7. On host example, the Blog address (URL) is shown at http://www.example.com/home, and the WordPress address (URL) is installed at http://www.example.com/home/wp.

Note that directory URLs are missing trailing slashes.

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 Codex » Function Reference/bloginfo最新版との差分

Directory URL Tags

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



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