④テーマ内のPHPコードの書き方、方法を決定しよう【WordPressテーマの自作】

公開日:2021年8月30日 テーマ作り
④テーマ内のPHPコードの書き方、方法を決定しよう【WordPressテーマの自作】

WordPressのテーマで使用されるプログラムは大きく以下の3通りあります。

  • WordPressそのものの動作や表示をさせるための命令を書くPHPプログラム
  • デザイン・要素の表示を示すCSSプログラム
  • 何かの動きを与えるJavaScriptプログラム

それぞれに書き方があるのですが、中でもPHPについては同じ結果となるものの書き方にいろいろなパターンがあります。

皆さんの中には、何かの機能を足したくてネット検索し、コピペで...と言われるものをコピーしてみたら動かなかった、エラーになったという経験はありませんか?

コピペで..となっているのに何で?と思われるかも知れませんが、実はPHPの書き方がご自身の環境に合っていないことでトラブルが起こることが非常に多いのです。

テーマを制作する上でも、その後いろいろとカスタマイズをする上でも、書き方のパターンを知っておくことは非常に重要ですのでこの機会に覚えておきましょう。

本ページおよび、制作過程のページは、実際に作成しながら進めています。前後ページへの挿入を行う必要性、内容を忘れないように書き留めていく必要があることから、公開済みの状態で内容を充実させていっていますので、お見苦しい点が多々あるかとは思いますが、ご容赦ください。

1.テーマで使われるオーソドックスなPHPプログラムの書き方

今回制作を進めるテーマもこの方法で解説していきます。一般的に多く使われているパターンかと思います。

書き方の作法としては、1つ1つの命令を完結するというものになります。

PHPは「<?php」という、これからPHPを使って命令を出しますよ!という宣言をして、「?>」でそのプログラムはここまで!と終了させます。

これを、PHPファイル全体ではなく、個々の命令で使うのがここで紹介する記述法です。

例としては以下のような書き方になります

<?php 命令の内容 ?>
<?php 命令の内容 ?>
<?php 命令の内容 ?>
...

もしもお使いのテーマがこのような記述になっているようでしたら、カスタマイズ用のコピーコードもこの形になっていなければなりません。

2.ファイル中のすべて、または一連のプログラムを1つの命令として記述する方法

前項では1つ1つの命令を1つ1つ「<?php」「?>」でくくって完了させて次へ進むという流れになっていますが、ここでの書き方は少し違います。

例としては以下のような書き方になります

<?php
命令や条件式のまとまり
命令や条件式のまとまり
命令や条件式のまとまり
?>

この書き方では、命令や条件式のまとまりの間に1つ1つの命令の内容を挿入することはできません。次のような場合はNGとなります。

<?php
命令や条件式のまとまり
命令や条件式のまとまり
<?php 命令 ?>
命令や条件式のまとまり
?>

もうお分かりですね。1つの「<?php」~「?>」の中に別の「<?php」~「?>」が入ってしまっています。1つのプログラムが始まってから終わっていないのに、次のプログラムがあるということになりエラーとなります。

こうした形でも成立させるためには、以下のようなしなければなりません。

<?php
命令や条件式のまとまり
命令や条件式のまとまり
?>
<?php 命令 ?>
<?php
命令や条件式のまとまり
?>

つまり途中で終了させて、別の命令を割り込ませ、再び命令の続きを開始する..という書き方になります。既存テーマへ何かを追加する場合には仕方ないかも知れませんが、このように書き方が混在してしまうと、後々解読するのが難しくなり、間違いを起こしやすくなりますから、注意しましょう。


WordPressでは、functions.phpとfunctions.phpへ割り込ませるプログラムの場合は2の方法を用います。これはfunctions.phpに書かれているものすべてが一連の命令であるからです。

その他のテンプレート類に関しては1の方法でも2の方法でも可能ですが、前述したように今回作成するテーマではプログラムの開始と終わりを把握しやすくするため、1の方法で紹介していきます。

サイトへの支援をお願いします

サイトへお越しいただきありがとうございました。
テーマを無料で提供し続けることができるよう、投げ銭によるサイトへの支援、およびSNSによる拡散をお願いします

  •  白黒ハチワレ猫の【モモ】とのんびり暮らしながらフリーランスでサイト制作のお手伝いをしています。
    ブログツールでありながら本格的なウェブサイトに必要な機能を追加できるWordpressの良さを活かした楽しく便利なサイト作りのお手伝いをさせていただいております

QR Code

このページはモバイル端末でもご覧いただけます

左のQRコードを読み取っていただくと、このページのURLが表示され、簡単にアクセスできます。ぜひモバイル端末でもご覧ください。

WordPressのカスタマイズ・不具合対応などご相談ください

Wordpressのカスタマイズ、不具合解消のご相談はすべてココナラのダイレクトメッセージからお受けしております。まずはこちらのバナーからお気軽にお問い合わせください。