Download the PHP package snowcap/core-bundle without Composer
On this page you can find all versions of the php package snowcap/core-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download snowcap/core-bundle
More information about snowcap/core-bundle
Files in snowcap/core-bundle
Package core-bundle
Short Description Symfony SnowcapCoreBundle
License MIT
Homepage https://github.com/snowcap/SnowcapCoreBundle
Informations about the package core-bundle
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):
- 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:
For Symfony < 2.7
For Symfony >= 2.7
Now tell composer to download the bundle by running the command:
Composer will install the bundle to your project's vendor/snowcap
directory.
Enable the Bundle
Enable the bundle in the kernel:
Running the tests
Before running the tests, you will need to install the bundle dependencies. Do it using composer :
Then you can simply launch phpunit
Form types
SnowcapCoreBundle provides a few useful form types.
File Field Type (snowcap_core_file)
The _snowcap_corefile field type is a simple file upload widget. It extends Symfony's default file type, and bring two extra features:
- 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
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 _filepath option.
Options
file_path
type: string or callable required
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.
allow_delete
type: boolean default: true
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).
delete_label
type: string default: null
The label that will be displayed next to the deletion checkbox.
download_label
type: string default: null
The label that will be displayed on the download button.
Image Field Type
The _snowcap_coreimage field type extends the _snowcap_corefile 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.
Note: If you are using SnowcapImBundle, in addition to the options provided by _snowcap_corefile, you can specify a _imformat option. It will be used to dynamically create a thumbnail of the picture. Please refer to the SnowcapImBundle documentation for more information.