addiks/shtumi-useful-bundle

Symfony ShtumiUsefulBundle

dev-master 2024-02-22 11:31 UTC

Requires

• php: >=7.3
• ext-json: *
• doctrine/orm: *
• symfony/framework-bundle: >=4.4.0 || ^5.4
• symfony/security-bundle: >=4.4.0 || ^5.4

Suggests

• sonata-project/admin-bundle: master-dev
• sonata-project/doctrine-orm-admin-bundle: master-dev

MIT

• Mikhail Shtukin
• Alessandro Friscia
• Gerrit Addiks

• Ajax Autocomplete form type
• Dependent filtered form type
• daterange
• shtumi

README

ShtumiUsefulBundle provides some useful things that needed almost in every project. It's:

Form types:

• Ajax Autocomplete form type (useful when you operate with thousands and hundred thousands records [for instance: users])

• Dependent filtered form type (useful when you need operate dependent entities in one form (for instance: countries/regions))

• Date range form type (allows you select date range with JS calendar and take valid DateRange object)

DQL extra functions:

• IF

• IFNULL

• ROUND

• DATE_DIFF

You can use Ajax autocomplete form type as a filter type with SonataAdminBundle

Installation

Add the following lines to your deps file and then run php bin/vendors install:

[ShtumiUsefulBundle]
    git=https://github.com/shtumi/ShtumiUsefulBundle.git
    target=bundles/Shtumi/UsefulBundle

For Symfony 2.0 please use branch 2.0 of ShtumiUsefulBundle:

[ShtumiUsefulBundle]
    git=https://github.com/shtumi/ShtumiUsefulBundle.git
    target=bundles/Shtumi/UsefulBundle
    version=origin/2.0

You also should install SonataAdminBundle and all dependencies for it.

Add ShtumiUsefulBundle to your application kernel

    // app/AppKernel.php
    public function registerBundles()
    {
        return array(
            // ...
            new Shtumi\UsefulBundle\ShtumiUsefulBundle(),
            // ...
        );
    }

Register the ShtumiUsefulBundle namespace

    // app/autoload.php
    $loader->registerNamespaces(array(
        'Shtumi'            => __DIR__.'/../vendor/bundles',
        // your other namespaces
    ));

Import routes

// app/config/routing.yml

shtumi_useful:
    resource: '@ShtumiUsefulBundle/Resources/config/routing.xml'

Update your configuration

Add form theming to twig

twig:
    ...
    form:
        resources:
            - ShtumiUsefulBundle::fields.html.twig

Update your configuration in accordance with using ShtumiUsefulBundle things

Load jQuery to your views

    <script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>