Incremental Rebuilds
Which content changes queue which URLs — without rebuilding the universe.
After the first Full Rebuild, day-to-day edits should not need a manual export. Tivlo puts routes on the to-do list; WP-Cron (or Process Queue Now) writes new HTML.
The idea is the same as WordPress itself: change a post, and the things that mention that post should update too. Home, the category list, the author archive. Leave related rebuilds on unless you enjoy stale indexes.
Same rules as a full build
Incremental related URLs obey the same Plugin Settings as a full export. A group you deselected is never resurrected by a post edit. Unticked means unticked.
When a post is published or updated
The post permalink is queued (high priority). That page reprints first.
If Also rebuild related taxonomy & archival routes is on, Tivlo also queues related routes (see the table below).
Cron or Process Queue Now fetches each URL and overwrites the file.
Revisions and autosaves do not enqueue. Tivlo waits until you mean it (publish or update). Your draft history can stay chaotic in peace.
Related routes
| Related URL | When it is queued |
|---|---|
| Front page | Related rebuilds on |
| Posts page | Related on, and a static front page is set |
| Post type archive | That archive is in export scope |
| Term archives | Taxonomies attached to the post, if those taxonomies are selected |
| Year/month archives | For the post type when date archives are on |
| Author archive | Author archives on |
When a post is trashed, deleted, or unpublished
- Its static file is removed immediately — visitors should not keep a souvenir.
- Related routes are queued for rebuild so lists stop linking to a ghost.
Terms, comments, users, theme, and menus
| Event | What is queued |
|---|---|
| Term created, edited, or deleted | Term archive + home |
| Comment approved, unapproved, posted (when auto-approved), edited, trashed, spammed, untrashed, or deleted | Parent post (+ related routes if that setting is on). Requires Rebuild parent post instantly when comments update. |
| Profile update / user delete | Author archive when author archives are exported |
| Customizer save, theme switch, or nav menu update | Soft full rebuild — all exportable URLs, existing files overwritten as jobs complete |
A menu change really does mean “reprint a lot of pages.” Headers live on every snapshot. Drain the queue or go make a sandwich — this one takes a minute on a large site.
Queue behavior
| Detail | Value |
|---|---|
| Table | {prefix}tivlo_ssg_queue |
| Batch size | Setting Queue Batch Size (default 5) |
| Schedule | Every minute (tivlo_ssg_every_minute) plus a short single-event after enqueue |
| Re-enqueue | Resets an existing URL to pending |
| Failures | Retry up to 3 attempts, then remain failed under Recent Failures |
Tivlo_SSG_Queue::enqueue( home_url( '/about/' ), 1 );How is this guide?