｢WP Members｣未ログイン時のエラーメッセージの注意事項

今回は、かなりマニアックな内容です。もし、検索エンジンで調べて、このページにたどり着き、知りたかった内容だったならば検索エンジンすごいなと思います。
私自身忘れないよう備忘録として記載しておきます。

会員サイトを制作する際、自身でWordpressのユーザー管理をカスタマイズして制作しても良いのですが、より簡単に制作する方法としてプラグインを利用する方法があります。その中でも、有名なプラグインは｢WP Members｣かと思います。

｢WP Members｣では、会員専用ページに対して、未ログイン時のエラーメッセージを設定した内容に従って出力する事ができます。しかし、実装方法によっては、出力されなかったり、意図しない動作につながる事があります。今回は、その事例を紹介させて頂こうと思います。

1.｢WP Members｣未ログイン時のエラーメッセージの設定

｢設定｣ → ｢WP-Members｣
｢ダイアログ｣タブ→｢アクセス制限された投稿記事および固定ページ、ログインおよび登録フォームの上に表示｣

WP Members 会員ページアクセス時の未ログイン時のエラーメッセージの設定

ここで設定した値が、会員専用ページで、未ログイン時の状況において出力されます。

2.今回起きた事象

各種制作したページを呼び出す自作のショートコードを使い、ページの中からオリジナルのページを呼び出そうとしました。具体的には以下のショートコードです。

■自作のショートコード

本ショートコードを使って、ページ内で、[insert post_type=’page’ slug_name=’voice’]を使い、スラッグ名がvoiceの固定ページを呼び出そうとしたが、本ショートコード内の最後の｢return apply_filters(‘the_content’, $rtn);｣の処理で、WP Membersの処理が呼び出され、未ログイン時のエラーメッセージが表示されてしまい、挿入してほしかったページが出力されませんでした。
そのため、最終的には本ショートコードを使わずページの内容を直接記載し対処しました。

3.考察

WP Membersの未ログイン時のエラーメッセージの出力は、フィルターフックでthe_contentが呼びされたときに動作し、ログイン済みか未ログインかを判断していると思われる。そのため、エディター(editor)(※1)がないページなどでは、設定したエラーメッセージが出力されない事象も発生する。

※１ 例)register_post_typeでカスタム投稿を追加したような場合

‘supports’ => array(‘title”, ‘thumbnail’)を見るとわかる通り、’editor'(本文)がない。
｢WP_Members｣プラグインからすると、フィルターフックの’the_content’が呼び出されないため(エディター画面がない)、ログイン済みか未ログインかを判断する処理が呼び出されず、本投稿ページが会員用ページだとしても、エラーメッセージを出力する事ができない。

一方、独自に追加したショートコード[insert post_type=’page’ slug_name=’voice’]の方は、本来は、ログイン済みか未ログインかどうかに関わらず、指定されたページを出力するショートコードであるが、フィルターフックでthe_contentにフックをかけて処理を実行しているため、WP Membersのthe_contentにフックをかけている処理(ログイン済みか未ログインかを判断する処理)も呼び出され、未ログインであった場合のエラーメッセージが出力されてしまっていた。

4.まとめ

WP Members プラグインの処理は、ログイン済みか未ログインかの確認処理を、フィルターフックで追加されたthe_contentにフックをかけて実行しているため、注意が必要です。

先の内容でもあった通り、別のページを呼び出すのにthe_contentにフックをかけて実行する場合は、意図しないWP Membersのログイン済みか未ログインかを判断する処理が呼び出されてしまうため、本フックは使わずに直接、HTML文で記載した方が良い。

また、会員ページのカスタム投稿で、editorがない場合には、WP Membersのログイン済みか未ログインかを判断する処理が呼び出されないため、自身で、ログイン済みか未ログインかを、Wordpressの関数｢is_user_logged_in()｣を使って確認し処理を分岐させる必要があります。

以上