README

This package adds file type to Symfony Form

Installation

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

$ composer require netliva/filetype

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require netliva/filetype

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Netliva\FileTypeBundle\NetlivaFileTypeBundle(),
        );

        // ...
    }

    // ...
}

Configurations

Routes Definations

netliva_file_route:
  resource: .
  type: netliva_file_route

Config Definations

Yükleyeceğiniz dosyaların nereye yükleneceğini ve indirme linkinin neresi olacağını aşağıdaki kodları ayarlar dosyanıza ekleyerek düzenleyebilirsiniz. Bu ayarlar opsiyonel olup varsayılan değerler aşağıdaki gibidir.

# Symfony >= 4.0. Create a dedicated netliva_config.yaml in config/packages with:
# Symfony >= 3.3. Add in your app/config/config.yml:

netliva_file_type:
    file_config:
        upload_dir: public/netliva_uploads
        download_uri: /uploads

upload_dir: dosyalarınızın proje ana klasöründen itibaren nereye yükleneceğini tanımlamanızı sağlar.
download_uri: yüklenen dosyalarınızın hangi klasör altından indirileceğini gösteren sanal bir dizindir. Dosyalarınız gerçekte bu klasör altında yeralmaz sadece dosyanın görünen url'ini belirler. Eğer burada belirteceğiniz klasör gerçekte proje ana dizininde bulunursa görüntülemede sıkıntı çıkabilir.

Basic Usage

Öncelikle json_array veya text formatında veritabanı alanınızı oluşturun. Ardından bu alan için formtype'a aşağıdaki gibi tanımlamanızı ekleyin.

<?php
//...
public function buildForm (FormBuilderInterface $formBuilder, array $options)
{
   //...
   $formBuilder->add('images', NetlivaFileType::class, [ 'label' => 'Images', 'multiple' => false]);
   // Eğer Bootstrap Css Kütüphanesini kullanıyorsanız, bootstrap görünümünü aktifleştirin
   $formBuilder->add('images', NetlivaFileType::class, [ 'label' => 'Images', 'multiple' => false, 'bootstrap'=>true]);
   // Yüklenen dosya için benzersiz bir isim ile yüklenmesini isterseniz unique_name aktifleştirebilirsiniz
   $formBuilder->add('images', NetlivaFileType::class, [ 'label' => 'Images', 'multiple' => false, 'unique_name'=>true]);
   // Dosyanın belirtilen ana yükleme dizini içinde alt klasöre yüklenmesi için 'sub_folder' kullanabilirsiniz
   $formBuilder->add('images', NetlivaFileType::class, [ 'label' => 'Images', 'multiple' => false, 'sub_folder'=>'categorized/sub/folder']);
   // return_data_type yardımıyla dönüş değerini belirleyebilirsiniz. Varsayılan değer 'array' dir.
   // Eğer veritabanı alanı text ise 'string', json ise 'array' belirlemeniz uygundur.
   $formBuilder->add('images', NetlivaFileType::class, [ 'label' => 'Images', 'multiple' => false, 'return_data_type'=>'string']);
   //...
}
//...
?>

Kaydedilen verileri kullanma

eğer tek dosya yüklediyseniz;

<img src="{{ entity.image|nl_file_uri }}" />

eğer multiple => true olarak yükleme yaptıysanız;

{% for img in entity.images %}
   <img src="{{ img|nl_file_uri }}" />
{% endfor %}

netliva / filetype

Maintainers

Details