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 2.x　3.x CakePHP3

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

Message コメントをキャンセル

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

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

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

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

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

: CakePHP3のForm Helperの使い方のまとめ

CakePHP3になりフォームヘルパーの使い方も大きく変わりましたので、使い方をまとめました。基本的な使い方からプラスアルファの便利な使い方まで紹介。

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

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

: CakePHP3で画像・ファイルのアップロード処理を自作・解説付き・その２

ファイルのアップロード機能の自作サンプルコードとその解説のその２。アップロード機能に関連するファイルの更新や削除の処理や画像、フォルダのパスの指定方法などを含めて解説。

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

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

: CakePHP 2.3 コマンドラインからPHPのシェル実行の方法解説

CakePHP 2.3でコマンドラインから CakePHPで記述した処理を実行する方法を解説します。

: CakePHP 2.3　連携先のテーブルの項目で条件抽出する場合

アソシエーション（連携）している先のテーブルの項目で条件抽出する際の考え方と注意点をサンプルソースを用いて説明しています。

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

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

: CakePHP3でQRコードを作成、表示するライブラリ「cakePHP-QR-Code-Helper」

CakePHPでQRコードを生成するライブラリ「cakePHP-QR-Code-Helper」の紹介。GDライブラリのインストールも必要ないHelperとして提供されているため、ファイルを設置すればすぐに使用可能。