メニューと共通設定を管理する
サイト上部のリンクやサイト名など、複数のページで使う情報を管理画面から整える考え方を説明します。
目次
ページ上部のリンクは「メニュー」、サイト名などの共通情報は「サイト設定」で管理します。 これらの設定を使うようにテーマが作られていれば、管理画面から変更できます。
メニューの名前と、リンクの文字は別
メニューは、リンクを並べたまとまりです。たとえばサイト上部に「ホーム」「記事一覧」「このサイトについて」を並べます。
メニューの管理用の名前を primary、管理画面での表示名を「上部メニュー」とする例を考えます。ページを作る側は primary という名前を使って、このまとまりを取り出します。
その中の各リンクには、「記事一覧」のような表示文字と、移動先があります。メニュー自体の名前、リンクの文字、移動先を分けると、設定で迷いにくくなります。
リンクを追加して順番を整える
管理画面の Menus を開きます。既存テーマが使うメニューがあれば、まずそれを編集します。同じ役割のメニューを別名で新しく作っても、テーマが読み込まなければ表示されません。
- 対象メニューを開きます。
- 登録済みの記事などへ移動させるなら Add Content、指定したURLへ移動させるなら Add Custom Link を選びます。
- 読者に見せる文字と、リンク先を確認します。
- Move up / Move downで順番を整えます。
- 子の項目にしたい場合は Parent を設定します。
メニューを保存したら公開ページを開き、表示が変わったことと、各リンクが正しいページへ移動することを確認します。公式のメニューの説明(別タブで開く)が、リンクの種類と親子の扱いの出典です。
内部リンクと外部リンク
/posts/ のような書き方は、同じサイトの中の場所を指します。https://... から始まる別サイトへのリンクは、外部のURLを指定します。
同じサイトの記事を選べるなら、記事を参照するリンクを使うと、CMSが記事の状態やURLの情報を扱えます。文字としてURLを入力するリンクとは性質が違います。
メニューのデータに「別タブで開く」設定があっても、実際のリンクへ反映するのはテーマの仕事です。管理画面の設定と、読者がクリックしたときの挙動の両方で確認してください。
サイト名や説明文を変える
管理画面の Settings で、設定したい情報に対応するページを開きます。
| 場所 | 主に扱うもの |
|---|---|
| General | サイト名、説明文、ロゴ、時刻の扱いなど |
| Social | SNSのアカウント情報 |
| SEO | 検索や共有に使う既定の情報など |
サイト名なら「週末ノート」、短い説明なら「休日の小さな楽しみを集めるブログ」のように入力します。保存後、ヘッダーなど、その設定を使う公開画面を開き直して確認します。
SNS設定では、完全なURLではなくアカウント名を保存する項目があります。入力欄の案内を確認し、URLを入れる欄なのか、アカウント名を入れる欄なのか確かめます。公式のサイト設定ガイド(別タブで開く)
制作側は、設定を読み出して表示する
ここからは、テーマのファイルを編集する人向けです。管理画面でメニューやサイト名を変えたい人は、次の「変えたはずなのに見えないとき」へ進み、必要なら制作担当者に確認してください。
管理画面の入力をページへ反映するには、テーマ側でその設定を読み出して使います。
次は、Astroの部品でサイト名を読む短い例です。すでにEmDashを組み込んだプロジェクトが前提です。
---
import { getSiteSettings } from 'emdash';
const settings = await getSiteSettings();
const title = settings.title ?? '週末ノート';
---
<a href="/">{title}</a>getSiteSettings() はサイト設定を取り出す関数です。?? は、値がないときに右側を使う書き方です。上の例なら、サイト名が未設定でも「週末ノート」と表示します。
この部品ファイルは、作っただけでは画面に出ません。使うレイアウトから読み込んで配置する必要があります。詳しくは小さなテーマを作るで扱います。
ロゴの登録前にもサイト名を表示できるコード例は、getSiteSettings() で読むサイト名・説明・ロゴにあります。
変えたはずなのに見えないとき
メニューなら、名前がテーマの読み出す名前と同じかを確認します。記事を参照するメニューでは、参照先が未公開のために表示されない場合もあります。
サイト名なら、まず保存が完了したかを確かめます。保存できていれば、テーマがその設定を使っているか、文字がファイルに直接書かれていないかを制作担当者に調べてもらいましょう。