Title: Coyomi (コヨミ) – アーカイブカレンダー
Author: Pifto Works
Published: <strong>2026年10月20日</strong>
Last modified: 2026年10月20日

---

プラグインを検索

![](https://s.w.org/plugins/geopattern-icon/coyomi.svg)

# Coyomi (コヨミ) – アーカイブカレンダー

 作者: [Pifto Works](https://profiles.wordpress.org/piftoworks/)

[ダウンロード](https://downloads.wordpress.org/plugin/coyomi.0.3.0.zip)

 * [詳細](https://ja.wordpress.org/plugins/coyomi/#description)
 * [レビュー](https://ja.wordpress.org/plugins/coyomi/#reviews)
 * [開発](https://ja.wordpress.org/plugins/coyomi/#developers)

 [サポート](https://wordpress.org/support/plugin/coyomi/)

## 説明

多くのアーカイブカレンダーのウィジェットは、ページを表示するたびに月ごとにデータベース
へ問い合わせます。何年分も記事があるサイトでは、1ページあたり 100本ほどのクエリー
になります。

このウィジェットは、記事のある日を内容が変わったときに一度だけ集計し、`wp-content/
uploads/lwac/` の静的な JSON ファイルに書き出します。ページの表示では、そのファイル
を読むだけです。

Coyomi (暦) は、日本語で「カレンダー」という意味です。

 * クエリーは作り直し 1回につき 1本 (`SELECT DISTINCT DATE(post_date)`)、ページの
   表示では 0本です
 * 記事の公開・非公開・ゴミ箱への移動・削除・日付やカテゴリーの変更のときと、1日
   1回作り直します
 * 最初の月は HTML で描きます (JavaScript が無くても表示できます)。ほかの月はブラウザー
   で描きます
 * ページ全体のキャッシュと一緒に使えます: ブラウザーはいつも最新のデータファイル
   を取りに行きます
 * 投稿タイプとカテゴリーで絞り込めます
 * レイアウトは 5種類: 月のカレンダー・週 (1週間を横一列)・年 (12か月のタイル)・
   ドロップダウンのみ・年 / 月 / 日のツリー
 * 設定画面 (「設定  Coyomi」) にライブプレビューがあります。ウィジェットは、自分
   でレイアウトと色を選ばないかぎり、この設定に従います
 * 配色は 5種類 (カレンドリエ・パステル・クラシック・ダーク・シンプル)。どの色も
   ウィジェットごとに変えられ、保存するのは変えた色だけです
 * ほかのプラグインが `coyomi_events` フィルターで日付に予定 (セールなど) を足せ
   ます。何日も続く予定は 1行にまとめ、「開催中」か「終了」を付けます
 * 外部への通信なし: カレンダーはサイトの外のサービスと通信せず、データも集めません

### 開発者向け

予定は `coyomi_events` フィルターで足します。呼ぶのはデータを作り直すときだけ (ページ
の表示では呼びません) なので、時間のかかる処理をしてもかまいません。1日につき 1件
ずつ足します:

    ```
    add_filter( 'coyomi_events', function ( $events, $dataset ) {
        try {
            foreach ( my_plugin_sale_days() as $day ) {
                $events[] = array(
                    'date'   => $day,                    // 'YYYY-MM-DD' in the site's time zone
                    'label'  => 'Autumn sale',           // plain text, up to 60 characters
                    'url'    => get_permalink( 123 ),    // a post on this site, or ''
                    'color'  => '#bf0000',               // '#rrggbb' or '#rgb', or '' for the scheme's color
                    'source' => 'my-plugin',             // a-z, 0-9, _ and -, up to 32 characters
                );
            }
        } catch ( \Throwable $e ) {
            // Rebuilds also run on a reader's first page view and in cron. On failure, add nothing.
        }
        return $events;
    }, 10, 2 );
    ```

予定の表示のされ方:

 * `label`・`url`・`source` が同じで日が続く予定は、1行にまとめます (例: 「12/4–
   12/11」)。1つの予定では、毎日この 3つを同じにしてください。
 * `date`・`label`・`url` が同じ予定は、2つのプラグインが足しても 1回だけ表示します。
 * 一覧では、今日開かれている予定に「開催中」、終わった予定に「終了」と付けます。
   日付はブラウザーでの読者の日付を使うので、キャッシュされたページでも正しい状態
   が出ます。
 * 予定があっても、カレンダーが開く月は変わりません。読者は「前へ」「次へ」のボタン
   で予定のある月へ移ります。
 * 存在しない日付の予定と、ラベルが空の予定は捨てます。

予定を足すプラグインの決まり:

 * 足すのは、自分のプラグインが持っている予定だけにしてください。ほかのプラグイン
   から受け取った予定は渡し直さないでください。そのプラグインが自分で足せます。
 * `url` は、このサイトの投稿か固定ページにしてください。予定のリンクには `rel` 
   属性が付かないので、アフィリエイトなどの有料リンクは使わないでください。
 * `date` は、サイトのタイムゾーン (「設定  一般」) での日付です。タイムゾーン・
   パーマリンク構造・サイトアドレスが変わると、データを作り直します。

予定が変わったら、作り直しを頼みます。作り直しはリクエストの最後に 1回だけ走ります:

    ```
    do_action( 'coyomi_request_rebuild' );
    ```

プラグインを無効化するときは、作り直しを頼む前にフィルターを外してください。外さ
ないと、同じリクエストの最後に走る作り直しで予定がまた加わります。

データファイルの URL は、アップロードの URL ではなくサイトの URL から作るので、メディア
を別のドメインや CDN から配信していても動きます。それでも別の URL が必要な構成では、
次のようにします:

    ```
    add_filter( 'coyomi_data_url', function ( $url, $key, $path ) {
        return $url; // must be readable from the page (same origin, or CORS allowed)
    }, 10, 3 );<h3>WP-CLI</h3>
    ```

* `wp coyomi status` – データファイルと最後に作り直した日時
 * `wp coyomi rebuild`–
すべてのデータファイルを作り直す * `wp coyomi compare lwac_calendar-2` – 旧来の月
ごとのクエリーを一度だけ流し、記事のある日を突き合わせる

## 評価

このプラグインにはレビューがありません。

## 貢献者と開発者

Coyomi (コヨミ) – アーカイブカレンダー はオープンソースソフトウェアです。以下の人々
がこのプラグインに貢献しています。

貢献者

 *   [ Pifto Works ](https://profiles.wordpress.org/piftoworks/)

“Coyomi (コヨミ) – アーカイブカレンダー” は1ロケールに翻訳されています。 [翻訳者](https://translate.wordpress.org/projects/wp-plugins/coyomi/contributors)
のみなさん、翻訳へのご協力ありがとうございます。

[“Coyomi (コヨミ) – アーカイブカレンダー” をあなたの言語に翻訳しましょう。](https://translate.wordpress.org/projects/wp-plugins/coyomi)

### 開発に興味がありますか ?

[コードを閲覧](https://plugins.trac.wordpress.org/browser/coyomi/)するか、[SVN リポジトリ](https://plugins.svn.wordpress.org/coyomi/)
をチェックするか、[開発ログ](https://plugins.trac.wordpress.org/log/coyomi/)を [RSS](https://plugins.trac.wordpress.org/log/coyomi/?limit=100&mode=stop_on_copy&format=rss)
で購読してみてください。

## 変更履歴

#### 0.3.0

 * 何日も続く予定を 1行にまとめるようにしました (例: 「12/4–12/11」)。表示中の月
   の外の日も含みます。
 * 予定の一覧に「開催中」「終了」を付けるようにしました。状態は読者の日付に従うので、
   キャッシュされたページでも正しく出ます。
 * まったく同じ予定 (日付・ラベル・URL が同じ) は、2つのプラグインが足しても 1回
   だけ表示するようにしました。
 * 予定によって、カレンダーが開く月や週が変わらないようにしました。記事のある最新
   の月で開きます。
 * 週のレイアウトで、メニューから月を選ぶと、その月の最新の記事がある週が開くよう
   にしました。
 * 年のタイルの印を、1日ごとではなく 1つの予定につき 1つにしました。
 * パーマリンク構造・サイトアドレス・タイムゾーンが変わると、データを作り直すよう
   にしました。
 * 予定を足すプラグインがデータの作り直しの途中で失敗しても、記事のある日は残るよう
   にしました。
 * 訳は translate.wordpress.org の言語パックで配るようにしました。

#### 0.2.1

 * 修正: 従来のウィジェットで、カスタマイザーでカレンダーを変えると「エラーが発生
   しました」と出て、「公開」ボタンが押せないままになっていました。
 * 修正: 週のレイアウトで、1日の月の名前が曜日と重なっていました。

#### 0.2.0

 * Coyomi に改名しました。以前の版の設定・ウィジェット・データは、そのまま引き継ぎ
   ます。
 * フックと WP-CLI も新しい名前になりました: coyomi_events・coyomi_request_rebuild・
   coyomi_data_url・wp coyomi。

#### 0.1.4

 * Archives Calendar Widget からの移行 (設定画面のパネルと WP-CLI のコマンド) を
   削除しました。移行で作ったカレンダーは、そのまま動きます。

#### 0.1.3

 * 色の欄に、空の見本ではなくいまの色を出し、カラーピッカーもその色で開くようにしま
   した。
 * 説明文で、ボタンの名前に合わせて「デフォルト」のボタンと書くようにしました。

#### 0.1.2

 * 修正: シンプルの配色で、罫線と枠が出ていませんでした。
 * 修正: 年のレイアウトで、今月のタイルの文字が消えることがありました。シンプルでは、
   記事のある日でも今日を赤で示すようにしました。
 * 「カスタマイザーで編集」で、それぞれのカレンダーを置いた場所が開くようにしました。
 * 設定画面の色のパネルを、いつも開いておくようにしました。

#### 0.1.1

 * 設定画面 (「設定  Coyomi」) を追加しました。ライブプレビュー・設置場所の一覧・
   旧プラグインからの移行・データの状態があります。
 * ウィジェットごとに決めていなければ、サイト全体のレイアウト・色・nofollow に従う
   ようにしました。
 * データファイルの URL をサイトの URL から作るようにしました。アップロードを別の
   ドメインから配信していても動きます。
 * 修正: 設定画面で、レイアウトと配色のボタンが重なっていました。
 * CSS と JS の URL がファイルを変えるたびに変わるので、CDN が古いものを配り続け
   なくなりました。

#### 0.1.0

 * 最初の版です。

## メタ

 *  バージョン **0.3.0**
 *  最終更新日 **18時間前**
 *  有効インストール数 **10未満**
 *  WordPress バージョン ** 5.5またはそれ以降 **
 *  検証済み最新バージョン: **7.1.3**
 *  PHP バージョン ** 7.4またはそれ以降 **
 *  言語
 * [English (US)](https://wordpress.org/plugins/coyomi/)、[Japanese](https://ja.wordpress.org/plugins/coyomi/).
 *  [プラグインを翻訳](https://translate.wordpress.org/projects/wp-plugins/coyomi)
 * タグ
 * [archives](https://ja.wordpress.org/plugins/tags/archives/)[calendar](https://ja.wordpress.org/plugins/tags/calendar/)
   [performance](https://ja.wordpress.org/plugins/tags/performance/)[widget](https://ja.wordpress.org/plugins/tags/widget/)
 *  [詳細を表示](https://ja.wordpress.org/plugins/coyomi/advanced/)

## 評価

レビューはまだ送信されていません。

[Your review](https://wordpress.org/support/plugin/coyomi/reviews/#new-post)

[すべてのレビューを見る](https://wordpress.org/support/plugin/coyomi/reviews/)

## 貢献者

 *   [ Pifto Works ](https://profiles.wordpress.org/piftoworks/)

## サポート

意見や質問がありますか ?

 [サポートフォーラムを表示](https://wordpress.org/support/plugin/coyomi/)