View source for User:Ahecht/Scripts/refresh

__NOTOC__
{{Infobox user script
 | name = User:Ahecht/Scripts/refresh
 | desc = 
 | author = [[:en:User:Ahecht]], based on code by [[:he:User:IKhitron|IKhitron]]
 | status = Stable
 | mainsource = User:Ahecht/Scripts/refresh.js
 | beta = [[User:Ahecht/sandbox/Scripts/refresh.js]]
 | skins = 
 | browsers = 
 | logo = 
 | screenshot = 
 | screenshot-caption = 
 | styled = 
}}

{{u|Ahecht}}'s '''Refresh''' is a [[Wikipedia:User scripts|user script]] that adds "purge all" and "null edit all" options to the "Tools" menu on category pages, template pages, and on [[Special:WhatLinksHere]] and [[Special:Search]]. Makes <code>forcelinkupdate</code> purges or [[WP:NULLEDIT|nulledit]] on all pages in the category (if activated from a category page), all pages that transclude the template (if activated from a template page), all pages linking to the target page (if activated from [[Special:WhatLinksHere]]), or all pages in a search result (if activated from [[Special:Search]]).

Based on [[phab:T170039#3473755]] and [[:he:User:IKhitron/101.js]]. Note that, per [[:phab:T365303]], category updates may take a few minutes even after a null edit with this script.

'''To use this script''': '''Copy''' the line below, then '''<span class="plainlinks">[[[{{fullurl:Special:MyPage/common.js|action=edit}} click here]]]</span>''', '''paste''' the line, and hit {{Mw button|'''Publish changes'''}}.
* <code>{{Tlps|Iusc|{{FULLPAGENAME}}.js|{{FULLPAGENAME}}}}</code>
* Report any issues to me, [[User talk:{{ROOTPAGENAME}}|{{ROOTPAGENAME}}]].

===Options===
By default, the script will reuse the same bubble notification for each page it refreshes. To have each notification in its own bubble, add {{jscode|1=var refreshReuseBubble = false;}} to your [[Special:MyPage/common.js]] above the line that calls refresh.js.

Other options that can be set via the [[HELP:CONSOLE|javascript console]]:
*To shuffle the order in which pages are refreshed, open the console and type {{jscode|1=window.refreshShuffle = true;}} and press enter before running the script.
*For items in a category, the script defaults to sorting by <code>timestamp</code> in <code>descending</code> order (newest first). You can change this by setting {{jscode|1=window.refreshCatSort='sortkey';}} or by setting {{jscode|1=window.refreshCatDir='ascending';}} (or {{jscode|1='asc'}}) before running the script.
*For search results, the script defaults to sorting by <code>last_edit_desc</code>. You can change this by setting {{jscode|1=window.refreshSearchSort='VALUE';}}, where VALUE is one of the options for <code>srsort</code> specified at [[:mw:API:Search]].

== See also ==
*[[Wikipedia:Purge]]
*[[Wikipedia:User scripts/List#Purging]]
*[[User:Ahecht/Scripts|My other user scripts]]