====== Media-Cache Configuration Plugin ======

---- plugin ----
description: Allows the configuration default caching behavior for media files
author     : Michael Große 
email      : dokuwiki@cosmocode.de 
type       : action
lastupdate : 2018-01-10
compatible : Frusterick Manners
depends    : 
conflicts  : 
similar    : 
tags       : media, caching

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-mediacacheconfig/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-mediacacheconfig/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-mediacacheconfig/
donationurl: 

screenshot_img : 
----

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Usage =====

By DokuWiki default, all media files are cached for at least one hour or what is specified in [[config:cachetime]], whichever is higher. This behavior can be [[https://www.dokuwiki.org/images#caching|modified]] with the ''recache'' and ''nocache'' parameters in page's syntax.

This plugin alters the default behavior (i.e. if neither ''recache'' nor ''nocache'' has been specified) to act as if ''nocache'' has been specified in the syntax.

This plugin maybe useful if you media files change often and it's important that your users see the new version right away. However using this plugin may cause a performance hit, because the server has to be contacted for every media-file every time.
===== Configuration and Settings =====

  * **''always-validate''** -- unchecking this effectively deactivates the plugin
  * more configuration options may be added in the future

===== Development =====
  * This effectively sets the ''[[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control#Cacheability|Cache-Control: no-cache]]'' header for the media file 

=== Change Log ===

**Releases:**
{{rss>https://github.com/cosmocode/dokuwiki-plugin-mediacacheconfig/releases.atom description author}}