InputfieldSelector

Date/time settings:

getDefaultSettings()

Return factory defaults for configurable settings:

$defaults = $f->getDefaultSettings();

getSettings()

Return effective settings after merging defaults and instance values:

$f->preview = false;
$settings = $f->getSettings();
echo $settings['preview']; // false

The ready() method also applies optional global classes from $config->InputfieldSelector:

$config->InputfieldSelector = [
    'selectClass' => 'uk-select',
    'inputClass' => 'uk-input',
    'checkboxClass' => 'uk-checkbox',
];

setup()

Build internal operator, field, and modifier metadata. render() calls this automatically. Call it manually before using getSelectorInfo() for system or modifier fields.

$f->setup();

getSelectorInfo($field)

Return selector metadata for a system field, modifier field, field name, or Field object.

$f->setup();

$info = $f->getSelectorInfo('template');
$info = $f->getSelectorInfo($fields->get('title'));

The returned array can include keys such as input, label, operators, options, sanitizer, and subfields.

sanitizeSelectorString($selectorString, $parseVars = true)

Normalize a selector string, prepend initValue, optionally parse variables, resolve username values for created_users_id / modified_users_id, and enforce the allowSubselectors setting.

$f->initValue = 'template=blog-post';
$selector = $f->sanitizeSelectorString('title%=api', false);
// template=blog-post, title%=api

When allowSubselectors is false, submitted subselectors are removed, an error is recorded, and a forced non-match selector is added.

$f->allowSubselectors = false;
$selector = $f->sanitizeSelectorString('children=[title%=api]', false);
// id<0

processInput(WireInputData $input)

Process submitted selector input and sanitize it. With no initValue, value contains the processed selector.

$form->processInput($input->post);
$selector = $f->val();

When initValue is populated, value stores the editable portion and lastSelector stores the full selector:

$f->initValue = 'template=blog-post';
$form->processInput($input->post);

$editable = $f->val();
$full = $f->lastSelector;

Use sanitizeSelectorString() directly when you need an immediate full selector from raw input.

render()

Render the full visual selector builder:

echo $f->render();

Rendered output includes:

• A <ul class="selector-list"> containing selector rows.
• A hidden input containing the editable selector value.
• Add/remove controls when allowAddRemove is enabled.
• Preview and counter elements unless disabled.

renderRow($select, $subfield, $opval, $class = '')

Render one selector row wrapper from pre-rendered control markup.

$row = $f->renderRow($selectHtml, $subfieldHtml, $opvalHtml, 'custom-row');

This is mainly a small extension point for row markup.

• Get an instance with $modules->get('InputfieldSelector').
• Intended for admin/process-module contexts, not general public forms.
• Ajax endpoints require a logged-in user and a valid rendered inputfield session state.
• limitFields may include subfields like page_ref.title.
• initValue is not rendered as editable rows; it is stored separately and represented in preview data.
• Source file: wire/modules/Inputfield/InputfieldSelector/InputfieldSelector.module.