Awesome Shortcuts Bundle

What is the point ?

This bundle allows you to easily add and use shortcuts for your dev apps., _(*3)

Install

This procedure describes the installation of the project for use in a virtual machine vagrant., _(*4)

Recovery Bundle

Composer

Add the following lines in your composer.json :, _(*5)

    {
        "require": {
            "appventus/shortcuts-bundle": "dev-master"
        }
    }

Then execute the following command:, _(*6)

    php composer.phar update

Bundle activation

In your AppKernel.php add the following lines :, _(*7)

<?php

public function registerBundles()
{
    $bundles = array(
        // ...
        new AppVentus\Awesome\ShortcutsBundle\AvAwesomeShortcutsBundle(),
    );
}

Configuration

Twig

Add the following lines in Config.yml :, _(*8)

    # Sf=2.*
    twig:
        form:
            resources:
                - 'AvAwesomeShortcutsBundle::fields.html.twig'# Twig Configuration
    # Sf>=3.*
    twig:
        form_themes:
            - 'AvAwesomeShortcutsBundle::fields.html.twig'

In your layout file, load the following files :, _(*9)

    '@AvAwesomeShortcutsBundle/Resources/public/css/datepicker.css'
    '@AvAwesomeShortcutsBundle/Resources/public/js/bootstrap-datepicker.js'

Using shortcuts

A service allows the use of functions used in many applications., _(*10)

Eg. in a controller:, _(*11)

$shorcutService = $this->get('av.shorcuts');
$shorcutService->getSession(...
$shorcutService->setSession(...
$shorcutService->createAndQueueMail(...
$shorcutService->createAndSendMail(...

View ShortcutService file for a complete list of shortcuts and their parametres., _(*12)

FormErrorService

As it is common to submit forms by ajax, it is desired to return the error forms of a string, _(*13)

The FormErrorService transforms errors on a form (and its sub-forms) into a string., _(*14)

Eg. in a controller:, _(*15)

    $form = ...  //some form

    if ($form->isValid()) {
        ...
    } else {
        $formErrorService = $this->get('av.form_error_service');
        $errorsAsString = $formErrorService->getRecursiveReadableErrors($form);
    }

Integration with AvAlertifyBundle

This bundle brings a lot of shortcuts for AvAlertify bundle to standardize all alerts for your application., _(*16)

Instead of using:, _(*17)

$this->get('session')->getFlashBag()->add('noty', array(
        'type'              => $type,
        'layout'            => $layout,
        'body'              => $content,
        'translationDomain' => $translationDomain
    )
);

or worse, _(*18)

$this->session->getFlashBag()->add('success', 'Congratulations !');

We can now use the following shortcuts from the av.shortcuts Service :, _(*19)

$this->container->get('av.shortcuts')->congrat($content, $layout, $translationDomain);

or any of our controller inheriting AwesomeController :, _(*20)

$this->congrat('Congratulations !');         // Success
$this->warn('Careful, this is important !'); // Warning
$this->inform('Did you know ?');             // Information
$this->scold('Oups something went wrong !'); // Error

RedactorType

Add the assetic injector redactor tag, _(*21)

$redactorOptions = [
    'lang' => $this->request->getLocale(),
    'plugins' => ['video'],
    'buttons' => ['html', 'formatting', 'bold', 'italic', 'underline', 'deleted', 'unorderedlist', 'orderedlist', 'outdent', 'indent', 'image', 'video', 'link', 'alignment', 'horizontalrule'],
    'imageUpload' => '/bundles/avawesomeshortcuts/libs/redactor/scripts/image_upload.php',
];

$builder->add('description', RedactorType::class, [
    'options' => $redactorOptions
]);