「MediaWiki:Common.js」の版間の差分

2026年2月20日 (金) 10:25時点における版

/* ここにあるすべてのJavaScriptは、すべてのページ読み込みですべての利用者に対して読み込まれます */



/* ============================================================
   メインページに「最近の更新（7件）」を表示するスクリプト
   - タイトル＋差分リンク付き
   - localStorage による5分キャッシュ
   - API の maxage/smaxage による HTTP キャッシュ
   - MediaWiki 1.39.3 で動作確認済み
   ============================================================ */

$(function () {

    // ▼ メインページ以外では実行しない（重要）
    if (mw.config.get('wgPageName') !== 'Main_Page' &&
        mw.config.get('wgPageName') !== 'メインページ') {
        return;
    }

    // ▼ localStorage 用のキー
    const key = 'recentchanges-cache';
    const keyTime = key + '-time';

    // ▼ キャッシュの有効期限（ミリ秒）→ 5分
    const ttl = 5 * 60 * 1000;
    const now = Date.now();

    // ▼ localStorage にキャッシュがあれば利用
    const cached = localStorage.getItem(key);
    const cachedTime = localStorage.getItem(keyTime);

    if (cached && cachedTime && now - cachedTime < ttl) {
        $('#recentchanges-container').html(cached);
        return; // API を叩かず終了
    }

    // ▼ MediaWiki API を呼び出して最近の更新を取得
    $.getJSON(mw.util.wikiScript('api'), {
        action: 'query',
        list: 'recentchanges',
        rclimit: 7,                     // 取得件数
        rcprop: 'title|timestamp|ids',  // タイトル・時刻・差分ID
        rcshow: '!bot',                 // Bot 編集を除外（不要なら削除）
        format: 'json',

        // ▼ HTTP キャッシュ（ブラウザ・CDN）
        maxage: 300,   // ブラウザキャッシュ 5分
        smaxage: 300   // CDNキャッシュ 5分
    }, function (data) {

        let html = '<ul>';

        data.query.recentchanges.forEach(rc => {

            // ▼ 差分リンクの生成
            const diffUrl = mw.util.getUrl(rc.title, {
                diff: rc.revid,
                oldid: rc.old_revid
            });

            // ▼ リスト項目の HTML
            html += `
                <li>
                    <a href="/wiki/${rc.title}">${rc.title}</a>
                    &nbsp;
                    <a href="${diffUrl}">差分</a>
                    &nbsp;
                    (${rc.timestamp})
                </li>
            `;
        });

        html += '</ul>';

        // ▼ localStorage にキャッシュ保存
        localStorage.setItem(key, html);
        localStorage.setItem(keyTime, now);

        // ▼ メインページに表示
        $('#recentchanges-container').html(html);
    });
});