模板:Update monitor
| 以下顯示項目為範例,可以調整,請見下方模板說明。 |
| 此{{Update monitor}}模板最後於3個月前編輯。(更新快取) 除非設定時間,否則本框恆為藍色。 |
| {{Update monitor}}模組最後於2個月前編輯。(更新快取) 除非設定時間,否則本框恆為藍色。 |
| Template:update monitor/doc模板最後於2個月前編輯。(更新快取) 除非設定時間,否則本框恆為藍色。 |
| Module:update monitor/doc模組最後於2個月前編輯。(更新快取) 除非設定時間,否則本框恆為藍色。 |
| 此模板已評為穩定版,其已臻成熟,可正常使用於各處而不會出現錯誤。已可在幫助頁面和其他維基百科資源中提及,以幫助新用戶學習。為降低服務器負載和錯誤輸出,改善本模板前應進行沙盒測試,而不是重複的試錯性編輯。 |
| 此模板使用Lua語言: |
致幽默維基人:請查看下方隱藏說明。
介紹
[編輯]{{Update monitor}}是一個用於顯示頁面最後更新時間的模板。它會根據距離最後一次編輯的時間長短,自動切換提示框的顏色與圖標(藍、綠、黃、紅)。
機制/原理
[編輯]本模板透過MediaWiki內建的1794169961函數,計算當前時間與該頁面的最後修訂時間戳記(20260716134551)之間的秒數差,並與自訂或預設的時間閾值進行比較,從而動態改變外層{{ombox}}的樣式框顏色與圖標。
用法
[編輯]直接將以下代碼插入至需要監視更新的頁面頂部:
{{Update monitor}}
參數
[編輯]所有參數均為選填:
{{Update monitor
| 1 = <!-- 目標頁面名稱(選填,預設為當前頁面) -->
| green = <!-- 正常狀態時間 -->
| yellow = <!-- 警告狀態時間 -->
| red = <!-- 過期狀態時間 -->
| tittle = <!-- 附加於首行後方的自訂文字 -->
| text = <!-- 自訂次行說明小字,會直接覆蓋自動生成的文字 -->
| tl = <!-- 是否套用 tl 模板樣式連結(yes/no) -->
| this = <!-- 指定 purge 重新整理的目標頁面 -->
| small = <!-- 是否顯示為右側迷你框(yes/no) -->
| badcat = <!-- 警告或過期狀態時自動加入的分類 -->
| cat = <!-- 永久自動加入的分類 -->
| demo = <!-- 測試用:模擬最後編輯距今時間(如 5 hour) -->
}}
注意事項
[編輯]- 輸入自訂時間單位時必須使用英文單位(如
min、minute、hour、hours、day、days)。 - 由於維基百科的頁面快取機制,提示框的顏色與倒數說明可能不會即時更新,可以點擊提示框右側的(更新快取)連結來重新整理伺服器快取。
技術細節
[編輯]- 本模板基於標準的{{ombox}}進行樣式與衍生開發。
- 內部時間核心採用倒序判斷(紅➔黃➔綠➔藍),當特定顏色參數被設定為
disable或none時,系統會將其過期閾值設為遙遠的未來(9999999999),使其永遠無法觸發,從而達到忽略該階段的效果。
參數說明
[編輯]| 參數 | 說明 | 預設值 | 備註 |
|---|---|---|---|
| 1 或 target | 要監控的目標頁面名稱。 | 當前頁面名稱({{subst:FULLPAGENAME}}) | |
| green | 變為綠色狀態的時間。若低於此時間,框體顯示為藍色。 | 1hour | 支援單位包括:min(分鐘)、hour(小時)、day(天)等。
|
| yellow | 變為黃色狀態的時間。若低於此時間,框體顯示為綠色。 | 8hour | 同上。 |
| red | 變為紅色狀態時間。若低於此時間,框體顯示為黃色。 | 24hour | 同上。可設為none或disable以停用紅色狀態。
|
| tittle | 附加在第一行主要文字後方的自訂文字。 | (無) | 輸入後會以逗號,與前文串接。
|
| text | 自訂第二行的說明小字。 | (依時間自動生成) | 若填寫此參數,將會覆蓋原說明。 |
| tl | 當設定為yes時,目標頁面的連結將會呈現{{[[Template:{{{1}}}|{{{1}}}]]}}模板樣式。
|
no | 僅在填入1 或 target時生效。 |
| this | 顯示此字;用於指定(更新快取)連結所重新整理(purge)的目標頁面。
|
(當前頁面) | |
| small | 當設定為yes時,提示框將縮小為右側迷你框,適用於條目或排版空間受限處。
|
no | |
| badcat 或badcategory |
當頁面處於黃色或紅色狀態時,自動為頁面加入的分類。 | (無) | 僅在條目、專案、模板、分類及主題命名空間生效。 |
| cat 或category |
頁面會加入的分類。 | (無) | 限制空間同上。 |
| demo | 模擬參數,用於測試。 | (無) | 傳入如5 hours、2 days可模擬該頁面在該時間前已被編輯。
|
範例
[編輯]基礎
[編輯]監控{{Template:Itn}}更新狀態,黃色8小時,紅色24小時:
{{Update monitor|Template:Itn|green=0min|yellow=8hour|red=24hour}}
{{Update monitor|Template:Itn
| green = 0min
| yellow = 8hour
| red = 24hour
| tl = yes
| tittle = 請儘速更新
| text = 這裡放置自訂的小字說明文字,覆蓋預設說明。
}}
精簡模式
[編輯]{{Update monitor|Template:Itn|green=0min|yellow=8hour|red=24hour|small=yes}}
模式
[編輯]| Template:Itn模板剛剛更新。(更新快取) 更新後本框顯示為藍色;超過10分鐘本框會變成綠色;超過8小時本框會變成黃色;超過24小時本框則會變成紅色。 |
| Template:Itn模板最後於2分鐘前編輯。(更新快取) 更新後本框顯示為藍色;超過10分鐘本框會變成綠色;超過8小時本框會變成黃色;超過24小時本框則會變成紅色。 |
| Template:Itn模板最後於30分鐘前編輯。(更新快取) 更新後本框顯示為藍色;超過10分鐘本框會變成綠色;超過8小時本框會變成黃色;超過24小時本框則會變成紅色。 |
| Template:Itn模板最後於13小時前編輯。(更新快取) 更新後本框顯示為藍色;超過10分鐘本框會變成綠色;超過8小時本框會變成黃色;超過24小時本框則會變成紅色。 |
| Template:Itn模板最後於26小時前編輯。(更新快取) 更新後本框顯示為藍色;超過10分鐘本框會變成綠色;超過8小時本框會變成黃色;超過24小時本框則會變成紅色。 |
模板數據
[編輯]一個用於顯示頁面最後更新時間的模板。它會根據距離最後一次編輯的時間長短,自動切換提示框的顏色與圖標(藍、綠、黃、紅)。
| 參數 | 描述 | 類型 | 狀態 | |
|---|---|---|---|---|
| 目標頁面 | target 1 | 監視對象的完整頁面名稱。若留空,則使用當前頁面。 | 頁面名稱 | 建議 |
| 綠色觸發時間 | green | 藍色提示框維持的時間。超過此時間後會變為綠色提示框。支援sec(秒)、min(分鐘)、hour(小時)、day(天)、week(週)、month(個月)、year(年)。填入disable或none則忽略此階段。
| 字串 | 非必填 |
| 黃色觸發時間 | yellow | 綠色提示框維持的時間。超過此時間後會變為黃色提示框。支援英文時間單位(如hours, months)。填入disable或none則忽略此階段。
| 字串 | 非必填 |
| 紅色觸發時間 | red | 黃色提示框維持的時間。超過此時間後會變為紅色警告框。支援英文時間單位(如days, years)。填入disable或none則忽略此階段。
| 字串 | 非必填 |
| 自訂標題附加文字 | tittle | 附加在第一行主要文字後方的自訂文字。輸入後會以逗號「,」與前文串接。 | 字串 | 非必填 |
| 自訂說明小字 | text | 自訂第二行的說明小字。若填寫此參數,將會完全覆蓋模組自動生成的變色時間說明。 | 字串 | 非必填 |
| 套用 tl 樣式 | tl | 當設定為yes時,目標頁面的連結將會呈現tl模板樣式。
| 布林值 | 非必填 |
| 目標為放置模板的頁面 | this | 填入yes時,會在提示主文字前加上「此」字(例如:「此模板...」、「此條目...」)。
| 布林值 | 非必填 |
| 精簡模式 | small | 當設定為yes時,提示框將縮小為右側精簡模式,適用於條目或排版空間受限處。
| 布林值 | 非必填 |
| 超時分類 | badcategory badcat | 當頁面處於黃色或紅色狀態時,自動為頁面加入的分類。 | 字串 | 非必填 |
| 分類 | category cat | 頁面會加入的分類。 | 字串 | 非必填 |
| 範例模式(模擬時間) | demo | 用於測試或在沙盒展示範例。傳入一段相對時間(如10hours或2days),系統將模擬該頁面最後編輯於該時間之前。
| 字串 | 非必填 |
| 幽默模式 | funny | 僅在幽默頁面加入。
| 布林值 | 非必填 |
| 目標對象為使用者討論頁 | user | 當模板用於舊版討論頁時的參數。
| 布林值 | 不建議使用 |
參見
[編輯]- {{Module:Update monitor}}
- {{Time ago}}
- {{Purge}}