kyoushu/common-bundle

This package is abandoned and no longer maintained. No replacement package was suggested.

1.0.0 2016-03-16 16:55 UTC

Requires

• php: >=5.5.0
• doctrine/doctrine-bundle: ~1.5
• doctrine/orm: ~2.5
• stof/doctrine-extensions-bundle: ^1.2
• symfony/form: >=2.3
• symfony/framework-bundle: >=2.3
• symfony/twig-bundle: >=2.3
• symfony/validator: >=2.3

Requires (Dev)

• phpunit/phpunit: ~4.5
• symfony/browser-kit: ~2.3
• symfony/css-selector: >=2.3
• symfony/dom-crawler: ~2.6

MIT

• James Willans

README

This file has been generated automatically. It will require editing to reflect describe functionality provided by this bundle.

Installation

Install stof/doctrine-extensions-bundle

Add the following lines to composer.json

"require": {
    "kyoushu/common-bundle": "dev-master"
}

Add the following line to app/AppKernel.php

$bundles = array(
    // ...
    new Kyoushu\CommonBundle\KyoushuCommonBundle(),
    // ...
);

Todo

• Documentation for dynamic routes
• Documentation for videos and video metadata

Upload Handler

The bundle provides an upload handler which will copy uploaded files to a target directory on update/persist.

All you need to do is implement Kyoushu\CommonBundle\Upload\UploadInterface in your entity.

namespace AppBundle\Entity;

use Kyoushu\CommonBundle\Upload\UploadInterface;
use Symfony\Component\HttpFoundation\File\File;

class MyUploadEntity implements UploadInterface
{

    /**
     * @var File|null
     */
    protected $file;
    
    /**
     * @var string|null
     */
    protected $relPath;
    
    /**
     * @return File|null
     */
    public function getFile()
    {
        return $this->file;
    }
    
    /**
     * @param File|null $file
     * @return $this
     */
    public function setFile(File $file = null)
    {
        $this->file = $file;
        return $this;
    }
    
    /**
     * @return string|null
     */
    public function getRelPath()
    {
        return $this->relPath;
    }

    /**
     * @param string|null $relPath
     * @return $this
     */
    public function setRelPath($relPath)
    {
        $this->relPath = $relPath;
        return $this;
    }

    /**
     * @return string
     */
    public function getRelDir()
    {
        return 'sub/dir/where/upload/should/go';
    }

}

Entity Traits

The bundle provides a range of traits to speed up the creation of entities

namespace AppBundle\Entity;

use Kyoushu\CommonBundle\Entity\Traits as EntityTraits;

class MyEntity
{

    // Provides the property $id (auto-incrementing primary key) and related getter
    use EntityTraits\IdTrait;
    
    // Provides the properties $title and $slug and related getters/setters
    // - $slug is generated from the value of $title on persist/update
    use EntityTraits\TitleSlugTrait;
    
    // Provides the $summary property and related getters/setters
    // - Intended to be used with textarea form fields
    use EntityTraits\SummaryTrait;
    
    // Provides $created and $updated timestamp properties and related getters/setters
    // - $created is set to \DateTime('now') on persist
    // - $updated is set to \DateTime('now') on persist/update
    use EntityTraits\TimestampTrait;

}

Entity Finders

You can create an entity finder by extending the class \Kyoushu\CommonBundle\EntityFinder\AbstractEntityFinder

namespace AppBundle\EntityFinder;

use Kyoushu\CommonBundle\EntityFinder\AbstractEntityFinder;

class MyEntityFinder extends AbstractEntityFinder
{

    public function getEntityClass()
    {
        return 'AppBundle\Entity\MyEntity';
    }

}

Custom parameters can be used by overriding configureQueryBuilder() and getRouteParameterKeys()

namespace AppBundle\EntityFinder;

use Kyoushu\CommonBundle\EntityFinder\AbstractEntityFinder;

class MyEntityFinder extends AbstractEntityFinder
{

    protected $title;

    public function getEntityClass()
    {
        return 'AppBundle\Entity\MyEntity';
    }

    public function getTitle()
    {
        return $this->title;
    }

    public function setTitle($title)
    {
        $this->title = $title;
        return $this;
    }

    public function getRouteParameterKeys()
    {
        return array('page', 'perPage', 'title');
    }

    public function configureQueryBuilder(QueryBuilder $queryBuilder)
    {
        $title = $this->getTitle();
        if($title !== null){
            $queryBuilder->andWhere('entity.title like :like_title');
            $queryBuilder->setParameter('like_title', '%' . $title . '%');
        }
    }

}