Dokumentasi

Persyaratan

• WordPress 6.4 atau lebih baru
• PHP 8.0 atau lebih baru
• Apache (dengan mod_rewrite) atau Nginx
• Izin tulis pada folder wp-content/cache/statixpress/

Instalasi

1. Download file zip plugin dari statixpress.site atau WordPress.org.
2. Di WordPress admin, buka Plugins → Add New → Upload Plugin.
3. Pilih file .zip yang sudah didownload, klik Install Now.
4. Klik Activate Plugin.
5. Buka StatixPress → Settings dan aktifkan cache.
6. Kunjungi halaman mana saja di situs Anda — halaman tersebut akan di-cache sebagai file HTML statis saat pertama kali dimuat.

Verifikasi Plugin Aktif

Buka halaman mana saja dan lihat source HTML-nya. Anda akan melihat komentar di bagian bawah:

<!-- StatixPress | Cached: 2025-01-01 10:00:00 -->

Anda juga bisa cek StatixPress → Diagnostic untuk pemeriksaan sistem lengkap.

Semua pengaturan ada di StatixPress → Settings di WordPress admin Anda.

Crawler bawaan menemukan semua URL yang dipublikasikan dari database WordPress dan membuat file cache statis untuk semuanya. Tidak memerlukan sitemap.xml.

Menjalankan Crawler Secara Manual

1. Buka StatixPress → Crawler.
2. Klik Start Crawl. Crawler akan mengantrekan semua post, halaman, arsip, dan halaman taksonomi yang dipublikasikan.
3. Progress ditampilkan secara real time. Setiap URL dikunjungi dan di-cache.
4. Setelah selesai, seluruh situs Anda sudah pre-warm — tidak ada cold-start untuk pengunjung.

Auto-Crawler Cron

Anda bisa mengaktifkan crawl terjadwal setiap jam yang menjaga semua halaman tetap segar secara otomatis. Konfigurasi intervalnya di Settings → Crawler → Cron Interval.

StatixPress mendukung WooCommerce secara langsung dengan Hybrid Mode: halaman produk dan toko disajikan sebagai HTML statis, sementara cart, checkout, dan halaman akun tetap dinamis.

Cache Clearing Saat Stok Berubah

Ketika stok produk berubah (misalnya setelah pembelian), plugin secara otomatis menghapus cache untuk halaman produk tersebut dan halaman kategori induknya.

Plugin ini membuat aturan konfigurasi server yang memberi tahu web server Anda untuk menyajikan file statis secara langsung — melewati PHP sepenuhnya.

Apache (.htaccess)

Plugin secara otomatis menulis aturan yang diperlukan ke file .htaccess Anda saat aktivasi. Tidak diperlukan tindakan manual. Jika Anda perlu meregenerasinya, buka Settings → Server Rules → Regenerate.

# StatixPress - Apache Rules
RewriteEngine On
RewriteCond %{REQUEST_METHOD} GET
RewriteCond %{QUERY_STRING} ^$
RewriteCond %{HTTP_COOKIE} !(wordpress_logged_in|woocommerce_cart) [NC]
RewriteCond %{DOCUMENT_ROOT}/wp-content/cache/statixpress/$1/index.html -f
RewriteRule ^(.*) /wp-content/cache/statixpress/$1/index.html [L]

Nginx

Untuk Nginx, buka Settings → Server Rules dan salin snippet Nginx-nya. Tambahkan di dalam blok server {} Anda:

location / {
    set $cache_file "$document_root/wp-content/cache/statixpress${uri}index.html";
    if ($request_method = GET) {
        if ($query_string = "") {
            if ($http_cookie !~ "wordpress_logged_in|woocommerce_cart") {
                try_files $cache_file $uri $uri/ /index.php?$args;
            }
        }
    }
}

ISR membawa pola stale-while-revalidate ke WordPress. Saat halaman yang di-cache kadaluarsa, pengunjung berikutnya mendapatkan versi lama (stale) secara instan sementara versi baru diregenerasi di latar belakang. Tanpa downtime. Tanpa layar kosong.

Cara Kerja

1. Pengunjung meminta halaman yang cache-nya sudah kadaluarsa.
2. Mereka langsung mendapatkan versi cache lama (respon cepat).
3. Sebuah job background meregenerasi halaman dengan mengambilnya via loopback request.
4. Pengunjung berikutnya mendapatkan versi terbaru.

Konfigurasi

Saat Anda memperbarui sebuah post, plugin secara otomatis menghapus (purge) URL yang sesuai dari CDN Anda agar pengunjung tidak pernah melihat konten yang sudah kadaluarsa. Mendukung Cloudflare, BunnyCDN, dan Fastly.

Cloudflare

1. Buka StatixPress → CDN → Cloudflare.
2. Masukkan Zone ID Anda (tersedia di Cloudflare Dashboard → Overview).
3. Masukkan API Token dengan izin Cache Purge.
4. Simpan. Mulai sekarang, setiap pembaruan post memicu purge Cloudflare otomatis.

BunnyCDN

1. Buka StatixPress → CDN → BunnyCDN.
2. Masukkan Pull Zone ID dan API Key dari dashboard BunnyCDN.
3. Simpan dan uji dengan tombol Test Purge.

Fastly

1. Buka StatixPress → CDN → Fastly.
2. Masukkan Service ID dan API Token Anda.
3. Simpan. Purge dipicu via surrogate keys saat post diperbarui.

StatixPress adalah proyek open-source. Kami menerima kontribusi dari pengembang di seluruh dunia.

• Laporkan bug di repositori GitHub kami
• Kirim pull request untuk fitur baru atau perbaikan
• Bantu pengguna lain di forum komunitas