snowcap/core-bundle

Symfony SnowcapCoreBundle

Saturday, September 26, 2015
by Snowcap
Repository
6 Watchers
3 Stars
7,291 Installations

PHP
2 Dependents
1 Suggesters
2 Forks
12 Open issues
15 Versions
1 % Grown

The README.md

, _(*1)

Snowcap Core Bundle

The Snowcap Core Bundle is a bundle used at Snowcap to help us with some repetitive tasks, including (but not limited to):, _(*2)

Dealing with file and image uploads
RSS feed generation
SEO-related tasks (sitemaps, etc)

Installation

Download SnowcapCoreBundle using composer

Add SnowcapCoreBundle in your composer.json:, _(*3)

For Symfony < 2.7

{
    "require": {
        "snowcap/core-bundle": "~1.0"
    }
}

For Symfony >= 2.7

{
    "require": {
        "snowcap/core-bundle": "~2.0"
    }
}

Now tell composer to download the bundle by running the command:, _(*4)

``` bash $ php composer.phar update snowcap/core-bundle, _(*5)


Composer will install the bundle to your project's `vendor/snowcap` directory.

### Enable the Bundle

Enable the bundle in the kernel:

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

public function registerBundles()
{
    $bundles = array(
        // ...
        new Snowcap\CoreBundle\SnowcapCoreBundle(),
    );
}

Running the tests

Before running the tests, you will need to install the bundle dependencies. Do it using composer :, _(*6)

``` bash $ php composer.phar --dev install, _(*7)


Then you can simply launch phpunit

``` bash
$ phpunit

Form types

SnowcapCoreBundle provides a few useful form types., _(*8)

File Field Type (snowcap_core_file)

The snowcap_core_file field type is a simple file upload widget. It extends Symfony's default file type, and bring two extra features:, _(*9)

It allows users to ask for the deletion of the current file
The widget includes a "download" button that allows the user to download the file

Usage

<?php
// src/Acme/SiteBundle/Form/CandidateType

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder->add('cv', 'snowcap_core_file', array(
        'label' => 'Curriculum Vitae',
        'file_path' => 'cvPath',
    ));
}

When Symfony displays the form widget, it will also render a "donwload" button, which is basically a link pointing to the file, as specified by the file_path option., _(*10)

Options

file_path

type: string or callable required, _(*11)

Either a public path that can be processed by Symfony's PropertyAccess component or a callable that takes the field data as sole argument and returns a path. This path will be used to build the download button url., _(*12)

allow_delete

type: boolean default: true, _(*13)

When true, will display a checkbox allowing users to ask for the deletion of the current file. When checked, on form submission, the field data will be replaced by an instance of Snowcap\CoreBundle\File\CondemnedFile. It is up to you to process that Condemned file instance (unless you use the SnowcapCoreBundle FileSubscriber)., _(*14)

delete_label

type: string default: null, _(*15)

The label that will be displayed next to the deletion checkbox., _(*16)

download_label

type: string default: null, _(*17)

The label that will be displayed on the download button., _(*18)

Image Field Type

The snowcap_core_image field type extends the snowcap_core_file field type. It behaves the same way, except that it is rendered differently: instead of displaying a "download" button, it will actually display the uploaded image., _(*19)

Note: If you are using SnowcapImBundle, in addition to the options provided by snowcap_core_file, you can specify a im_format option. It will be used to dynamically create a thumbnail of the picture. Please refer to the SnowcapImBundle documentation for more information., _(*20)

The Versions

26/09 2015

dev-master

9999999-dev https://github.com/snowcap/SnowcapCoreBundle

Symfony SnowcapCoreBundle

symfony-bundle core-bundle

Symfony SnowcapCoreBundle