---
title: テンプレートタグ リファレンス - ContentDataSortOrder
description: ContentDataSortOrder のテンプレートタグ リファレンス。SortedContents / SortedEntries / SortedPages の使い方、モディファイア、テンプレートへの実装例を掲載。
image: https://12grid.co.jp/hs-fs/hubfs/cdso-png.png?width=1040&height=600&name=cdso-png.png
---

[ContentDataSortOrder](https://12grid.co.jp/products/content-data-sort-order/?hsLang=ja-jp) [← 製品ページに戻る](https://12grid.co.jp/products/content-data-sort-order/?hsLang=ja-jp)

# テンプレートタグ リファレンス

ContentDataSortOrder v1.0

ContentDataSortOrder が提供するテンプレートタグの一覧と使い方です。  
サンプルコードはコピーしてそのままご利用いただけます。

## 目次

- [`mt:SortedEntries`](https://12grid.co.jp/products/content-data-sort-order/reference/#sorted-entries) — 記事をカスタム順に出力
- [`mt:SortedPages`](https://12grid.co.jp/products/content-data-sort-order/reference/#sorted-pages) — ウェブページをカスタム順に出力
- [`mt:SortedContents`](https://12grid.co.jp/products/content-data-sort-order/reference/#sorted-contents) — コンテンツデータをカスタム順に出力
- [`mt:CdsoSortOrder`](https://12grid.co.jp/products/content-data-sort-order/reference/#cdso-sort-order) — ページネーションプラグイン連携用
- [共通属性一覧](https://12grid.co.jp/products/content-data-sort-order/reference/#attributes)
- [固定記事（ピン留め）の使い方](https://12grid.co.jp/products/content-data-sort-order/reference/#pin)
- [実践サンプル集](https://12grid.co.jp/products/content-data-sort-order/reference/#examples)

## <mt:SortedEntries>

記事をカスタム順（並べ替え画面で設定した順序）で出力します。並べ替え未設定の記事はMT標準のソート順（公開日の降順）で末尾に追加されます。

### 基本的な使い方

MTML <ul> <mt:SortedEntries> <li> <a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a> <span><$mt:EntryDate format="%Y/%m/%d"$></span> </li> </mt:SortedEntries> </ul>

### 件数を制限して出力

MTML <!-- 上位5件のみ --> <mt:SortedEntries limit="5"> <h3><$mt:EntryTitle$></h3> </mt:SortedEntries>

### 並べ替え済みの記事のみ出力

MTML <!-- 並べ替え画面で順序を設定した記事だけを出力 --> <mt:SortedEntries include_unordered="0"> <$mt:EntryTitle$> </mt:SortedEntries>

**出力対象:** 公開済みの記事のみが出力されます。下書き・予約投稿・公開終了の記事は出力されません。

## <mt:SortedPages>

ウェブページをカスタム順で出力します。フォルダ階層に関わらず、並べ替え画面で設定した順序で出力されます。

### 基本的な使い方

MTML <ul> <mt:SortedPages> <li> <a href="<$mt:PagePermalink$>"><$mt:PageTitle$></a> <mt:PageFolder> <span>フォルダ: <$mt:FolderLabel$></span> </mt:PageFolder> </li> </mt:SortedPages> </ul>

### ナビゲーションメニューとして使う

MTML <nav> <ul> <mt:SortedPages> <li><a href="<$mt:PagePermalink$>"><$mt:PageTitle$></a></li> </mt:SortedPages> </ul> </nav>

## <mt:SortedContents>

コンテンツデータをカスタム順で出力します。`content_type` 属性でコンテンツタイプ名を指定する必要があります。

### 基本的な使い方

MTML <!-- content_type にはコンテンツタイプ名を指定します --> <ul> <mt:SortedContents content_type="お知らせ"> <li> <a href="<$mt:ContentPermalink$>"><$mt:ContentLabel$></a> <span><$mt:ContentModifiedDate format="%Y/%m/%d"$></span> </li> </mt:SortedContents> </ul>

### 件数制限 + オフセット

MTML <!-- 4件目から3件取得（ページネーション用途など） --> <mt:SortedContents content_type="お知らせ" limit="3" offset="3"> <$mt:ContentLabel$> </mt:SortedContents>

### コンテンツフィールドを出力

MTML <mt:SortedContents content_type="お知らせ"> <article> <h2><$mt:ContentLabel$></h2> <mt:ContentFields> <mt:ContentField> <div class="field"> <h3><$mt:ContentFieldLabel$></h3> <div><$mt:ContentFieldValue$></div> </div> </mt:ContentField> </mt:ContentFields> </article> </mt:SortedContents>

**content_type の指定:** MT管理画面 → コンテンツタイプ → 一覧 で表示されるコンテンツタイプ名をそのまま指定してください。

## <mt:CdsoSortOrder>

PageBute などのページネーションプラグインと併用するためのラッパータグです。内部の `<mt:Entries>` や `<mt:Pages>` にカスタムソート順を注入します。

### 記事のページネーション

MTML <mt:CdsoSortOrder type="entry"> <mt:Entries limit="10" offset="0"> <h3><a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a></h3> </mt:Entries> </mt:CdsoSortOrder>

### ウェブページ

MTML <mt:CdsoSortOrder type="page"> <mt:Pages> <$mt:PageTitle$> </mt:Pages> </mt:CdsoSortOrder>

### コンテンツデータ

MTML <mt:CdsoSortOrder type="content_data" content_type="お知らせ"> <mt:Contents content_type="お知らせ"> <$mt:ContentLabel$> </mt:Contents> </mt:CdsoSortOrder>

| 属性 | 説明 | デフォルト |
| --- | --- | --- |
| `type` | オブジェクトタイプ（`entry` / `page` / `content_data`） | `entry` |
| `blog_id` | ブログID | 自動取得 |
| `content_type` | コンテンツタイプ名（type="content_data" 時に必須） | — |

## 共通属性一覧

`mt:SortedEntries`、`mt:SortedPages`、`mt:SortedContents` で共通して使用できる属性です。

| 属性 | 説明 | デフォルト |
| --- | --- | --- |
| `blog_id` | ブログID。省略時はコンテキストから自動取得 | 自動 |
| `content_type` | コンテンツタイプ名（SortedContents のみ必須、例: `"お知らせ"`） | — |
| `lastn` / `limit` | 出力件数の上限 | 全件 |
| `offset` | 先頭からスキップする件数 | 0 |
| `include_unordered` | 並べ替え未設定のアイテムも出力するか（0 / 1） | 1（出力する） |
| `default_sort` | カスタムソートを無効にしてMT標準順で出力（0 / 1） | 0（カスタム順） |
| `exclude_private_tag` | 指定したプライベートタグを持つ記事/ウェブページを除外 | — |
| `exclude_tag_field` | コンテンツデータのタグフィールド名（exclude_tag と併用） | — |
| `exclude_tag` | 指定したタグを持つコンテンツデータを除外 | — |
| `glue` | アイテム間に挿入する文字列 | — |

### ループ変数

ループ内で以下の変数が使用できます。

| 変数 | 説明 |
| --- | --- |
| `__first__` | ループの最初のアイテムの場合 true |
| `__last__` | ループの最後のアイテムの場合 true |
| `__odd__` | 奇数番目のアイテムの場合 true |
| `__even__` | 偶数番目のアイテムの場合 true |
| `__counter__` | ループカウンター（1始まり） |

## 固定記事（ピン留め）の使い方

特定の記事を常にリストの先頭に固定表示したい場合（災害情報、重要なお知らせなど）、プライベートタグを使って並べ替え対象から除外できます。

### 手順

1. 固定したい記事のタグ欄に `@pin` を追加（`@` で始まるタグはMTのプライベートタグです）

2. テンプレートで固定記事とソート済み記事を分けて出力

### 記事の場合

MTML <!-- 固定記事（@pin タグ付き）を先に出力 --> <mt:Entries tag="@pin" include_private="1"> <div class="pinned"> <span class="badge">重要</span> <a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a> </div> </mt:Entries> <!-- 通常の記事（@pin を除外してカスタム順で出力） --> <mt:SortedEntries exclude_private_tag="@pin"> <div> <a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a> </div> </mt:SortedEntries>

### ウェブページの場合

MTML <mt:Pages tag="@pin" include_private="1"> <div class="pinned"><$mt:PageTitle$></div> </mt:Pages> <mt:SortedPages exclude_private_tag="@pin"> <div><$mt:PageTitle$></div> </mt:SortedPages>

### コンテンツデータの場合

MTML <!-- タグフィールド名が「タグ」の場合 --> <mt:SortedContents content_type="お知らせ" exclude_tag_field="タグ" exclude_tag="@pin"> <$mt:ContentLabel$> </mt:SortedContents>

**タグ名は自由:** `@pin` 以外のプライベートタグ名でも使用できます（例: `@important`、`@featured`）。

## 実践サンプル集

よくあるユースケースのサンプルコードです。コピーしてそのままお使いいただけます。

### お知らせ一覧（トップページ用）

MTML <section class="news"> <h2>お知らせ</h2> <ul> <mt:SortedEntries limit="5"> <li> <time><$mt:EntryDate format="%Y.%m.%d"$></time> <a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a> </li> </mt:SortedEntries> </ul> </section>

### グローバルナビゲーション

MTML <nav class="global-nav"> <ul> <mt:SortedPages> <li> <a href="<$mt:PagePermalink$>" <mt:If tag="PageID" eq="<$mt:PageID$>"> class="current"</mt:If> ><$mt:PageTitle$></a> </li> </mt:SortedPages> </ul> </nav>

### コンテンツデータのカード一覧

MTML <div class="card-grid"> <mt:SortedContents content_type="お知らせ"> <div class="card"> <h3><a href="<$mt:ContentPermalink$>"><$mt:ContentLabel$></a></h3> <time><$mt:ContentModifiedDate format="%Y/%m/%d"$></time> </div> </mt:SortedContents> </div>

### 区切り文字付きの出力

MTML <!-- カンマ区切りでタイトルを出力 --> <mt:SortedEntries glue=", "> <$mt:EntryTitle$> </mt:SortedEntries>

### カスタムソートを一時的に無効化

MTML <!-- MT標準のソート順（公開日の降順）で出力 --> <mt:SortedEntries default_sort="1"> <$mt:EntryTitle$> (<$mt:EntryDate format="%Y/%m/%d"$>) </mt:SortedEntries>

### 記事詳細ページで他の記事一覧を表示

**テンプレートの種類について:** SortedEntries / SortedPages / SortedContents はインデックステンプレート、アーカイブテンプレート、ウィジェットなど、すべてのテンプレートタイプで使用できます。記事詳細テンプレート内で使用した場合、現在表示中の記事も出力に含まれます。

MTML <!-- 記事詳細テンプレート内で、カスタム順の記事一覧を表示 --> <aside> <h3>記事一覧</h3> <ul> <mt:SortedEntries limit="5"> <li><a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a></li> </mt:SortedEntries> </ul> </aside>

 最終更新日: 2026年4月14日

© 2026 [12Grid Inc.](https://12grid.co.jp?hsLang=ja-jp) — ContentDataSortOrder  |  [製品ページ](https://12grid.co.jp/products/content-data-sort-order/?hsLang=ja-jp)  |  [利用規約](https://12grid.co.jp/products/content-data-sort-order/terms?hsLang=ja-jp)