全ページのお知らせを、1か所の変更で揃える
Widget Areaで共通表示を管理し、本文にコピーするひな形との違いを理解します。
目次
**Widget Area(ウィジェットエリア)**を使うと、1か所のお知らせを編集して、複数のページに同じ内容を表示できます。たとえば「年末年始のお知らせ」をトップにも記事の下にも出し、日付をまとめて直せます。
テーマに名前付きの表示場所を用意し、その中身を管理画面から編集する仕組みです。
初回は、管理画面で中身を用意する作業と、制作担当者がテーマのファイルへ表示場所を組み込む作業の両方があります。組み込みが済んだあとは、編集担当者が管理画面でお知らせを直せます。
ひな形をコピーする方法との違い
| やりたいこと | 向いている仕組み |
|---|---|
| 共通のお知らせを、全使用先で同じ内容にする | Widget Area |
| 注意書きを記事に挿入し、その記事向けに直す | Sections(保存したひな形を挿入する機能) |
| ページ内で部品を組み合わせる | blocks型の入力欄(部品を選んで並べる欄) |
Sectionsは挿入時に文章をコピーするため、元を直しても、挿入済みの文章はまとめて更新されません。すべての使用先で同じ内容を保ちたい場合は、Widget Areaを選びます。
管理画面で、表示場所を作る
- EmDashの管理画面で**Widgets(ウィジェット)**を開く。メニューが見つからなければ、管理者に利用できるか確認する。
- **Add Widget Area(表示場所を追加)**で、名前と管理画面での呼び名を決める。
- **Available Widgets(使えるウィジェット)**から、使いたいものをエリアへ移す。
- 内容を設定し、必要なら表示順を並べ替える。
この例では、内部の名前をsite-notice、画面の呼び名を「共通のお知らせ」とします。どのページに出るかも説明欄へ書くと、後任の人が判断しやすくなります。
文章ならContent(本文)、メニューならMenu、最近の投稿などなら**Component(用意された表示部品)**を選びます。
制作担当者が、テーマに表示場所を置く
名前を付けただけでは、読者向けページに表示されません。制作担当者がコードエディターで、共通レイアウトなどの.astroファイルを開き、表示したい場所へWidgetAreaを置きます。コードを貼る場所は、管理画面の本文欄ではなく、テーマのファイルです。次は表示部分の最小例で、既存レイアウト全体を置き換えるコードではありません。
---
import { WidgetArea } from 'emdash/ui';
---
<WidgetArea name="site-notice" />2本の---で囲んだ前半は、表示部品を使えるように読み込む部分です。後半の<WidgetArea ... />が、実際に表示する場所です。すでに---があるファイルでは、読み込みを既存の枠内へ追加します。
管理画面側の名前と、コードのnameを一致させます。エリアがない場合や、中身が空の場合は何も表示されません。余白や背景などの見た目はテーマ側で整えます。公式のWidget Areaガイド(別タブで開く)に配置と装飾の例があります。
共通の変更は、複数のページで確かめる
確認用サイトで「営業開始は10時です」と表示し、管理画面で「11時です」へ直してみます。トップと記事詳細の両方を開き直し、同じ変更が出ることを確かめます。記事本文の下書きを編集する場合とは影響範囲が違うので、公開中の共通表示が変わる前提で作業の時刻を決めておきます。
ページを一時保存して配るキャッシュを使っているサイトでは、設定を直したあとも古い表示が残る場合があります。制作担当者が、ウィジェットの変更で対象ページを更新する設定になっているかを確かめます。
便利な部品にも、受け皿が必要
検索ウィジェットは、検索フォームを表示する部品です。標準では/searchへ送るため、その行き先の検索ページも必要です。最近の投稿のリンクも、自分のサイトの記事URLに合うか確認します。
多言語のメニューでは、リンクに言語の部分を付ける処理が別に必要な場合があります。「部品を選べたら全部つながった」と判断せず、表示したリンクを実際に開いてください。
お知らせが終わったときの扱いも決める
使う期間が終わったら、中身を外すのか、別の案内へ置き換えるのかを決めます。空になったときに大きな余白だけ残らないかも確認します。
表示場所の名前、使われるページ、編集担当者を作業メモへ残しておくと、次のお知らせにも同じ仕組みを使えます。