コンテンツ情報の置換

以下の箇所で、テキスト内に対象コンテンツの情報を取り込むためのプレースホルダー記法が使用できます。

• モデル: プレビューURL・公開URL
• Webhook: ペイロード
• FTスキーマ: コンテンツ参照要素
• FTスキーマ: コンテンツリンク要素

コンテンツ自身の情報

フィールドに入力した内容

メディアの情報

参照コンテンツの情報

言語

利用例

「FTスキーマ: コンテンツ参照要素」の例

この例では、以下のような置換処理を行います。

• リンク先URL: slug フィールド（1行テキストフィールド）の値
• タイトル: meta フィールド（フィールドセット）内の title フィールド（1行テキスト）の値
• カテゴリー名: category フィールド（コンテンツ参照）に設定されたコンテンツの name フィールド（1行テキスト） の値
• サムネイル画像: image フィールド（メディアフィールド）に設定されたメディア

<a class="card-link" href="/ja/help/usage/{{content.slug}}">
	<h4 class="title">{{content.meta.title}}</h4>
	<p class="category-name">{{content.category.name}}</p>
	<img class="thumbnail" src="{{content.thumbnail.url}}">
</a>

以下のような置換結果になります。

<a class="card-link" href="/ja/help/usage/etc-placeholder-notation">
	<h4 class="title">プレースホルダー記法</h4>
	<p class="category-name">その他</p>
	<img class="thumbnail" src="https://cms-assets.nilto.com/spaces/668473005/media/2120092731/_/mcp-setup-claude-01.webp">
</a>

「Webhook: GitHub Actions(repository_dispatch を使用)」の例

{
  "event_type": "nilto_update",
  "client_payload": {
    "content_id": {{content._id}},
    "model": "{{content._model}}",
    "space": "{{content._space}}",
    "status": "{{content._status}}",
    "title": "{{content._title}}",
    "lang": "{{lang}}",
    "skip_ci": {{content.skip_ci}},
    "category": "{{content.category.slug}}"
  }
}

以下のような置換結果になります。

{
  "event_type": "nilto_update",
  "client_payload": {
    "content_id": 1234567890,
    "model": "articles",
    "space": "production",
    "status": "published",
    "title": "プレースホルダー記法",
    "lang": "ja",
    "skip_ci": false,
    "category": "etc"
  }
}

GitHub Actions側での利用イメージ (.github/workflows/main.yml) は以下です。

jobs:
  build:
    # 本番用スペース （LUID: 'production'） かつ 'skip_ci' フィールドが false の場合のみビルドを実行する例
    if: github.event.client_payload.space == 'production' && github.event.client_payload.skip_ci == false
    runs-on: ubuntu-latest
    steps:
      - name: Log Category
        run: echo "Building category: ${{ github.event.client_payload.category }}"
      - name: Build and Deploy
        run: npm run build

「Webhook: Slack通知用Payload」の例

{
  "blocks": [
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*モデル:*\n{{content._model._name}}"
        },
        {
          "type": "mrkdwn",
          "text": "*ID:*\n`{{content._id}}`"
        }
      ]
    },
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*タイトル:*\n{{content._title}}"
      }
    }
  ]
}

「プレビューURL・公開URL」の例

https://www.nilto.com/{{lang}}/help/usage/{{content.slug}}

メディア情報の置換

以下の箇所で、テキスト内に対象メディアの情報を取り込むためのプレースホルダー記法が使用できます。

• FTスキーマ: 内部画像要素
• FTスキーマ: メディアリンク要素

メディアの情報

利用例

FTスキーマ: 内部画像要素

<img src="{{media.url}}?width=200&height=200" alt="{{media.alt}}" />