Plugin Settings
Every panel on Settings → Tivlo Static Site → Plugin Settings, in everyday language.
Open Settings → Tivlo Static Site → Plugin Settings. Labels below match the admin UI. You do not need every row on day one — the defaults are already a sensible blog/brochure setup.
Saving does not update existing static files
After any change here, switch to the Build Console and run Full Rebuild. To drop pages that are no longer in scope, enable Clear existing static files before running a full rebuild. Otherwise Tivlo keeps serving last week’s files like a polite but stubborn intern.
[IMAGE: plugin-settings]
Screenshot of Plugin Settings showing Core Publishing, Export Folders, and the export-scope cards. Caption: “Plugin Settings — publishing, routing, triggers, optimization, and export scope.”
Core Publishing
These three are the master switches. Leave them on unless you have a reason.
| Setting | Default | What it means |
|---|---|---|
| Enable static generation | On | Master switch for export, rebuild, and static delivery |
| Serve static HTML directly | On | Hand files to anonymous visitors |
| Skip static delivery for logged-in users | On | You (logged in) always get live WordPress — so the editor still feels like WordPress |
You can leave generation on and turn serving off if you want files updated in the background without visitors seeing them yet. Useful when you are still poking at settings.
Export Folders & Target Routing
| Setting | Default | What it means |
|---|---|---|
| Export Folder Slug | Empty (auto) | Multisite only. Folder under wp-content/tivlo-static/. Letters, numbers, dashes, underscores. Leave blank for the auto slug (subdirectory, subdomain, or main). |
| Public Base URL | Empty | Rewrite WordPress home/site URLs inside exported HTML/CSS to another host. Generation still fetches this WordPress site. Leave blank if visitors hit this same install. |
Single-site installs have no folder-slug field; output is
wp-content/tivlo-static/.
Build Triggers & Rules
These apply to content you edit after you save. They do not time-travel through files from last Tuesday.
| Setting | Default | What it means |
|---|---|---|
| Also rebuild related taxonomy & archival routes when content changes | On | When you publish a post, also reprint home, archives, and terms so lists stay honest |
| Rebuild parent post instantly when comments update | On | Approve, edit, trash, spam, or delete a comment → rebuild that post so visitors see it |
| Queue Batch Size | 5 | How many to-do items run per cron tick or Process Queue Now (1–50) |
| HTTP Timeout (sec) | 30 | How long Tivlo waits for WordPress to render a page (5–120) |
Raise the timeout if a heavy page times out. Raise the batch size only if your host has enough PHP workers — bigger batches are not always faster.
Optimization & Performance
These run when pages are written, not when you preview live WordPress while logged in. Your admin view stays uncompressed and familiar.
| Setting | Default | What it means |
|---|---|---|
| Inject Tivlo Generator Metadata | On | A small HTML comment with a build timestamp — handy when debugging “is this file fresh?” |
| Keep stylesheets & scripts as external files | On | Avoid giant inlined CSS/JS; leftover inline bits are written under wp-content/tivlo-static/assets/ |
| Consolidate duplicate stylesheets globally | On | Merge page stylesheets into wp-content/tivlo-static/assets/css/bundle-*.css |
| Optimize exported HTML for performance | On | Reveals the HTML Compactor chips |
Compactor sub-options (when Optimize HTML is on):
| Chip | Default | What it means |
|---|---|---|
| Minify HTML Core | On | Collapse extra whitespace, strip HTML comments |
| Lazy-Load Inline Media | On | Images load lazily; the first image stays eager so the hero is not late to the party |
| Strip WP Bloat Scripts | On | Drop emoji scripts, oEmbed/REST discovery, shortlink, obsolete type attributes |
| Preload Asset Hints | On | dns-prefetch / preconnect for third-party hosts |
Details: Optimization & Assets.
Export scope cards
The right column controls what is written. Full tour: Export Scope.
- Target Content Types
- Target Archive Pages
- Target Taxonomy Archives
- Site Pages
- Extra Archive Pages
- Never Export These Paths
- Excluded Automatically (WooCommerce, when those pages exist)
- Estimated Export Size (live count of the current selection)
Reset Settings
Click Reset Settings and confirm Reset to Defaults. This is the “I poked too many chips” button.
Every option returns to plugin defaults. Custom paths, post type selections, and optimization choices are lost.
A full rebuild starts immediately with the default configuration — you do not have to remember to click Rebuild after a reset.
Logged-out preview
Logged-in users bypass static delivery by default. Use a private window to see what anonymous visitors receive. The admin bar lies with a smile.
How is this guide?