カテゴリー: WordPress/php

WordPressで、記事の閲覧数ランキングを表示させるときに便利なプラグイン「WordPress Popular Posts（以下WPP）」。

そのままウィジェットに突っ込めばランキング表示できるし、設定もいろいろできるしすごく良いですよね。

ところが、表示の仕方をカスタマイズしたり、もっと好きな場所に好きなように表示させたいとなった場合、何やら関数を作ったりフックを使ったりしなきゃいけないようで初心者にはちょっとつらい。

というわけで、初心者向けに超シンプルにフルカスタマイズできる方法をご紹介します。

実装

考え方は至ってシンプル。

めっちゃ簡単にできそうでしょ！？

できます。
やっていきましょう。

記事IDを取得

<?php
if ( function_exists( 'wpp_get_mostpopular' ) ){
  $wpp_option = array( // 表示オプションの設定
    'range' => 'weekly',
    'post_type' => 'post',
    'order_by' => 'views',
    'limit' => 5
  );
  $wpp_query = new WPP_Query( $wpp_option );
  $wpp_query_ids = array_map(
    function( $wppost ){
      return (int)$wppost->id;
    }, $wpp_query->get_posts()
  );
}

こんな感じです。

$wpp_optionでは、表示オプションを配列にしてやります。

WPPで使えるオプションは、「設定→WordPress Popular Posts→パラメーター」から確認できます。

これで、”$wpp_query_ids”に、１～５位までの記事のIDが配列で格納されました。

あとは、この配列を使って、WP_Queryで記事を表示させます。

普通にループ

おなじみのやつですが、“orderby => post__in”の部分がポイント。

<?php
$wp_query = new WP_Query();
$param = array(
  'posts_per_page' => '5',
  'post_type' => 'post',
  'post__in' => $wpp_query_ids, // ここで記事IDの配列を使う
  'orderby' => 'post__in' // 配列に入ってる順番に表示
);
$wp_query->query($param);
if($wp_query->have_posts()):
  while($wp_query->have_posts()) : $wp_query->the_post();
?>
<p><a href="<?php the_permalink();"><?php the_title(); ?></a></p>
<?php
  endwhile;
endif; wp_reset_query();
?>

ランクとか、閲覧数も表示させたい！

WPPを仕様通り表示させると、簡単に閲覧数やランクを表示させることができますが、今回はIDだけ拾ってあとは普通のループに任せちゃってるので、表示させられないじゃん…

しかしご安心ください。いけます。

閲覧数の表示

wpp_get_views()という関数を使います。

ループ内で以下のように書けば、閲覧数を表示させることができます。

<?php echo wpp_get_views($post->ID, 'weekly'); ?>

上の例と合わせるなら、こんな感じ

<?php
$wp_query = new WP_Query();
$param = array(
  'posts_per_page' => '5',
  'post_type' => 'post',
  'post__in' => $wpp_query_ids, // ここで記事IDの配列を使う
  'orderby' => 'post__in' // 配列に入ってる順番に表示
);
$wp_query->query($param);
if($wp_query->have_posts()):
  while($wp_query->have_posts()) : $wp_query->the_post();
?>
<p><a href="<?php the_permalink();"><?php the_title(); ?></a>(閲覧数：<?php echo wpp_get_views($post->ID, 'weekly'); ?>)</p>
<?php
  endwhile;
endif; wp_reset_query();
?>

ランクの表示

こっちはプログラミングでやっちゃいましょう。

基礎中の基礎、「変数$iをループごとに１ずつ増やして表示させる」だけですね。

<?php
$wp_query = new WP_Query();
$param = array(
  'posts_per_page' => '5',
  'post_type' => 'post',
  'post__in' => $wpp_query_ids, // ここで記事IDの配列を使う
  'orderby' => 'post__in' // 配列に入ってる順番に表示
);
$wp_query->query($param);
if($wp_query->have_posts()):
  $i = 1; // 変数"$i"を定義
  while($wp_query->have_posts()) : $wp_query->the_post();
?>
<p><?php echo $i; ?>位</p>
<p><a href="<?php the_permalink();"><?php the_title(); ?></a>(閲覧数：<?php echo wpp_get_views($post->ID, 'weekly'); ?>)</p>
<?php
  endwhile;
  $i++; // $iを１増やす
endif; wp_reset_query();
?>

おわり

こんな感じで、難しく考えなくても、シンプルにランキングが実装できます。
クライアントワークでも使えますね！

僕は頭がよろしくないので、いつも難しいコードとか読むと発狂しそうになるんですが、だいたいは「IDさえゲットできればなんとかなる」と思っていて、とにかくまずはIDを取得することを考えるようにしています。

ではでは、エクセレントなランキング表示を！

あんまりやりたくないパターンだけど、WordPressの固定ページテンプレート内で記事一覧を表示させ、あまつさえページネーションもつけたいというときがある。

このページネーションの２ページ目以降が404になってはまったけど、動かない原因と対策がわかったのでメモ。

なぜ404となるのか

固定ページ内でページネーションを使うと404になる原因についてですが、たぶん以下のような感じだと思います。

• ページネーションの仕様上、２ページ目とかのURLに、/page/2/とかがつく
• 例えば/hoge/page/2/のようなパーマリンクになる
• そんな固定ページはないので、404になる。

まぁ、固定ページでそもそもページネーションできるようになっていないんでしょうね。そりゃそうよ。

解決策

/page/2/みたいにならなければいいんじゃないか。

WordPressでは、上記のようなURL構造でなくとも、?page=2みたいなパラメータでもページネーションになります。

ただし、デフォルトだと?page=2にアクセスしても、/page/2/にリダイレクトされてしまう。

よって、ページネーションのURLの形式を?page=2にして、なおかつ勝手にリダイレクトさせないようにすればＯＫ。

実装

functions.phpに以下を記述

add_filter('redirect_canonical','my_disable_redirect_canonical');
function my_disable_redirect_canonical( $redirect_url ) {

    if ( is_archive() ){
        $subject = $redirect_url;
        $pattern = '/\/page\//'; // URLに「/page/」があるかチェック
        preg_match($pattern, $subject, $matches);

        if ($matches){
        //リクエストURLに「/page/」があれば、リダイレクトしない。
        $redirect_url = false;
        return $redirect_url;
        }
    }

}

続いて、ページネーションのほうは以下のようにする。

<?php
$paged = (int) get_query_var('paged'); // $pagedを定義。これがないとページネーションが動かないっぽい
$wp_query = new WP_Query();
$param = array(
  'post_type' => 'hoge',
  'paged' => $paged
);
$wp_query->query($param);
if($wp_query->have_posts()):
while($wp_query->have_posts()) : $wp_query->the_post();
?>
ここで記事をループさせる
<?php endwhile; endif; ?>

<?php
if ($wp_query->max_num_pages > 1): // ここからページネーション
echo '<div class="new-pagenation">';
echo paginate_links(array(
  'base' => get_pagenum_link(1) . '%_%',
  'format' => '?paged=%#%',
  'current' => max(1, $paged),
  'total' => $wp_query->max_num_pages,
  'next_text' => '次へ',
  'prev_text' => '前へ'
));
echo '</div>';
endif;
?>

paginate_links()というナイスな関数を使うのが肝で、パラメータでURLのフォーマットを設定することができる。他にもいろいろパラメータを設定できる優れもので、僕もこんな関数があることを初めて知りました。具体的な使用方法はWordPress Codexを参照してください。

次回以降普通のページネーションでもこれ使おう…

あとは、paginate_links()で出力されるhtmlに合わせ、スタイリングしてやりましょう。

以上、現場からでした。

これでも動かない場合は、こっちも見てみてね。

WordPress カスタム投稿でページネーションが404になる原因と解決法

WordPressで会員制サイトを作るためのプラグイン「WP-Members」、めっちゃ便利ですねこれ。

会員登録機能も簡単に作れて、記事に閲覧制限もかけられる。

ただし、閲覧制限で非表示になる部分は投稿コンテンツ（the_content();）のみなので、カスタムフィールドを使っている場合、カスタムフィールドにも閲覧制限設定を実装する必要があります。

そんなに難しくないので、サクッとやっちゃいましょう。

実装

まず、「記事に閲覧制限をかけているかどうか」を取得します。下記を記事用テンプレートに記述。

$block_flag = get_post_meta($post->ID, '_wpmem_block', true); // 閲覧制限のチェック

閲覧制限がかかっていると、”$block_flag”に”1″が、かかっていないと”0″が入ります。

続いて、カスタムフィールドの出力を制御します。

if( !$block_flag || is_user_logged_in() ) {
  // ここに書かれたものは、「閲覧制限がない」または「ログインしているとき」に表示される
}

ややこしい言い回しになってしまいましたが、要するに「閲覧制限をかけていない場合か、ログインしている場合に表示される」というわけで、この中に書いたものは、閲覧制限で非表示になります。

これを、カスタムフィールドが出力される場所ごとに書いてもいいんですが、面倒だし見づらくなるので、まとめちゃいましょう。

例えばこんな感じ

$block_flag = get_post_meta($post->ID, '_wpmem_block', true); // 閲覧制限のチェック

if( !$block_flag || is_user_logged_in() ) {
  // カスタムフィールドの値を先に全部取得しとく
  $custom_url = get_field('custom_url');
  $custom_client = get_field('custom_client');
  $custom_editor = get_field('custom_editor');
}

// 以下、出力部分
if( $custom_url ) {
  echo $custom_url;
}
if( $custom_client ) {
  echo $custom_editor;
}
if( $custom_editor ) {
  echo $custom_editor;
}

これで、「ログインしていないとそもそもカスタムフィールドの値を取得しない。カスタムフィールドの値がなければ、出力もされない」というロジックになりますので、コード量を大幅に削減でき、見やすくなります。

この方法がまかり通らない場合（リピーターフィールド等）は、仕方ないので別個対応してあげましょう。

以上、現場からでした。

WP_Queryでループの検索条件を文字列で絞り込むとき、だいたい以下のように書くと思います。

<?php
$wp_query = new WP_Query();
$param = array(
  'posts_per_page' => '5',
  'post_type' => 'post',
  's' => '検索用テキスト',
  'post_status' => 'publish',
);
$wp_query->query($param); if($wp_query->have_posts()):
// ここに出力を書く
endwhile; endif; wp_reset_query();
?>

普通は’s’のところに、検索のための文字列を入れますよね。

ただ、これはデフォルトだとタイトルと投稿内容しか対象にならない。「カスタムフィールドも検索対象にしたいんじゃ！」ってこと、あると思います。

ここで’s’も’meta_query’も普通に使っちゃうと、AND検索になります。なので、例えば「東京駅」で検索かけたときに、カスタムフィールドには入ってるけどタイトルには入ってないから検索結果に出ないということになっちゃうんですよね。それじゃ困る。

「タイトルか、もしくはカスタムフィールドにあれば表示する」というOR検索にしたいわけです。

そんなときは、こうしましょう。

実装

以下コードをfunctions.phpに記述

add_action( 'pre_get_posts', function( $q )
{
    if( $title = $q->get( '_meta_or_title' ) )
    {
        add_filter( 'get_meta_sql', function( $sql ) use ( $title )
        {
            global $wpdb;

            // Only run once:
            static $nr = 0; 
            if( 0 != $nr++ ) return $sql;

            // Modify WHERE part:
            $sql['where'] = sprintf(
                " AND ( %s OR %s ) ",
                $wpdb->prepare( "{$wpdb->posts}.post_title = '%s'", $title ),
                mb_substr( $sql['where'], 5, mb_strlen( $sql['where'] ) )
            );
            return $sql;
        });
    }
});

そしてループの条件を以下のようにします。これは、カスタムフィールド「station」もしくはタイトルで、「東京駅」という単語でOR検索をかけるときの例。

<?php
$wp_query = new WP_Query();
$param = array(
  'posts_per_page' => '5',
  'post_type' => 'post',
  'post_status' => 'publish',
  '_meta_or_title' => '東京駅',
  'meta_query' => array(
    array(
      'key' => 'station', // 検索をかけるカスタムフィールドのkey
      'value' => '東京駅',
      'compare' => 'LIKE'
    )
  )
);
$wp_query->query($param); if($wp_query->have_posts()):
// ここに出力を書く
endwhile; endif; wp_reset_query();
?>

これでヨシ！

以上、現場からでした。

WordPressで、「カスタム投稿タイプのページネーション２ページ目以降（２ページ目以降じゃなくても、nページ目以降で）が404になる」という現象にちょいちょい陥ったことがあるものの、いつもその場しのぎの応急処置しかしていなかったけど、今回それじゃだめな仕様を実装しなければいけなくなったので、その原因とちゃんとした解決法を調べた。

現象が発生する条件

この現象が発生するのは以下のとき。

つまり、管理画面で「1ページに表示する最大投稿数」を10にしていて、カスタム投稿タイプ”shop”の表示数を5とかにしたい場合、ページネーションがうまく機能しなくなる。

原因

この原因は、かいつまんで言うと

という感じのようです。

つまり、例えば

• デフォルト投稿記事数が20
• 管理画面からの設定数が10

だった場合、デフォルト投稿は２ページ目まで表示されます。

そしてなんと、カスタム投稿タイプもこれに合わせて２ページ目までしか表示されないということらしいです。

カスタム投稿の記事数が30,管理画面の設定数が5だとしても、どんな値でもデフォルト投稿のページ数になってしまう。

そういうことか。。。一見ほとんどバグじゃないかと思いますが、WordPressの仕様らしいのでしょうがないですね。

しょうがないので、解決してみましょう。

応急処置

ググったらよく出てくるやつ。

シンプルでいいです。確かにこれなら理論上いけますね。

簡単なテーマやサイトであればこれでいいと思いますが、「いや、それじゃ困る。なぜならデフォルト投稿の表示数も管理画面から設定できるようにしないといけないから」というパターン、あると思います。

というわけで、もっと自然に解決する方法がこちら。

自然に解決

functions.phpに以下を記述

<?php
add_filter( 'parse_query', 'custom_per_page' );
function custom_per_page( $query ) {
  if ( is_admin() || is_singular() || !is_main_query() ) { // 管理画面とsingleとメインループじゃない部分は除く
    return false;
  }

  if ( get_query_var( 'post_type' ) == 'event' ) {
      $query->set( 'posts_per_page', '6' );
  }
}

そして、テンプレート側では’posts_per_page’を指定しない。

カスタム投稿ごとに表示数を設定したい場合は、単純に増やせばＯＫ

<?php
add_filter( 'parse_query', 'custom_per_page' );
function custom_per_page( $query ) {
  if ( is_admin() || is_singular() || !is_main_query() ) { // 管理画面とsingleとメインループじゃない部分は除く
    return false;
  }

  if ( get_query_var( 'post_type' ) == 'event' ) {
      $query->set( 'posts_per_page', '6' );
  }

  if ( get_query_var( 'post_type' ) == 'blog' ) {
    $query->set( 'posts_per_page', '5' );
  }
}

以上、現場からでした。

こっちの記事もどうぞ

WordPress 固定ページ内でページネーションを使ったら404になる原因と対策

いちばんやさしいWordPressの教本第3版 人気講師が教える本格Webサイトの作り方 (「いちばんやさしい教本」)

Amazonで見る

WordPressでajax実装したのはいいけど、スマホで実機確認したら動いてない！読み込みに失敗してる！

PCで動いてスマホで動かないってどういうことやねん…ajaxやぞ…そんなことあんのか…

と長い間悩んでましたが、全然違うところに原因があってしんどかったという話です。

管理画面にログインしているかどうかが問題だった

スマホで動いてないのではなく、管理画面にログインしてないときに動いてなかったのです。なんてこった…ずっとログインしたまま作業してたからね…

というわけで、管理画面にログインしてないときに動かない場合に見る部分はこちらです。

/**
 * Ajax実装部分
 */
function my_ajax_scroll() {
  // ここに処理を書く
}
add_action('wp_ajax_my_ajax_scroll', 'my_ajax_scroll');
add_action('wp_ajax_nopriv_my_ajax_scroll', 'my_ajax_scroll');

WordPressでAjaxを使うとき、functionsにこんな感じで関数を書き、add_actionしますね。
この”wp_ajax_nopriv”のほうは「ログインしていないとき」に有効なadd_actionで、ここを忘れてたり間違えてたりすると、ログインしていない状態でうまくajax通信ができないということでした。

以上、現場からでした。

WordPressのプラグイン「Advanced Custom Fields」で、チェックボックス（セレクトボックス）の値を、選択してないやつも含めて全部取得したい。

例えば、「月火水木金土日」という選択肢があって、「火水」しか選択してなくても、とりあえずリストとして全部表示させたいわけである。

これはけっこう長いこと悩んでいて、あれこれややこしい方法で実装してみては「ほんまにこれしかないんか…」と調査しまくっていたが、ついにめっちゃ簡単な方法を見つけたので備忘録。

実装

関数”get_field_object()”を使う。

例えば、”custom_week”というカスタムフィールドに、「月～日」の選択肢を用意しており、更に土日を選択しているとき、値は以下のようになる。

$week = get_field_object('custom_week');
echo '<pre>';
var_dump($week);
echo '</pre>';

// 以下、出力部分
array(15) {
  ["key"]=>
  string(19) "field_59b111613d05f"
  ["label"]=>
  string(9) "営業日"
  ["name"]=>
  string(14) "custom_week"
  ["_name"]=>
  string(14) "custom_week"
  ["type"]=>
  string(8) "checkbox"
  ["order_no"]=>
  int(1)
  ["instructions"]=>
  string(0) ""
  ["required"]=>
  int(0)
  ["id"]=>
  string(24) "acf-field-custom_week"
  ["class"]=>
  string(8) "checkbox"
  ["conditional_logic"]=>
  array(3) {
    ["status"]=>
    int(0)
    ["allorany"]=>
    string(3) "all"
    ["rules"]=>
    int(0)
  }
  ["choices"]=>
  array(7) {
    ["月"]=>
    string(3) "月"
    ["火"]=>
    string(3) "火"
    ["水"]=>
    string(3) "水"
    ["木"]=>
    string(3) "木"
    ["金"]=>
    string(3) "金"
    ["土"]=>
    string(3) "土"
    ["日"]=>
    string(3) "日"
  }
  ["default_value"]=>
  string(0) ""
  ["layout"]=>
  string(10) "horizontal"
  ["value"]=>
  array(2) {
    [0]=>
    string(3) "土"
    [1]=>
    string(3) "日"
  }
}

“var_dump()”でデバッグしてしまえばだいたいわかるけど、この場合

“$week[‘choices’]”

で選択肢を配列で全部取得できる。あとはforeachで回すなりなんなり好きにしちゃいましょう！

繰り返しフィールドだろうとなんだろうと、get_field_object()で全値をとって、var_dump()で中身を見てしまえばなんだってできるね。

以上、現場からでした。