この記事は最後に更新してから1年以上経過しています。

メディア(attachment)を拡張してより便利に活用する

説明

「メディア(attachment)」は、標準ではカテゴリもタグもカスタムフィールドもない。投稿と親子関係を作って利用することが前提だからともいえるが、メディアをもっと便利に活用するために、それらの付加情報を絞り込みの材料として利用できないか調べてみた。

投稿タイプの1つである「メディア」は、リクエストの初期段階で register_post_type関数によって登録される。その際、メディアは「投稿(post)」と同じ構造になっているが、タクソノミーは指定されていない。また、編集ページのウィジェット指定は、タイトル(title)、作成者(author)、コメント(comments)のみとなっている。

投稿タグを追加する

「カテゴリ」や「タグ」などのタクソノミーを追加する場合は、そのタクソノミーと投稿タイプの両方が登録されていなければならない。どちらかが登録されていない場合はエラーになるので、要注意だ。というわけで、ここではinitアクションを利用する。

add_action( 'init' , 'attachment_extend' );

function attachment_extend() {
	register_taxonomy_for_object_type( 'post_tag', 'attachment' );
}

register_taxonomy_for_object_type関数は、タクソノミーを投稿タイプで利用できるよう登録するもので、タグ(post_tag)、メディア(attachment)を順に指定する。これだけで、メディアの編集ページに「タグ」ウィジェットが、ライブラリページの一覧にも「タグ」が追加される。

属性(順序)を追加する

次に「属性(順序)」ウィジェットを追加してみる。具体的には、先ほどにinitアクション関数を次のように1行追加するだけである。

function attachment_extend() {
	register_taxonomy_for_object_type( 'post_tag', 'attachment' );
	add_post_type_support( 'attachment', 'page-attributes' );
}

add_post_type_support関数を使用し、属性ウィジェットである'page-attributes'を指定すればいい。これで、メディアの編集ページに「タグ」ウィジェットが追加される。なお属性ウィジェットは、標準の固定ページで利用しているものだが、固定ページ以外で利用する場合は「順序」のみが表示され、「親」や「テンプレート」項目は表示されない。これでメディア情報の取得時に'menu_order'を活用できる。

おまけ。メディアでカスタムフィールドを利用する場合は、add_post_type_support関数のパラメータを次のように変更すれば1回の呼び出しで済む。

add_post_type_support( 'attachment', array( 'page-attributes', 'custom-fields' ) );

最終更新 : 2014年05月22日 19:17


お勧め

wp_add_post_tags(2012年7月5日 更新)

mixed wp_add_post_tags( [ int $post_id = 0 [ , string $tags = '' ] ] )
投稿情報に投稿タグを追加する。

get_tags(2018年5月27日 更新)

array get_tags( [ mixed $args = '' ] )
条件を指定してタグ情報を検索し、マッチしたすべてのタグ情報を取得する。

wp_array_slice_assoc(2022年2月2日 更新)

array wp_array_slice_assoc( array $array, array $keys )
キーを指定して配列の一部を抽出する。

get_post_permalink(2022年11月6日 更新)

string | false get_post_permalink( [ int | WP_Post $id$post = 0 [ , bool $leavename = false [ , bool $sample = false ] ] ] )
カスタム投稿タイプの投稿ページのパーマリンクを取得する。

remove_query_arg(2024年3月21日 更新)

string remove_query_arg( string | string[] $key [ , bool | string $query = false ] )
クエリーURIからパラメータ(キー名=値)を削除する。