saxulum/saxulum-crud

Saxulum CRUD

saxulum-crud

, _(*1)

Features

• list action
• create action
• edit action
• view action
• delete action

Requirements

• php: >=5.4,
• doctrine/common: ~2.5,
• symfony/form: ~2.7,
• symfony/http-kernel: ~2.7,
• symfony/routing: ~2.7,
• symfony/security: ~2.7
• twig/twig: ~1.2

Installation

Through Composer as saxulum/saxulum-crud., _(*2)

Usage

Trait

Use the following trait within your controller: Saxulum\Crud\Controller\CrudTrait., _(*3)

Base configuration

• crudName: contains the lowercase name of the object, example: sample
• crudObjectClass: contains the class name of the object, example: Saxulum\Crud\Entity\Sample

Advanced configuration

• crudRoutePattern: contains a template pattern like: %s_%s
• crudRolePattern: contains a template pattern like: role_%s_%s
• crudTemplatePattern: contains a template pattern like: @SaxulumCrud/%s/%s.html.twig

Services

• crudAuthorizationChecker: contains an instance of the symfony authorization checker
• crudDoctrine: contains an instance of the doctrine manager registry
• crudPaginator: contains an instance of a knp paginator
• crudFormFactory: contais an instance of a symfony form factory
• crudUrlGenerator: contains an instance of symfony routing url generator
• ~~crudSecurity~~: deprecated by symfony 2.7, use crudAuthorizationChecker
• crudTwig: contains an instance of the twig environment

Twig: form label generation

Use the following extension to use label generation: [Saxulum\Crud\Twig\FormLabelExtension][8]., _(*4)

Within the form template you can use something like this:, _(*5)

```{.twig} {% block form_label %} {% spaceless %} {% if label is empty %} {% set label = prepareFormLabel(form) %} {% endif %} {{ parent() }} {% endspaceless %} {% endblock form_label %}, <sub>(*6)</sub>

#### Example

The form name is `day_edit`, there is a collection field `comestiblesWithinDay`
with a subfield called `comestible`. As you can see the `_` within the name will
be replaced by a `.`.

```{.yaml}
day:
    edit:
        label:
            comestibles_within_day: Consumption
            comestibles_within_day_collection:
                comestible: Comestible

Advanced names: If you want the underscore within the form name, work with camel case. Which means someFormName_edit will be converted to some_form_name.edit., <sub>(*7)</sub>