sedona/sbo

Sedona Back-Office bundles

Sedona Back Office

Installation

Requirements

• Symfony 2.7 mini, compatible with Symfony 3

Step 1: Download the Bundles

Open a command console, enter your project directory and execute the following command to download the latest version of this bundle:, _(*1)

$ composer require "sedona/sbo" "dev-master"

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation., _(*2)

 Step 2: Enable the Bundles

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project, if you don't use them already, you also need to add a few more bundles:, _(*3)

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

             new FOS\JsRoutingBundle\FOSJsRoutingBundle(),

             new JMS\DiExtraBundle\JMSDiExtraBundle($this),
             new JMS\AopBundle\JMSAopBundle(),

             new Sedona\SBORuntimeBundle\SedonaSBORuntimeBundle(),
             new Sg\DatatablesBundle\SgDatatablesBundle(),
             new Avanzu\AdminThemeBundle\AvanzuAdminThemeBundle(),
             new Exercise\HTMLPurifierBundle\ExerciseHTMLPurifierBundle(),
        );

        if (in_array($this->getEnvironment(), array('dev', 'test'), true)) {
              // ...
              $bundles[] = new Sedona\SBOGeneratorBundle\SedonaSBOGeneratorBundle();
        }
        // ...
    }

    // ...
}

 Step 3: Create a base layout

Create a template app/Resources/views/layout_admin.html.twig, _(*4)

    {% extends 'SedonaSBORuntimeBundle:layout:base-layout.html.twig' %}

    {% block avanzu_logo %}
        <a href="{{ path('admin_home') }}" class="logo">
            <img src="{{ asset('bundles/sedonasboadmintheme/images/sedona-logo.png') }}"/> Test SBO
        </a>
    {% endblock %}
    {% block title %}Administration{% endblock %}    
    {% block page_title %}Administration{% endblock %}    
    {% block page_subtitle %}Administration area{% endblock %}

Step 4: Add some basic configuration

Add in routing.yml, _(*5)

admin:
    resource: "@AppBundle/Controller/Admin"
    type:     annotation
    prefix:   /admin

fos_js_routing:
    resource: "@FOSJsRoutingBundle/Resources/config/routing/routing.xml"

Add in config.yml, _(*6)

jms_di_extra:
    locations:
        all_bundles: false
        bundles: [SedonaSBOTestBundle]
        directories: ["%kernel.root_dir%/../src"]

And activate translation in it by uncommenting, _(*7)

    translator:      { fallback: "%locale%" }

Generator usage

php app/console sbo:generate:crud --entity SedonaSBOTestBundle:Track --with-write --overwrite

To be working, each Entity should have its __toString() method declared., _(*8)

Association fields OneToMany are created but commented by default:, _(*9)

• in datatable: before uncommenting, the column name should be changed (entity.name by default)
• in form: only entities with few lines should be uncommented, for long datas, should be replaced by a select2

Credits

Sedona Back Office is created and maintained by Sedona http://www.sedona.fr, _(*10)

It is available under the MIT Licence, more details in the LICENCE file., _(*11)

We would like to thanks the authors of the different libraries and bundle used in this solution., _(*12)

• SBOGeneratorBundle is based on SensioGeneratorBundle from SensioLabs https://github.com/sensiolabs/SensioGeneratorBundle
• SBORuntimeBundle extends AvanzuAdminThemeBundle from Avanzu https://github.com/avanzu/AdminThemeBundle which is a Symfony implementation of the AdminLTE template from Almsaeed Studio https://github.com/almasaeed2010/AdminLTE
• Genererated Datatable use SgDatatablesBundle from Stwe https://github.com/stwe/DatatablesBundle which implements JQuery Datatable https://datatables.net/