MediaWiki:Common.js

提供:百科事典.com
2026年2月20日 (金) 10:38時点におけるAdmin (トーク | 投稿記録)による版 (MediaWiki:Common.js に追加するコード(日本語コメント付き・完全動作版)002)
ナビゲーションに移動検索に移動

注意: 保存後、変更を確認するにはブラウザーのキャッシュを消去する必要がある場合があります。

  • Firefox / Safari: Shift を押しながら 再読み込み をクリックするか、Ctrl-F5 または Ctrl-R を押してください (Mac では ⌘-R)
  • Google Chrome: Ctrl-Shift-R を押してください (Mac では ⌘-Shift-R)
  • Internet Explorer / Microsoft Edge: Ctrl を押しながら 最新の情報に更新 をクリックするか、Ctrl-F5 を押してください
  • Opera: Ctrl-F5を押してください
/* ここにあるすべてのJavaScriptは、すべてのページ読み込みですべての利用者に対して読み込まれます */


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

$(function () {

    // ▼ メインページ名の判定(日本語版と英語版の両方に対応)
    const page = mw.config.get('wgPageName');
    if (page !== 'Main_Page' && page !== 'メインページ') {
        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 => {

            // ▼ old_revid が null(新規作成)の場合は差分リンクを作らない
            let diffLink = '';
            if (rc.old_revid && rc.revid) {
                const diffUrl = mw.util.getUrl(rc.title, {
                    diff: rc.revid,
                    oldid: rc.old_revid
                });
                diffLink = `<a href="${diffUrl}">差分</a>`;
            } else {
                diffLink = '(新規)';
            }

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

        html += '</ul>';

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

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