---
title: "Configuration"
manual: "Temporal Cache Management"
version: "main"
source: "Configuration/Index.rst"
rendered: "2026-10-07T14:40:31+00:00"
---

# Configuration {#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](Strategies.html#configuration-strategies-how-settings-combine) before changing
> either, and [Performance considerations](../Performance/Index.html#performance-considerations) before deploying the change.

## Chapters {#configuration-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](Strategies.html#configuration-strategies)

**⚙️ 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.html#scheduler-setup)

[Advanced settings](Advanced.html#configuration-advanced)

**📋 Examples & presets**

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

[Examples & presets](Examples.html#configuration-examples)

**🔧 Troubleshooting**

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

[Configuration troubleshooting](Troubleshooting.html#configuration-troubleshooting)

## All settings at a glance {#configuration-defaults}

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 {#configuration-methods}

### Extension Manager {#extension-manager}

```text
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`](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ExtensionArchitecture/FileStructure/ExtConfTemplate.html#file-extension-ext-conf-template-txt), and the values are
stored in `config/system/settings.php`.

### PHP configuration {#php-configuration}

**config/system/additional.php**

```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`](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Configuration/Typo3ConfVars/Index.html#file-project-config-system-additional-php) is read after `config/system/settings.php`, so it
wins over the Extension Manager.

### Backend module wizard {#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`](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Configuration/Typo3ConfVars/Index.html#file-project-config-system-additional-php).

## Next steps {#next-steps}

-   [Optimization strategies](Strategies.html#configuration-strategies) \- Every setting in detail
-   [Examples & presets](Examples.html#configuration-examples) \- Complete configurations
-   [Performance considerations](../Performance/Index.html#performance-considerations) \- Performance implications
-   [Configuration wizard](../Backend/Wizard.html#backend-wizard) \- The wizard in the backend module