Crud Controller¶

The CRUD controller is in charge of generating the forms (add, edit & delete) related to an item / model and handling automatically the multilingual / translation problematic.

environment_relation:
controller_url:	Url of the CRUD controller
model:	Which model it generates the form for.
	Relation name. Allows to define a children / parent relationship.
tab:	Tab informations (such as the icon & label), see nosTabs
views:	Optional. Views locations.
layout:	How the form looks like and where fields are displayed inside it. Optional if layout_insert and layout_update are defined.
layout_insert:	Optional. Specific layout for insert. Will use `layout` as default value.
layout_update:	Optional. Specific layour for update. Will use `layout` as default value.
fields:	All fields displayed in the form.

<?php
return array(
        'controller_url' => '',
'environment_relation' => null,
        'model' => '',
'tab' => array(
    'iconUrl' => '',
    'labels' => array(
        'update' => null,
        'insert' => 'New item',
        'blankSlate' => 'Translate an item',
    ),
),
        'layout' => array(),
        'fields' => array(),
'require_js' => array(),
'views' => array(
    'form' => 'nos::crud/form',
    'delete' => 'nos::crud/delete_popup',
),
);

environment_relation¶

The environment_relation must contain a relation name of type Orm\\BelongsTo.

It allows to use the GET['environment_id'] in an action of this model.

It will be used to populate the column associated with the relation. Examples include:

Add a page at a specific location inside the tree (with a pre-selected parent) ;
Add a media in a specific folder ;
Add a monkey inside a species ;
Add an blog post inside a category.

Some examples:

<?php
// Add a sub-page action
'action' => array(
    'action' => 'nosTabs',
    'tab' => array(
        // The 'page_parent_id' will be populated with $_GET['environment_id'] from the action
        'url' => '{{controller_base_url}}insert_update?environment_id={{_id}}&context={{_context}}',
    ),
),


// Add a media in this folder action
'action' => array(
    'action' => 'nosTabs',
    'tab' => array(
        // The 'media_folder_id' will be populated with $_GET['environment_id'] from the action
        'url' => '{{controller_base_url}}insert_update?environment_id={{id}}',
    ),
),

tab¶

views¶

form:	View for the form (both insert and update). Default is `nos::crud/form`.
delete:	View for the delete popup. Default is `nos::crud/delete_popup`.
insert:	Optional. View for the insert form (will use `form` value as default)
update:	Optional. View for the update form (will use `form` value as default)

layout¶

The layout is a data passed to the parameters of the view. It list all the views needed to render the form.

There are two syntaxes:

the full syntax ;
a simplified syntax, which is used 90% of the time.

The full syntax for using a layout is the following:

<?php
'layout' => array(
    'first_view' => array(
        'view' => 'nos::form/layout_standard',
        'params' => array(
            // View data (depends on the view).
            'title' => '',
            'content' => '',
        ),
    ),
    'second_view' => array(
        'view' => 'noviusos_page::admin/page_form',
        // No 'params'
    ),
    // More views can be used here.
),

In addition to view-specific params / data, Novius OS always include the following vars:

$item : the instance of the model currently edited (or added / translated).
$fieldset : the form instance which holds all fields definition.

Because 90% of the time, we want to use nos::form/layout_standard as the view for the layout, a simplified syntax was created: only write the view params of the standard layout.

It’s much more limitating because you can only use one view to render the layout, and it has to be nos::form/layout_standard. But that’s what should be used 90% of the time.

<?php
'layout' => array(
    // View data
    'title' => '',
    'content' => '',
),

We only need to define the view data for the standard layout, and it will be wrapped like so:

<?php
$layout = array(
    array(
        'view' => 'nos::form/layout_standard',
        'params' =>  $layout,
    ),
);

<?php
// The following...
return array(
        'layout' => array(
                'view_1' => array(
                        'view' => 'nos::form/layout_standard',
                        'params' => array(
            // View data (depends on the view).
                        ),
                ),
        ),
);

// ... is the same as this:
return array(
        'layout' => array(
                // View params for ``nos::form/layout_standard``.
        ),
);

Native views included in Novius OS¶

Used as container for other layouts / views
- Standard layout: used as a container for other views ;
- Expander: used inside layout_standard.content in the Pages application ;
Used as final views:
- Fields: used inside layout_standard.content in the User application ;
- Accordion: used inside layout_standard.menu in the Pages application.

fields¶

Contains the fields definition array.

The fields syntax is based on an existing FuelPHP feature, which is used to configure form attributes for each column of a Model :

Standard fields¶

Bold text is the value for the type property.

<input type=”text“>
<input type=”password“>
<textarea>
<select>
<input type=”radio“>
<input type=”checkbox“>
<input type=”submit“>
<input type=”button“>
<input type=”file“>

<?php
return array(
        'gender' => array(
                'label' => 'Gender',
                'form' => array(
                        'type' => 'select',
                        'options' => array(
                                'm' => 'Male',
                                'f' => 'Female',
                        )
                ),
                'validation' => array('required'),
        ),
);

<button type=”submit”>¶

type = submit generates <input type="submit">
type = button generates <input type="button">

The tag property can be used to force a precise HTML tag, it’s useful for a submit button.

FuelPHP will automatically use the value as the button’s text.

<?php
return array(
        'save' => array(
                'form' => array(
                        'type' => 'submit',
                        'tag' => 'button',
                        'value' => 'Save',
                ),
        ),
);

Renderers (advanced fields)¶

The renderer list is available in a dedicated page.

insert:	Adding an new item
blankSlate:	Translating an existing item
update:	Editing an existing item

renderer_options:
label:	Text for the label. Won’t be shown for hidden fields
form:	`array` Attributes of the <input> tag
renderer:	Class name of a renderer
	(optional) `array` Options for the renderer
validation:	(optional) `array` rules used to validate the field.
expert:	(optional) `boolean` Should the field be visible only to expert users? Default `false`.
show_when:	(optional) `callable` Custom callback function to alter the visibility of the field. Must return `true` for the field to be shown.