パートナー制度
テンプレート開発ガイド
WordPress のサーバーやプラグインの保守なしにAstro でテンプレートを作れます。スターターパックをダウンロードすればすぐに手元でプレビューできます。提出前の検査も審査と同じ規則で手元で確かめられます。
スターターパック
そのまま動くひな形のテンプレート、開発ツール(daigakus-template)、SDK、このページと同じ仕様書が入っています。アカウントがなくてもダウンロードできます。
3 つのコマンドで提出まで
cd my-template
pnpm install --ignore-scripts # 依存を入れる(審査と同じ入れ方)
pnpm dev # http://localhost:4321 でプレビュー
pnpm pack:zip # 検査 → テストビルド → 提出用 zip Node.js 22 以上とpnpm 9 以上(corepack enable)が必要です。
AI(Claude Code など)と一緒に作る場合はSKILL.md をダウンロードしてプロジェクトに置いてから依頼してください。使い方は下の「16. AI と一緒に作る」にあります。
テンプレート制作ガイド
daigakus.com のテンプレートを作る方のための仕様書です。スターターパックの GUIDE.md と、ウェブ版(https://daigakus.com/partners/developers )は同じ内容です。
1. しくみ
daigakus.com のお客様(テナント)は、管理画面のフォームに店名・営業時間・お知らせ・メニューなどを入力します。 公開ボタンを押すと、プラットフォームがその内容を content.json に書き出し、テンプレートを Astro の静的ビルドにかけて、できた HTML をそのまま配信します。
お客様の入力 ─→ content.json ─→ astro build(あなたのテンプレート)─→ 静的な HTML・CSS
- テンプレートは「content.json を読んで HTML を作る Astro プロジェクト」です。サーバーで動くコードはありません
- ビルドはネットワークに繋がっていない環境で行います。ビルド中に外部の API や CDN へ取りに行くことはできません
- 入力欄(フォーム)はテンプレートが作るのではなく、プラットフォームが用意します。テンプレートは 入力された値をどう見せるか を担当します
テンプレートが受け取る内容は 3 種類です。
| 種類 | 中身 | 決めるのは |
|---|---|---|
標準セクション(site) | 基本情報・所在地・営業時間・SNS・行動ボタン・お知らせ・よくある質問・問い合わせ・規約類 | 全テンプレート共通(daigakus) |
モジュール(modules) | メニュー・商品情報・空室情報・スケジュール・事例紹介など、お客様が追加・削除する部品 | daigakus と代理店 |
テンプレート設定(data) | 配色・レイアウトの選び方・トップの見せ方・独自のコンテンツ項目など、そのテンプレート独自の項目 | あなた(template.json の schema) |
お客様はテンプレートを切り替えても、標準セクションとモジュールの内容はそのまま引き継がれます。プラットフォームが決めるのは入力欄とデータの受け渡しだけで、レイアウトと見せ方は自由です。
自由にできること:
- レイアウト(1 カラム / 2 カラム / 非対称、セクションの順序・余白・グリッド)、CSS、コンポーネント分割、画像、同梱フォント
- 同梱した JavaScript による軽い動き(外部の読み込みは不可。§10)
template.jsonのschemaに、配色・レイアウトの選び方・トップの見せ方などの見た目の項目を追加するschemaに、そのテンプレートだけのコンテンツ項目(例: 「お店のこだわり」)を追加する(標準セクションと重複させない)- 固定文言のページを追加する(お客様が編集しない紹介ページなど。標準セクションのページは必須のまま残します)
変えられないこと:
- 標準セクションのページを出すこと、追加されたモジュールをすべて表示すること(§8・§9)
- 問い合わせフォームの送信先・フィールド名(§11)
- 外部の JS・CSS・フォント・iframe を読み込まない(§10)
- サーバーで動くコードを持たない(静的ビルドのみ)
「自由なレイアウト」と「お客様が編集できる項目」は別です。レイアウトは自由ですが、お客様が編集する内容は必ず入力欄(標準セクション・モジュール・schema)として宣言します。宣言していない文言・画像はテンプレートに直接書いてよく、お客様は編集できません(1 社専用のテンプレートでは、固定の紹介ページを作るのに使えます)。
2. 用意するもの
- Node.js 22 以上
- pnpm 9 以上(
corepack enableで使えます)。審査では pnpm で依存を入れるので、lockfile はpnpm-lock.yamlが必要です - Astro(5 系)の基本的な知識。スターターは Astro 5・素の CSS で書いています
3. はじめかた
-
スターターパック(https://app.daigakus.com/developers/starter )をダウンロードして展開します
-
my-templateに移動して、依存を入れますpnpm install --ignore-scripts pnpm devhttp://localhost:4321で、sample/content.jsonの内容のサイトが表示されます。ファイルを保存するとブラウザが自動で更新されます -
template.jsonのid・name・descriptionを変えます。idはテンプレートの識別子で、最初に提出した方が永続的に所有します(英小文字で始まる 2〜31 文字の英小文字・数字・ハイフン)。sample/*.jsonのtemplate.idも同じ値にします -
src/を作り替えます。src/lib/content.tsが値の準備をしているので、ページはそこから import して使います
--ignore-scripts を付けるのは、審査と同じ条件にするためです(付けないと pnpm 11 は依存のビルドスクリプトについて確認を求め、pnpm-workspace.yaml を作ります。このファイルは提出物に入れられませんが、pnpm pack:zip は自動で除外します)。
4. 開発ツール
SDK(vendor/daigakus-shared.tgz)に入っているコマンド daigakus-template です。スターターの package.json に短縮のスクリプトがあります。
| コマンド | スクリプト | すること |
|---|---|---|
daigakus-template dev [--sample 名前] | pnpm dev | プレビュー用の開発サーバー。--sample minimal で sample/minimal.json を使う |
daigakus-template build [--sample 名前 | --all] | pnpm build(--all) | 審査と同じテストビルド。出力に必要なページ・問い合わせフォームの契約・外部ファイルの読み込みを検査する |
daigakus-template check [--typecheck] | pnpm check | 提出前の検査(ファイル構成・package.json・lockfile・template.json・すべての sample)。--typecheck で astro check も |
daigakus-template pack [--no-build] | pnpm pack:zip | 検査とテストビルドのあと、提出用の submit/<id>-<version>.zip を作る |
daigakus-template schema | 標準セクションと標準モジュールの項目一覧(Markdown) |
共通のオプション: --date YYYY-MM-DD(ビルド日を固定。ピン留めお知らせの期限の確認などに使う)。
検査の規則はサーバーの受付と同じ関数を使っています。手元の pnpm pack:zip が通れば、サーバーの自動検査も(SDK の改変がない限り)通ります。
5. ファイル構成
my-template/
template.json テンプレートの定義(必須)
thumbnail.png 一覧に出す画像。1200x630 の PNG を推奨、2MB まで(必須)
package.json dependencies に astro と "@daigakus/shared": "file:./vendor/daigakus-shared.tgz"(必須)
pnpm-lock.yaml pnpm install で作られる(必須)
vendor/daigakus-shared.tgz SDK。改変せずにそのまま入れる(必須)
sample/content.json テスト用の内容。審査のテストビルドに使う(必須)
sample/*.json ほかのテスト用の内容(任意。check と build --all が検査する)
sample/public/media/ サンプルの写真(sample の内容でビルドするときだけ使う)
astro.config.mjs output: 'static'
src/ ページ・部品・CSS
public/ すべてのサイトに入る静的ファイル(サンプル写真は置かない)
6. template.json
{
"id": "hana-cafe",
"name": "はなカフェ",
"version": "1.0.0",
"description": "カフェ・喫茶店向け。季節のおすすめと営業時間をトップで伝える",
"contract": 2,
"modules": ["menu"],
"schema": {
"sections": [
{
"key": "design",
"label": "デザイン",
"fields": [
{ "key": "theme", "type": "select", "label": "配色", "default": "light",
"options": [{ "value": "light", "label": "明るい" }, { "value": "dark", "label": "落ち着いた" }] },
{ "key": "layout", "type": "select", "label": "トップの構成", "default": "image",
"options": [{ "value": "image", "label": "大きな写真" }, { "value": "text", "label": "文章中心" }] }
]
}
]
}
}
| キー | 内容 |
|---|---|
id | テンプレートの識別子。一度提出したら変えない |
name / description | お客様のテンプレート一覧に出る名前と説明 |
version | x.y.z。同じバージョンは中身を変えられません。直したら版を上げて提出し直します |
contract | 2 にします(標準セクションとモジュールを受け取る形)。省略すると旧形式(1)になり、site と modules が届きません |
modules | 専用のデザインで表示するモジュールの id(任意)。ここに無いモジュールも、汎用表示で必ず出します(§9) |
schema | テンプレート独自の入力欄(見た目・独自コンテンツ)。sections(key・label・fields)の配列 |
入力欄の型
| 型 | 値 | 備考 |
|---|---|---|
text / textarea | 文字列 | max で文字数の上限 |
markdown | Markdown の文字列 | 表示前に必ずサニタイズする(§10) |
number | 数値 | |
boolean | true / false | |
date | YYYY-MM-DD | |
url / email | 文字列(未入力は空文字) | url は保存時に http / https / mailto / tel だけに制限済み |
select | options の value のどれか | options: [{ "value", "label" }] |
image | media_id(文字列) | content.media[id] で実体を引く(§8) |
list | 行の配列 | fields を持つ。入れ子は 1 段まで。max で件数の上限 |
共通の属性: key・type・label・help(入力欄の下の説明)・required・default・max。
default を付けた項目は、お客様が未入力でも既定値が入って届きます。デザイン設定はお客様が一度も保存しなくても公開できるので、すべての項目に妥当な既定値を用意するか、未入力でも崩れない表示にしてください。
7. content.json
ビルドのとき、環境変数 DAIGAKUS_CONTENT に content.json のパスが入ります。
{
"template": { "id": "hana-cafe", "version": "1.0.0" },
"tenant": { "slug": "cafe-hana", "primaryHost": "cafe-hana.daigakus.com", "formEndpoint": "https://app.daigakus.com/api/forms/cafe-hana" },
"data": { "design": { "theme": "light" } },
"site": { "profile": { "name": "カフェ花", "kind": "store" }, "news": { "posts": [] } },
"modules": [
{ "id": "menu", "name": "メニュー", "version": "1.0.0", "schema": { "sections": [] }, "data": { "menu": { "items": [] } } }
],
"media": { "01HX...": { "src": "/media/01HX....webp", "width": 1200, "height": 800, "alt": "" } }
}
| キー | 内容 |
|---|---|
tenant.primaryHost | 公開先のホスト名(独自ドメインのこともある)。canonical・OGP・sitemap の絶対 URL に使う |
tenant.formEndpoint | 問い合わせフォームの送信先(§11) |
data | デザイン設定(template.json の schema の形) |
site | 標準セクション(§8)。項目の一覧は docs/REFERENCE.md |
modules | お客様が追加したモジュール(表示順)(§9) |
media | 画像。image 型の値(media_id)から引く |
読み込みと検証は SDK の関数で行います。スターターの src/lib/content.ts がそのまま使えます。
import { loadContentFromEnv, validateContentAgainstManifest } from '@daigakus/shared/content-loader';
import { parseSiteContent } from '@daigakus/shared/site';
const doc = loadContentFromEnv(); // 構造の検証
const design = validateContentAgainstManifest(doc, manifest); // デザイン設定の検証と既定値の補完
const site = parseSiteContent(doc); // 標準セクションの検証と既定値の補完
検証に失敗したら例外を投げてビルドを止めてください(壊れたサイトを公開しないため)。スターターはそのようにしています。
8. 標準セクションとページ
contract 2 のテンプレートは、次のページを必ず出力します。
| URL | 出す条件 | 中身 |
|---|---|---|
/ | 常に | トップ |
/news/ | 常に | お知らせ(site.news.posts、新しい順) |
/about/ | 常に | 会社概要・店舗情報(site.business・hours・location)。見出しは site.profile.kind で「会社概要」「店舗情報」「事業者情報」「概要」を出し分ける |
/faq/ | site.faq.items が 1 件以上 | よくある質問 |
/contact/ | site.contact.enabled | 問い合わせフォーム(§11) |
/legal/privacy/ | site.privacy.enabled | プライバシーポリシー(Markdown) |
/legal/terms/ | site.terms.enabled | 利用規約(Markdown) |
/legal/tokushoho/ | site.tokushoho.enabled | 特定商取引法に基づく表記(項目の表) |
/tools/ | site.tools.items が 1 件以上 | 外部ツール(フォーム・予約・EC。プロ・MAX。ExternalEmbed。docs/27) |
/{モジュールの id}/ | 追加されたモジュールごと | モジュールのページ(§9) |
推奨: /404.html・/sitemap.xml・/robots.txt、OGP と canonical、構造化データ(JSON-LD)。スターターはすべて入っています。
出す条件を満たさないページは出力せず、ナビゲーションからも消します。daigakus-template build は出力にこれらのページがあるかを検査します。
標準セクションを使うときの共通の関数(@daigakus/shared/site):
resolveCtaButtons(site)… 行動ボタン(電話・LINE・予約ページ・フォーム)を「押せるボタン」最大 2 個にしたもの。電話番号が無いのに電話ボタン、のような壊れたボタンを除き、代わりのボタンを選び済みです。トップの目立つ位置に出してくださいpinnedPost(site, now)… トップの上部に目立たせるお知らせ(臨時休業など)。30 日を過ぎたものは返しませんmoduleDisplaySections(module)… モジュールの汎用表示用の値(§9)
入力の少ないお客様も多くいます。空の項目は見出しごと出さないようにしてください(sample/minimal.json で確かめられます)。
9. モジュール
content.modules には、お客様が追加したモジュールが表示順で入ります。各要素は id・name・version・schema(入力欄の定義)・data(入力値)を持ちます。
- 追加されたモジュールはすべてサイトに出します。ナビゲーションの順は
content.modulesの順です template.jsonのmodulesに書いたモジュールは、専用のデザインで表示します(例:menuを写真付きのお品書きに)- それ以外(知らないモジュール・あとから追加されたモジュール)は、
moduleDisplaySections(module)を使った汎用表示で出します。スターターのsrc/components/modules/Generic.astroがそのまま使えます - 標準ページと衝突する id(
news・faq・contact・legal・aboutなど、RESERVED_MODULE_SLUGS)のモジュールはページを作りません BANNER_MODULES(notice)はページを持たないモジュールです。src/lib/content.tsのnoticeBannerを、src/layouts/Base.astroのヘッダーの上(スキップリンクの直後)に出してください。HTML と CSS はnoticeBannerHtml()/@daigakus/shared/module-widgets.cssが用意しています
弊社標準のモジュール(商品情報・メニュー・空室情報・スケジュール・事例紹介)の項目は docs/REFERENCE.md にあります。sample/content.json にはそれぞれのサンプルが入っています。
10. 画像と安全の決まり
テナントのサイトは、お客様が入力した文章をそのまま表示します。次の決まりを守ってください(審査で確認します)。
- Markdown は必ずサニタイズしてから
set:htmlで出す。スターターのsrc/lib/markdown.ts(marked+sanitize-htmlの許可リスト方式。許可するのはp br strong em del ul ol li a h3 h4 blockquote code pre hr、リンクは http / https / mailto / tel だけ)を使えば足ります - Markdown 以外の入力値は、Astro の通常の式(
{value})で出す(自動でエスケープされます)。set:htmlに入力値を直接渡さない - 入力された URL は、http / https 以外を捨ててから
hrefに使う(スターターのsafeHttpUrl())。電話はtel:、メールは形式を確かめてからmailto:を作る - JSON-LD など
<script>の中に値を入れるときは、JSON.stringify(...)のあと<を<に置き換える - 外部の JS・CSS・フォントを読み込まない(必要なものはテンプレートに同梱する)。地図の埋め込み(iframe)やアクセス解析のタグも入れない。外部サービス(Google マップ・GA4・外部フォーム/予約/EC)は、プラットフォームの公式設定と
MapEmbed/ExternalEmbed部品だけを使う(docs/27) - JavaScript は最小限に。スターターでは問い合わせの送信結果の表示だけに、小さなインラインスクリプトを使っています
画像:
image型の値は media_id です。content.media[id]のsrc(/media/...の相対パス、またはhttps://media.daigakus.com/...の絶対 URL)・width・height・altを使います- 画像の実体はプラットフォームがビルドの前に
public/media/へ置きます。テンプレートが画像を変換・取得する必要はありません - サンプルの写真は
sample/public/media/に置きます。astro.config.mjsは、DAIGAKUS_CONTENTがsample/の中を指すときだけsample/publicを使うので、お客様のサイトにサンプル写真は入りません public/に置いたものは、すべてのお客様のサイトに入ります(ファビコンの既定・共通のアイコンなど)
11. 問い合わせフォーム
/contact/ には、content.tenant.formEndpoint へネイティブの form POST をするフォームを置きます。
method="post"、actionはtenant.formEndpoint- 入力欄の name:
name(必須)・email(必須)・phone・subject・body(必須)、ボット対策の見えない欄website(人には見えないようにし、空のまま送らせる) - 送信後、サーバーは成功時
/contact?sent=1、入力不備のとき/contact?error=1へ 303 で戻します。テンプレートはクエリを見て結果を表示します(JS が無くても送信自体はできる) - 成功時のメッセージは
site.contact.thanks(空なら既定の文)、フォームの上の説明はsite.contact.intro(Markdown) - プライバシーポリシーを載せている(
site.privacy.enabled)なら、フォームの近くにリンクを置く
スターターの src/components/ContactPage.astro がこの契約どおりに作ってあります。
12. 提出物の決まり
pnpm pack:zip で作った zip をそのまま提出すれば、次の決まりは満たされます。
- zip は 20MB まで、展開後 100MB・5,000 ファイルまで
- 入れないもの:
node_modules/・.git/・シンボリックリンク・..を含むパス・絶対パス - 使えないもの(どの階層でも):
.npmrc・.pnpmfile.cjs・pnpm-workspace.yaml・ルートのpatches/、package.json のoverrides・resolutions・pnpm.*の設定 - 依存はすべて npm レジストリのバージョン指定(
file:・link:・git・URL は SDK 以外は不可)。lockfile もレジストリの integrity だけ vendor/daigakus-shared.tgzは配布した SDK と完全に一致すること(サーバーで照合します。改変・再圧縮しない)postinstallなどのスクリプトは審査の install では動きません(--ignore-scripts)template.jsonのidがスターターのまま(starter)だと受け付けません
13. 審査
提出は、代理店の管理画面(/partner)の「テンプレートを提出する」から行います(代理店のご契約が必要です。https://daigakus.com/partners/templates )。プロ・MAX のお客様は、ご自身の管理画面(/app/template)から専用テンプレートの zip を直接アップロードすることもできます(初回審査 3,000 円。docs/18 §1.2)。
提出後、次の順で進みます。
- 自動の検査(提出の直後): ファイル構成・template.json・package.json・lockfile・SDK の照合・sample/content.json の検証。エラーがあればその場で理由が表示されます
- 目視の確認(弊社の担当者): ファイルの中身(特にビルド時に実行される設定ファイルと、公開されるファイル)と、§10 の決まりを確認します
- 依存の導入とテストビルド:
pnpm install --prod --frozen-lockfile --ignore-scriptsのあと、ネットワークなし・メモリ 1GB・5 分以内でsample/content.jsonをビルドします - 承認されると、公開テンプレートはすべてのお客様のテンプレート一覧に並びます(非公開テンプレートは指定のお客様だけ)
手元での確認の目安:
-
pnpm pack:zipがエラーなく終わる -
pnpm build(すべての sample)が通り、pnpm dev --sample minimalで空のサイトが崩れない - スマートフォンの幅(360px 前後)で読める・押せる(ボタンやリンクは 44px 程度の高さ)
- 文字と背景のコントラストが十分(本文は 4.5:1 以上)
- 画像に
alt(media[id].alt)を使っている。装飾の画像はalt="" - 外部の読み込み(JS・CSS・フォント・iframe)がない
-
thumbnail.pngを、あなたのテンプレートの見た目に差し替えた
14. 新しいバージョン
- 直したら
template.jsonのversionを上げて(例1.0.0→1.1.0)、もう一度提出します。審査は同じ流れです - 使っているお客様は、承認された新しい版に管理画面から更新できます(自動では切り替わりません)
- デザイン設定の項目を変えるときは、既存のお客様の入力が新しい定義でも通るようにします(キーを消すと値は無視され、新しい必須項目は未入力扱いになります)
15. よくあるエラー
| 表示 | 対処 |
|---|---|
pnpm-workspace.yaml は同梱できません | pnpm が自動で作った設定です。削除するか、pnpm pack:zip で zip を作れば自動で外れます。次から pnpm install --ignore-scripts を使います |
vendor/daigakus-shared.tgz が配布した SDK と一致しません | スターターパックに入っていた SDK をそのまま使ってください。古いスターターパックを使っている場合は、新しいものをダウンロードして vendor/ だけ差し替え、pnpm install --ignore-scripts をやり直します |
pnpm-lock.yaml の lockfileVersion は '9.0' | pnpm 9 以上で pnpm install し直します |
content.json does not satisfy template.json | sample の data が template.json の schema と合っていません。pnpm check で場所が分かります |
/faq/ が出力されていません など | 出す条件(§8)を満たす sample で、そのページを出力していません |
外部のファイルを読み込んでいます | フォントや JS をテンプレートに同梱し、相対パスで読み込みます |
16. AI と一緒に作る(SKILL.md)
Claude Code などのコーディングエージェントに作らせる場合は、スターターパックの SKILL.md をプロジェクトに置いてから依頼します。置き場所はエージェントの決まりに従ってください(Claude Code なら .claude/skills/daigakus-template/SKILL.md)。
SKILL.mdは、このガイドの要点と、守るべき決まり(必須ページ・フォーム・外部読み込み・提出物)を AI 向けに短くまとめたものです。ウェブ版(https://daigakus.com/partners/developers/skill.md )からもダウンロードできます- 仕様の正本はこのガイドと
docs/REFERENCE.mdです。SKILL.mdと食い違うときは、このガイドに従ってください - AI が書いたコードでも、提出前の
pnpm check・pnpm build・pnpm pack:zipは人が実行して結果を確認します。審査で見るのは、だれが書いたかではなく、実際のファイルとビルド結果です
17. 項目リファレンス
content.json の site(標準セクション)と弊社標準モジュールの項目です。スターターパックの docs/REFERENCE.md、daigakus-template schema と同じ内容です。
標準セクション(site)
概要
事業者名・キャッチコピー・紹介文・ロゴなど、サイト全体で使う基本の情報です。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.profile.name | 事業者名・店舗名・会社名 | 文字(1 行) | 必須、60 字まで |
site.profile.name_kana | ふりがな | 文字(1 行) | 60 字まで |
site.profile.kind | 事業の形態 | 選択肢 | 既定 "store"、store / company / individual / other |
site.profile.tagline | キャッチコピー | 文字(1 行) | 120 字まで |
site.profile.description | 紹介文 | Markdown | 5000 字まで |
site.profile.logo | ロゴ | 画像 | |
site.profile.main_image | メイン画像 | 画像 |
所在地・連絡先
住所・アクセス・電話番号など、お客様が訪問・連絡するための情報です。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.location.postal_code | 郵便番号 | 文字(1 行) | 10 字まで |
site.location.address | 住所 | 文字(複数行) | 200 字まで |
site.location.access | アクセス | 文字(複数行) | 500 字まで |
site.location.tel | 電話番号 | 文字(1 行) | 30 字まで |
site.location.fax | FAX | 文字(1 行) | 30 字まで |
site.location.email | メールアドレス(サイトに表示) | メール | |
site.location.map_embed_url | Google マップの埋め込み URL(任意) | URL |
会社・店舗情報
「会社概要」「店舗情報」として表に並べる項目です。決まった項目のほか、自由に項目を追加できます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.business.representative | 代表者 | 文字(1 行) | 60 字まで |
site.business.established | 設立・開業 | 文字(1 行) | 60 字まで |
site.business.capital | 資本金 | 文字(1 行) | 60 字まで |
site.business.employees | 従業員数・スタッフ数 | 文字(1 行) | 60 字まで |
site.business.business | 事業内容 | 文字(複数行) | 1000 字まで |
site.business.items | その他の項目 | リスト | 最大 30 件 |
site.business.items[].label | 項目名 | 文字(1 行) | 必須、40 字まで |
site.business.items[].value | 内容 | 文字(複数行) | 必須、500 字まで |
営業時間
営業時間・受付時間と定休日です。曜日ごとに時間が違う場合は行を分けて入力します。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.hours.rows | 営業時間 | リスト | 最大 14 件 |
site.hours.rows[].days | 曜日など | 文字(1 行) | 必須、40 字まで |
site.hours.rows[].time | 時間 | 文字(1 行) | 必須、60 字まで |
site.hours.rows[].note | 備考 | 文字(1 行) | 100 字まで |
site.hours.holidays | 定休日 | 文字(1 行) | 100 字まで |
site.hours.note | 補足 | 文字(複数行) | 500 字まで |
SNS・外部リンク
Google マップや SNS、予約サイト・ネットショップなど外部のページへのリンクです。入力したものだけサイトに表示します。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.links.map_url | Google マップ | URL | |
site.links.instagram | URL | ||
site.links.x | X(旧 Twitter) | URL | |
site.links.facebook | URL | ||
site.links.line | LINE 公式アカウント | URL | |
site.links.youtube | YouTube | URL | |
site.links.tiktok | TikTok | URL | |
site.links.others | その他のリンク | リスト | 最大 10 件 |
site.links.others[].label | 表示名 | 文字(1 行) | 必須、40 字まで |
site.links.others[].url | URL | URL | 必須 |
行動ボタン
サイトを見た人に押してほしいボタン(電話・LINE・予約・問い合わせ)です。トップページの目立つ位置と、スマートフォンでは画面の下に常に表示します。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.cta.primary | いちばん押してほしいボタン | 選択肢 | 既定 "form"、tel / line / reservation / form |
site.cta.primary_label | ボタンの文言 | 文字(1 行) | 24 字まで |
site.cta.secondary | 2 つめのボタン | 選択肢 | 既定 "none"、tel / line / reservation / form / none |
site.cta.secondary_label | 2 つめのボタンの文言 | 文字(1 行) | 24 字まで |
site.cta.reservation_url | 予約ページの URL | URL | |
site.cta.note | ボタンの近くに添える一言 | 文字(1 行) | 60 字まで |
検索・SNS 表示
検索結果や SNS で共有されたときのタイトル・説明文・画像と、ブラウザのタブに出すファビコンです。空欄なら基本情報の内容を使います。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.seo.title | サイトのタイトル | 文字(1 行) | 60 字まで |
site.seo.description | サイトの説明文 | 文字(複数行) | 200 字まで |
site.seo.og_image | SNS で共有したときの画像(OGP 画像) | 画像 | |
site.seo.favicon | ファビコン | 画像 | |
site.seo.noindex | 検索エンジンにサイトを表示しない(noindex) | はい / いいえ | 既定 false |
お知らせ
新着情報・お知らせ・ブログです。日付の新しい順にサイトへ表示します。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.news.posts | 記事 | リスト | 最大 300 件 |
site.news.posts[].date | 日付 | 日付 | 必須 |
site.news.posts[].title | 見出し | 文字(1 行) | 必須、100 字まで |
site.news.posts[].body | 本文 | Markdown | 10000 字まで |
site.news.posts[].image | 画像 | 画像 | |
site.news.posts[].pinned | トップページの上部に目立たせて表示する | はい / いいえ | 既定 false |
よくある質問
お客様からよくいただく質問と回答です。1 件以上あると、サイトに「よくある質問」ページを作ります。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.faq.intro | ページの説明 | 文字(複数行) | 500 字まで |
site.faq.items | 質問 | リスト | 最大 100 件 |
site.faq.items[].question | 質問 | 文字(1 行) | 必須、200 字まで |
site.faq.items[].answer | 回答 | Markdown | 必須、5000 字まで |
site.faq.items[].category | カテゴリ | 文字(1 行) | 40 字まで |
問い合わせフォーム
サイトの問い合わせフォームの表示と文言です。届いた問い合わせは「問い合わせ」画面で確認できます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.contact.enabled | 問い合わせフォームをサイトに表示する | はい / いいえ | 既定 true |
site.contact.mode | フォームの種類 | 選択肢 | 既定 "native"、native / external |
site.contact.embed_url | 外部フォームの URL | URL | |
site.contact.intro | フォームの上に表示する説明 | Markdown | 2000 字まで |
site.contact.thanks | 送信後に表示するメッセージ | 文字(複数行) | 500 字まで |
外部ツール
予約・外部フォーム・オンラインショップなど、許可された外部サービスの埋め込みです(プロ・MAX)。ページ /tools/ に並びます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.tools.intro | ページの説明 | Markdown | 2000 字まで |
site.tools.items | 埋め込み | リスト | 最大 5 件 |
site.tools.items[].kind | 種類 | 選択肢 | 既定 "iframe"、iframe / stripe_buy_button |
site.tools.items[].label | 表示名 | 文字(1 行) | 必須、40 字まで |
site.tools.items[].url | 埋め込み URL | URL | |
site.tools.items[].stripe_buy_button_id | Stripe Buy Button ID | 文字(1 行) | |
site.tools.items[].stripe_publishable_key | Stripe 公開可能キー | 文字(1 行) | |
site.tools.items[].note | 説明 | 文字(複数行) | 200 字まで |
利用規約・プライバシーポリシー
どちらも必須ではありません。基本情報をもとにしたひな形を入れてあるので、載せたいものにチェックを入れて保存すると、サイトのフッターからリンクします。文章は自由に直せます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
site.privacy.enabled | プライバシーポリシーをサイトに載せる | はい / いいえ | 既定 false |
site.privacy.body | 本文 | Markdown | 20000 字まで |
site.terms.enabled | 利用規約をサイトに載せる | はい / いいえ | 既定 false |
site.terms.body | 本文 | Markdown | 30000 字まで |
site.tokushoho.enabled | 特定商取引法に基づく表記をサイトに載せる | はい / いいえ | 既定 false |
site.tokushoho.items | 表記の項目 | リスト | 最大 30 件 |
site.tokushoho.items[].label | 項目名 | 文字(1 行) | 必須、60 字まで |
site.tokushoho.items[].value | 内容 | 文字(複数行) | 必須、1000 字まで |
弊社標準モジュール
キーは modules[].data の中の位置です。
一時的なお知らせ(notice)
臨時休業・出荷停止などを、サイトのいちばん上に帯で表示します。色(案内・注意・重要・再開)と表示する期間を選べます。ページは作らず、すべてのページの上部に出ます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.notice.items | お知らせ | リスト | 最大 5 件 |
data.notice.items[].level | 色 | 選択肢 | 既定 "info"、info / warning / danger / success |
data.notice.items[].title | 見出し | 文字(1 行) | 60 字まで |
data.notice.items[].body | 本文 | 文字(複数行) | 必須、300 字まで |
data.notice.items[].starts_on | 表示を始める日 | 日付 | |
data.notice.items[].ends_on | 表示を終える日 | 日付 | |
data.notice.items[].url | 詳しいページの URL | URL | |
data.notice.items[].link_label | リンクの文言 | 文字(1 行) | 24 字まで |
data.notice.items[].enabled | このお知らせを表示する | はい / いいえ | 既定 true |
商品情報(products)
販売している商品を写真・価格・説明付きで紹介します。ネットショップへのリンクや売り切れ表示もできます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.products.intro | ページの説明 | 文字(複数行) | 500 字まで |
data.products.items | 商品 | リスト | 最大 200 件 |
data.products.items[].name | 商品名 | 文字(1 行) | 必須、100 字まで |
data.products.items[].category | カテゴリ | 文字(1 行) | 40 字まで |
data.products.items[].price | 価格 | 文字(1 行) | 60 字まで |
data.products.items[].image | 写真 | 画像 | |
data.products.items[].description | 説明 | Markdown | 3000 字まで |
data.products.items[].url | 購入・詳細ページの URL | URL | |
data.products.items[].sold_out | 売り切れ | はい / いいえ | 既定 false |
メニュー(menu)
飲食店・サロンなどのメニューや料金表です。カテゴリごとにまとめて表示し、おすすめに印を付けられます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.menu.intro | ページの説明 | 文字(複数行) | 500 字まで |
data.menu.items | 品目 | リスト | 最大 200 件 |
data.menu.items[].name | 名前 | 文字(1 行) | 必須、100 字まで |
data.menu.items[].category | カテゴリ | 文字(1 行) | 40 字まで |
data.menu.items[].price | 価格 | 文字(1 行) | 60 字まで |
data.menu.items[].image | 写真 | 画像 | |
data.menu.items[].description | 説明 | 文字(複数行) | 1000 字まで |
data.menu.items[].recommended | おすすめ | はい / いいえ | 既定 false |
空室情報(rooms)
宿泊施設・賃貸物件・貸し会議室などの部屋ごとの空き状況です。空室・満室などの状態をすぐに更新できます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.rooms.intro | ページの説明 | 文字(複数行) | 500 字まで |
data.rooms.updated_on | 情報の更新日 | 日付 | |
data.rooms.items | 部屋・物件 | リスト | 最大 200 件 |
data.rooms.items[].name | 部屋名・物件名 | 文字(1 行) | 必須、100 字まで |
data.rooms.items[].status | 状況 | 選択肢 | 既定 "available"、available / few / reservation / full / preparing |
data.rooms.items[].type | タイプ・間取り | 文字(1 行) | 60 字まで |
data.rooms.items[].price | 料金・賃料 | 文字(1 行) | 60 字まで |
data.rooms.items[].area | 広さ・定員 | 文字(1 行) | 60 字まで |
data.rooms.items[].available_from | 入居・利用可能日 | 文字(1 行) | 60 字まで |
data.rooms.items[].image | 写真 | 画像 | |
data.rooms.items[].description | 説明 | 文字(複数行) | 1000 字まで |
スケジュール(schedule)
イベント・教室・ライブ・出店予定などの日程です。日付順に表示し、受付中・満席・中止などの状況を出せます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.schedule.intro | ページの説明 | 文字(複数行) | 500 字まで |
data.schedule.hide_past | 終わった予定をサイトに表示しない | はい / いいえ | 既定 true |
data.schedule.events | 予定 | リスト | 最大 300 件 |
data.schedule.events[].date | 日付 | 日付 | 必須 |
data.schedule.events[].time | 時間 | 文字(1 行) | 60 字まで |
data.schedule.events[].title | タイトル | 文字(1 行) | 必須、100 字まで |
data.schedule.events[].place | 場所 | 文字(1 行) | 100 字まで |
data.schedule.events[].status | 状況 | 選択肢 | 既定 "none"、none / open / few / full / closed / canceled |
data.schedule.events[].description | 説明 | 文字(複数行) | 1000 字まで |
data.schedule.events[].url | 詳細・申込みページの URL | URL |
事例紹介(works)
施工事例・制作実績・作品・開催したイベントなどを、写真と説明付きで紹介します。カテゴリ分けやおすすめの表示もできます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.works.intro | ページの説明 | 文字(複数行) | 500 字まで |
data.works.items | 事例 | リスト | 最大 200 件 |
data.works.items[].title | タイトル | 文字(1 行) | 必須、100 字まで |
data.works.items[].category | カテゴリ | 文字(1 行) | 40 字まで |
data.works.items[].date | 時期 | 日付 | |
data.works.items[].client | お客様・場所 | 文字(1 行) | 100 字まで |
data.works.items[].image | メイン写真 | 画像 | |
data.works.items[].image2 | 写真 2 | 画像 | |
data.works.items[].image3 | 写真 3 | 画像 | |
data.works.items[].image4 | 写真 4 | 画像 | |
data.works.items[].summary | 概要 | 文字(複数行) | 300 字まで |
data.works.items[].body | 詳しい説明 | Markdown | 10000 字まで |
data.works.items[].details | データ | 文字(複数行) | 2000 字まで |
data.works.items[].url | 関連ページの URL | URL | |
data.works.items[].featured | おすすめ(トップページなどで目立たせる) | はい / いいえ | 既定 false |
フォトギャラリー(gallery)
店内・作品・施工例・活動の様子などの写真を、左右に動かして見られるスライドで紹介します。アルバム名を付けると、アルバムごとに分けて表示します。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.gallery.intro | ページの説明 | 文字(複数行) | 500 字まで |
data.gallery.photos | 写真 | リスト | 最大 200 件 |
data.gallery.photos[].image | 写真 | 画像 | 必須 |
data.gallery.photos[].caption | 説明 | 文字(1 行) | 120 字まで |
data.gallery.photos[].album | アルバム | 文字(1 行) | 40 字まで |
資料・PDF(documents)
お知らせのチラシ・回覧板・総会資料・メニュー表・パンフレットなどの PDF を載せます。1 ページ目の縮小画像が付き、その場で開いたりダウンロードしたりできます。
| キー | 項目 | 型 | 制約 |
|---|---|---|---|
data.documents.intro | ページの説明 | 文字(複数行) | 500 字まで |
data.documents.items | 資料 | リスト | 最大 200 件 |
data.documents.items[].title | 資料の名前 | 文字(1 行) | 必須、100 字まで |
data.documents.items[].file | PDF ファイル | file | 必須 |
data.documents.items[].date | 日付 | 日付 | |
data.documents.items[].category | 分類 | 文字(1 行) | 40 字まで |
data.documents.items[].description | 説明 | 文字(複数行) | 500 字まで |
モジュールに使えない id
about、access、api、app、assets、company、contact、faq、index、legal、media、news、privacy、search、services、sitemap、terms、tokushoho、tools
テンプレートを提出するには
テンプレート代理店(制度 A)の新規受付は一時停止しています。スターターパック・開発ガイド・SDK は引き続きご利用いただけます。専用テンプレートの提出はオリジナルテンプレート制作の方法をご確認ください。
-
オリジナルテンプレート制作
特定のお客様専用のテンプレート。お客様の管理画面からアップロードし審査のあと使えるようになります。
-
ホスティング代理店
お客様の代理でホスティングを契約・運用。制作と組み合わせて一気通貫でご提供いただけます。