### [エントリー総数の表示](https://wpforms.com/developers/how-to-display-the-total-number-of-entries/)

**公開日:** 2020年10月29日
**著者:** David Ozokoye

**概要:** このチュートリアルでは、フォームIDに基づいてフォームのエントリー総数を表示するショートコードの作成方法をご紹介します。

**内容:**

フォームのエントリー総数を表示したいですか？ 簡単なPHPスニペットを使ってカスタムショートコードを作成すれば、これを簡単に実現できます。

このチュートリアルでは、WPFormsでエントリーの総数を表示する方法をご紹介します。

---

## フォームの作成

この例では、ニュースレター登録フォームのすぐ下に、登録したユーザー数を表示することを目指します。 まず、[新しいフォームを作成](https://wpforms.com/docs/creating-first-form/)するか、既存のフォームを編集してフォームビルダーを開きます。

![ニュースレター登録フォーム](https://wpforms.com/wp-content/uploads/2024/11/newsletter-form.png)## サイトにコードスニペットを追加する

提供されたコードスニペットをコピーした後、サイトに簡単に追加してショートコードを有効にできます。スニペットの追加方法がわからない場合は、[このチュートリアル](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "WPFormsにカスタムPHPまたはJavaScriptを追加する方法")を参照してください。

それでは、コードの説明に入りましょう。ショートコードの属性は、`$atts = shortcode_atts(['id' => '','type' => 'all', ],` を使用して設定されます。

`id`属性はフォームIDを指定する必要があるため、非常に重要です。これにより、ショートコードはどのフォームのエントリーをカウントすべきかを判断します。フォームIDがわからない場合は、[こちらのチュートリアルを参照してください](https://wpforms.com/developers/how-to-locate-form-id-and-field-id/ "フォームIDとフィールドIDの確認方法")。

2つ目の属性である`type`はオプションです。デフォルトでは、ショートコードはすべてのエントリーをカウントし、合計数を表示します。この属性を指定しない場合、フォームのすべてのエントリーが自動的に含まれます。ただし、カウントおよび合計を表示するエントリーの種類を指定したい場合は、以下の属性のいずれかを使用できます：

- `all`: フォームのすべてのエントリーを表示します。
- `unread`：[エントリー]画面からまだ閲覧されていないエントリーのみを集計して表示します。
- `read`：[エントリー]画面からすでに閲覧されたエントリーのみを集計して表示します。
- `starred`：[エントリー]画面からスターが付けられたエントリーのみを集計して表示します。

## ショートコードの使用方法

このデモでは、すでに基本的なニュースレター登録フォームを作成し、WordPressのページに組み込んでいます。

![ページにフォームを追加する](https://wpforms.com/wp-content/uploads/2020/10/wpforms-add-form.jpg)ショートコードをページに組み込む前に、訪問者に対して、表示される数字の意味について説明を加えておきます。 そこで、ショートコードの前に説明文を追加します。

![ショートコードを追加する前に、この数字が何を意味するのかをユーザーに理解してもらうためのテキストを追加します](https://wpforms.com/wp-content/uploads/2020/10/wpforms-add-some-text-above.jpg)それでは、ショートコードをページに組み込みましょう。 **ショートコード**ブロックを使用して、ニュースレターフォーム（フォームID **25**）へのエントリー総数を表示するカスタムショートコードを組み込みました。ショートコードは以下の通りです：

`[wpf_entries_count id="25" type="all"]`

**注意：** サイトのキャッシュ設定やホスティングサーバーの設定によっては、件数のリアルタイム更新に遅延が生じる場合があります。

![このフォームのエントリー総数を表示するには、ページにショートコードを追加してください](https://wpforms.com/wp-content/uploads/2020/10/wpforms-display-entry-count.jpg)typeパラメータを使用すると、表示するエントリーの種類をカスタマイズできます。 たとえば、typeパラメータの値として「starred」を指定すると、スター付きのエントリーのみが表示されます。ショートコードは以下のようになります。

`[wpf_entries_count id="25" type="starred"]`

これで、ページにアクセスすると、フォームの下にエントリーの総数が表示されます。

![これで、ショートコードを使用して各フォームのエントリー総数を表示できるようになりました](https://wpforms.com/wp-content/uploads/2020/10/wpforms-display-total-number-entries.jpg)以上です！サイト上のフォームのエントリー総数を表示するカスタムショートコードをサイトに追加できました！

サイトのフロントエンドにすべてのフォームを表示するカスタムショートコードも作成してみませんか？その方法については、[ショートコードを使用してWPFormsのリストを表示する方法](https://wpforms.com/developers/how-to-display-a-list-of-wpforms-using-a-shortcode/ "ショートコードを使用してWPFormsのリストを表示する方法")のチュートリアルをご覧ください。

**カテゴリ:** チュートリアル

**タグ:** PHP

---