Swiffers / TmsMediaClientBundle

Symfony2 bundle client for TmsMediaBundle

TmsMediaClientBundle

Symfony2 bundle client for TmsMediaBundle

Installation

To install this bundle please follow the next steps:

First add the dependency in your composer.json file:

"repositories": [
    ...,
    {
        "type": "vcs",
        "url": "https://github.com/Tessi-Tms/TmsMediaClientBundle.git"
    }
],
"require": {
        ...,
        "tms/media-client-bundle": "dev-master"
    },

Then install the bundle with the command:

php composer update

Enable the bundle in your application kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        ...
        new Tms\Bundle\MediaClientBundle\TmsMediaClientBundle(),
    );
}

Now import the bundle configuration in your app/config/config.yml

imports:
    ...
    - { resource: @TmsMediaClientBundle/Resources/config/config.yml }

Now the Bundle is installed and configured.

How to use

OneToOne Relation with a media:

In your entity:

/**
 * @var Media
 *
 * @ORM\OneToOne(targetEntity="Tms\Bundle\MediaClientBundle\Entity\Media", cascade={"all"})
 * @ORM\JoinColumn(name="media_id", referencedColumnName="id", onDelete="SET NULL", nullable=true)
 */
private $media;

In the entity form type:

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ...
        ->add('media', 'related_to_one_media', array(
            'data' => $builder->getData()->getMedia()
        ))
        ...
    ;
}

ManyToMany Relation with a media:

In your entity:

/**
 * @var array<Media>
 *
 * @ORM\ManyToMany(targetEntity="Tms\Bundle\MediaClientBundle\Entity\Media", cascade={"all"})
 * @ORM\JoinTable(name="my_entity_media",
 *     joinColumns={@ORM\JoinColumn(name="my_entity_id", referencedColumnName="id", onDelete="cascade")},
 *     inverseJoinColumns={@ORM\JoinColumn(name="media_id", referencedColumnName="id", onDelete="cascade")}
 * )
 */
private $images;

Additional information:

If you want a ManyToOne behavior, just add a UNIQUE constraint to the media key. Replace the inverseJoinColumns line with:

inverseJoinColumns={@ORM\JoinColumn(name="media_id", referencedColumnName="id", unique=true, onDelete="cascade")}

In the entity form type:

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ...
        ->add('images', 'related_to_many_media')
        ...
    ;
}

Without media entity relation:

In your entity:

/**
 * @var string
 *
 * @ORM\Column(name="image", type="text")
 */
private $image;

In this entity form type:

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ...
        ->add('image', 'direct_link_media')
        ...
    ;
}