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 CakePHP3

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

Message コメントをキャンセル

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

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

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

: CakePHP 2.3　Search Pluginで検索処理　その４前方一致検索、後方一致検索、不等号による検索、between句による範囲検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で前方一致検索、後方一致検索、不等号による検索、between句による範囲検索の解説です。

: CakePHP3のCakeDC/Usersのログイン後のリダイレクトとユーザ権限管理の設定解説

CakeDC謹製Usersプラグインの紹介。ログイン認証後にリダイレクトする先の設定方法についての解説と実運用するために必要なコツを解説。便利な仕組みも仕様の理解があって初めてうまく使いこなせる。

: CakePHP3でComposerでインストールできないプラグイン、外部ライブラリを vendorに入れて手動で読み込む方法

CakePHP3にComposerからインストールできないプラグインやライブラリなどを利用する方法、vendorにファイルを設置し、composer.jsonを更新し、それを呼び出す方法を詳細に解説。

: CakePHP4でcontrollerで実行したバリデーションエラーをmodelのにマージする方法

CakePHP4でcontrollerで実行したバリデーションの結果をModelのバリデーション結果に追加するメソッド「setError()」「setErrors()」の使い方の解説。

: CakePHP3でデータを保存する save()で発生するエラーを確認する方法を解説

CakePHP3でデータ保存処理のログを取得する方法。save()では true、falseの戻り値しか取得できないが、saveOrFail()と try…catch文を使いエラーログ、エンティティを取得し、不具合の解析を行う。