Recommandé
Contenu connexe
En vedette
En vedette (12)
WordPressの表示件数
- 3. 管理画面＞設定＞表示設定
- 6. pre_get_posts • 大曲さんのブログによると、pre_get_postsとい うフックを利用して、色々やると実現したいこ とができるらしい。 • そこで、WordPressのファイルの中身を探検し てみることにします。 • なお、以下参照していくコアファイルは WordPress3.5.1のものです。
- 7. ./wp-includes/query.php 1919行 該当のフックは/wp-includes/query.php 1919 行 function get_posts() { …略… do_action_ref_array('pre_get_posts', array(&$this)); にありました。
- 9. do_action_ref_array http://codex.wordpress.org/Function_Reference/do_action_ref_array Codexによると This function is identical to do_action, but the arguments passed to the functions hooked to $tag are supplied using an array. [意訳] この関数はdo_actionと同一、 しかしこのタグにフックされた関数に渡される引数は一つの配列です。
- 13. 処理を上から追っていってみま しょう。 •./wp-includes/query.php 1922行 $this->parse_query();によって$this->query_varsにいくつかキーが追加 されているもののまだ‘posts_per_page‘は未設定。 $q = &$this->query_vars; query_varsプロパティを参照変数$qに代入している。 ん、参照変数？
- 14. 参照とは何？ 通常、変数に値を代入する時。 $a = 10; $b = $a; $b = 20; echo '$aの結果は' . $a . '<br/>'; echo '$bの結果は' . $b; $aの結果は10 $bの結果は20 とブラウザ上に表示されます。
- 15. 参照とは何？ しかし。 $a = 10; $b =& $a; $b = 20; echo '$aの結果は' . $a . '<br/>'; echo '$bの結果は' . $b; $aの結果は20 $bの結果は20 と表示されます。
- 18. 更に下に進んでいくと、 •./wp-includes/query.php 1922行 if ( !isset($q['posts_per_page']) || $q['posts_per_page'] == 0 ) $q['posts_per_page'] = get_option('posts_per_page'); という表記が見つかりました。 これはつまり$q[‘posts_per_page’]に値がセットされていて、その値がNULLで ないまたは0と同値であるような値である場合は wp_optionsテーブル(プレフィックスをwp_に設定してあれば)のoption_nameカ ラムがposts_per_pageであるoption_valueの値をセットする。
- 19. どういうことかというと。 管理画面の設定 > 表示設定 > 1ページに表示する最大投稿 数がそこにセットされるということです。 つまり、すでに $q['posts_per_page']が設定されていたなら ば、そこの値ではなく 前もって$q['posts_per_page']に設定されている値が1ペー ジに表示する最大投稿数に設定される仕組みになっている らしい。 だったら前もってここに値を設定しておけば、表示件数を 自由にかえられそうです。
- 21. pre_get_posts コールバックに渡される引数はarray(&$this) つまりこのオブジェクト自身なので。 たとえば、アーカイブページの表示を変えたい場合は function archive_change_posts_per_page($query) { if ( !is_admin() && $query->is_main_query()){ if ( $query->is_archive()) { $query->set( 'posts_per_page', '5' ) ); } } } この関数をコールバックとして渡してやります。
- 22. この関数について少し詳しくみていきましょう。 引数に渡す$queryの部分は通常、グローバル変数$wp_queryが渡されています。 if ( !is_admin() && $query->is_main_query()) この部分で管理画面ではない、かつ$query->is_main_queryが真であれば。 アクションフック、pre_get_postsは管理画面にも影響を与えます。 具体的にいうと、 投稿一覧、固定ページ一覧、メディアライブラリ、各カスタム投稿タイプの記 事一覧の表示件数などに影響を与えます。 (Wp_Queryのインスタンスを利用したプラグインなどを使用していると他にも 影響があるかもしれません) 各一覧ページの表示させる件数は表示オプションから変更できますが、この フックが有効になっていると表示件数を変えることができないということにな るので!is_admin()を条件に加えておきましょう。
- 23. $query->is_main_query 大曲さんのブログによると、 WordPress3.3から使えるようになったようです。 is_main_queryメソッドでは何をしているかというと。 function is_main_query() { global $wp_the_query; return $wp_the_query === $this; } } 現在処理の対象となっているオブジェクト($wp_query)が$wp_the_queryと等 値であるかを判別しているようです。
- 26. ./wp-settings.php 224行目 $wp_the_query = new WP_Query(); 232行目 $wp_query = $wp_the_query; 実はこれもまた参照変数に代入されているのです。
- 28. 再び$query->is_main_query 何故、$query->is_main_query()が真である必要があるのか。 たとえばquery_posts関数を使っていた場合。 ./wp-includes/query.php 89行目 function query_posts($query) { $GLOBALS['wp_query'] = new WP_Query(); return $GLOBALS['wp_query']->query($query); } 参照変数$wp_queryを新たなWP_Queryのインスタンスで上書きしてい ます。 その新たなインスタンスのメソッドを使って引数で与えられたqueryメ ソッドを実行する。
- 30. 再び$query->is_main_query ./wp-includes/query.php 3550 行 function is_main_query() { global $wp_the_query; return $wp_the_query === $this; } $wp_the_queryと等値(同じオブジェクトの同じインスタンスを参照し ているということなのでメインクエリであることが保証される。基本 的に$wp_queryはquery_postsなどによって書き換えられるが、 $wp_the_queryは書き換えられない) つまり本来そのページに適用されるべき記事の表示件数だけをかえた い場合は、$query->is_main_queryが真である必要があります。
- 31. 余談 wp_reset_query() ./wp-includes/query.php 104行目 function wp_reset_query() { $GLOBALS['wp_query'] = $GLOBALS['wp_the_query']; wp_reset_postdata(); } wp_reset_queryは別のインスタンスを参照してしまった$wp_queryを 再びグローバル変数wp_the_queryの参照変数とする処理を行なってい ます。 query_posts()の後にwp_reset_query()が必要なのはそういう理由です。
- 32. 再びコールバック関数 function archive_change_posts_per_page($query) { if ( !is_admin() && $query->is_main_query()){ if ( $query->is_archive()) { $query->set( 'posts_per_page', '5' ) ); } } } $query->is_archive()メソッドによって、アーカイブページであるかど うかを判定して、 $query->set( 'posts_per_page', '5' ) ); を実行します。
- 33. $query->set( 'posts_per_page', '5' ) ); ./wp-includes/query.php 1903行 function set($query_var, $value) { $this->query_vars[$query_var] = $value; } よって、 $this->query_vars['posts_per_page'] = 5; となります。