Difference between revisions of "Template:Purge"
en>Jo-Jo Eumerus m (Changed protection level for "Template:Purge": Allowing template editors on some templates with full protection dating back to pre-TPROT times which aren't too often or too sensitively used. ([Edit=Require template editor access] (inde...) |
(No difference)
|
Revision as of 13:38, 25 March 2017
This template is used on 110,000+ pages. To avoid large-scale disruption and unnecessary server load, any changes to it should first be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can then be added to this page in a single edit. Please consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
{{Purge}}
produces a link that will purge the page's cache and rebuild it from the wikitext.
Purpose
For efficiency in service, MediaWiki caches pages. Depending on the exact sequence of actions editors follow, one may view an out-of-date version of a given page. This happens most often on heavily-edited pages and on pages which contain an instance of transclusion.
{{Purge}}
adds to any page a link that, when clicked, not only reloads the page, but clears the server cache, forcing the page to be completely rendered "from scratch". This is not a one-time solution; generally, editing a page is itself sufficient to purge cache. Rather, it is a measure taken in anticipation of the frequent need to purge.
Examples
Code | Yields | Result |
---|---|---|
{{Purge}}
|
Creates a purge link for the page it is used on. | |
{{Purge|Purge this page's server cache.}}
|
Creates a purge link for the page it is used on, but with the text "Purge this page's server cache." | |
{{Purge|page=Main Page}}
|
Creates a purge link for Main Page. | |
{{Purge|Purge this page's server cache.|page=Main Page}}
|
Creates a purge link for Main Page, but with the text "Purge this page's server cache." | |
{{Purge|anchor=TemplateData}}
|
Creates a purge link for the page it is used on, which points to the "TemplateData" section. |
When you are linking to a section, purging that page will cause you to lose the section link.
TemplateData
TemplateData for Purge
A template that produces a link that will clear the cache and rebuild page from the wikitext
Parameter | Description | Type | Status | |
---|---|---|---|---|
Label | 1 | The label of the purge link
| String | optional |
Page | page | The page to purge | Page | optional |
Anchor | anchor | An anchor to jump to after the page is purged | Line | optional |
The above documentation is transcluded from Template:Purge/doc. (edit | history) Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Please add categories to the /doc subpage. Subpages of this template. |