ショートコードを使った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

関連記事一覧

カテゴリー

ホームページサポートについて

神奈川県横浜市を拠点に、全国対応のホームページ制作・運用サポートを提供しています。

高品質なデザインとSEO対策で、お客様のビジネスを効果的にアピールします。

また、制作後の運用サポートも充実しており、長期的なお付き合いをお約束します。

初めてのホームページ作成からリニューアルまで、お客様のニーズに合わせたサービスを提供します。

PAGE TOP