primoz2500/hasoneautocompletefield

A CMS form field for adding has_one relationships using autocomplete

2.11.4 2022-05-10 22:45 UTC

Requires

• silverstripe/framework: ~4.0

MIT

• Nathan Cox
• Primoz Skerbis

• form
• cms
• relation
• silverstripe
• formfield
• has_one

README

Overview

This module adds a field for using an autocomplete dropdown to assign a has_one relationship. It's styled after the URLSegment field.

FORK CHANGES: Added support for functions as result list title ( fields are accessible as get{FieldName} functions just with the function name )

Maintainer Contacts

• Nathan Cox ([e-mail])
• Primoz Skerbis ([e-mail])

Requirements

• SilverStripe 4.0+

For SilverStripe 3.x see the version 1 branch on Github: https://github.com/nathancox/silverstripe-hasoneautocompletefield/tree/1

Installation Instructions

Via composer:

composer require primoz2500/hasoneautocompletefield

Or manually download the module and place it in a folder called hasoneautocompletefield in your site root.

Visit yoursite.com/dev/build?flush=1

Documentation

Example code:

<?php

use SilverStripe\CMS\Model\SiteTree;
use NathanCox\HasOneAutocompleteField\Forms\HasOneAutocompleteField;

class Page extends SiteTree
{
    private static $db = [];

    private static $has_one = [
        'LinkedPage' => 'Page'
    ];

    public function getCMSFields()
    {
        $fields = parent::getCMSFields();

        $fields->addFieldToTab('Root.Content', $pageField = HasOneAutocompleteField::create('LinkedPageID', 'Linked Page', 'Page', 'Title'));
        $pageField->setSearchFields(array('Title', 'Content'));
        $pageField->enableClearButton();

        return $fields;
    }
}

Known Issues

Issue Tracker