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

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

テンプレートタグ/wp title

提供: WordPress Codex 日本語版
< テンプレートタグ
2008年3月7日 (金) 01:20時点におけるBono (トーク | 投稿記録)による版 (en:Template Tags/wp_title 2.3 時点の原文 (2007年9月7日 (金) 03:53 Christophe 版))

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

Description

Displays or returns the title of the page, preceded by a separator string.

This tag can be used anywhere within a template as long as it's outside The Loop on the main page, though is typically used in the <title> element for the head of a page.

The title text depends on the query:

Single post or a Page
the title of the post (or Page)
Date-based archive 
the date (e.g., "2006", "2006 - January")
Category 
the name of the category

Usage

%%% <?php wp_title('sep', display); ?> %%%

Examples

Default Usage

Displays page title using defaults.

<p>You are now at <?php wp_title(); ?>.</p>

Using Separator

Displays blog name (through bloginfo()) along with page title in the document's title tag, using "--" as the separator. This results in (when on a single post page) My Blog--Title of Post.

<title><?php bloginfo('name'); ?><?php wp_title('--'); ?></title>

Separator with Blog Name and Title Reversed

This lets you reverse page title and blog name in the title tag from example above (Title of Post--My Blog) by removing the separator from wp_title(), then tests if wp_title() holds a value, and displays the separator between it and bloginfo() if it does.

<title>
<?php wp_title(' '); ?>
<?php if(wp_title(' ', false)) { echo '--'; } ?> 
<?php bloginfo('name'); ?>
</title>

Parameters

sep 
(string) Text to display between portions of the title (i.e. the separator), such as the archive elements of year and month. The separator text is placed before each title element, so when used in conjunction with the bloginfo('name') tag, it should come after it. Defaults to '&raquo;' (»).
display 
true (default): function will display (print) the page title using PHP echo.
false: function will return the page title as a string.

Related

記事

コードドキュメンテーション

  • クラス: WP_Query - WP_Query クエリの詳細概要
  • オブジェクト: $wpdb - $wpdb オブジェクトの使い方概要
  • 関数: get_query_var()
  • 関数: query_posts() - 追加カスタムクエリの作成
  • 関数: get_post() - 項目の ID を使ってその投稿のレコードをデータベースから取得する
  • 関数: get_posts() - 項目の配列を返す特別な関数。
  • 関数: get_pages() - ページの配列を返す特別な関数。
  • 関数: have posts() - クエリが記事を返すかどうか判断する条件分岐。
  • 関数: the_post() - クエリの後に自動的にループを設定するのに使われる。
  • 関数: rewind_posts() - 現在のループをクリアする。
  • 関数: setup_postdata() - ループ内で単一クエリ結果のデータを設定する。
  • 関数: wp_reset_postdata() - 以前のクエリを復元する(通常、ループ内のもう一つのループで使われる)。
  • 関数: wp_reset_query()
  • 関数: is_main_query() - 変更するのがメインクエリであるよう保証する。
  • アクションフック: pre_get_posts - 実行される前に WordPress クエリを変更する。
  • アクションフック: the_post - 投稿オブジェクトをクエリの後に変更する。
  • フィルターフック: found_posts - found_posts WP_Query オブジェクトの値を変更する


関連

固定ページ: get_all_page_ids(), get_ancestors(), get_page_link(), get_page_by_path(), get_page_by_title(), get_page_children(), get_page_hierarchy(), get_page_uri() /en, get_pages(), is_page(), page_uri_index() /en, wp_list_pages(), wp_page_menu()


リスト・ドロップダウン関数: wp_list_authors(), wp_list_categories(), wp_list_pages(), wp_list_bookmarks(), wp_list_comments(), wp_get_archives(), wp_page_menu(), wp_dropdown_pages(), wp_dropdown_categories(), wp_dropdown_users()


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。