Configuration

Reference for the twelve extension configuration settings of nr_temporal_cache.

All of them are optional. With no configuration the extension uses global scoping and dynamic timing, and harmonization is off.

Important

The choice of scoping and timing strategy changes what the extension does, not only how fast it does it. Read How the settings combine before changing either, and Performance considerations before deploying the change.

Chapters

🎯 Optimization strategies

Scoping, timing and harmonization settings, and how the three interact.

Covers: scoping.strategy, scoping.use_refindex, timing.strategy, timing.hybrid.pages, timing.hybrid.content, harmonization.enabled, harmonization.slots, harmonization.tolerance, harmonization.auto_round

Strategy configuration

⚙️ Advanced options

Cache lifetime cap, debug logging, and the state of the scheduler task.

Covers: advanced.default_max_lifetime, advanced.debug_logging, Scheduler task

Advanced settings

📋 Examples & presets

The presets the backend wizard offers, and worked configurations with what each of them changes.

Examples & presets

🔧 Troubleshooting

Cache not updating, high database load, harmonization doing nothing, settings that appear to be ignored.

Configuration troubleshooting

All settings at a glance

Defaults as implemented in NetresearchTemporalCacheConfigurationExtensionConfiguration.

Setting	Type	Default	Accepted values
`scoping.strategy`	string	`global`	`global`, `per-page`, `per-content`
`scoping.use_refindex`	boolean	`true`	`0`, `1`
`timing.strategy`	string	`dynamic`	`dynamic`, `scheduler`, `hybrid`
`timing.hybrid.pages`	string	`dynamic`	`dynamic`, `scheduler`
`timing.hybrid.content`	string	`scheduler`	`dynamic`, `scheduler`
`harmonization.enabled`	boolean	`false`	`0`, `1`
`harmonization.slots`	string	`00:00,06:00,12:00,18:00`	comma-separated `HH:MM` or `H:MM`
`harmonization.tolerance`	integer	`3600`	seconds; `0` harmonizes nothing
`harmonization.auto_round`	boolean	`false`	`0`, `1`
`advanced.default_max_lifetime`	integer	`86400`	seconds greater than 0
`advanced.debug_logging`	boolean	`false`	`0`, `1`

Where to configure

Extension Manager

1. Admin Tools → Extensions
2. Find "nr_temporal_cache"
3. Click the "Configure" icon
4. Adjust the settings, grouped by scoping, timing, harmonization, advanced
5. Save

The form is generated from ext_conf_template.txt, and the values are stored in config/system/settings.php.

PHP configuration

config/system/additional.php

<?php

$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['nr_temporal_cache'] = [
    'scoping' => [
        'strategy' => 'per-page',
        'use_refindex' => true,
    ],
    'timing' => [
        'strategy' => 'dynamic',
    ],
    'harmonization' => [
        'enabled' => true,
        'slots' => '00:00,06:00,12:00,18:00',
        'tolerance' => 3600,
    ],
];

additional.php is read after config/system/settings.php, so it wins over the Extension Manager.

Backend module wizard

Tools → Temporal Cache → Wizard walks through five steps — welcome, analysis, presets, custom, summary — showing statistics for the current site and recommending settings.

Note

The wizard does not write configuration. It shows which values to use, as its own note says; apply them in the Extension Manager or in additional.php.

Next steps

Optimization strategies - Every setting in detail
Examples & presets - Complete configurations
Performance considerations - Performance implications
Configuration wizard - The wizard in the backend module