Developed with love by KnpLabs Hire us for your project!
124

SimpleThingsFormExtraBundle

by simplethings

[DEPRECATED]

SimpleThingsFormExtraBundle

Build Status

This bundle contains additional functionality for Symfony2's Form Component.

Currently this Bundle provides the following:

  • RecaptchaFieldType for using Google's reCAPTCHA service.
  • ImageType for showing the previously uploaded image
  • FileSet for showing a list of previously uploaded files
  • FieldTypeExtension for allowing setting attr when building a Form.

Current this Bundle does not provide the following:

  • In depth documentation.
  • Unicorns or other fairytale creatures.

Contributors

Thanks to all who have helped make this bundle awesome. For a list of people who have helped you
should visit this page: https://github.com/SimpleThings/SimpleThingsFormExtraBundle/contributors.

Contributing

If you want to help create a fork of this repository do some coding and send a Pull Request.

Installing

Fire up a terminal and either clone this repository or add it as a submodule both are shown here
by example.

$ git clone git://github.com/simplethings/SimpleThingsFormExtraBundle.git vendor/bundles/SimpleThings/FormExtraBundle
$ git submodule add git://github.com/simplethings/SimpleThingsFormExtraBundle.git vendor/bundles/SimpleThings/FormExtraBundle

for symfony 2.0 use the deps file by adding this in it and running php bin/vendors install

[FormExtraBundle]
    git=https://github.com/simplethings/SimpleThingsFormExtraBundle.git
    target=bundles/SimpleThings/FormExtraBundle
    version=v0.1

or for symfony 2.1 add this to your composer.json and run composer install

{
    "require": {
        "simplethings/form-extra-bundle": "1.0.*"
    }
}

the enable to the bundle inside your kernel class normally called AppKernel.php

<?php

public function registerBundles()
{
    // ...
    new SimpleThings\FormExtraBundle\SimpleThingsFormExtraBundle(),
    // ...
}

Usage

RecaptchaFieldType

<?php
// ...
$builder->add('recaptcha', 'formextra_recaptcha');
// ...
# app/config/config.yml
simple_things_form_extra:
    recaptcha:
        private_key: "your-private-key"
        public_key:  "your-public-key"

When doing functional testing it is not possible to use the real Google Recaptcha API therefor there is
a SimpleThings\FormExtraBundle\FunctionalTest\Recaptcha which always returns true.

It can be used by overwriting the DependencyInjection parameter in app/config/config_test.yml

parameters:
    simple_things_form_extra.service.recaptcha.class: SimpleThings\FormExtraBundle\FunctionalTest\Recaptcha

The formextra_recaptcha form type takes a widget_options setting which is encoded as json and set to the configuration
javascript variable Recaptcha needs. This allows you to change the theme for the widget or roll your own. For more information
about what is possible check here http://code.google.com/apis/recaptcha/docs/customization.html.

<?php
// ...
$builder->add('recaptcha', 'formextra_recaptcha', array(
    'widget_options' => array(
        'theme' => 'white', // blackglass, clean, red is the predefined themes.
    ),
));
// ...

PlainType

Sometimes it is needed to show the value of a field without having it be an input box. This is where
PlainType comes in handy. It will render a simple p tags with the fields value and also prevent that
field from being bound if the form is tampered with.

<?php
// ...
$builder->add('username', 'formextra_plain');
// ...

FileSetType

FileSetType allows you to incrementally add more files to a collection of files by extending
the FileType. It renders an unordered list of all the previously uploaded base filenames.

Instead of returning the previously added file you return an array of all file names
from the fields getter method and in the setter method you append the newly uploaded file to the collection:

<?php
class Document
{
    // temporary field, used in the form, to move new attachments to persistence
    private $newAttachment;
    // persistent array with all attachments.
    private $attachments;

    public function getNewAttachment()
    {
        $files = array();
        foreach ($this->attachments AS $attachment) {
            $files[] = $attachment->getFilename();
        }
        return $files;
    }

    public function setNewAttachment(File $newAttachment = null)
    {
        $this->newAttachment = $newAttachment;
    }

    public function moveNewAttachment()
    {
        // code to move file and include in the attachments field.
    }
}

Using the builder to create a field for this type would then look like:

<?php
$builder->add('newAttachment', 'formextra_fileset', array(
    'type' => 'file',
));

There are optional parameters 'delete_route' and 'delete_id' which are then used with twigs path
method to generate a route with parameters "id" and "file", to delete the listed file. If the information
passed is not enough you should overwrite the twig template with your own logic to implement
deleting.

TranslationDomainExtension

This field extension provides the forward compatibility for the support of translation domains
added in Symfony 2.1. So activating it is useful only when using Symfony 2.0 (activating it in
Symfony 2.1 will add useless overhead)

To use it, you need to activate it and to register the form theme using the translation domain.

# app/config/config.yml
simple_things_form_extra:
    translation_domain_forward_compat: true

twig:
    form:
        resources:
            - SimpleThingsFormExtraBundle:Form:translation_domain.html.twig
            # eventually other themes here

You can now provide the translation domain used for labels and choice options when building the form:

<?php
// ...
$builder->add('body', 'textarea', array(
    'label' => 'some message',
    'translation_domain' => 'form_extra',
));
// ...

HelpExtension

This field extension provides help message option.

To use it, you need to activate it and to register the form theme using the translation domain.

# app/config/config.yml
simple_things_form_extra:
    help_extension: true

twig:
    form:
        resources:
            - SimpleThingsFormExtraBundle:Form:field_type_help.html.twig

You can also load the help extension form theme into your own form theme.

{% use 'SimpleThingsFormExtraBundle:Form:field_type_help.html.twig' %}

You can now provide the help message for field when building the form:

<?php
// ...
$builder->add('body', 'textarea', array(
    'label' => 'some message',
    'help'  => 'some usefull help message'
));
// ...

HtmlEntitiesTransformer

Converts html code into entites. Also extends htmlentities function to auto guess the used charset
if mbstring extension is availible.

<?php
// ...
$builder->get('body')->prependNormTransformer(new HtmlEntitiesTransformer(ENT_COMPAT, true));
// ...

StripTagsTransformer

Provides easy tag stripping capabilities for your forms to reduce xss attacks. You note it is not the
best solution.

<?php
// ...
// This will allow <p> tags.
$builder->get('body')->prependNormTransformer(new StripTagsTransformer('<p>'));
// ...
simple_things_form_extra:
translation_domain_forward_compat: false
help_extension: false
recaptcha:
public_key: ~ # Required
private_key: ~ # Required
  • Merge pull request #49 from nurikabe/patch-1
    By DavidBadura, 6 years ago
  • Don't output an empty help block
    By Evan Owens, 6 years ago
  • Merge pull request #48 from camilleb/master
    By DavidBadura, 6 years ago
  • change field_row for form_row in help twig template
    By Camille Boissel, 6 years ago
  • fix test for pull request #47 (property_path deprecated at false)
    By DavidBadura, 6 years ago
  • Merge pull request #47 from RomainLegouverneur/patch-1
    By DavidBadura, 6 years ago
  • property_path deprecated at false
    By RomainLegouverneur, 6 years ago
  • [travis] test working onyl with version >2.3, add 2.4 env
    By DavidBadura, 6 years ago
  • test new travis config
    By DavidBadura, 7 years ago
  • Merge pull request #45 from n4s-bill/master
    By DavidBadura, 7 years ago
  • Update field_type_help.xml
    By n4s-bill, 7 years ago
  • Update FieldTypeHelpExtension.php
    By n4s-bill, 7 years ago
  • update .travis.yml
    By DavidBadura, 7 years ago
  • update README
    By DavidBadura, 7 years ago
  • Merge pull request #43 from ivan1986/gaufrette_support
    By DavidBadura, 7 years ago
  • Merge pull request #42 from ivan1986/defBasePath
    By DavidBadura, 7 years ago
  • parameter
    By ivan1986, 7 years ago
  • fix webDir
    By ivan1986, 7 years ago
  • support gaufrette in image
    By ivan1986, 7 years ago
  • Default base_path by base_url and web root dir
    By ivan1986, 7 years ago
  • Merge pull request #41 from mwalser/master
    By DavidBadura, 7 years ago
  • Use $options[…] instead of $form->getConfig()->getAttribute(…)
    By mwalser, 7 years ago
  • Fix FieldTypeHelpExtension for Symfony 2.3
    By mwalser, 7 years ago
  • Merge pull request #40 from ivan1986/fix23
    By DavidBadura, 7 years ago
  • Merge pull request #1 from DavidBadura/fix23
    By ivan1986, 7 years ago
  • fix RecaptchaType test
    By DavidBadura, 7 years ago
  • equals data in tests
    By ivan1986, 7 years ago
  • update composer
    By ivan1986, 7 years ago
  • rewrite tests
    By ivan1986, 7 years ago
  • fix defaults
    By ivan1986, 7 years ago