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 コメントをキャンセル

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

: CakePHP 2.3でファイルをアップロード・その2　ファイル名を乱数で設定

CakePHPのアップロードするファイル名を乱数で変更しセキュリティを高める方法を解説。

: CakePHP4、5でSELECT telephone as tel FROM usersの様にasでカラムに別名を付ける方法

CakePHP4、CakePHP5でクリエビルダーを利用してテーブルからレコードを取得する際、asを使用してカラムの別名で値を取得したい場合の対応方法を解説。また、別名にはハイフンやアスタリスクなど使用できない文字がある点も解説。

: CakePHP3で生の SQLの実行はConnectionManagerを使う

CakePHP3で生の SQL文を実行する方法を解説。クリエビルダーを使う場合は TableRegistryを利用するが、SQLを実行する場合は ConnectionManagerを使う。プリペアードステートメントの使用方法も解説。

: Windows環境の XAMPPを利用して CakePHPの開発する際の注意点

WindowsベースにXAMPPで環境を構築しCakePHP4を利用したWebシステムを構築する際は、大文字と小文字の違いを意識する必要がある。LinuxベースのWebサーバに移動させたときに不具合で動作しないこともある。

: CakePHP3のタイムゾーンを協定世界時UTCから日本標準時間JSTにずれを変更する方法

CakePHP3の標準設定のタイムゾーンは「UTC（協定世界時）」に設定されている。これを日本標準時に変更する方法（app.php、bootstrap.phpの変更方法）の解説。

: CakePHP4、5の認証処理で認証が通らない際の確認方法と確認箇所の紹介

CakePHP4、5系の認証処理でログイン認証が通らない場合の確認方法、確認箇所を解説。ログ出力し、ステータスを確認するが、ステータスの内容も紹介。それはそのままusernameを変更する際のポイントでもある。