Skip to main content

Background

Composite background: color, image, position, size, repeat, attachment or gradient.

Helperpu_background()
Typebackground
Stored valuestructured array

Example​

pu_background('hero_background', ['label' => 'Hero background']);

Stored value​

Pressundo stores this field as structured array. Composite fields keep structured arrays rather than opaque CSS strings, so your application can reuse individual values.

Storage example​

[
    'type'       => 'image',
    'color'      => '#0F172A',
    'image'      => 123,
    'position'   => 'center center',
    'size'       => 'cover',
    'repeat'     => 'no-repeat',
    'attachment' => 'scroll',
    'gradient'   => [],
]

Important arguments​

Common field arguments: label, description, default, required, show_if, hide_if.

All normal fields can also use conditional visibility:

'show_if' => ['enabled' => true],

Behavior​

  • The same schema renders in Air, Slate and Compact.
  • Sanitization runs before validation/storage.
  • Hidden conditional fields keep their stored value unless your application explicitly changes it.
  • Output escaping remains contextual and should be applied where the value is rendered on the front end.

Notes​

The field is sanitized and validated through the central field-value processor before normal admin saves.

Reading the value​

$options = pu_options('theme_settings');
$value = $options->get('example_value', null);

Use the actual field ID from your schema instead of example_value.

Last updated on