README

Symfony Media Bundle. The bundle allow in easy way upload files. The bundle required to working dropzone.js script.

Configure

Require the bundle with composer:

$ composer require soft-passio/media-bundle

Enable the bundle in the kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new SoftPassio\MediaBundle\MediaBundle(),
        // ...
    );
}

Create your Media class:

<?php

namespace AppBundle\Entity;

use SoftPassio\MediaBundle\Entity\Media as BaseMedia;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity()
 */
class Media extends BaseMedia
{

}

Add to config.yml:

twig:
    form:
        resources:
            - 'MediaBundle:form:fields.html.twig'
            
media:
    entities:
        media_class: AppBundle\Entity\Media
    allowed_mime_types: ["image/jpeg", "image/jpg", "image/png", "image/gif", "application/pdf"]

Add to routing.yml:

media:
    resource: '@MediaBundle/Controller/'
    type: annotation

Add these libs into your admin panel:

<!--css -->
<link rel="stylesheet" href="{{ asset('bundles/media/css/dropzone.min.css') }}" />

<!-- js -->
<script src="{{ asset('bundles/media/js/dropzone.min.js') }}"></script>

Update your database schema:

$ php app/console doctrine:schema:update --force

Media Form Type

<?php

use Symfony\Component\Form\AbstractType;
use SoftPassio\MediaBundle\Form\Type\MediaType;
use Symfony\Component\Form\FormBuilderInterface;

class Post extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $formMapper
            ->add('image', MediaType::class)
        ;
    }
}

Twig helper

Render a media:

<img src="{{ post.media|media }}" />

Group of validation

Bundle allow to validation every single used MediaType in different way. For example you want to allow only PDF files:

You need to add group into config.yml:

media:
    entities:
        media_class: AppBundle\Entity\Media
    allowed_mime_types: ["image/png", "image/gif"]
    max_file_size: 15000000
    groups:
        lorem:
            allowed_mime_types: ["application/pdf"]
            max_file_size: 560000

Set group in MediaType:

$formMapper->add('image', MediaType::class, [
    'group' => 'lorem'
]);

License

The bundle is released under the MIT License.

soft-passio / media-bundle

Maintainers

Details