【WP-Champloo】wp_get_archivesを配列で取得する関数 #WordPress

標準テンプレータグでは整形されたHTMLコードが出力される為、配列を返す関数を作ってみました。

ソースコード

functions.php

<?php
/**
* @function get_archives_array
* @param post_type(string) / period(string) / year(Y) / limit(int)
* @return array
*/
if(!function_exists('get_archives_array')){
    function get_archives_array($args = ''){
        global $wpdb, $wp_locale;

        $defaults = array(
            'post_type' => '',
            'period'  => 'monthly',
            'year' => '',
            'limit' => ''
        );
        $args = wp_parse_args($args, $defaults);
        extract($args, EXTR_SKIP);

        if($post_type == ''){
            $post_type = 'post';
        }elseif($post_type == 'any'){
            $post_types = get_post_types(array('public'=>true, '_builtin'=>false, 'show_ui'=>true));
            $post_type_ary = array();
            foreach($post_types as $post_type){
                $post_type_obj = get_post_type_object($post_type);
                if(!$post_type_obj){
                    continue;
                }

                if($post_type_obj->has_archive === true){
                    $slug = $post_type_obj->rewrite['slug'];
                }else{
                    $slug = $post_type_obj->has_archive;
                }

                array_push($post_type_ary, $slug);
            }

            $post_type = join("', '", $post_type_ary); 
        }else{
            if(!post_type_exists($post_type)){
                return false;
            }
        }
        if($period == ''){
            $period = 'monthly';
        }
        if($year != ''){
            $year = intval($year);
            $year = " AND DATE_FORMAT(post_date, '%Y') = ".$year;
        }
        if($limit != ''){
            $limit = absint($limit);
            $limit = ' LIMIT '.$limit;
        }

        $where  = "WHERE post_type IN ('".$post_type."') AND post_status = 'publish'{$year}";
        $join   = "";
        $where  = apply_filters('getarchivesary_where', $where, $args);
        $join   = apply_filters('getarchivesary_join' , $join , $args);

        if($period == 'monthly'){
                $query = "SELECT YEAR(post_date) AS 'year', MONTH(post_date) AS 'month', count(ID) as posts FROM $wpdb->posts $join $where GROUP BY YEAR(post_date), MONTH(post_date) ORDER BY post_date DESC $limit";
        }elseif($period == 'yearly'){
            $query = "SELECT YEAR(post_date) AS 'year', count(ID) as posts FROM $wpdb->posts $join $where GROUP BY YEAR(post_date) ORDER BY post_date DESC $limit";
        }

        $key = md5($query);
        $cache = wp_cache_get('get_archives_array', 'general');
        if(!isset($cache[$key])){
            $arcresults = $wpdb->get_results($query);
            $cache[$key] = $arcresults;
            wp_cache_set('get_archives_array', $cache, 'general');
        }else{
            $arcresults = $cache[$key];
        }
        if($arcresults){
            $output = (array)$arcresults;
        }

        if(empty($output)){
            return false;
        }

        return $output;
    }
}
?>

パラメータ

post_type（投稿タイプを指定）

post（投稿）初期値
any（全てのカスタム投稿タイプ）

period（アーカイブ種別を指定）

monthly（月別アーカイブ）初期値
yearly（年別アーカイブ）

year（期間を指定）

2012（西暦を4桁で示す年）

limit（取得するアーカイブ記事の数を指定）

表示件数（正数）

使用例

年別アーカイブリストを取得したい場合

ソース

<?php $archives = get_archives_array(array('period'=>'yearly')); ?>
<?php if($archives): ?>
<ul>
<?php foreach($archives as $archive): ?>
<li><a href="<?php echo get_year_link($archive->year); ?>"><?php echo $archive->year; ?>年(<?php echo $archive->posts; ?>)</a></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>

出力

<ul>
<li><a href="http://xxxx.xxx/2013/">2013年(10)</a></li>
<li><a href="http://xxxx.xxx/2012/">2012年(1)</a></li>
<li><a href="http://xxxx.xxx/2011/">2011年(3)</a></li>
</ul>

月別アーカイブリストを取得したい場合

ソース

<?php $archives = get_archives_array(); ?>
<?php if($archives): ?>
<ul>
<?php foreach($archives as $archive): ?>
<li><a href="<?php echo get_month_link($archive->year, $archive->month); ?>"><?php echo $archive->year; ?>年<?php echo $archive->month; ?>月(<?php echo $archive->posts; ?>)</a></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>

出力

<ul>
<li><a href="http://xxxx.xxx/2013/04/">2013年4月(10)</a></li>
<li><a href="http://xxxx.xxx/2012/12/">2012年12月(1)</a></li>
<li><a href="http://xxxx.xxx/2011/10/">2011年10月(3)</a></li>
</ul>

期間指定の月別アーカイブリストを取得したい場合

ソース

<?php $archives = get_archives_array(array('year'=>2013)); ?>
<?php if($archives): ?>
<ul>
<?php foreach($archives as $archive): ?>
<li><a href="<?php echo get_month_link($archive->year, $archive->month); ?>"><?php echo $archive->year; ?>年<?php echo $archive->month; ?>月(<?php echo $archive->posts; ?>)</a></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>

出力

<ul>
<li><a href="http://xxxx.xxx/2013/04/">2013年4月(6)</a></li>
<li><a href="http://xxxx.xxx/2013/03/">2013年3月(1)</a></li>
<li><a href="http://xxxx.xxx/2013/01/">2013年1月(3)</a></li>
</ul>

カスタム投稿タイプの月別アーカイブリストを取得したい場合

ソース

<?php $archives = get_archives_array(array('post_type'=>'カスタム投稿タイプ名')); ?>
<?php if($archives): ?>
<ul>
<?php foreach($archives as $archive): ?>
<?php print_r($archive); ?>
<li><a href="<?php echo get_post_type_month_link('カスタム投稿タイプ名', $archive->year, $archive->month); ?>"><?php echo $archive->year; ?>年<?php echo $archive->month; ?>月(<?php echo $archive->posts; ?>)</a></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>

出力

<ul>
<li><a href="http://xxxx.xxx/2013/04/カスタム投稿タイプ名/">2013年4月(3)</a></li>
<li><a href="http://xxxx.xxx/2013/03/カスタム投稿タイプ名/">2013年3月(2)</a></li>
</ul>

上記出力に関して「get_post_type_month_link」関数は存在しない為、WP-Champlooプラグインのインストールをお勧めします。