説明
array get_post_class( [ mixed $class = '' [ , int $post_id = null ] ] )
投稿記事のクラス名を取得する。
パラメータ
- $class追加するクラス名を文字列まはた配列で指定（省略時は''）。
- $post_id対象となる投稿情報のIDを指定（省略時はnull）。
返り値
クラス名を含んだ配列を返す。注意
クラス名は esc_attr関数で属性値として無効な文字は取り除かれる。
クラス名としては、'post-{ID}'、'type-{投稿タイプ名}'、'status-{投稿ステータス}'、'format-{投稿フォーマット名}'、'hentry'、'category-{カテゴリーのスラッグまたはID}'、'tag-{投稿タグのスラッグまたはID}'など。
[4.2.0]カスタムタクソノミーが'{カスタムタクソノミー名}-{そのスラッグまたはID}'の形式で追加されるようになった。
[6.1.0]'post_class_taxonomies'フィルターが追加され、クラス名として含めたくないタクソノミーがある場合にはこのフィルターで除外できる。
使用例
- 現在の投稿情報のクラス名を取得する。<?php $classes = get_post_class(); ?>
- 現在の投稿情報のクラス名に'topic'を追加して取得する。。<?php $classes = get_post_class( 'topic' ); ?>
- IDが2014の投稿情報のクラス名を取得する。。<?php $classes = get_post_class( '', 2014 ); ?>
フィルター
[6.1.0]カスタムタクソノミーのクラス名を追加する前に'post_class_taxonomies'フィルターを呼び出す。パラメータ$taxonomiesにはパブリックなタクソノミーの配列が、$post_IDには実際の投稿情報のID値が、$classesにはその時点のクラス名を格納した配列が、$classには本関数が受け取った内容が格納されている。$taxonomies = apply_filters( 'post_class_taxonomies', $taxonomies, $post_ID, $classes, $class );return apply_filters( 'post_class', $classes, $class, $post_ID );アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/post-template.php最終更新 : 2022年11月06日 16:58
関連
お勧め
5.5の機能強化：テンプレートパーツの取得関連（2020年8月12日 更新）
来月にリリースされるWordPress 5.5に向けてBeta 1～4と公開が続いている。「WordPress 5.5 Beta 4（以降Beta 4）」のソースコードを見ていくと、テンプレートパーツを取得する関数にパラメータが追加されていた。
ブロックエディターの文字サイズ設定を変えてみる（2019年12月12日 更新）
今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。
コメントの「ウェブサイト」止めました（2014年4月15日 更新）
とあるサイトのスパムコメントが多く、その都度のスパム指定するのが面倒である。これまでいくつか対策を行ってきたが、そういった対応にもいい加減うんざりしてきたので、試験的に「ウェブサイト」を無効化しようと思った。
WordPressのコーディングスタンダードとPSR-2がかみ合わない（2018年5月27日 更新）
先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon（4.6）」から「Oxygen（4.7）」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style（Formatter）」が「PSR-2」に設定されていることが原因だった。
はじめてJSONファイル（JED 1.x）を作った時のメモ（2022年3月11日 更新）
先日、サイト間で投稿内容をコピー＆ペーストするためのプラグイン「Paste JSON text」をブロックエディターに対応させた。このプラグインでは、JavaScriptファイルで翻訳テキストを使用しており、はじめてJEDファイルを作成。その作業のポイントを忘れないように残すことにした。