CakePHP3で /Layout/defult.ctpにある titleタグ、h1タグを編集する方法

2019/04/07

CakePHP3で /Layout/defult.ctpに設定されている titleタグ、h1タグのテキストを変更する方法

　
CakePHP3のデフォルトのテンプレートを使て画面を表示する場合、titleタグや h1タグに表示されるテキストは、テーブルの名称に基づくテキストになります。
　
管理画面であればこれでも問題ない場合もありますが、公開側の画面ではそういうわけにはいきません。
　
ということで、titleタグ、h1タグのテキストを編集する方法を解説します。
　
　

デフォルトの titleタグ、h1タグの設定内容について

　
CakePHP3で「Tests」テーブルの index()アクションに対して表示される titleタグ、h1タグに編集されるテキストに関連するファイルは
　
サイトの共通して使用するテンプレートである下記と
/src/Template/Layout/defult.ctp
　
画面ごとに使用するテンプレートである下記とがあります。
/src/Template/Tests/index.ctp
　
　
デフォルトの設定では、
/src/Template/Layout/defult.ctp
のファイル上に
　
titleタグに関する記述と

<title>
    <?= $cakeDescription ?>:
    <?= $this->fetch('title') ?>
</title>

<title>

<?= $cakeDescription ?>:

<?= $this->fetch('title') ?>

</title>

　
h1タグに関する記述とがあります。

<li class="name">
    <h1><a href=""><?= $this->fetch('title') ?></a></h1>
</li>

<h1><a href=""><?= $this->fetch('title') ?></a></h1>

</li>

　
この処理の部分で、テーブル名に基づくテキストが編集されます。
　
　

titleタグ、h1タグのテキストを任意のものに変える方法

　
これに対して、titleタグ、h1タグのテキストを変更したい場合は
　
ページごとのテンプレートファイルにページごとの値を設定していきます。
/src/Template/Tests/index.ctp
　
titleタグに編集するテキストは、下記の様に設定します。
　

<?php $this->assign("title", "タイトルタグに編集するタイトル"); ?>

1	<?php $this->assign("title", "タイトルタグに編集するタイトル"); ?>

　
$this->assign()の 1つ目のパラメータに変数名を指定して、2つ目のパラメータに編集したいテキストを指定します。
　
　
デフォルトの設定では titleタグ、h1タグは同じテキストが編集される設定になっていますので、h1タグのテキストを違うテキストにしたい場合は、下記の様に h1タグ用のテキストを設定します。
　

<?php $this->assign("h1", "h1タグに編集するh1テキスト"); ?>

1	<?php $this->assign("h1", "h1タグに編集するh1テキスト"); ?>

　
　
また、h1タグ用のテキストを設定した場合は、「/src/Template/Layout/defult.ctp」ファイルに h1のテキストを編集する設定をします。
　

<li class="name">
    <h1><a href=""><?= $this->fetch('h1') ?></a></h1>
</li>

<h1><a href=""><?= $this->fetch('h1') ?></a></h1>

</li>

　
　
ただ、このままだと h1タグの指定がないページでは h1タグの部分が表示されなくなってしまいますので、下記の様に h1のテキストが指定している場合のみ表示するようにしておくと汎用性が高まります。
　

<li class="name">
<h1><a href=""><?= $this->fetch('h1') ? $this->fetch('h1') : $this->fetch('title') ?></a></h1>
</li>

<h1><a href=""><?= $this->fetch('h1') ? $this->fetch('h1') : $this->fetch('title') ?></a></h1>

</li>

　
　
ちなみに、デフォルトのテンプレートでは h2タグ以降の設定はありませんので、h2タグ以降は必要に応じてビューテンプレートファイルの中で設定するといいでしょう。
　
　

- CakePHP 3.x 4.x 5.x CakePHP3

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3のメッセージ日本語化の設定（国際化と地域化の機能の使い方の解説）

CakePHP3の英語のメッセージを日本語化（多言語化）する手順を解説。オリジナルのメッセージを作成する方法やプログラムで文言を追加する場合の対応なども解説。

: CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングする方法

CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングをする方法を解説。インストール方法、読み込み方法。および、具体的なスクレイピングを実行するサンプルソースも。

: CakePHP3で他のテーブルのマスタテーブルからセレクトボックス（プルダウンリスト）を作る

他のテーブルのマスタのレコードからプルダウンリストを作成し、選択できるようにするサンプルプログラムと解説。ORMの設定によりデータベースの値を取得し、配列を作成し optionsに与える。

: CakePHP3で「SQLSTATE[23000]: Integrity constraint violation」「SQLSTATE[42S22]: Column not found」などのエラーが出たときの確認するポイント

CakePHP3の開発で発生する「SQLSTATE[23000]: Integrity constraint violation」「SQLSTATE[42S22]: Column not found」のエラーには特有の原因もあるため、その説明と対処方法の解説。

: CakePHP3でレコードを保存（追加、更新、Insert、Update）する複数の方法を紹介

CakePHP3でレコードを追加、更新（Insert、Update）する記述方法を解説。1件ずつ処理、全件をまとめて処理、条件に該当する複数件のレコードを処理方法をサンプルコードを用いて解説。

: CakePHP 2.3　ログイン、操作履歴、アクセスログ出力

CakePHPでログインや操作履歴などのアクセスログ出力処理を作成します。

: CakePHP 2.3　Search Pluginで検索処理　その５入力項目に複数項目入力した場合の AND検索、OR検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で複数項目を入力した場合の AND検索、OR検索についての解説です。

: CakePHP5系で認証機能のAuthenticationプラグインをインストール・エラー発生注意

CakePHPのユーザ認証に使用するオフィシャルなプラグインAuthenticationだが、CakePHP5系では Authentication Ver.3系を使う必要があるが、公式ChiffonBookが間違えている。

: CakePHP3の検索プラグイン「friendsofcake/search」の様々な検索の仕方の実装方法

CakePHP3で検索をするプラグイン「friendsofcake/search」の検索条件のカスタマイズ方法の解説。検索項目を増やしたり、以上、以下での検索や、チェックボックスによる検索の方法などを解説。