Fields

• Input
• Wysiwyg
• Markdown
• Picture
• Datetime
• Checkbox
• Code
• Textarea
• Tags
• Select
• Mask
• Relations
• Modification

Fields are used to generate the output for the form template.

All possible fields are defined in the config/platform.php file inside the fields section Every field may be used in a entity, template or filter.

Fields and entities are defined separately, that allows us to use only a key to access them, for example if we need a wysiwyg redactor requested value will be our class. This allows to change the tinymce to summernote or ckeditor almost in one click.

Don’t be shy to add custom fields, for example to use a redactor comfortable for you or any component.

Input

Input is one of the most diversed elements of forms that allows you to create different parts of interface and provide interaction with user. Input is mainly intended to create text fields.

An example:

Input::make()
    ->type('text')
    ->name('place')
    ->max(255)
    ->required()
    ->title('Name Articles')
    ->help('Article title');

Note that a lot of parameters, like max, required, title, help and others, are accessible from almost every field of the system and are completely optional

Wysiwyg

A visual redactor which contents are displayed in the process of redaction and look almost like a result. The redactor allows to add images, tables, define text styles and embed videos.

An example:

TinyMCE::make()
    ->name('body')
    ->required()
    ->title('Name Articles')
    ->help('Article title')
    ->theme('inline');

To display a top panel and a menu, that allows you to view a splash screen and html code, in the redactor, you need to set an attribute theme('modern').

Markdown

Light markup language redactor created to write a maximum human-friendly and easy-to-correct text suitable to be transpiled to languages for advanced publications

an example:

SimpleMDE::make()
    ->name('body')
    ->title('What would you tell us?');

Picture

Allows to upload pictures and cut them to a required format

An example:

Picture::make()
    ->name('picture')
    ->width(500)
    ->height(300);

Datetime

Allows to set date and time

An example:

DateTimer::make()
    ->type('text')
    ->name('open')
    ->title('Opening date')
    ->help('The opening event will take place');

Checkbox

User graphical interface element that allows a user to control the parameter with two states — ☑ on and ☐ off.

An example:

CheckBox::make()
    ->name('free')
    ->value(1)
    ->title('Free')
    ->placeholder('Event for free')
    ->help('Event for free');

Code

A field for a program code with a highligt

An example:

Code::make()
    ->name('block')
    ->title('Code Block')
    ->help('Simple web editor');

Textarea

A textarea field is an element of form used to insert several text strings inside it. As opposed to input tag, it’s possible to do a line break there, it will be saved and sent to server.

An example:

TextArea::make()
    ->name('description')
    ->max(255)
    ->rows(5)
    ->required()
    ->title('Short description');

Tags

A notation of several values delimited by comma

An example:

Tags::make()
    ->name('keywords')
    ->title('Keywords')
    ->help('SEO keywords');

Select

Simple selection from array list:

Select::make()
    ->options([
        'index'   => 'Index',
        'noindex' => 'No index',
    ])
    ->name('select')
    ->title('Select tags')
    ->help('Allow search bots to index');

Mask

A mask for data input in input tag. It’s great to use it when a value must be inserted in some standard way, for example when inserting a phone number or TIN

An example:

Input::make()
    ->type('text')
    ->name('phone')
    ->mask('(999) 999-9999')
    ->title('Phone')
    ->help('Number Phone');

A json with parameters may be passed to mask, eg:

Input::make()
    ->type('text')
    ->name('price')
    ->mask([
         'mask' => '999 999 999.99',
         'numericInput' => true
    ])
    ->title('Cost');

Input::make()
    ->type('text')
    ->name('price')
    ->mask([
        'alias' => 'currency',
        'prefix' => ' ',
        'groupSeparator' => ' ',
        'digitsOptional' => true,
    ])
    ->title('Cost');

All available Inputmask may be found here

Relations

Relationship fields may used to set the relation for your record. It loads data with ajax request and may used with huge number of data.

Relationship::make()
    ->name('related_article')
    ->required()
    ->title('My related article')
    ->handler(AjaxWidget::class);

AjaxWidget $query property will contain search string and $key property will contain a value if it already set for the field.

namespace App\Http\Widgets;

use Orchid\Widget\Widget;

class AjaxWidget extends Widget
{

    /**
     * @var null
     */
    public $query = null;

    /**
     * @var null
     */
    public $key = null;

    /**
     * @return array
     */
    public function handler()
    {
        $data = [
            [
                'id'   => 1,
                'text' => 'Post 1',
            ],
            [
                'id'   => 2,
                'text' => 'Post 2',
            ],
            [
                'id'   => 3,
                'text' => 'Post 3',
            ],
        ];

        if(!is_null($this->key)) {
            foreach ($data as $key => $result) {

                if ($result['id'] === intval($this->key)) {
                    return $data[$key];
                }
            }
        }

        return $data;

    }

}

Modification

You also can modify value and other params with magic method modify with the name of attribute which you want modify:

Input::make()
    ->type('text')
    ->name('name')
    ->modifyValue(function ($value) {
        return strtoupper($value);
    })

It allow to create «calculated fields».