Settings

Settings decide how the banner looks and behaves and what Silvertrail keeps. The admin holds the decisions a site owner makes, and code can set every one of them.

The settings filter

The silvertrail_settings filter sets any setting, and code wins over the admin. The admin shows a field that code sets as "Set in code" and keeps the admin's own value underneath.

add_filter( 'silvertrail_settings', function ( $settings ) {
	$settings['expiry_months'] = 12;
	$settings['records']       = true;
	return $settings;
} );
Key Admin Values Default
enabled Top of the page bool. Turned off, Silvertrail adds nothing to the site: no banner, no blocking, none of its tags. true
layout Design 'modal' (a dialog in the middle), 'box' (the bottom right corner) or 'bar' (across the page) 'modal'
bar_position Design 'top' or 'bottom', the edge the bar sits on 'top'
appearance Design 'light' or 'dark'. The default 'theme' takes whichever the theme is. 'theme'
require_choice Design bool. Turned on, the page dims and the banner stays until the visitor chooses. Turned off, the page stays as it is, and a click outside or Escape closes the banner without storing anything. null requires a choice for 'modal' only. null
imprint_page Texts page ID, 0 for none 0
floating_button Design 'never', 'auto' for pages without a link to #silvertrail, or 'always' 'never'
floating_position Design 'left' or 'right', the bottom corner of the floating button 'left'
records Tools bool. Keeps a record of each decision. false
load_css code bool. Turned off, the theme's silvertrail/silvertrail.css is the whole stylesheet. true
expiry_months code 1 to 13, how long the choice lasts in the browser 6
retention_days code 30 to 3650, how long records are kept 365
gpc code bool. Global Privacy Control counts as "only essential". true
trail code bool. The preferences list what the page held back and loaded. true
webmcp code bool. Offers agents the WebMCP tools in browsers that support WebMCP. true
webmcp_tokens code list of WebMCP origin trial tokens, printed in the page head until they expire []

An unknown key or an invalid value triggers a _doing_it_wrong notice. An invalid value falls back to the nearest valid one, or to the default. A setting the admin left at its default follows a new default in a later version.

wp silvertrail settings and the silvertrail/get-settings ability list every value and whether it comes from code, admin or default.

The presets and the texts are not in this filter. They have their own code paths: presets through silvertrail_register_service() and texts through the theme's JSON files.

Preview while switched off

While enabled is off, add ?silvertrail-preview to any URL to see that page as visitors would get it with Silvertrail on. Choices made in a preview are not recorded, and the Leak check scans as if Silvertrail were on.