New resource

Description

The "New Resource" module purpose - render a form to create a new record of some entity

Format is very similar to Resource module. The difference is that NewResource creates a record, while Resource edits an existing record.

Configuration
Fields
Validation
Appearance examples

`NewResource` configuration

Add a named NewResourceModule to an AdminixPage. This complete provider creates a user with connection-neutral validation based on the Eloquent model.

namespace App\Adminix\Pages;

use AlexKudrya\Adminix\AdminixPage;
use AlexKudrya\Adminix\AdminixPageProvider;
use AlexKudrya\Adminix\Modules\Resource\NewResourceModule;
use AlexKudrya\Adminix\Modules\Resource\ResourceField;
use AlexKudrya\Adminix\Modules\Resource\ResourceInputTypeEnum;
use App\Models\User;

final class CreateUserPage implements AdminixPageProvider
{
    public static function get(): AdminixPage
    {
        return AdminixPage::uri('users-create')
            ->name('users-create')
            ->title('Create user')
            ->addModule(
                NewResourceModule::name('new-user')
                    ->title('New user')
                    ->dataSource(User::class)
                    ->addFields(
                        ResourceField::name('Name')
                            ->field('name')
                            ->type(ResourceInputTypeEnum::STRING)
                            ->required()
                            ->addValidationRules('required', 'string', 'max:255'),
                        ResourceField::name('Email')
                            ->field('email')
                            ->type(ResourceInputTypeEnum::EMAIL)
                            ->required()
                            ->addValidationRules(
                                'required',
                                'email',
                                'max:255',
                                'unique:' . User::class . ',email'
                            ),
                    )
            );
    }
}

Result: /adminix/users-create renders a create form. The module name is required and must be unique within the page.

`NewResource` configuration methods

Method	Description
name	Name of module, must be unique in current page. name('new_user')	Required
title	Title on the top of module title('NEW USER')	Optional
dataSource	Source of data for new entity creation, can be an `Eloquent Model`, for example `\App\Models\User::class` or name of table in database `users` or `public.users` dataSource(\App\Models\User::class) or dataSource('users')	Required
addField addFields	Methods by which you can add fields for the current `NewResource` module. Details described below. #Fields Argument can be only `AlexKudrya\Adminix\Modules\Resource\ResourceField` class instance. ->addField( ResourceField::name('Name') ->field('name') ->type(ResourceInputTypeEnum::STRING) ->required() )	Required
addFieldValidation	Method by which you can add validation rules for a field in the current `NewResource` module. Format similar to native Laravel Validation feature. Details described below. #Validation ->addFieldValidation( 'name', [ 'string', 'required', "unique:". User::class.",name" ] )	Optional
successRedirectUri	An uri of adminix page, where user will be redirected in case of successful record creation. successRedirectUri(UsersPage::URI)	Optional

Fields

Fields is an array, of input fields to be rendered in the Form.

use AlexKudrya\Adminix\AdminixPage;
use AlexKudrya\Adminix\Modules\Resource\NewResourceModule;
use AlexKudrya\Adminix\Modules\InputSelectSrc;
use AlexKudrya\Adminix\Modules\Resource\ResourceField;
use AlexKudrya\Adminix\Modules\Resource\ResourceInputTypeEnum;

$page = new AdminixPage();

$page->addModule(
    NewResourceModule...
        ->addFields(
            ResourceField::name('Name')
                ->field('name')
                ->type(ResourceInputTypeEnum::STRING)
                ->required(),

            ResourceField::name('Email')
                ->field('email')
                ->type(ResourceInputTypeEnum::EMAIL)
                ->required(),
                
            ResourceField::name('Password')
                ->field('password')
                ->password()
                ->confirmed()
                ->required(),
                
            ResourceField::name('Role')
                ->field('role_id')
                ->type(ResourceInputTypeEnum::SELECT)
                ->required()
                ->src(
                    InputSelectSrc::dataSource(Role::class)
                        ->nameField('name')
                        ->valueField('id')
                ),
                
            ResourceField::name('Admin')
                ->field('is_admin')
                ->type(ResourceInputTypeEnum::HIDDEN)
                ->value(false),
        )
)

...

To add field to your NewResource module you need paste AlexKudrya\Adminix\Modules\Resource\ResourceField class instance as an argument to addField or addFields method of NewResourceModule object.

ResourceField::asyncSrc() is supported for create-form SELECT fields. Use it the same way as in ResourceModule when a related table is too large for eager-loaded src() options. Old input after validation errors is kept as a temporary selected option and resolved by the async option endpoint when the page loads. multiple() is supported too: selected chips are restored from old input, submitted values are backend-validated against the async source, and the created record receives a JSON array string.

ResourceField::upload() is supported for create forms too. Use ResourceInputTypeEnum::FILE for stored files, or an IMAGE field with upload(...) for stored images. Dropzone uploads show configured accepted formats and maximum size inside the drop area. The created record receives the stored filesystem path after validation succeeds; uploaded files are not restored into old input after validation errors because browsers do not allow programmatic file input values. See Resource for the full upload example and result details.

ResourceField::password() is supported for create forms. It renders password inputs with an optional visibility toggle and Laravel-compatible field_confirmation naming when confirmed() is enabled. updateOnly() password fields are ignored during creation; immutable() password fields can be created but are not writable on edit forms. See Resource for the full password contract and security notes.

Create forms honor ResourceField::visibleOnCreate()/hiddenOnCreate(). Hidden-on-create fields are not rendered and are excluded from server-side writable field resolution.

`ResourceField` configuration

Method

Description

name

Title of the libel displayed near to the input

'name' => 'Email',

Required

type

Type of rendered input, can be provided only by AlexKudrya\Adminix\Modules\Resource\ResourceInputTypeEnum Enum class.

Available types:

STRING,
EMAIL,
INTEGER,
BOOLEAN,
FILE (stored upload),
SELECT,
DATE,
DATETIME,
TIME,
WEEK,
MONTH,
IMAGE (image URL/path input, or stored image upload when upload() is enabled),
HIDDEN,
PASSWORD,
RANGE,
PHONE/TEL,
COLOR (colorpicker),
TIMEZONE (IANA timezone select),
TEXT/TEXTAREA (multiline text),
EDITOR/CKEDITOR/WYSIWYG (advanced text editor),
JSON (JSON code textarea with safe fallback)
KEY_VALUE (JSON object editor with key/value rows)
TAGS (tag input with chip preview)

type(ResourceInputTypeEnum::EMAIL)

Required

field

Name of field in database table where new record will be created.

field('role_id')

Required

required

If enabled - field will be required for form submitting, and form wil not be submitted until this field wil not be filled. By default, is disabled.

required()

Optional

src

Required for filed with type SELECT if select_records is empty. Need to display correct <options/> of <select/>input.

For example, users table has related table roles, and relation maked by role_id field in users table. To dasplay select with options from roles table, you need to configure src correctly.

Example:

ResourceField::name('Role')
    ->field('role_id')
    ->type(ResourceInputTypeEnum::SELECT)
    ->required()
    ->src(
        InputSelectSrc::dataSource(Role::class)
            ->nameField('name')
            ->valueField('id')
    ),

setting	Description
dataSource	Source of data for filed items, can be an `Eloquent Model` - `\App\Models\Role::class` or name of table in database `roles`or `public.roles`
nameField	Name of field which will be a label in `<option/>`
valueField	Name of field which will be a value in `<option/>` (usually it is "id")

Optional

addSelectRecords

Required for fields with type SELECT as an alternative for src(). Required if src() is empty. It is a list of options, where name() is a title of <option/>, and value()is a value of <option/>

Arguments can be only AlexKudrya\Adminix\Modules\SelectRecord class instances.

ResourceField::name('Role')
    ->field('role_id')
    ->type(ResourceInputTypeEnum::SELECT)
    ->addSelectRecords(
        SelectRecord::name('Admin')->value(1),
        SelectRecord::name('Manager')->value(2),
        SelectRecord::name('Seller')->value(3),
        SelectRecord::name('Guest')->value(4),
    )

Optional

value

Used only for fields with type HIDDEN and provides fixed value to it.

value('some text')

Or you can paste parameter from route, if you provided it. For example https://site.com/adminix/new_order/315, 315 in this case will be pasted as value into this hidden input. Use param:0 for the first route parameter in new pages; legacy param:1 remains supported for existing providers.

value('param:0')

Optional

confirmed

Can be used only for fields with type PASSWORD. Determines password confirmation and renders additional PASSWORD input below current for password confirmation.

Validation uses Laravel's field_confirmation request key.

confirmed()

Optional

addValidationRules

Adding validation rules for current field.

Password confirmation uses Laravel's field_confirmation request key.

Format similar to Laravel native Validation feature.

Details here Validation.

->addValidationRules(
    'integer',
    'required',
    'exists:'. Role::class.',id'
),

Optional

Validation

An array of validation rules for form input data. Format similar to Laravel native Validation feature.

#Laravel Validation

There are 3 ways to add validation rules to your newResource form:

Add rules to every ResourceField personally, by using addValidationRules() method
Add rules to every field by using addFieldValidation() method of NewResourceModule object
Add all rules for add fields by using validation() method of NewResourceModule object

Way 1 example:

use AlexKudrya\Adminix\AdminixPage;
use AlexKudrya\Adminix\Modules\Resource\NewResourceModule;
use AlexKudrya\Adminix\Modules\InputSelectSrc;
use AlexKudrya\Adminix\Modules\Resource\ResourceField;
use AlexKudrya\Adminix\Modules\Resource\ResourceInputTypeEnum;

$page = new AdminixPage();

$page->addModule(
    NewResourceModule...
        ->addFields(
            ResourceField::name('Name')
                ->field('name')
                ->type(ResourceInputTypeEnum::STRING)
                ->required()
                ->addValidationRules(
                    'string',
                    'required',
                    "unique:". User::class.",name"
                ),

            ResourceField::name('Email')
                ->field('email')
                ->type(ResourceInputTypeEnum::EMAIL)
                ->required()
                ->addValidationRules(
                    'email',
                    'required',
                    "unique:". User::class.",email"
                ),
                
            ResourceField::name('Password')
                ->field('password')
                ->password()
                ->confirmed()
                ->required()
                ->addValidationRules(
                    'string',
                    'required',
                    'confirmed'
                ),
                
            ResourceField::name('Role')
                ->field('role_id')
                ->type(ResourceInputTypeEnum::SELECT)
                ->required()
                ->src(
                    InputSelectSrc::dataSource(Role::class)
                        ->nameField('name')
                        ->valueField('id')
                )
                ->addValidationRules(
                    'integer',
                    'required',
                    'exists:'. Role::class.',id'
                ),
        )
)

...

Way 2 example:

use AlexKudrya\Adminix\AdminixPage;
use AlexKudrya\Adminix\Modules\Resource\NewResourceModule;

$page = new AdminixPage();

$page->addModule(
    NewResourceModule...
        ->addFields(...)
        ->addFieldValidation('name', [
            'string',
            'required',
            'unique:App\Models\User,name',
        ])
        ->addFieldValidation('email', [
                'email',
                'required',
                'unique:App\Models\User,email',
        ])
        ->addFieldValidation('password', [
            'string',
            'required',
            "confirmed",
        ])
        ->addFieldValidation('role_id', [
            'integer',
            'required',
            'exists:App\Models\Role,id',
        ])
)
...

Way 3 example:

use AlexKudrya\Adminix\AdminixPage;
use AlexKudrya\Adminix\Modules\Resource\NewResourceModule;

$page = new AdminixPage();

$page->addModule(
    NewResourceModule...
        ->addFields(...)
        ->validation([
            'name' => [
                'string',
                'required',
                'unique:App\Models\User,name',
            ],
            'email' => [
                'email',
                'required',
                'unique:App\Models\User,email',
            ],
            'password' => [
                'string',
                'required',
                "confirmed",
            ],
            'role_id' => [
                'integer',
                'required',
                'exists:App\Models\Role,id',
             ],
        ])
)
...

Appearance examples

Example: New Record form from New User creation

Rendered example:

Last modified: 23 July 2026

New resource

Description

NewResource configuration

NewResource configuration methods

Fields

ResourceField configuration

Validation

Appearance examples

`NewResource` configuration

`NewResource` configuration methods

`ResourceField` configuration