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で Ajaxを使う方法の解説。3.6以降対応。Successとthenの両方を解説。

CakePHP3でajaxを利用する処理の実装方法を解説。プルダウンを変更するとデータベースの値を取得し検索結果の内容を変更するというような処理を想定。CakePHP3.6以降の CSRF対策対応済。

: CakePHP3のインストールでURL rewriting……のエラーが！その解決方法解説

CakePHP3をインストールしたら URL rewriting is not properly configured.のエラーが。原因は.htaccessが有効になっていないこと。httpd.confに設定を追加すればOK。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合

ID以外のカラムでアソシエーション（連携）させるための考え方とサンプルソースを用いての説明を行っています。

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

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

: cakephp3 カスタムバリデーションを簡易的に実装する方法

CakePHP3の独自のバリデーションをテーブルクラス内に簡単に記述する方法を解説。他のテーブルクラスでは使えないが、記述する量は少なく実装できるため、他で使わない処理を書くのには便利。

: CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説

CakePHP3で定数や共通で使う変数をまとめて設定し、プログラム内で読み込む方法を、bootstrap.phpに直接記述する方法と定数ファイルを分ける方法の3つの方法で解説。

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

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

: CakePHP3でDocumentRootやtmp、webroot、logsなどのフォルダへのパスの定数

CakePHP3で特定フォルダのパスの定数を解説。root、DocumentRoot、app、config、webroot、tests、tmp、cache、vendor、コア、コアの srcが設定済み。realpath()関数を使うと柔軟なパス指定が可能。