Edit trick

Changes will be published after manual review

Title

Give your trick a describing title. Do not start with «How to...».

Your trick

Keep it short and concise! Markdown is supported.

When you are dealing with a plugin's `Settings` model, you'll probably use the default `Settings` controller by registering your model like so:
```php
// Plugin.php
public function registerSettings()
{
    return [
        'settings' => [
            //...
            'class'       => \AuthorName\PluginName\Models\Settings::class,
        ]
    ];
}
```
If you need for any reason to add an AJAX handler to this controller, only for your `Settings` model, you can do it by extending the default controller:
```php
// Plugin.php
public function boot()
{
    // Extends the default Settings controller
    \System\Controllers\Settings::extend(function (\System\Controllers\Settings $controller) {

// Settings' index page doesn't have a formWidget initiated, abort instantly
        if (url()->current() === Backend\Facades\Backend::url('system/settings')) {
            return;
        }
				
		// Only for your Settings model
        if ($controller->formGetWidget()->model instanceof \AuthorName\PluginName\Models\Settings) {
            $controller->addDynamicMethod('onAjaxHandlerName', static function () use ($controller) {
                // Do whatever you want here
            });
        }
    });
}
```
You can then call this AJAX handler from a partial form field.
```yaml
# /authorname/pluginname/models/settings/fields.yaml
fields:
    _ajax_button:
        type: partial
        path: $/authorname/pluginname/models/settings/ajax_button.htm
        span: left
```
```html

<button type="button"
        class="btn btn-primary"
        data-request="onAjaxHandlerName"
        data-request-flash
>Call my ajax handler</button>
```

This trick can also be used to add basic form's event handler like `get*Options` on form's refresh field and so on.

References

Add additional online resources to your trick

+ Add reference

Topics

If your trick fits more than one topic select multiple. Select at least one.

Backend Plugin Development CMS Twig Themes Deployment