【WordPress】WP-PageNavi 固定ページでページングを表示する

[WordPress]WP-PageNaviプラグインを使った固定ページでページング処理

WP-PageNaviを使ったページング処理は、下記のソースコードにより表示可能ですが、固定ページでうまく表示できない場合があります。

<?php
if(function_exists('wp_pagenavi')) { wp_pagenavi(); }
wp_reset_query();
?>

ページングのリンクが表示できない原因については、下記の理由が考えられます。w

ループ処理に問題がある
$pagedが取得できていない
ページ名が重複している

ループ処理に問題がある

固定ページでカテゴリやタクソノミーごとの一覧を表示している場合、ループ処理を行うことなります。ループ処理の方法として、WP_Queryを使ったWP_QUERYを使用してWP-PAGENAVIでページナビを表示やquery_postsを使った困ったことにWP-PageNaviがまったく機能していない状況です・・・などの方法があります。

今回、ハマったのは３つ目の対応ですが、ループ処理においてよくある間違いとして色々なところで書かれていたので、参考までに。

WP_Query() を使った場合は、wp_reset_postdata();
query_posts() を使った場合は、wp_reset_query();
関数を使って、ループ処理内のpostデータとして割り当てられた値をリセットします。
WP-PageNaviプラグインを使った処理を記述より先に上記の関数を書いてしまうと、
ページングのHTMLが生成されません。これはループ処理のデータを参照してページングのHTMLが作らているためです。そのため、ループ処理のデータをリセットする関数を書く前にWP-PageNaviの処理を書かなければなりません。
サンプル

WP-PageNaviを書くページの.phpファイル

<?php
// ループ条件を設定
$args = array(
	'post_type' => 'result', /* 投稿タイプを指定 */
	'paged' => $paged,
	'posts_per_page' => 10, // 表示件数
	'order' => 'date',
	'order' => 'DESC',
);
?>
<?php query_posts( $args ); ?>
<?php if (have_posts()) : ?>
	<?php while (have_posts()) : the_post();  ?>
		/* ループ開始 */
		<?php the_time("Y年m月d日"); ?><br />
		<a href="<?php the_permalink(); ?>"><?php
		the_title(); ?></a>
	<?php endwhile; ?>
	
<?php else : ?>
		<h1>記事がありません</h1>
		<p>表示する記事はありませんでした。</p>
<?php endif; ?>
<?php
// ページングを表示
if (function_exists('wp_pagenavi')) { wp_pagenavi(); }
// ループ処理のデータをリセット 
wp_reset_query();
?>

WP_Query() においても、同様に注意が必要です。

$pagedが取得できていない

固定ページでは、$pagedが取得できない場合があるようです。その場合には、下記のコードを検索条件の前に書いて、再定義しておくと回避できるようすが、私の環境では再現していないため、メモとして残します。

$paged = (int) get_query_var('paged');
$paged = get_query_var('paged');

query_posts()の検索条件で最大表示件数を指定する場合にも注意が必要です。showposts()ではなくposts_per_page()を使う必要があります。

ページ名が重複している

今対応しているサイトでハマったのは、この部分！！
固定ページ名とタクソノミーのrewrite(slug)に書かれている定義名が同じだったのが原因で、indexとしか表示されませんでした。
タクソノミーの定義名を「s」をつけて回避しました。

functions.php

function my_item_init() {
 
    register_post_type('item', array(
	'hierarchical' => true,
            'labels' => array(
            'name' => '商品',
            'all_items' => '商品一覧',
            'search_items' => '商品を検索',
            'not_found' =>  '商品が見つかりません',
            'not_found_in_trash' => 'ゴミ箱内に商品が見つかりませんでした。',
            'parent_item_colon' => ''
        ),
        'public' => true,
        'publicly_queryable' => true,
        'show_ui' => true,
        'query_var' => true,
        'has_archive' => true,  /*archiveテンプレートでアーカイブ表示*/
       'rewrite' => array('slug' => <span style="color: #ff2600">'items',</span> 'with_front' => false), /*
        'capability_type' => 'post',
        'hierarchical' => true,
        'menu_position' => 5,
        'supports' => array('title','editor','thumbnail','custom-fields','page-attributes' )
    ));