WordPress記事のフォームから送信されたデータをPHPで処理し、記事ページにデータを表示する方法。

2021年9月12日

Contents

コトの発端
開発
実行
まとめ
参考にさせて頂いたページ
いつもの

コトの発端

このブログ上で簡単なWEBサービスを始めたくなった。

まずは簡単に、記事上のフォームからPHPの関数にデータを渡し、処理したデータを同じ記事に返してもらう仕組みを構築してみる。

開発

WordPressの「ショートコード」と呼ばれる仕組みを使って開発するのが簡単そう。

ショートコードを使用すると記事からPHPで定義した関数を簡単に呼び出すことができるよ。

処理の流れ

ここで開発するサンプルの処理の流れを書いていくよ。

記事上のフォームから同じ記事へ、データをポストする。
記事上のショートコードが使用中のテーマのfunctions.php中の定義された関数を呼び出す。
呼び出した関数がPOSTされたデータを参照し、ショートコードの呼び出し位置に表示する。

これから実装について述べていく。

フォームの作成

今回のフォームは、テキストフォームと送信ボタンだけにした。

入力データはTESTDATAの名前でPOSTすることとし、下記のHTMLコードを追加したカスタムHTMLブロックに記述した。

<form method="post">
テキスト：<input type="text" name="TESTDATA">
<input type="submit" value="送信">
</form>

※HTMLを入力するブロック。

このブログで上記フォームを設置した例。

ちなみにフォームでPOSTするデータの名前がWordPressシステムの予約語と被ると不具合が発生する。下記参照。

: 記事にデータをPOSTしたら存在するはずのページで、404 PageNotFoundページが見つかりませんのエラー表示となる。WordPress、ショートコード、PHP。
コトの発端とある記事にて、WordPressのショートコードを使用して、PHPへフォームデータをPOSTするプログラムを開発していた。こんなの記事のフォームから同じ記事へデータをPOSTしたとこ ...

使用中テーマのfunctions.phpに関数を定義

ポストされたデータを処理するPHPの関数を、使用しているテーマのfunctions.phpに定義する。

functions.phpの場所はこのブログの環境だと下記のとおり。

/var/www/wordpress_unluckysystems/wp-content/themes/affinger-child/functions.php

下記の例はポストされたデータをfilter_inputで受け取り、そのままreturnにて値を返すだけのプログラム。

定義した後はadd_shortcodeでショートコードを登録する。ここでのショートコードの名前は「sc_test」とした。

最低限の実装であるためシステムのセキュリティは考慮していない（重要）

    function form_receive(){
        $postdata = filter_input(INPUT_POST,"TESTDATA");
        if($postdata != NULL){
            return $postdata;
        }
        else{
            return 'ポスト無し。';
        }
    }
    add_shortcode('sc_test','form_receive');