Misplaced Pages

Template:Purge

Article snapshot taken from Wikipedia with creative commons attribution-sharealike license. Give it a read and then ask your questions in the chat. We can research this topic together.

This is an old revision of this page, as edited by WOSlinker (talk | contribs) at 18:54, 1 October 2010 (remove {{pp-template}}). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

Revision as of 18:54, 1 October 2010 by WOSlinker (talk | contribs) (remove {{pp-template}})(diff) ← Previous revision | Latest revision (diff) | Newer revision → (diff)

Purge

Template documentation[view] [edit] [history] [purge]
WarningThis template is used in system messages, and on approximately 448,000 pages, or roughly 1% of all pages.
Changes to it can cause immediate changes to the Misplaced Pages user interface.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Please discuss 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}} Purge Creates a purge link for the page it is used on.
{{Purge|Purge this page's server cache.}} 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}} Purge Creates a purge link for Main Page.
{{Purge|Purge this page's server cache.|page=Main Page}} Purge this page's server cache. Creates a purge link for Main Page, but with the text "Purge this page's server cache."
{{Purge|anchor=TemplateData}} Purge 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

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Purge in articles based on its TemplateData.

TemplateData for Purge

A template that produces a link that will clear the cache and rebuild page from the wikitext

Template parameters

ParameterDescriptionTypeStatus
Label1

The label of the purge link

Default
Purge
Stringoptional
Pagepage

The page to purge

Page nameoptional
Anchoranchor

An anchor to jump to after the page is purged

Lineoptional
Purge Pages
General purge templates
About Purge on Misplaced Pages
The above documentation is transcluded from Template:Purge/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template. Categories: