it-blaster/attach-file-bundle

Symfony2 bundle. The ability to attach files to the form.

AttachFileBundle

, _(*1)

Вспомогательный бандл для работы с файлами на сайте. Есть возмжность прикреплять несколько файлов к одной сущности. Есть поддержка языковых версий., _(*2)

Installation

Добавьте ItBlasterAttachFileBundle в composer.json:, _(*3)

{
    "require": {
        "it-blaster/attach-file-bundle": "dev-master"
    },
}

Теперь запустите композер, чтобы скачать бандл командой:, _(*4)

``` bash $ php composer.phar update it-blaster/attach-file-bundle, <sub>(*5)</sub>

Композер установит бандл в папку проекта `vendor/it-blaster/attach-file-bundle`.

Далее подключите бандл в ядре `AppKernel.php`:

``` php
<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new ItBlaster\AttachFileBundle\ItBlasterAttachFileBundle(),
    );
}

В app/config/config.yml необходимо указать путь до класса бихейвора it_blaster_file и подключить шаблон виджета attach_file:, <sub>(*6)</sub>

``` bash propel: ... behaviors: ... it_blaster_file: ItBlaster\AttachFileBundle\Behavior\AttachFileBehavior, <sub>(*7)</sub>

twig: form: resources: - 'ItBlasterAttachFileBundle:Form:attach_file_widget.html.twig', <sub>(*8)</sub>

assetic: bundles: - 'ItBlasterAttachFileBundle', <sub>(*9)</sub>

В файл app/config/routing.yml необходимо подключить роутинг-файл бандла:
``` bash
attach_file:
    resource: '@ItBlasterAttachFileBundle/Resources/config/routing.yml'

Usage

В файле schema.yml подключите бихейвор it_blaster_file ``` xml, <sub>(*10)</sub>

В параметре <b>file_columns</b> необходимо указать имя поля изображения. В данном примере этим полем является поле <b>image</b>. Если к сущности необходимо прекреплять несколько файлов, названия полей в параметре <b>file_columns</b> нужно указать через запятую, например:
``` xml

Поля файлов должны иметь тип integer, <sub>(*11)</sub>

Далее в описании формы редактирования необходимо подключить поле прикрепления файла: ``` php $formMapper ->add('image_file', 'attach_file', array( 'label' => 'Изображение', 'required' => false, 'constraints' => [ new Image([ 'mimeTypes' => [ 'image/gif', 'image/jpeg', 'image/pjpeg', 'image/png' ] ]) ], <sub>(*12)</sub>

    ));

Обратите внимание, что поле называется не `image`, а `image_file`. Это поле image_file и соответствующие методы get и set создал бихейвор <b>AttachFileBehavior</b>, они используются исключительно для формы редактирования.

Use i18n
-------
Если вы используете языковые версии на сайте на основе propel-бихейвора `i18n` и к каждому переводу необходимо прикреплять файл, то вам необходимо в основной таблице (<b>document</b>) указать параметр `i18n`, где будет имя поля файла, и в соответствующей таблице с переводами (<b>document_i18n</b>) укзать параметр `file_columns`, в котором будет то же самое значение поля файла. Пример:
``` xml

Далее подключаем виджет attach_file в админ-форме: xml $formMapper ->add('DocumentI18ns', new TranslationCollectionType(), [ 'label' => false, 'required' => false, 'type' => new TranslationType(), 'languages' => $this->getConfigurationPool()->getContainer()->getParameter('locales'), 'options' => [ 'label' => false, 'data_class' => 'Artsofte\MainBundle\Model\DocumentI18n', 'columns' => [ 'active' => [ 'label' => "Опубликовать", 'type' => 'checkbox', ], 'file_title' => [ 'label' => "Имя файла", 'type' => 'text', 'required' => true, ], 'download_file' => array( 'type' => 'attach_file', 'label' => 'Выберите файл', 'maxSize' => '20M', 'options' => [ 'sonata_help' => 'Допустимые типы файлов: pdf, doc, docx, zip, jpg, gif, png', 'constraints' => [ new \Symfony\Component\Validator\Constraints\File([ 'mimeTypes' => [ 'application/pdf', 'application/msword', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'application/vnd.oasis.opendocument.text', 'application/zip', 'image/gif', 'image/jpeg', 'image/pjpeg', 'image/png' ] ]) ] ] ), ] ] ]) ;, <sub>(*13)</sub>

Credits

It-Blaster it-blaster@yandex.ru, <sub>(*14)</sub>