当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「テンプレートタグ/wp count posts」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(未翻訳テンプレ追加、体裁微調整)
(残りを和訳。戻り値セクションを追加。クリーンアップ。)
 
(3人の利用者による、間の3版が非表示)
1行目: 1行目:
{{NeedTrans}}
 
 
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
First available with WordPress [[Version 2.5]], this template tag returns the count of the rows in ''wp_posts'' that meet the ''post_type'' and ''post_status'' designated.
+
 
 +
WordPress [[Version 2.5|2.5]] で新規導入されたこの関数は、指定した投稿タイプの各投稿ステータスの投稿数をプロパティとして持つオブジェクトを返します。また第 2 パラメータを入れて <code>wp_count_posts()</code> を使うと、非公開(プライベート)の投稿数も含めることができます。デフォルトの場合や、ユーザーがログインしていなかったりゲストユーザーだったりした場合は、非公開の投稿数は含まれません。
 +
 
 +
この関数は投稿ステータスをプロパティとするオブジェクトを返すので、もし非公開の投稿数が必要なら PHP 関数 <code>isset()</code> を使ってプロパティの有無をチェックしましょう。すべての投稿ステータスがオブジェクトに含まれるのではないからです。
  
 
<div id="Usage">
 
<div id="Usage">
 
== 使い方 ==
 
== 使い方 ==
 
</div>
 
</div>
  <?php wp_count_posts('type', 'status'); ?>
+
 
 +
  <?php wp_count_posts( $type, $perm ); ?>
 +
 
 +
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 
 +
{{Parameter|$type|文字列|カウント対象の投稿タイプ。|オプション|'post'(ふつうの「投稿」)}}
 +
{{Parameter|$perm|文字列|現在のユーザーが読める非公開の投稿を含めるには 'readable' をセット。|オプション|''空の文字列''}}
 +
 
 +
<div id="Return_Values">
 +
== 戻り値 ==
 +
</div>
 +
 
 +
{{Return||オブジェクト|各投稿ステータスの投稿数をプロパティとして持つオブジェクト。指定した投稿タイプが存在しなければプロパティを何も持たないオブジェクトを返す。}}
  
 
<div id="Examples">
 
<div id="Examples">
18行目: 33行目:
 
=== 初期設定での使用 ===
 
=== 初期設定での使用 ===
 
</div>
 
</div>
The default usage returns a count of the posts that are published.
+
デフォルトでは公開された投稿の数を返します。オブジェクトを返すので、出力をデバッグするには var_dump() が使えます。
  
<pre><?php $published_posts=wp_count_posts(); ?></pre>
+
<pre><?php
 +
$count_posts = wp_count_posts();
 +
?></pre>
  
<div id="Count drafts">
+
<div id="Get_the_Publish_Status_Post_Count">
===Count_drafts===
+
=== 公開済みの投稿数を取得 ===
 
</div>
 
</div>
Return the count of post drafts.
 
  
<pre><?php $draft_posts=wp_count_posts('post','draft'); ?></pre>
+
投稿ステータスが「公開済」の投稿数を取得するには、<code>wp_count_posts()</code> 関数を呼び出してから ''''publish'''' プロパティをアクセスします。
 +
 
 +
<pre><?php
 +
$count_posts = wp_count_posts();
 +
 
 +
$published_posts = $count_posts->publish;
 +
?></pre>
 +
 
 +
もし PHP5 のみで動作すればよく、ひとつのステータスだけが欲しいなら、次のような省略表記が使えます。ただしこれは PHP4 では動作しないので、後方互換性を維持したければ上記のコードを使わなければなりません。
 +
 
 +
<pre><?php
 +
$published_posts = wp_count_posts()->publish;
 +
?></pre>
 +
 
 +
<div id="Count_drafts">
 +
=== 下書きを数える ===
 +
</div>
 +
「下書き」の数も「公開済」と同様に取得できます。
 +
 
 +
<pre><?php
 +
$count_posts = wp_count_posts();
 +
 
 +
$draft_posts = $count_posts->draft;
 +
?></pre>
  
 
<div id="Count_pages">
 
<div id="Count_pages">
===Count pages===
+
=== 固定ページを数える ===
 
</div>
 
</div>
Return the count the number of published pages
+
固定ページのステータスについて数えるにはふつうの投稿と同じ方法を使いますが、第 1 パラメータを使用します。
  
<pre><?php $published_pages=wp_count_posts('page','publish'); ?></pre>
+
<pre><?php
 +
$count_pages = wp_count_posts( 'page' );
 +
?></pre>
  
<div id="Parameters">
+
<div id="Other_Uses">
== パラメータ ==
+
=== その他の使い方 ===
 
</div>
 
</div>
; type : (''string'') Type of row in ''wp_posts'' to count where type is equal to ''post_type''.  Defaults to '''post'''
+
 
; status : (''string'') Status of row in ''wp_posts'' to count where status is equal to ''post_status''. Default to '''publish'''
+
<code>wp_count_posts()</code> は任意の投稿タイプの投稿ステータスを数えるのに使うことができます。これには添付ファイルや、プラグインまたは WordPress コアの一部として将来追加される任意の投稿タイプも含まれます。
 +
 
 +
== ソースファイル ==
 +
 
 +
<tt>wp_count_posts()</tt> は {{Trac|wp-includes/post.php}} にあります。
  
 
== 変更履歴 ==
 
== 変更履歴 ==
47行目: 92行目:
  
 
<div id="Related">
 
<div id="Related">
== 関連 ==
+
== 関連項目 ==
 
</div>
 
</div>
{{Tag Post Tags}}
 
  
{{PHP Function Tag Footer}}
+
{{Count Tags}}
  
{{Stub}}
+
{{Tag Post Tags}}
  
{{原文|Template Tags/wp_count_posts|54365}}
+
{{原文|Template Tags/wp_count_posts|141368}} <!-- 23:35, 18 February 2014 Vanjwilson 版 -->
  
{{DEFAULTSORT:wp_count_posts}}
+
{{DEFAULTSORT:Wp_count_posts}}
 +
[[Category:wp2.5]]
  
 
[[en:Template Tags/wp_count_posts]]
 
[[en:Template Tags/wp_count_posts]]
 +
[[it:Riferimento funzioni/wp_count_posts]]

2015年9月5日 (土) 21:51時点における最新版

WordPress 2.5 で新規導入されたこの関数は、指定した投稿タイプの各投稿ステータスの投稿数をプロパティとして持つオブジェクトを返します。また第 2 パラメータを入れて wp_count_posts() を使うと、非公開(プライベート)の投稿数も含めることができます。デフォルトの場合や、ユーザーがログインしていなかったりゲストユーザーだったりした場合は、非公開の投稿数は含まれません。

この関数は投稿ステータスをプロパティとするオブジェクトを返すので、もし非公開の投稿数が必要なら PHP 関数 isset() を使ってプロパティの有無をチェックしましょう。すべての投稿ステータスがオブジェクトに含まれるのではないからです。

使い方

<?php wp_count_posts( $type, $perm ); ?>

パラメータ

$type
文字列) (オプション) カウント対象の投稿タイプ。
初期値: 'post'(ふつうの「投稿」)
$perm
文字列) (オプション) 現在のユーザーが読める非公開の投稿を含めるには 'readable' をセット。
初期値: 空の文字列

戻り値

(オブジェクト) 
各投稿ステータスの投稿数をプロパティとして持つオブジェクト。指定した投稿タイプが存在しなければプロパティを何も持たないオブジェクトを返す。

用例

初期設定での使用

デフォルトでは公開された投稿の数を返します。オブジェクトを返すので、出力をデバッグするには var_dump() が使えます。

<?php
$count_posts = wp_count_posts();
?>

公開済みの投稿数を取得

投稿ステータスが「公開済」の投稿数を取得するには、wp_count_posts() 関数を呼び出してから 'publish' プロパティをアクセスします。

<?php
$count_posts = wp_count_posts();

$published_posts = $count_posts->publish;
?>

もし PHP5 のみで動作すればよく、ひとつのステータスだけが欲しいなら、次のような省略表記が使えます。ただしこれは PHP4 では動作しないので、後方互換性を維持したければ上記のコードを使わなければなりません。

<?php
$published_posts = wp_count_posts()->publish;
?>

下書きを数える

「下書き」の数も「公開済」と同様に取得できます。

<?php
$count_posts = wp_count_posts();

$draft_posts = $count_posts->draft;
?>

固定ページを数える

固定ページのステータスについて数えるにはふつうの投稿と同じ方法を使いますが、第 1 パラメータを使用します。

<?php
$count_pages = wp_count_posts( 'page' );
?>

その他の使い方

wp_count_posts() は任意の投稿タイプの投稿ステータスを数えるのに使うことができます。これには添付ファイルや、プラグインまたは WordPress コアの一部として将来追加される任意の投稿タイプも含まれます。

ソースファイル

wp_count_posts()wp-includes/post.php にあります。

変更履歴

  • 2.5 : 新規テンプレートタグ

カウントタグ: wp_count_posts(), wp_count_terms() /en, wp_count_comments() /en, count_users() /en


投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


最新英語版: WordPress Codex » Template Tags/wp_count_posts最新版との差分