CakePHP3でkeywords、DescriptionをHTMLヘルパーを使って設定する

2019/09/21

CakePHP3では metaタグを編集する HTMLヘルパーが用意されている

metaタグの keywords、DescriptionをHTMLヘルパーを使って設定する方法

　
CakePHP3で keywords、Descriptionを設定する方法を解説します。
　
CakePHP3には最初から metaタグを編集する HTMLヘルパーが組み込まれています。
それを利用してメタタグの keywords、Descriptionを編集します。
　
　

metaタグが編集されるレイアウトファイルを確認

　
まずはじめに、metaタグが編集される場所を確認します。
　
metaタグが編集されるファイルは、下記のレイアウトファイルになります。
/src/Template/Layout/default.ctp
　
このレイアウトファイルの 32行目あたりに「<?= $this->fetch(‘meta’) ?>」という記述があります。
これが metaタグを出力する「fetch()」になります。
　
ここに編集する値を、各ページごとのテンプレートで指定する、という処理になります。
　
　

metaタグの値を指定するテンプレートファイルを編集

　
値を指定するテンプレートは
/src/Template/Topics/view.ctp
などのテンプレートファイルに下記のコードを記述します。
　
　
記述する metaタグのヘルパーの基本形は以下のようになります。
　

<?= $this->Html->meta("属性","値",["block"=>true]); ?>

1	<?= $this->Html->meta("属性","値",["block"=>true]); ?>

　
　
具体的に「keywords」「description」を指定すると以下のようになります。
　

<?= $this->Html->meta("keywords","キーワード",["block"=>true]); ?>
<?= $this->Html->meta("description","ディスクリプション",["block"=>true]); ?>

1 2	<?= $this->Html->meta("keywords","キーワード",["block"=>true]); ?> <?= $this->Html->meta("description","ディスクリプション",["block"=>true]); ?>

　
1つ目のパラメーターが、metaタグの「name（属性）」の値を指定するもので「keywords」は「キーワード」、「description」は「ディスクリプション」を指定する箇所になります。
　
2つ目のパラメーターが、metaタグの「content」の値を指定する箇所になります。
　
　
出力結果は以下のようになります。
　

<meta name="keywords" content="キーワード"/>
<meta name="description" content="ディスクリプション"/>

1 2	<meta name="keywords" content="キーワード"/> <meta name="description" content="ディスクリプション"/>

　
　
また、3つ目のパラメーターは、ブロック化をするのか、しないのかを指定する箇所になります。
　
「ブロック化」のデフォルトは、「"block"=>false」の「ブロック化をしない」になっています。
そのため、デフォルトの設定では、metaタグが編集される場所がテンプレートファイルに「<?= $this->fetch(‘meta’) ?>」を記述した場所になります。
　
そのため、「<body>」と「</body>」の間に出力され、metaタグの役割を果たしません。
　
そのため、「"block"=>true」を記述し、headタグ内に記述してある「<?= $this->fetch(‘meta’) ?>」の場所にまとめて出力されるようにします。
　
これが、「ブロック化を有効にする」指定です。
　
基本的に metaタグを出力する処理は「"block"=>true」も記述する、という認識で問題ありません。
　
　
ちなみに、「"block"=>true」が指定されている場合は、echoがなくても metaタグに出力することができます。
　

// 出力される
$this->Html->meta("description","ディスクリプション",["block"=>true]);

// 出力される
echo $this->Html->meta("description","ディスクリプション");

// 出力されない
$this->Html->meta("description","ディスクリプション");

// 出力される

$this->Html->meta("description","ディスクリプション",["block"=>true]);

// 出力される

echo $this->Html->meta("description","ディスクリプション");

// 出力されない

$this->Html->meta("description","ディスクリプション");

サイト全体に共通する処理をページごとに切り替える処理

　
今回は、サイト全体に共通して指定をする必要はあるものの、ページごとにそれぞれ違うテキストを切り替えて編集していく必要がある metaタグの「keywords」「description」を指定する方法を解説しました。
　
　
同じような考え方をする仕組みとして、下記の記事で書いている titleタグ、h1タグの値を指定する方法や、使用する JavaScriptや CSSをページごとに設定する方法、パンくずを指定する方法、OGPを指定する方法などにも活用することができます。
CakePHP3で /Layout/defult.ctpにある titleタグ、h1タグを編集する方法
 CakePHP3でページごとに読み込むJavaScript、CSSを変える処理の解説
 CakePHP3のOGPはHTMLヘルパーの$this->Html->meta()を使って設定
 CakePHP3にOGPをfetch、asignを利用してテンプレートごとに指定する方法を解説
 CakePHP3でパンくずの指定は HTMLヘルパーを使って指定する方法を解説
　
　
これらは、レイアウトファイルに変数を指定しておき、そこに編集する値を各ページ用のテンプレートファイルで指定する、という仕組みです。
　
　

- CakePHP 2.x　3.x CakePHP3

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

Message コメントをキャンセル

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

: VirtualBoxにCakePHP3を設置。必要なCentOS、Apache、PHP、MySQL、Composerをインストールし設定する

VirtualBoxにCentOS、Apache、MySQL、PHPをインストールするところから初めてCakePHP3の開発環境を構築する手順を詳細解説。この記事1つで全ての設定が完了する。

: CakePHP3のビューで受取ったテーブルのオブジェクトを連想配列に変換する方法

コントローラーからビューに送ったテーブルのオブジェクトを連想配列に変換し、ビューの中で自由に使えるようにするメソッド「toArray()」の解説。連想配列に変換できれば利用度アップ！

: CakePHP3のOGPはHTMLヘルパーの$this->Html->meta()を使って設定

CakePHP3でOGPを設定する方法を解説。metaタグを編集するHTMLヘルパーを利用してOGPのタグを編集する。また、エレメントとして分割することでメンテナンス性も向上させる。

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

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

: CakePHP 2.3　Search Pluginで検索処理　その６ORDER、sortソートの機能

CakePHPの検索プラグイン Search Pluginの検索処理の中で order、ソートについての解説です。

: CakePHP 2.3　デバッグキット（DebugKit）超初心者向けフォロー講座

CakePHP初心者に向けてデバッグキット（DebugKit）のインストール方法、はまりポイントを解説。

: CakePHP3にデイトピッカー jQuery UI DatePickerを実装する手順の解説

CakePHP3にjQuery UIのDatePickerを実装する手順を説明。併せて、デイトピッカーを設置に関連するCakePHP3の解説と、テーマを変更したり、表記を変更するカスタマイズする方法なども紹介。

: CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。Usersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。

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

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