2017 © Pedro Peláez
 

symfony-bundle attachment-bundle

Attach a file collection to Doctrine entities.

image

nazka/attachment-bundle

Attach a file collection to Doctrine entities.

  • Saturday, March 15, 2014
  • by jsampedro77
  • Repository
  • 1 Watchers
  • 1 Stars
  • 14 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 1 Versions
  • 0 % Grown

The README.md

Nakza Attachment Bundle

Attach a collection of files to any Doctrine entity. Features include:, (*1)

  • Easy attach files to an entity using Trait.
  • Configurable Security provider for each entity with attachments.
  • Controller to list, view and download attachments
  • Thumbnail generation for images and video (optional). Can create your own thumnail generators.
  • File uploads with VichUploader and KnpGaufrette

Installation

Create a composer.json in your projects root-directory:, (*2)

{
    "require": {
        "nazka/attachment-bundle": "*"
    }
}

and run:, (*3)

curl -s http://getcomposer.org/installer | php
php composer.phar install

Temporally, you have to configure Gaufrette and VichUploader. This we be automatically done in future., (*4)

in config.yml ``` yaml knp_gaufrette: adapters: attachment_adapter: local: directory: %kernel.root_dir%/../private/attachments filesystems: attachment_fs: adapter: attachment_adapter, (*5)

vich_uploader: db_driver: orm gaufrette: true storage: nazka_attachment.storage.gaufrette mappings: attachment: upload_destination: attachment_fs inject_on_load: false, (*6)


This parameter must be created to have video thumnails generated by ffmpeg, set to false if you want to disable:

    nazka_attachment_ffmpeg_path: /usr/bin/ffmpeg

Usage
-----

Your entity should use HasAttachmentsTrait, this way it will also implemente HasAttachmentsInterface.

``` php
<?php

namespace Nazka\Sample\Entity;

use Doctrine\ORM\Mapping as ORM;
use Nazka\AttachmentBundle\Model\HasAttachmentsInterface;
use \Nazka\AttachmentBundle\Entity\HasAttachmentsTrait;

/**
 * Nazka\SampleBundle\Entity\SupportCase
 *
 * @ORM\Table()
 * @ORM\Entity()
 */
class SupportCase implements HasAttachmentsInterface
{

    use HasAttachmentsTrait;

Now you can access the attachments with the methods provided in the Trait, like:, (*7)

$entity->getAttachments();

TO-DO

  • Finish documentation, security access provider section and thumbnail generation.
  • Automatic creation of nazka_attachment_fs Gaufrette FileSystem.

The Versions

15/03 2014

dev-master

9999999-dev

Attach a file collection to Doctrine entities.

  Sources   Download

GPLv2

The Requires

 

The Development Requires

by Javier Sampedro