blast-project/core-bundle

This is the core of Libre Informatique Symfony2 projects

Wednesday, March 28, 2018
by beta
Repository
3 Watchers
3 Stars
6,905 Installations

PHP
19 Dependents
2 Suggesters
3 Forks
2 Open issues
19 Versions
0 % Grown

The README.md

Blast CoreBundle

[][coveralls] , _(*1)

, _(*2)

The goal of this bundle is to make the use of SonataAdmin "view-models" possible without writting a line of PHP, without loosing a feature of Sonata, and importing the idea of composite settings using lots of characteristics of an admin (its direct inheritance tree, the traits used by its Entity, the inheritance tree of its Entity...), making things more flexible, extendable, reusable and maintenable through many bundles and uses., _(*3)

This bundle is the next step after the SonataAdminBundle. Configure an entire backend bundle filling only YAML files... Try it!, _(*4)

It is also the core of Libre Informatique's Symfony 2/3 projects., _(*5)

Example

I want to design and create a bundle as a toolbox for other bundles' entities. It will provide traits for email addresses and phonenumbers, for instance (cf. BlastBaseEntitiesBundle)., _(*6)

Using the BlastCoreBundle, your "base" bundle will carry the traits, but also the way to display properties given by its traits in a SonataAdmin (which becomes a CoreAdmin) CRUD. Then using the traits of your "base" bundle in the entities of other bundles (also implementing the BlastCoreBundle) will add the fields naturally, the columns in the list of objects, etc... as you set up for your trait in your "base" bundle, without having to write a line for this., _(*7)

Imagine this feature appliable to 50 entities distributed in 10 bundles, and count in your mind the number of saved lines, the number of potential bugs avoided and the ease of maintenance when you want to change the nature of the field used by the provided email address or phonenumber... This is what the BlastCoreBundle permits., _(*8)

Installation

Prerequisites

having a working Symfony2 environment
having created a working Symfony2 app (including your DB and your DB link)
having composer installed (here in /usr/local/bin/composer, with /usr/local/bin in the path)

Downloading

$ composer require blast-project/core-bundle dev-master, _(*9)

This will download and install : * knplabs/knp-menu * knplabs/knp-menu-bundle * cocur/slugify * sonata-project/core-bundle * sonata-project/cache * sonata-project/block-bundle * sonata-project/exporter * twig/extensions * sonata-project/admin-bundle * sonata-project/doctrine-orm-admin-bundle * blast-project/core-bundle * libre-informatique/base-entities-bundle * twig/twig ^1.22.1, _(*10)

Third party bundles, Sonata bundles

Please refer to the Sonata Project's instructions, foundable here : https://sonata-project.org/bundles/admin/3-x/doc/reference/installation.html https://sonata-project.org/bundles/user/3-x/doc/reference/installation.html, _(*11)

And follow the installation guides., _(*12)

At the end, you should have a app/AppKernel.php that looks like that:, _(*13)

<?php

use Symfony\Component\HttpKernel\Kernel;
use Symfony\Component\Config\Loader\LoaderInterface;

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

            // Add your dependencies
            new Sonata\CoreBundle\SonataCoreBundle(),
            new Sonata\BlockBundle\SonataBlockBundle(),
            new Knp\Bundle\MenuBundle\KnpMenuBundle(),
            //...

            // If you haven't already, add the storage bundle
            // This example uses SonataDoctrineORMAdmin but
            // it works the same with the alternatives
            new Sonata\DoctrineORMAdminBundle\SonataDoctrineORMAdminBundle(),

            // You have 2 options to initialize the SonataUserBundle in your AppKernel,
            // you can select which bundle SonataUserBundle extends
            // Most of the cases, you'll want to extend FOSUserBundle though ;)
            // extend the ``FOSUserBundle``
            //new FOS\UserBundle\FOSUserBundle(),
            //new Sonata\UserBundle\SonataUserBundle('FOSUserBundle'),
            // OR
            // the bundle will NOT extend ``FOSUserBundle``
            //new Sonata\UserBundle\SonataUserBundle(),

            // Then add SonataAdminBundle
            new Sonata\AdminBundle\SonataAdminBundle(),
            new Blast\CoreBundle\BlastCoreBundle(),

            //...
        ];
        //...
    }
    //...
}

And at the end of the app/config/config.yml file:, _(*14)

# ...
sonata_block:
    default_contexts: [cms]
    blocks:
        # Enable the SonataAdminBundle block
        sonata.admin.block.admin_list:
            contexts:   [admin]
        # Your other blocks

PostgreSQL

Create the database needed, _(*15)

If you are using PostgreSQL as your main database, you'll need to install postgresql-contrib and load the "uuid-ossp" extension :, _(*16)

  $ sudo apt-get install postgresql-contrib
  $ echo 'CREATE EXTENSION "uuid-ossp";' | psql [DB]

The "libre-informatique" bundles

Edit your app/AppKernel.php file and add your "libre-informatique" bundle, for instance the "libre-informatique/core-bundle" :, _(*17)

    // app/AppKernel.php
    // ...
    public function registerBundles()
    {
        $bundles = array(
            // ...

            // The libre-informatique bundles
            new Blast\CoreBundle\BlastCoreBundle(),

            // your personal bundles
        );
    }

Usages

Configuring your SonataAdminBundle interfaces with YAML properties

Discover the configuration of the CoreBundle., _(*18)

Going further...

Configuring a standalone bundle

Discover the configuration of a standalone bundle., _(*20)

Going further using the CoreAdmin

Instead of the Blast\CoreBundle\Admin\Traits\Base trait, you might be interested in : * Blast\CoreBundle\Admin\Traits\Embedded: if the current CoreAdmin aims to be embedded * Blast\CoreBundle\Admin\Traits\Embedding: if the current CoreAdmin aims to embed other forms and you want its embedding fields to be treated automatically, _(*21)

Creating new field types., _(*22)

Using Sonata Project extensions

If needed, you can easly use the BlastCoreBundle in combination with other bundles from the Sonata Project, for instance :, _(*23)

Please refer yourself to the proper documentation from the Sonata Project..., _(*24)

Managing entities dashboard groups

Discover the configuration of the dashboard., _(*25)

Using Blast Core command tools for patches

Discover how to implement patches, _(*26)

The Versions

28/03 2018

dev-wip-platform

dev-wip-platform https://github.com/blast-project/CoreBundle

This is the core of Libre Informatique Symfony2 projects

symfony-bundle core-bundle

This is the core of Libre Informatique Symfony2 projects

blast-project/core-bundle

The README.md

Blast CoreBundle

Example

Installation

Prerequisites

Downloading

Third party bundles, Sonata bundles

PostgreSQL

The "libre-informatique" bundles

Usages

Configuring your SonataAdminBundle interfaces with YAML properties

Going further...

Read more about the CoreBundle, and how to improve the SonataAdminBundle

Configuring a standalone bundle

Going further using the CoreAdmin

Using Sonata Project extensions

Managing entities dashboard groups

Using Blast Core command tools for patches

The Versions

dev-wip-platform

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

dev-wip-lisem

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

dev-master

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

0.6.4

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

0.5.2

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

dev-wip-locale

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

0.5.1

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

dev-wip-test

The Requires

The Development Requires

by Baptiste SIMON

by Libre Informatique

by Romain SANCHEZ

by Marcos Bezerra de Menezes

dev-feature-sonata_saved_filters

The Requires