post_type_archive_title

(3.1.0以降)
post_type_archive_title - カスタム投稿タイプアーカイブのタイトルを表示する

説明

string post_type_archive_title( [ string $prefix = '' [ , bool $display = true ] ] )
カスタム投稿タイプアーカイブのタイトルを表示する。

パラメータ

  • $prefix
    プレフィックス文字を指定(省略時は'')。
  • $display
    表示する場合はtrue、取得する場合はfalseを指定(省略時はtrue)。

返り値

パラメータ$displayがfalseの場合はタイトルを返す。なお、$displayがtrueか、リクエストページがカスタム投稿タイプアーカイブ以外の場合は何も返さない。

注意

get_queried_object関数を使って、リクエストページのオブジェクトを取得している。

使用例

  • カスタム投稿タイプアーカイブのタイトルを表示する。
    <?php post_type_archive_title(); ?>
  • カスタム投稿タイプアーカイブのタイトルを取得する。
    <?php $title = post_type_archive_title( '', false ); ?>

フィルター

タイトルを表示または返す前にpost_type_archive_titleフィルターを実行する。パラメータ$nameにはカスタム投稿タイプ名が格納されている。
$title = apply_filters('post_type_archive_title', $name );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/general-template.php

関連

お勧めコンテンツ

各種リンクを取得する関数一覧(2014年6月12日 登録)

サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク(パーマリンク)を取得する関数を用意しており、それらを一通り把握しておくべきだろう。

プラグインのロード順を制御する(2014年6月9日 登録)

これまでプラグインがどのような順番でロードされるか意識していなかったのだが、とある自作プラグインを他のプラグインよりも先にロードさせたくなったので調べてみた。

メディアライブラリに絞り込み用の「投稿タグ」を追加する(2014年6月24日 登録)

この記事は、先月投稿したコラム「メディア(attachment)を拡張してより便利に活用する」の続編。メディアで「投稿タグ」を追加するだけで「メディアライブラリ」ページの投稿一覧の中には「タグ」カラムが追加されるが、今回はその「投稿タグ」で絞り込み検索に対応してみる。

カスタム投稿タイプの投稿保存には専用アクションを使おう(2014年7月4日 登録)

カスタム投稿タイプを登録して、専用ウィジェット(meta_box)を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。

4.2の「アクティビティ」ウィジェットに投稿以外の情報も表示する(2015年5月13日 登録)

ダッシュボードの「アクティビティ」ウィジェットは「投稿(post)」の状況を表示し、固定ページ(page)やカスタム投稿タイプの投稿記事の状況については標準では表示されない。このことに対して以前『3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する』を紹介したのだが、4.2では新しいフィルターが追加され、カスタマイズが少し容易になった。

最終更新日時 : 2014-12-23 14:57