ショートコードを使ったphpファイルの呼び出し方法。

ワードプレス（WordPress）のショートコードを使って、phpの外部ファイルを呼び出す方法です。

ショートコードを使う事で、投稿記事の中や固定ページにphpで取得したリストやイベントを表示させる事が出来ます。

ショートコードを使わなくても、ワードプレスでは指定したphpファイルを呼び出す関数があります。

これは、sample.phpを読み込んで、表示させる関数です。

※この他にも同様の動きをする関数が複数あります。

この関数は直接テーマファイルに記述する必要があるので、テーマの編集に慣れていないと少々ハードルが高いですね。

それと、どうしても投稿記事や固定ページ本文中に、外部ファイルを読み込ませたい場合などは、本文中に直接phpコードを書くとセキュリティ的に問題があるので、ショートコードが使えると非常に便利です。

ショートコード化する事で、記述する事も少なく効率的な投稿が出来ます。

とにかく、投稿文章内にphpファイル使った記述ができるので、他のブログやホームページとは違う演出が出来ます。

また、テーマファイルへの変更が無いので、テーマのバージョンアップなどで直接書き込んだコードが消される事がありません。

これは、かなり大きなメリットです。

※テーマのバージョンアップ時は必ずテーマのバックアップはとってしください。

参考ページ：ワードプレステーマのバージョンアップで失敗しない方法

ショートコード化のデメリット

ショートコード化のデメリットは……　直接的なモノは思い当たりません。

しいて言えば、場所を選ばずに記述が出来るので、外部ファイルが増える事でしょうか。

その為の、対策も一応されているので、大丈夫です。

※一部のプラグインで、functions.phpを読みこまないプラグインがあります。その場合は、今回のショートコードは実行されません。もしショートコードが表示されないのであれば、関連するプラグインを確認してください。

作業手順

• functions.phpにコードを追記
• news.phpを制作　※サンプルファイルです。
• 任意の場所にショートコードを記述

functions.phpにコードを追記

テーマのfunctions.phpに下記のコードを追記します。

functions.phpの場所は

ドメイン名/wp-content/themes/使用しているテーマ/

にあります。

functions.php

//ショートコードを使ったphpファイルの呼び出し方法
function Include_my_php($params = array()) {
    extract(shortcode_atts(array(
        'file' => 'default'
    ), $params));
    ob_start();
    include(get_theme_root() . '/' . get_template() . "/$file.php");
    return ob_get_clean();
}
add_shortcode('myphp', 'Include_my_php');

先程のデメリットで言いましたように、外部ファイルが増える場合には、テーマファイルと同じ階層では、ファイルが増えて管理がしにくくなります。そこで読み込む場所を指定出来る様になっています。読み込み先を指定する事で、外部ファイルを一か所に的まで管理できるようになり、テーマの管理が楽になります。

7行目を下段の様に変更すれば、特定の場所を指定出来ます。

 include(get_theme_root() . '/' . get_template() . "/$file.php");

 include(get_theme_root() . '/' . get_template() . "/指定フォルダー名/$file.php");

とする事で、任意の場所にphpファイルを置く事が出来ます。

サンプルファイル

このサンプルファイルは新着記事の一覧リストです。

詳細はご説明しませんが、シンプルなリストファイルです。

news.php

最新記事　5件

• 
  ：

このnews.phpをテーマファイルと同じ階層につくってください。

※先のfunctions.phpで読み先を指定した場合は、指定したフォルダーにいれてください。

※ファイルの文字コードはUTF-8としてください。Shift-jisで制作した場合は、日付の箇所が文字化けするので注意してください。

ご自身で用意されてた、他のphpファイルでも結構です。

任意の場所にショートコードを記述

本文中の任意の場所に下記のショートコードを記述してください。

[myphp file='news']

記述方法

[myphp file='ファイル名']

拡張子は不要です。

今回の内容は、簡単ではありませんが、これは上手く使う事でホームページの見せ方を大きく変える事が出来ます。

ワードプレスはこうした情報が沢山あるので、非常に助かります。

また、こうした改造（カスタマイズ）を日々行っている事がワードプレスの凄いところです。

プロがワードプレスを使う理由は様々ですが、こうした柔軟さは他のCMSでな無いところですね。

今回のソースは下記サイトを参考とさせてもらいました。

参考サイト：How to Develop a PHP File Include Plugin for WordPress