Title: Koci Cache
Author: kocimedia
Published: <strong>November 16, 2026</strong>
Last modified: November 16, 2026

---

Search plugins

![](https://ps.w.org/koci-cache/assets/banner-772x250.png?rev=3806231)

![](https://ps.w.org/koci-cache/assets/icon-256x256.png?rev=3806231)

# Koci Cache

 By [kocimedia](https://profiles.wordpress.org/kocimedia/)

[Download](https://downloads.wordpress.org/plugin/koci-cache.1.1.0.zip)

 * [Details](https://wordpress.org/plugins/koci-cache/#description)
 * [Reviews](https://wordpress.org/plugins/koci-cache/#reviews)
 *  [Installation](https://wordpress.org/plugins/koci-cache/#installation)
 * [Development](https://wordpress.org/plugins/koci-cache/#developers)

 [Support](https://wordpress.org/support/plugin/koci-cache/)

## Description

Koci Cache saves every page as a static HTML file and serves it before WordPress
loads (through the standard `advanced-cache.php` drop-in), so most visitors get 
the page without PHP and database work. Everything beyond the page cache is off 
by default and can be switched on one by one.

#### Why another cache plugin?

 * **Small and readable** – one settings page, no upsells, no accounts, no external
   service. The whole plugin is a few hundred kilobytes.
 * **Safe by default** – logged-in users, carts, checkouts, password-protected pages,
   POST requests and pages with a query string (unless you allow its keys) are never
   cached; a page is only stored when it is complete (with a closing `</html>`) 
   and was generated for your own domain.
 * **Multilingual-friendly** – the cache key is the URL exactly as the browser requested
   it, so sites whose language plugin uses a URL prefix (/en/, /de/ …) never mix
   languages.
 * **Shared hosting friendly** – the cache warmer works in small, slow batches in
   the background and never blocks a visitor or an admin request.

#### Features

 * **Page cache** – static HTML files, 304 Not Modified support, optional separate
   mobile cache, lifespan and scheduled cleanup.
 * **Automatic clearing** – when a post, page, product or comment changes, only 
   the affected page, the home page and the related archives are cleared (no full
   flush during a product import). Menus, widgets and the Customizer clear everything.
   An admin bar button clears everything by hand.
 * **Advanced rules** – never-cache URLs, cookies and user agents, and query string
   keys that may be cached (e.g. `utm_source`).
 * **CSS** – minify (files and inline styles) and an optional, cascade-safe combine.
 * **JavaScript** – minify, defer, and delay until the first interaction, with exclusions.
 * **Media** – lazyload of images (with `<picture>` and `srcset`) and iframes, skipping
   the first images (LCP), missing width/height, font preload and local hosting 
   of Google Fonts.
 * **Preload** – after a full clear the URLs of your sitemap (WordPress, Yoast or
   a generic sitemap) are visited in the background; optional link prefetch on hover.
 * **Repair and diagnostics** – the Overview tab shows whether the drop-in and `
   WP_CACHE` are active and repairs the installation. Another cache plugin’s drop-
   in is never overwritten without your confirmation.

Every optimization keeps the original markup when anything goes wrong: a failed 
step can never break or empty a page. `?nokoci=1` shows a page without optimization
for testing.

#### How it works, what it changes

 * On activation the plugin copies `advanced-cache.php` into `wp-content` and adds`
   define( 'WP_CACHE', true );` (marked with a comment) to `wp-config.php`. On deactivation
   and uninstall both are removed again.
 * Everything the plugin writes is in the uploads folder, in `wp-content/uploads/
   koci-cache/`: the cached pages (`pages/`), the rules read by the drop-in (`config/
   config.json`, not readable from the web where .htaccess works), minified files(`
   min/`) and local Google Fonts (`fonts/`). Uninstalling deletes this folder and
   the settings.
 * Do not use it together with another page cache plugin (e.g. WP Rocket, W3 Total
   Cache, LiteSpeed Cache). Server-level caches (Varnish, LiteSpeed) can stay, but
   then let only one of them cache the HTML.

#### Privacy

The plugin does not track visitors, does not set cookies and does not send any data
anywhere. Pages are only cached for visitors who are not logged in and have no cart,
so cached files contain public pages only.

#### External services

Only when you switch on **Google Fonts self-host** (Media tab, off by default): 
when a page uses Google Fonts, your server downloads the Google Fonts stylesheet
from `https://fonts.googleapis.com` and the font files it refers to from `https://
fonts.gstatic.com` once, and serves them from your own site afterwards, so the visitors’
browsers no longer connect to Google. The request sends your server’s IP address
and a browser user agent (to get the WOFF2 files). Google Fonts: https://developers.
google.com/fonts – Terms: https://policies.google.com/terms – Privacy: https://policies.
google.com/privacy

The cache preload only requests pages and sitemaps of your own site.

#### Third-party libraries

CSS and JavaScript minification uses matthiasmullie/minify (MIT license, https://
github.com/matthiasmullie/minify) and matthiasmullie/path-converter (MIT license,
https://github.com/matthiasmullie/path-converter). Their source files are in the`
vendor` folder (see `composer.json`), with their licenses.

#### For developers

 * `koci_cache_is_cacheable` (bool) – return false to keep the current page out 
   of the cache.
 * `koci_cache_do_optimize` (bool) – return false to skip the CSS/JS/media optimization
   for the current page.
 * The `DONOTCACHEPAGE` constant is respected.
 * Actions: `koci_cache_purged_all`, `koci_cache_purged_post` (post ID), `koci_cache_cron_ran`,`
   koci_cache_preload_done`.
 * Script attributes: `data-koci-no` (never touched), `data-koci-no-delay` (not 
   delayed). Image attribute `data-no-lazy` or class `no-lazy` / `skip-lazy` (no
   lazyload).

## Screenshots

[⌊The Overview tab with the installation status and the cache statistics.⌉⌊The Overview
tab with the installation status and the cache statistics.⌉[

The Overview tab with the installation status and the cache statistics.

[⌊The cache settings.⌉⌊The cache settings.⌉[

The cache settings.

[⌊The CSS and JavaScript optimization settings.⌉⌊The CSS and JavaScript optimization
settings.⌉[

The CSS and JavaScript optimization settings.

[⌊The media settings (lazyload, image dimensions, fonts).⌉⌊The media settings (lazyload,
image dimensions, fonts).⌉[

The media settings (lazyload, image dimensions, fonts).

## Installation

 1. Install the plugin from the Plugins > Add New screen, or upload the plugin folder
    to `/wp-content/plugins/`, then activate it.
 2. Open Koci Cache > Overview. All status rows should be green; if not, click “Repair
    installation” and follow the message.
 3. The page cache works right away. Switch on the optimizations you need one by one,
    and check your site after each one.

## FAQ

### How do I see that a page comes from the cache?

Open the page in a private window (you must be logged out) and look at the source:
cached pages end with a `<!-- Koci Cache: generated … -->` comment, and the response
has an `X-Koci-Cache: HIT` header.

### The status shows that serving is not active.

Usually another cache plugin’s `advanced-cache.php` is in `wp-content`, `wp-config.
php` already has a `WP_CACHE` line from another plugin, or the files are not writable.
The Overview tab tells which one; deactivate the other cache plugin and click “Repair
installation”.

### Something looks broken after switching on an optimization.

Open the page with `?nokoci=1` to compare. Then add the affected file (a part of
its URL) to the exclusions of that optimization, or switch it off. Delay and combine
need the most testing.

### Is WooCommerce supported?

Yes. Cart, checkout and account pages, and visitors with items in the cart, are 
never cached; product changes clear the product page, the shop page and the product
categories.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Koci Cache” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ kocimedia ](https://profiles.wordpress.org/kocimedia/)

[Translate “Koci Cache” into your language.](https://translate.wordpress.org/projects/wp-plugins/koci-cache)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/koci-cache/), check
out the [SVN repository](https://plugins.svn.wordpress.org/koci-cache/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/koci-cache/) by 
[RSS](https://plugins.trac.wordpress.org/log/koci-cache/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.0

 * First public release on WordPress.org.
 * English source texts, translation-ready.
 * The cache key of query strings is computed once by the drop-in; only simple values
   are cached.
 * The front-end helper scripts (delay, lazyload, link prefetch) are readable files
   in `assets/js`, added with wp_enqueue_script(); font preload links use the wp_preload_resources
   filter.
 * All files are stored in the uploads folder (`koci-cache/`); the rules for the
   drop-in are a JSON file.

#### 1.0.7

 * The cache file is based on the original requested URL, so language prefixes never
   collide.
 * Empty or truncated cache files are never served.

#### 1.0.6

 * A failing optimization step returns the original HTML; incomplete pages and non-
   HTML responses are never cached.
 * Requests with a forged Host header never write the cache; logged-in and password
   cookies are never served from the cache.
 * Cascade-safe CSS combine; the preload queue is built in the background.

#### 1.0.0

 * First release: page cache, advanced rules, CSS/JS and media optimization, preload.

## Meta

 *  Version **1.1.0**
 *  Last updated **11 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [cache](https://wordpress.org/plugins/tags/cache/)[lazy load](https://wordpress.org/plugins/tags/lazy-load/)
   [minify](https://wordpress.org/plugins/tags/minify/)[page cache](https://wordpress.org/plugins/tags/page-cache/)
   [performance](https://wordpress.org/plugins/tags/performance/)
 *  [Advanced View](https://wordpress.org/plugins/koci-cache/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/koci-cache/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/koci-cache/reviews/)

## Contributors

 *   [ kocimedia ](https://profiles.wordpress.org/kocimedia/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/koci-cache/)