KANTENNA.COM

Solarized

HOME > 情報備忘録 > WordPress タグについて

WordPress タグについて

タグの情報を全て取得するのにwp_tag_cloud()使ってたんですがいろいろ余計な属性付きのHTML返ってくるんで調べてたらget_tags()なんてものが。

WordPressってテンプレートタグだけでページ作らないとダメなのかと思ってたんですが関数ってのもあるんですね。あんま情報ないですが・・・。

wp_tag_cloud('format=array')の返り値

PHP

<?php
array
0 => string '<a href='http://www.zaku055.com/?tag=%e3%82%a2%e3%83%8a%e3%83%ad%e3%82%b0' class='tag-link-69' title='1 件のトピック' style='font-size: 8pt;'>アナログ</a>' (length=166)
1 => string '<a href='http://www.zaku055.com/?tag=%e3%82%a2%e3%83%95%e3%82%a3%e3%83%aa%e3%82%a8%e3%82%a4%e3%83%88' class='tag-link-30' title='6 件のトピック' style='font-size: 19.6666666667pt;'>アフィリエイト</a>' (length=214)
2 => string '<a href='http://www.zaku055.com/?tag=%e3%82%a4%e3%83%a9%e3%82%b9%e3%83%88' class='tag-link-57' title='6 件のトピック' style='font-size: 19.6666666667pt;'>イラスト</a>' (length=178)
3 => string '<a href='http://ww.zaku055.com/?tag=%e3%82%aa%e3%83%95%e3%82%a3%e3%82%b9' class='tag-link-31' title='1 件のトピック' style='font-size: 8pt;'>オフィス</a>' (length=166)
・
・
・
?>

get_tags()の返り値

PHP

<?php
array
0 =>
object(stdClass)[230]
public 'term_id' => string '22' (length=2)
public 'name' => string '3DCG' (length=4)
public 'slug' => string '3dcg' (length=4)
public 'term_group' => string '0' (length=1)
public 'term_taxonomy_id' => string '22' (length=2)
public 'taxonomy' => string 'post_tag' (length=8)
public 'description' => string '' (length=0)
public 'parent' => string '0' (length=1)
public 'count' => string '3' (length=1)
1 =>
object(stdClass)[227]
public 'term_id' => string '23' (length=2)
public 'name' => string '3ds MAX' (length=7)
public 'slug' => string '3ds-max' (length=7)
public 'term_group' => string '0' (length=1)
public 'term_taxonomy_id' => string '23' (length=2)
public 'taxonomy' => string 'post_tag' (length=8)
public 'description' => string '' (length=0)
public 'parent' => string '0' (length=1)
public 'count' => string '1' (length=1)
2 =>
object(stdClass)[226]
public 'term_id' => string '24' (length=2)
public 'name' => string 'BMW' (length=3)
public 'slug' => string 'bmw' (length=3)
public 'term_group' => string '0' (length=1)
public 'term_taxonomy_id' => string '24' (length=2)
public 'taxonomy' => string 'post_tag' (length=8)
public 'description' => string '' (length=0)
public 'parent' => string '0' (length=1)
public 'count' => string '1' (length=1)
3 =>
object(stdClass)[214]
public 'term_id' => string '30' (length=2)
public 'name' => string 'アフィリエイト' (length=21)
public 'slug' => string '%e3%82%a2%e3%83%95%e3%82%a3%e3%83%aa%e3%82%a8%e3%82%a4%e3%83%88' (length=63)
public 'term_group' => string '0' (length=1)
public 'term_taxonomy_id' => string '30' (length=2)
public 'taxonomy' => string 'post_tag' (length=8)
public 'description' => string '' (length=0)
public 'parent' => string '0' (length=1)
public 'count' => string '6' (length=1)
・
・
・
?>

これなら色々と使いやすいですね。

リスト形式のHTMLを作成

PHP

<?php
$tag_page = 'http://www.zaku055.com/?tag=';
$html = '';
foreach (get_tags() as $object) {
$html .= sprintf('<li><a href="%s">%s</a></li>' . "\n", $tag_page . $object->slug, $object->name);
}
$html = sprintf('<ul>%s</ul>', $html);
var_dump($html);
?>

実行結果

PHP

<?php
string '<ul><li><a href="http://www.zaku055.com/?tag=3dcg">3DCG</a></li>
<li><a href="http://www.zaku055.com/?tag=3ds-max">3ds MAX</a></li>
<li><a href="http://www.zaku055.com/?tag=bmw">BMW</a></li>
<li><a href="http://www.zaku055.com/?tag=%e3%82%a2%e3%83%95%e3%82%a3%e3%83%aa%e3%82%a8%e3%82%a4%e3%83%88">アフィリエイト</a></li>
・
・
・
?>

/wp-includes/category.php

get_tags()とget_tag()は/wp-includes/category.phpで定義されてます。

PHP

<?php
/**
* Retrieves all post tags.
*
* @since 2.3.0
* @see get_terms() For list of arguments to pass.
* @uses apply_filters() Calls 'get_tags' hook on array of tags and with $args.
*
* @param string|array $args Tag arguments to use when retrieving tags.
* @return array List of tags.
*/
function &get_tags( $args = '' ) {
$tags = get_terms( 'post_tag', $args );
if ( empty( $tags ) ) {
$return = array();
return $return;
}
$tags = apply_filters( 'get_tags', $tags, $args );
return $tags;
}
/**
* Retrieve post tag by tag ID or tag object.
*
* If you pass the $tag parameter an object, which is assumed to be the tag row
* object retrieved the database. It will cache the tag data.
*
* If you pass $tag an integer of the tag ID, then that tag will
* be retrieved from the database, if it isn't already cached, and pass it back.
*
* If you look at get_term(), then both types will be passed through several
* filters and finally sanitized based on the $filter parameter value.
*
* @since 2.3.0
*
* @param int|object $tag
* @param string $output Optional. Constant OBJECT, ARRAY_A, or ARRAY_N
* @param string $filter Optional. Default is raw or no WordPress defined filter will applied.
* @return object|array Return type based on $output value.
*/
function &get_tag( $tag, $output = OBJECT, $filter = 'raw' ) {
return get_term( $tag, 'post_tag', $output, $filter );
}
?>

get_tags()の引数はstring|arrayなんですが何渡しても同じものが返ってきます。 get_terms()がよくわからないのでお手上げです。

get_tag()の方は第一引数にterm_idってのを渡すとそのオブジェクトが返ってきます。存在しないterm_idの場合nullが返ってきます。

PHP

<?php
var_dump(get_tag('20'));
var_dump(get_tag('1909'));
?>

実行結果

object(stdClass)[283]
  public 'term_id' => string '20' (length=2)
  public 'name' => string '素材' (length=6)
  public 'slug' => string '%e7%b4%a0%e6%9d%90' (length=18)
  public 'term_group' => string '0' (length=1)
  public 'term_taxonomy_id' => string '54' (length=2)
  public 'taxonomy' => string 'post_tag' (length=8)
  public 'description' => string '' (length=0)
  public 'parent' => string '0' (length=1)
  public 'count' => string '7' (length=1)
  public 'object_id' => string '376' (length=3)