1# Stale Plugin - Making your Dokuwiki Cache Stale
2
3## About
4
5Stale is a [DokuWiki Plugin](https://www.dokuwiki.org/plugin:stale) that aims to delete or make all DokuWiki Cache stale.
6
7For this purpose, it will :
8  * touches all configuration files (ie change only the modified date, not the content) in order to make the rendering cache stale (ie HTML,...)
9  * delete the [sitemap file](https://www.dokuwiki.org/sitemap) if present.
10
11
12## Configuration file touched
13
14The following configuration files are touched:
15
16  * the main configuration file: [local.php](https://www.dokuwiki.org/config)
17  * all plugin info file [plugin.info.txt](https://www.dokuwiki.org/devel:plugin_info)
18
19> Note that the plugins that are using the cache system, must make the cache dependent of their info file to get the cache stale
20
21Why ? Because these files are cache dependencies and if touched will then prohibit the use of the cache by the next request.
22
23## How to stale ?
24
25You can stale the cache:
26
27  * in the [sitemenu tool](https://www.dokuwiki.org/devel:menus) via the hand icon ![Hand index icon](images/hand-index-fill.svg)
28  * in the [admin page](https://www.dokuwiki.org/admin_window)
29
30
31## Release
32
33  * 2021-09-04:
34     * As [per request 2](https://github.com/ComboStrap/stale/issues/2), Make the cache stale, reload the page and shows the feedback
35  * 2021-09-01:
36     * Delete the [sitemap](https://www.dokuwiki.org/sitemap)
37  * 2021-08-30:
38     * The stale menu item is now a website item
39     * The action label is more clear and was added as language reference
40  * 2021-08-04:
41     * First release
42
43## Reference
44
45Based on the [dead plugin toucher](https://github.com/anandr/dokuwiki-plugin-toucher/pull/2#issuecomment-809981442) idea.
46