InputfieldPageAutocomplete

InputfieldPage usually sets most page-selection properties for you. Set them directly only when using this inputfield outside that delegate context.

getSelectedPages()

Return selected page IDs as a PageArray.

$selected = $f->getSelectedPages();
foreach($selected as $page) {
    echo $page->title;
}

The lookup accepts the field value as an array or pipe-separated string. A single template_id and parent_id are used as lookup restrictions when present. When multiple template_ids are configured, selected-page lookup loads by ID without a single-template restriction.

getAjaxUrl()

Build and return the ProcessPageSearch ajax URL used by the JavaScript autocomplete.

$url = $f->getAjaxUrl();

The selector stored for ProcessPageSearch is built from:

• parent_id
• template_id or template_ids
• findPagesSelector
• allowUnpub

If no selector constraints are configured, the selector falls back to id>0. Unless the selector already contains limit=, the URL adds limit=50.

When labelFieldFormat is populated, getAjaxUrl() stores the format with ProcessPageSearch and adds a format_name query parameter. Otherwise it adds get=<labelFieldName>.

render()

Render the complete autocomplete widget. Output includes:

• A hidden input containing selected page IDs as comma-separated values.
• A visible text input for autocomplete searching.
• A selected-items list when useList is enabled.

echo $f->render();

Use the base field name for $f->name; render() appends [] to the hidden input name automatically.

$f->name = 'related_pages'; // renders name='related_pages[]'

Do not include [] yourself, or the rendered name becomes related_pages[][].

When maxSelectedItems is 1, the input switches to single-select mode and useList is forced to false.

renderList()

Render the selected-items list as an <ol>.

echo $f->renderList();

renderListItem($label, $value, $class = '', Page $page = null)

Render one selected item. Hook this method to customize selected-list markup.

$wire->addHookAfter('InputfieldPageAutocomplete::renderListItem', function(HookEvent $event) {
    $page = $event->arguments(3);
    if($page && $page->template == 'article') {
        $event->return = str_replace('</span>', ' <em>article</em></span>', $event->return);
    }
});

When usePageEdit is set and the current user can edit the page, selected-item labels link to the page editor.

processInput(WireInputData $input)

Normalize submitted hidden input values into an array of integer page IDs.

// Submitted value: ['123,456']
$form->processInput($input->post);
$ids = $f->val(); // [123, 456]

Blank submitted values become an empty array.

getConfigInputfields()

Return module configuration fields for:

• Autocomplete search operator.
• Fields to query.
• Click-to-edit mode.
• Delete behavior.

install() / uninstall()

Install and uninstall register or remove this inputfield from InputfieldPage's available selection widgets.

Hookable methods:

• Access with $modules->get('InputfieldPageAutocomplete').
• Implements InputfieldHasArrayValue; values are arrays of page IDs.
• Implements InputfieldHasSortableValue; selected page IDs preserve sort order.
• getAjaxUrl() requires the current user to be able to execute ProcessPageSearch, which is normally true in the Page editor context.
• hideDeleted adds a wrapper class in renderReady() and a list class in renderList().
• Source file: wire/modules/Inputfield/InputfieldPageAutocomplete/InputfieldPageAutocomplete.module.